Scarica anche il manuale con le spiegazioni sul

Kit A72
MANUALE DEL SOFTWARE
TWIDO PER IL DISTACCO UTENZE
(CEI 0-16 ALLEGATO M)
INDICE
1 OBIETTIVO................................................................................................................................... 2
2 CONFIGURAZIONE DEL PROGRAMMA......................................................................................2
2.1 Configurazione oggetti di memoria...............................................................................2
3 FUNZIONAMENTO....................................................................................................................... 5
3.1 Accensione e operazioni di inizializzazione...................................................................5
3.2 Funzionamento normale...............................................................................................6
3.3 Funzionalità di diagnostica............................................................................................7
3.4 Codifica delle operazioni...............................................................................................8
3.5 Diagramma di flusso delle operazioni...........................................................................9
4 MESSA IN SERVIZIO DEL SOFTWARE.......................................................................................9
4.1 Download del software sul Twido..................................................................................9
4.2 Configurazioni in runtime............................................................................................10
2
1 OBIETTIVO
Il presente documento ha lo scopo di descrivere la procedura per la configurazione del software
con POD, numeri di cellulare abilitati (massimo 5), testi dei messaggi e altre configurazioni
possibili.
2 CONFIGURAZIONE DEL PROGRAMMA
2.1 Configurazione oggetti di memoria
Le principali parole di memoria utilizzate dal programma sono le seguenti:
COSTANTI:
- %KW0:30
Messaggio di Distacco Utenza, codificato in ASCII, 2 lettere per word
- %KW30:30
Messaggio di Ripristino Utenza, codificato in ASCII, 2 lettere per word
- %KW60:30
Messaggio di Stato Utenza, codificato in ASCII, 2 lettere per word
- %KW90:30
Messaggio di Reset Utenza, codificato in ASCII, 2 lettere per word
I messaggi sono composti come nell'esempio seguente:
DISTACCO utenza x
Dove x è sostituito dal codice POD dell’utenza.
I messaggi possono essere lunghi al massimo 60 caratteri (30 word), più altri 20 per il POD.
- %KW120:11
Stringa usata per la richiesta di presenza nuovi messaggi al modem
- %KW135:24
Messaggio di risposta di Utenza distaccata, codificato in ASCII, 2 lettere
per word
- %KW160:24
Messaggio di risposta di Utenza ripristinata, codificato in ASCII, 2 lettere
per word
- %KW185:19
Messaggio di risposta allo Stato Utenza, codificato in ASCII, 2 lettere per
word
- %KW205:24
Messaggio di risposta di Reset Utenza ok, codificato in ASCII, 2 lettere per
word
- %KW205:24
Messaggio di risposta di Reset Utenza non ok, codificato in ASCII, 2 lettere
per word
Questi messaggi standard alla prima accensione vengono copiati nella me
moria di runtime, dove verranno poi modificati dall'utente e utilizzati per il confronto con i messaggi
che verranno ricevuti.
3
MEMORIA DI RUNTIME:
- %MW0→99
Area di memoria utilizzata per l'invio delle stringhe di configurazione al
modem; è sempre composta in questo modo:
Parola di memoria
Byte più significativo
Byte meno significativo
%MW0
Comando (0=sola trasmissione,
1=trasmissione e ricezione,
2=sola ricezione)
Lunghezza n (trasmissione o
ricezione)
%MW1
Riservato (0)
Riservato (0)
%MW2.....99
Caratteri (in codifica ASCII) da trasmettere; nella eventuale
risposta del modem questi caratteri saranno seguiti dai caratteri
di ricezione
In questo programma viene sempre utilizzato il comando di trasmissione e
ricezione per avere un feedback dell'avvenuto comando
- %MW100→299
Area di memoria utilizzata per l'invio dei messaggi, è composta allo stesso
modo della precedente (ma tenuta volutamente distinta per facilitare il
debug)
- %MW300→309
POD, codificato in ASCII, con un massimo di 20 caratteri alfanumerici
- %MW310→315
Primo numero di cellulare abilitato, compreso di prefisso internazionale 39,
e con in totale 12 cifre
- %MW320→325
Secondo numero di cellulare abilitato
- %MW330→335
Terzo numero di cellulare abilitato
- %MW340→345
Quarto numero di cellulare abilitato
- %MW350→355
Quinto numero di cellulare abilitato
- %MW361
Codice che identifica lo stato del segnale GSM:
- %MW362
Intensità del segnale GSM, codificata in caratteri ASCII
- %MW363
Intensità del segnale GSM, come valore intero
I valori di intensità del segnale, il loro significato e la relativa codifica in
%MW361 sono i seguenti:
VALORE (%MW362 e
%MW363)
CODIFICA
(%MW361)
INDICAZIONE
Nota
-1
0
ATTENDERE…
accensione del sistema; attesa del segnale GSM.
0
2
SEGNALE BASSO
-113 dBm o meno
1
2
SEGNALE BASSO
-111 dBm
da 2 a 10
2
SEGNALE BASSO
da -109 dBm a -96 dBm
da 11 a 30
1
SEGNALE OK
da -95 dBm a -53 dBm
31 o maggiore
1
SEGNALE OK
-51 dBm o maggiore
99
3
SEGNALE SCONOSCIUTO
Non rilevabile
- %MW400→405
Numero di cellulare dell'ultimo sms ricevuto, che verrà riutilizzato per la
risposta al messaggio
- %MW410
Memoria messaggi (SIM) utilizzata
4
- %MW411
Memoria messaggi totale
- %MW412
Memoria messaggi rimanente
- %MW470→476
Variabili per settaggio di data e ora. Generalmente sono a 0, modificarle e
poi settare un bit per scrivere la nuova data e ora in memoria.
- %MW480→488
Data e ora di sistema
- %MW490
Ore oltre le quali l'uscita viene ripristinata. (di default è 12; se viene
impostata a 0 il ripristino automatico dopo un intervallo di tempo non
funziona
- %MW491
Minuti oltre i quali l'uscita viene ripristinata. Si tratta della variabile
precedente convertita in minuti (per modificarli cambiare %MW490)
- %MW500→599
Viene riportato l'ultimo messaggio ricevuto con un carattere per word, per
rendere più semplice il confronto fra stringhe.
- %MW600→639
Messaggio di risposta di Utenza distaccata, codificato in ASCII, 2 lettere
per word
- %MW640→679
Messaggio di risposta di Utenza ripristinata, codificato in ASCII, 2 lettere
per word
- %MW680→719
Messaggio di risposta allo Stato Utenza, codificato in ASCII, 2 lettere per
word
- %MW720→759
Messaggio di risposta di Reset Utenza ok, codificato in ASCII, 2 lettere per
word
- %MW760→799
Messaggio di risposta di Reset Utenza non ok, codificato in ASCII, 2 lettere
per word
Modificare direttamente queste 5 aree di memoria per inserire i nuovi messaggi di risposta,
tenendo presente che al momento dell'invio del messaggio il carattere “x” verrà sostituito con il
POD, il carattere “X” verrà sostituito con lo stato dell'ingresso e il carattere “Y” con lo stato
dell'uscita
- %MW800→999
Parole di memoria vuote, utilizzate per resettare le stringhe di comando al
modem prima di comporne altre, per eliminare eventuali caratteri residui di
comandi e messaggi inviati precedentemente.
- %MW1000
Codice che indica l'operazione in corso. Consultare il paragrafo x.y per la
descrizione delle operazioni
- %MW1001
Viene impostata a 100 quando arriva un messaggio di reset, e reimpostata
a 0 a reset avvenuto e messaggio di reset ok inviato (utilizzata per capire
se il reset è avvenuto per via di un comando GSM, e quindi si deve inviare
il messaggio di risposta, o per altri motivi per cui il messaggio non deve
essere inviato)
- %MW1050→1079
Coda delle ultime 15 operazioni, una ogni 2 word (%MW1050 = operazione
attuale, %MW1052 = operazione precedente, …)
- %MW1100→1139
Messaggio di Distacco Utenza, codificato in ASCII, 2 lettere per word
- %MW1140→1179
Messaggio di Ripristino Utenza, codificato in ASCII, 2 lettere per word
- %MW1180→1219
Messaggio di Stato Utenza, codificato in ASCII, 2 lettere per word
5
- %MW1220→1259
Messaggio di Reset Utenza, codificato in ASCII, 2 lettere per word
Modificare direttamente queste 4 aree di memoria per inserire i nuovi messaggi. Come già
spiegato per le %KW il POD andrà rappresentato con la lettera “x”, e verrà sostituito in runtime dal
programma col POD presente nella sua specifica area di memoria.
- %MW1300→1499
Copia dei messaggi fatta a fine ciclo, utilizzata per rilevare l'eventuale
modifica dei messaggi nel ciclo di PLC attuale
- %MW1500→1599
Copia effettuata in runtime del messaggio da inviare, con un carattere per
word, e con già sostituiti i caratteri x, X e Y con POD, stato input e stato
output
- %MW1600→1899
Coda degli ultimi 5 messaggi ricevuti, composti da 60 word ciascuno divise
in questo modo:
- 1 di 60 (word 1600): posizione del messaggio nella memoria della SIM
- 3→8 (word 1602→1607): mittente del messaggio
- 11→19 (word 1610→1618): data e ora di invio del messaggio
- 21→60 (word 1620→1659): testo del messaggio
- %MW1900→2299: messaggi di distacco, ripristino, stato e reset utenza, divisi in 100 word
ciascuno, divisi un carattere per word e con già sostituito all'interno il POD
al posto della lettera x, per facilitare il confronto fra messaggi.
Nelle rimanenti parole di memoria sono presenti, sparse, altre variabili di appoggio per calcoli,
elaborazione stringhe, etc.. In caso di modifiche al software fare attenzione a non sovrascriverle
per evitare comportamenti anomali del programma.
3 FUNZIONAMENTO
3.1 Accensione e operazioni di inizializzazione
Ad ogni accensione del sistema c’è un’attesa di 2 minuti per permettere al modem di agganciare la
cella del segnale GSM, e di ricevere eventuali messaggi inviati durante il periodo in cui il sistema
era spento (in questo periodo di tempo il codice dell'operazione e 1, e il codice del livello segnale
sarà fisso su 0).
Passati i 2 minuti vengono effettuate le configurazioni di base del modem (il settaggio del formato
dei messaggi in modalità testo e il non-invio delle stringa non sollecitata alla ricezione di un sms).
Dopo queste prime configurazioni di base viene rilevata l’intensità del segnale GSM e quindi viene
fatta una lettura di tutti i messaggi non ancora letti che sono arrivati mentre il sistema era spento.
Questi messaggi non verranno considerati.
Se vengono trovati messaggi non letti, dopo un’ulteriore attesa di 15 secondi per l’eventuale
ricezione di altri messaggi, il sistema legge dal modem la quantità di memoria messaggi occupata
e quella totale disponibile.
A seconda della quantità di memoria messaggi disponibile il sistema effettua diverse operazioni:
- Se la memoria disponibile è maggiore di 4 il sistema passa direttamente al funzionamento
normale;
6
- Se la memoria disponibile è minore di 4 ma diversa da 0 vengono cancellati tutti i messaggi
presenti e quindi svuotata la memoria della SIM; viene quindi richiesta nuovamente l’occupazione
della memoria per avere i dati aggiornati, e quindi si passa al funzionamento normale;
- Se la memoria messaggi era piena vengono cancellati tutti i messaggi e quindi c’è un’ulteriore
attesa di 2 minuti per l’eventuale ricezione di ulteriori messaggi non ricevuti prima a causa della
memoria piena. Dopo 2 minuti vengono riletti nuovamente tutti i messaggi ricevuti durante l’attesa,
che non verranno eseguiti, e quindi viene rieseguita la procedura di lettura memoria messaggi e
l’eventuale cancellazione e rilettura, fino a passare al funzionamento normale.
3.2 Funzionamento normale
Il funzionamento standard oscilla fra 2 operazioni principali: la lettura di eventuali messaggi ricevuti
e, ogni 30 secondi, la rilevazione dell’intensità del segnale GSM.
Alla ricezione di un messaggio le operazioni standard che vengono effettuate sono:
La verifica che il mittente sia fra i numeri abilitati;
L’aggiunta di mittente, data e ora e testo del messaggio alla coda degli ultimi 5 messaggi ricevuti;
La lettura dell’occupazione della memoria messaggi e, in caso lo spazio disponibile sia minore di 4,
lo svuotamento della memoria e l’aggiornamento dello stato della memoria.
A seconda del comando ricevuto invece vengono effettuate ulteriori operazioni:
DISTACCO UTENZA
Il messaggio standard di distacco utenza è il seguente:
“DISTACCO utenza x”
Dove x sta ad indicare il codice POD dell’utenza.
Alla ricezione del messaggio di distacco vengono attivati: l’uscita di comando collegata alla
protezione di interfaccia e il contatto di segnalazione; al rilevamento dell’apertura dell’interruttore, o
dopo 10 secondi dalla ricezione del messaggio, viene inviato un messaggio di risposta con il testo
“utenza x distaccata - Input=X – Ouput= Y”
Dove X e Y valgono 0 o 1 e indicano:
X=1 => Ingresso attivo; X=0 => ingresso disattivo.
Y=1 => Uscita attiva; Y=0 => uscita disattiva.
RIPRISTINO UTENZA
Il messaggio standard di ripristino utenza è il seguente:
“RIPRISTINO utenza x”
Dove x sta ad indicare il codice POD dell’utenza.
Alla ricezione del messaggio di ripristino vengono disattivati l’uscita di comando, riabilitando
l’impianto alla riconnessione, e il contatto di segnalazione; dopo 10 secondi dalla ricezione del
messaggio, viene inviato un messaggio di risposta con il testo
“utenza x ripristinata - Input=X – Ouput= Y”
7
Dove X e Y valgono 0 o 1 e indicano:
X=1 => Ingresso attivo; X=0 => ingresso disattivo.
Y=1 => Uscita attiva; Y=0 => uscita disattiva.
DIAGNOSTICA
Il messaggio standard di diagnostica, per verificare la connessione alla rete GSM del sistema di
teledistacco e acquisire da remoto lo stato degli ingressi e uscite verso la protezione di interfaccia,
è il seguente:
“utenza x stato Input - Output”
Dove x sta ad indicare il codice POD dell’utenza.
Alla ricezione del messaggio di diagnostica viene subito inviato un messaggio di risposta con il
testo
“utenza x stato - Input=X – Ouput= Y”
Dove K e Y valgono 0 o 1 e indicano:
X=1 => Ingresso attivo; X=0 => ingresso disattivo.
Y=1 => Uscita attiva; Y=0 => uscita disattiva.
RESET INTERFACCIA
Il messaggio standard di reset è il seguente:
“RESET utenza x”
Dove x sta ad indicare il codice POD dell’utenza.
Alla ricezione di questo SMS il sistema si resetta, e riesegue le operazioni iniziali di attesa e
configurazione, quindi prima di tornare nelle condizioni di funzionamento normali, invia il seguente
messaggio:
“utenza x RESET OK - Input=X – Output =Y”
Dove X e Y valgono 0 o 1 e indicano:
X=1 => Ingresso attivo; X=0 => ingresso disattivo.
Y=1 => Uscita attiva; Y=0 => uscita disattiva.
Se dopo 10 secondi il reset non avviene il sistema invia invece un messaggio di Reset KO:
“utenza x RESET KO - Input=K – Output =Y”
3.3 Funzionalità di diagnostica
In caso di perdita della connessione fra modem e PLC dopo 30 secondi viene mostrato nella
relativa pagina sul pannello un segnale di allarme; dopo ulteriori 40 secondi il sistema esegue
automaticamente un reset; quando la comunicazione viene ristabilita prima di tornare al
funzionamento normale verranno rieffettuate le operazioni di inizializzazione.
8
3.4 Codifica delle operazioni
Lo stato in cui si trova il Twido è codificato da un numero intero. Gli stati possibili sono i seguenti:
CODICE
OPERAZIONE
DESCRIZIONE
1
ATTESA 30 SECONDI CHE SI ACCENDA IL MODEM E INVIO CMGF
2
FINE INVIO CMGF, INVIO CNMI
5
FINE INVIO CNMI, OPPURE FINE ATTESA 30 SECONDI: LETTURA SEGNALE
6
LETTURA MESSAGGI PER METTERLI TUTTI READ
7
LETTURA SPAZIO MEMORIA MESSAGGI
8
CANCELLO TUTTI I MESSAGGI
9
INVIO MESSAGGIO RESET
10
FUNZIONAMENTO NORMALE INTERROGAZIONE MODEM SU SMS RICEVUTI
13
OGNI 30SEC, SE NON STO FACENDO ALTRO, CHIEDO LIVELLO SEGNALE
23
INVIO SMS DI DISTACCO RICEVUTO
33
INVIO SMS DI RIPRISTINO RICEVUTO
40
INVIO SMS DI STATO
50
RESET RICEVUTO
51
INVIO MESSAGGIO DI RESET KO
9
3.5 Diagramma di flusso delle operazioni
4 MESSA IN SERVIZIO DEL SOFTWARE
4.1 Download del software sul Twido
Per caricare il software sul Twido aprire il file del progetto con TwidoSuite e collegarsi al Twido con
il cavo fornitio e il convertitore CUSB.
Dopo avere individuato la porta COM a cui collegarsi cliccare sul menu in alto a sinistra su
Programma e poi dal menu in alto a destra su Debug, selezionare la porta COM a cui ci si vuole
collegare e fare clic su “Avvia comunicazione”.
Cliccare su “Trasferimento PC ==> controller” e cliccare su OK. Dal popup che appare mettere
quindi in RUN il Twido.
10
4.2 Configurazioni in runtime
Dal menu “Comanda il controller” sulla destra del software è possibile regolare l'orario del Twido:
cliccare quindi su “Regola l'ora dell'RTC” e cliccare su Sincronizza. In questo modo il Twido prende
l'ora direttamente dal PC. In alternativa settare l'ora manualmente e cliccare su Applica.
Nel software sono presenti inoltre delle tabelle di animazione, utili per effettuare le configurazioni e
per il debug del software.
Cliccare quindi su Gestione delle tabelle di animazione dal menu sulla destra, e si potranno
visualizzare 8 tabelle già preimpostate.
In queste tabelle è possibile inserire il codice POD, i numeri di cellulare abilitati e modificare i
messaggi standard di invio e di ricezione (tutti in caratteri ASCII).
Nei messaggi la x minuscola starà ad indicare il POD e in runtime verrà sostituita automaticamente
dal software; la X maiuscola nei messaggi di risposta verrà sostituita dallo stato dell'ingresso, e la
Y maiuscola dallo stato dell'uscita. (Attenzione: non ripetere questi caratteri più di una volta nel
singolo messaggio).
Nelle tabelle di animazione è possibile anche visualizzare l'ora attuale, e settare l'ora, scrivendo
nelle apposite word (MW …. ) la data e ora attuale, e poi settando il bit %M120. (Dopo il set del bit
questa verrà resettato automaticamente, l'orario nel Twido verrà aggiornato e le word di Set
verranno reimpostate a 0).
ATTENZIONE: il set della data e ora corretta è molto importante perché, alla ricezione di un
messaggio, se il giorno del messaggio non corrisponde con il giorno settato nel Twido il messaggio
non viene elaborato.
Altre impostazioni settabili dalle tabelle sono:
- l'attivazione/disattivazione dell'autoreset a mezzanotte, cambiando il valore del bit %M
- l'autoreset dopo l'avvenuto distacco dopo un certo numero di ore (di default sono 12). Questo è
gestito dalla word %MW : il valore impostato indica il numero di ore, impostandola a 0 l'autoreset
non viene fatto.
Per finire c'è una tabella di debug, sulla quale è possibile vedere la coda delle ultime 20 operazioni
(codificate come da tabella nel paragrafo 3.4), l'eventuale allarme di comunicazione con il modem,
la memoria messaggi occupata e totale e il livello di segnale GSM sia come valore, sia codificato
come da tabella seguente.
VALORE (%MW362 e
%MW363)
CODIFICA
(%MW361)
INDICAZIONE
Nota
-1
0
ATTENDERE…
accensione del sistema; attesa del segnale GSM.
0
2
SEGNALE BASSO
-113 dBm o meno
1
2
SEGNALE BASSO
-111 dBm
da 2 a 10
2
SEGNALE BASSO
da -109 dBm a -96 dBm
da 11 a 30
1
SEGNALE OK
da -95 dBm a -53 dBm
31 o maggiore
1
SEGNALE OK
-51 dBm o maggiore
99
3
SEGNALE SCONOSCIUTO
Non rilevabile
11

Download Report