IEC61131 3 Programming

Programmazione IEC 61131-3
ELSIST S.r.l.
Sistemi in elettronica
Via G. Brodolini, 1 !".I.#
1$33 C%S%LE &.T'
IT%L(
Internet) *tt+),,---.elsist.it
Email) elsist.elsist.it
TEL. !3/#-$101-01/23
4%5 !3/#-$101-01/22
INDICE
1 - LogicLab.................................................................................................................................................................... 7
2 - Risorse del sistema................................................................................................................................................... 8
2.1 - Architettura memoria............................................................................................................................................ 9
2.2 - Memoria di backup (Retain)............................................................................................................................... 10
2.3 - Accesso alla memoria........................................................................................................................................ 11
3 - Definizione tipo dati................................................................................................................................................. 12
3.1 - FLEP, file pointer............................................................................................................................................... 12
3.2 - SYSSERALMODE, modo comunicazione porta seriale.................................................................................... 12
3.3 - SYSCANMESSAGE, messaggio CAN............................................................................................................... 12
4 - Variabili di sistema................................................................................................................................................... 13
4.1 - Variabili sola lettura (System variables)............................................................................................................. 14
4.2 - Variabili lettura e scrittura (System variables).................................................................................................... 16
4.3 - D univoco prodotto............................................................................................................................................ 17
5 - Definizioni dati......................................................................................................................................................... 18
5.1 - Variable types definition, definizione tipo variabili.............................................................................................. 18
5.2 - Task D definition, identificatore di task PLC...................................................................................................... 18
5.3 - TermO definition, definizioni per terminale di /O............................................................................................... 19
5.4 - FSeek origin definition, definizioni per seek su file............................................................................................ 19
5.5 - Serial mode definition, definizioni modo seriale................................................................................................. 19
5.6 - CAN bit rate definition, definizioni bit rate CAN.................................................................................................. 19
5.7 - Digital input mode, definizioni modo acquisizione ingressi digitali.....................................................................20
5.8 - Digital output mode, definizioni modo gestione uscite digitali............................................................................ 20
5.9 - Analog to digital mode, definizioni modo acquisizione ingressi analogici...........................................................21
5.10 - Digital to analog mode, definizioni modo gestione uscite analogiche..............................................................21
6 - Funzioni definite da LogicLab.................................................................................................................................. 22
6.1 - Funzioni matematiche e trigonometriche........................................................................................................... 23
6.2 - Funzioni stringa................................................................................................................................................. 25
7 - Funzioni ed FB......................................................................................................................................................... 26
- Funzioni.................................................................................................................................................................. 26
- Function Blocks...................................................................................................................................................... 26
7.0.1 - Funzioni ed FB embedded......................................................................................................................... 26
7.0.2 - Librerie....................................................................................................................................................... 27
7.0.3 - mport libreria............................................................................................................................................. 27
7.0.4 - Link a libreria............................................................................................................................................. 28
7.0.5 - mportazione oggetti.................................................................................................................................. 29
7.0.6 - Considerazioni su link a libreria e su import oggetti................................................................................... 30
7.0.7 - Protezione funzioni e blocchi funzione....................................................................................................... 31
7.1 - Funzioni ed FB per gestione Flip/Flop............................................................................................................... 32
7.1.1 - F_TRG, Falling edge trigger..................................................................................................................... 32
7.1.2 - R_TRG, Raising edge trigger.................................................................................................................... 33
Mnl151c060 Pag. 1/271
7.1.3 - RS, Reset/Set flip flop................................................................................................................................. 34
7.1.4 - SR, Set/Reset flip flop................................................................................................................................. 35
7.2 - Funzioni ed FB per gestione timers.................................................................................................................... 36
7.2.1 - eTOF, Timer Off.......................................................................................................................................... 36
7.2.2 - eTON, Timer On......................................................................................................................................... 37
7.2.3 - eTP, Timer pulse......................................................................................................................................... 38
7.3 - Funzioni ed FB per gestione counters................................................................................................................ 39
7.3.1 - CTD, Counter Down................................................................................................................................... 39
7.3.2 - CTU, Counter Up........................................................................................................................................ 41
7.3.3 - CTUD, Counter Up/Down........................................................................................................................... 42
7.4 - Funzioni ed FB per conversione dati................................................................................................................... 44
7.4.1 - VBitTest, Variable bit test............................................................................................................................ 44
7.4.2 - VBitSet, Variable bit set.............................................................................................................................. 45
7.4.3 - BitToByte, Bit to byte conversion................................................................................................................ 46
7.4.4 - ByteToBit, Byte to bit conversion................................................................................................................ 48
7.4.5 - ByteToWord, Byte to word conversion........................................................................................................ 49
7.4.6 - WordToByte, Word to byte conversion........................................................................................................ 50
7.4.7 - DoubleToWord, Double to word conversion................................................................................................ 51
7.4.8 - WordToDouble, Word to double conversion................................................................................................ 52
7.4.9 - ToLower, Uppercase to lowercase letter conversion................................................................................... 53
7.4.10 - ToUpper, Lowercase to uppercase letter conversion................................................................................ 54
7.5 - Funzioni ed FB di utilit sistema......................................................................................................................... 55
7.5.1 - SysGetSysTime, get system time............................................................................................................... 55
7.5.2 - SysSetTaskLpTime, set task loop time....................................................................................................... 57
7.5.3 - SysGetRandom, get random number......................................................................................................... 58
7.5.4 - SysGetLastError, get last error................................................................................................................... 59
7.5.5 - SysPCodeAccept, accepts the protection code.......................................................................................... 60
7.5.6 - SysGetCrc, get CRC value......................................................................................................................... 61
7.5.7 - SysMAlloc, Memory allocation.................................................................................................................... 63
7.6 - Funzioni ed FB per gestione Data/Ora................................................................................................................ 64
7.6.1 - SysETimeToDate, epoch time to date conversion....................................................................................... 64
7.6.2 - SysDateToETime, date to epoch time conversion....................................................................................... 66
7.7 - Funzioni ed FB per gestione terminale di /O...................................................................................................... 68
7.7.1 - Sysfopen, file open..................................................................................................................................... 68
7.7.2 - Sysfclose, file close.................................................................................................................................... 70
7.7.3 - Sysfgetc, get character from file................................................................................................................. 71
7.7.4 - Sysfputc, put character to file...................................................................................................................... 72
7.7.5 - Sysfread, read data from file....................................................................................................................... 74
7.7.6 - Sysfwrite, write data to file.......................................................................................................................... 75
7.7.7 - SysGetChars, get input available characters from file............................................................................... 76
7.7.8 - SysGetOSpace, get output available space on file..................................................................................... 77
7.7.9 - SysGetRxBSize, get file Rx input buffer size.............................................................................................. 78
7.7.10 - SysGetTxBSize, get file Tx output buffer size........................................................................................... 79
7.7.11 - SysFBfClear, file input buffer clear........................................................................................................... 80
7.7.12 - SysFOBfClear, file output buffer clear....................................................................................................... 81
7.7.13 - SysFOBfFlush, file output buffer flush....................................................................................................... 82
7.7.14 - SysVarfprintf, variable print to file.............................................................................................................. 83
7.8 - File system.......................................................................................................................................................... 84
7.8.1 - Sysremove, file remove.............................................................................................................................. 85
Mnl151c060 Pag. 2/271
7.8.2 - Sysrename, file rename.............................................................................................................................. 86
7.8.3 - Sysfilelength, file lengh............................................................................................................................... 87
7.8.4 - Sysfseek, file seek...................................................................................................................................... 88
7.8.5 - SysDirListing, directory listing..................................................................................................................... 89
7.9 - Funzioni ed FB per gestione porta seriale.......................................................................................................... 91
7.9.1 - SysGetSerialMode, get serial mode........................................................................................................... 92
7.9.2 - SysSetSerialMode, set serial mode............................................................................................................ 94
7.9.3 - SetSMode, Set serial mode........................................................................................................................ 95
7.9.4 - SysGetSerialCTS, get serial CTS signal status.......................................................................................... 97
7.9.5 - SysSetSerialDTR, set DTR signal status.................................................................................................... 98
7.10 - Funzioni ed FB per gestione CAN bus.............................................................................................................. 99
7.10.1 - SysCANSetMode, set the CAN controller mode..................................................................................... 100
7.10.2 - SyssCANRxTxAv, checks if CAN Rx or Tx is available.......................................................................... 101
7.10.3 - SysCANRxMsg, receives a CAN message............................................................................................. 102
7.10.4 - SysCANTxMsg, transmit a CAN message.............................................................................................. 103
7.11 - Funzioni ed FB per gestione stringhe.............................................................................................................. 104
7.11.1 - eLEN, string length.................................................................................................................................. 104
7.11.2 - eFND, string find.................................................................................................................................... 105
7.11.3 - MemSet, memory set.............................................................................................................................. 106
7.11.4 - MemCopy, memory copy........................................................................................................................ 107
7.11.5 - SysVarsnprintf, variable print to string..................................................................................................... 108
7.11.6 - SysVarsscanf, extracts values from string............................................................................................... 110
7.12 - Funzioni ed FB per gestione moduli periferici.................................................................................................. 111
7.12.1 - SysPhrnfos, get infos from peripheral modules...................................................................................... 111
7.12.2 - SysGetPhrD, get peripheral digital input................................................................................................ 112
7.12.3 - SysSetPhrDO, set peripheral digital output............................................................................................. 115
7.12.4 - SysGetAnnp, get analog input............................................................................................................... 118
7.12.5 - SysSetAnOut, set analog output............................................................................................................. 120
7.12.6 - SysGetCounter, get counter.................................................................................................................... 122
7.12.7 - SysGetEncoder, get encoder input......................................................................................................... 124
7.12.8 - SysPhrVRd, read variable from peripheral module................................................................................. 126
7.12.9 - SysPhrVWr, write variable to peripheral module..................................................................................... 127
7.12.10 - CPUModuleO, CPU module /O management..................................................................................... 128
7.12.11 - Sys2CWrRd, writes/reads on 2C extension bus.................................................................................. 129
7.13 - Funzioni ed FB di utilit generale.................................................................................................................... 130
7.13.1 - DB100AddOffset, returns DB100 address offset..................................................................................... 130
7.13.2 - BLNK, blink command........................................................................................................................... 131
7.13.3 - BlinkValue, blink out value...................................................................................................................... 132
7.13.4 - ModbusRTUMaster_v1, modbus Rtu master.......................................................................................... 133
7.13.5 - ModbusSlave, modbus slave.................................................................................................................. 135
7.13.6 - ONOFFCYCLE, on/off cycle with random times..................................................................................... 138
7.13.7 - PDMng, PD management..................................................................................................................... 140
7.13.8 - PWMOut, PWM output management...................................................................................................... 142
7.13.9 - SysDMXMng, DMX management........................................................................................................... 143
7.13.10 - OEncoder, incremental encoder over /O............................................................................................. 145
7.13.11 - GetSO1155Crc, calculate CRC according SO1155............................................................................. 146
7.13.12 - ODataExchange, exchange data by using logic /O............................................................................. 147
7.13.13 - Average, value average........................................................................................................................ 149
7.13.14 - HDClkDtaReader, HD RFD clock/data reader................................................................................... 150
Mnl151c060 Pag. 3/271
7.13.15 - Linearize, linearize a non linear value................................................................................................... 152
7.13.16 - ValueScale, scales a value................................................................................................................... 153
7.14 - Protocollo DLMS, o EC 62056-21.................................................................................................................. 154
7.14.1 - EC62056_21Rd, EC62056-21 protocol read........................................................................................ 155
7.15 - Funzioni ed FB gestione modem (eModemLib).............................................................................................. 157
7.15.1 - ModemCore_v2, modem core management........................................................................................... 158
7.15.2 - ModemSMSReceive, receive a SMS message...................................................................................... 160
7.15.3 - ModemSMSRxCmd_v1, receive a SMS command................................................................................ 161
7.15.4 - ModemSMSSend_v1, send a SMS message......................................................................................... 162
7.15.5 - ModemPhoneCall_v1, executes a phone call......................................................................................... 165
7.15.6 - ModemHTTPGet, executes a HTTP Get request.................................................................................... 166
7.16 - Funzioni ed FB gestione One-Wire (ePLC1WireLib)....................................................................................... 169
7.16.1 - sOWireMng, One-Wire management...................................................................................................... 170
7.16.2 - sOWRddentifier, One-Wire read ROM identifier.................................................................................... 171
7.16.3 - sOWRdTemperature, One-Wire read temperature................................................................................. 173
7.16.4 - sOWRdHumidity, One-Wire read humidity.............................................................................................. 175
7.17 - Funzioni ed FB gestione networking............................................................................................................... 177
7.17.1 - SysPReach, P address is reachable..................................................................................................... 178
7.17.2 - SysSktListen, Socket listen..................................................................................................................... 179
7.17.3 - SysUDPSktRcv, UDP socket receive...................................................................................................... 181
7.17.4 - SysUDPSktSend, UDP socket send....................................................................................................... 182
7.17.5 - UDPDataTxfer, UDP data transfer.......................................................................................................... 184
7.18 - Funzioni ed FB supporto prodotti Hw Group (eHwGSpLib)............................................................................ 186
7.18.1 - STESnmpAcq, STE termometer acquisition over SNMP........................................................................187
7.18.2 - sHWgSProtocol, HW group serial protocol............................................................................................. 189
7.19 - Funzioni ed FB supporto protocollo NMEA (eNMEALib)................................................................................. 191
7.19.1 - NMEASnterface, NMEA system interface.............................................................................................. 192
7.19.2 - GLLSentence, Geographic Position sentence........................................................................................ 193
7.19.3 - MWVSentence, Wind Speed and Angle sentence.................................................................................. 195
7.20 - Funzioni ed FB supporto inverter Power One (ePowerOneLib)......................................................................196
7.20.1 - AuroraDSPMeasure, Aurora measure request to DSP........................................................................... 197
7.20.2 - AuroraCEnergy, Aurora cumulated energy reading................................................................................. 200
7.20.3 - CRCPolinomial, CRC polinomial calculation........................................................................................... 202
7.21 - Funzioni ed FB supporto log (eLogLib)........................................................................................................... 203
- Gestione invio notifiche a server Syslog................................................................................................................ 203
7.21.1 - SysLogReport, send a report to Syslog server....................................................................................... 205
7.21.2 - StringToLogFile, salva una stringa in un file di log.................................................................................. 207
7.21.3 - FileMemoryDump, dump memoria su file............................................................................................... 209
7.21.4 - SpyDataFile, spia i dati e li memorizza su file......................................................................................... 211
7.22 - Funzioni ed FB comunicazione multimaster (eMMasterDTxferLib).................................................................213
7.22.1 - MMasterDataTxfer, multimaster data transfer......................................................................................... 214
7.22.2 - DataTxferClient, Data transfer client....................................................................................................... 215
8 - Funzioni ed FB obsolete......................................................................................................................................... 217
8.1.1 - MDBRTUMASTER, modbus Rtu master.................................................................................................. 218
8.1.2 - ModbusRTUMaster, modbus Rtu master.................................................................................................. 220
8.1.3 - sModbusRTUMaster, modbus Rtu master................................................................................................ 222
8.1.4 - ModbusRTUSlave, modbus Rtu slave...................................................................................................... 224
8.1.5 - ModbusAsciiSlave, modbus Ascii slave.................................................................................................... 227
8.1.6 - ModemCore, modem core management.................................................................................................. 229
Mnl151c060 Pag. 4/271
8.1.7 - ModemCore_v1, modem core management............................................................................................. 231
8.1.8 - ModemSMSRxCmd, receive a SMS command........................................................................................ 233
8.1.9 - ModemSMSSend, send a SMS message................................................................................................. 234
8.1.10 - ModemPhoneCall, executes a phone call............................................................................................... 235
9 - Protocolli di comunicazione.................................................................................................................................... 236
9.1 - Protocollo modbus............................................................................................................................................ 236
9.1.1 - Accesso variabili da modbus..................................................................................................................... 236
9.1.2 - Lettura variabili da modbus....................................................................................................................... 236
9.1.3 - Scrittura variabili da modbus..................................................................................................................... 237
9.1.4 - Accesso Real time clock da modbus........................................................................................................ 238
9.1.5 - Lettura RTC da modbus............................................................................................................................ 238
9.1.6 - Scrittura RTC da modbus......................................................................................................................... 239
9.1.7 - Accesso Epoch time da modbus............................................................................................................... 240
9.1.8 - Lettura Epoch time da modbus................................................................................................................. 240
9.1.9 - Scrittura Epoch time da modbus............................................................................................................... 240
10 - Creazione pagine web utente............................................................................................................................... 241
10.1 - Criteri per realizzazione pagina...................................................................................................................... 242
10.2 - Pagine dinamiche........................................................................................................................................... 243
10.3 - Formato TAGs................................................................................................................................................. 244
10.3.1 - Campo Format........................................................................................................................................ 244
10.3.2 - Campo Type........................................................................................................................................... 245
10.3.3 - Campo Address...................................................................................................................................... 245
10.3.4 - Esempi di TAGs...................................................................................................................................... 245
10.4 - Formato ARGs................................................................................................................................................ 246
10.4.1 - ARG name.............................................................................................................................................. 246
10.4.2 - ARG id.................................................................................................................................................... 246
10.5 - Alcuni esempi.................................................................................................................................................. 247
10.6 - LogicO, gestione /O logici............................................................................................................................. 248
10.7 - COMPort, parametri comunicazione seriale................................................................................................... 249
10.7.1 - Funzioni javascript.................................................................................................................................. 250
11 - Tips and tricks....................................................................................................................................................... 251
11.1 - Swap variabile DWORD.................................................................................................................................. 251
11.2 - Swap variabile WORD.................................................................................................................................... 251
11.3 - Swap variabile BYTE...................................................................................................................................... 252
11.4 - Espandere DWORD in 32 BOOL.................................................................................................................... 253
11.5 - Comprimere 32 BOOL in DWORD.................................................................................................................. 254
11.6 - Definire caratteri ascii non stampabili.............................................................................................................. 255
11.7 - Rx/Tx dati su stream....................................................................................................................................... 256
11.8 - Conversione tipo dati...................................................................................................................................... 257
11.9 - User nformations and Settings....................................................................................................................... 259
12 - Esempi di programmazione.................................................................................................................................. 260
12.1 - Biblioteca esempi............................................................................................................................................ 260
12.2 - Definizioni /O logici negli esempi................................................................................................................... 261
12.3 - Esempi forniti con LogicLab............................................................................................................................ 262
12.3.1 - Elenco programmi di esempio................................................................................................................ 263
13 - Appendici.............................................................................................................................................................. 264
13.1 - Tabella istruzioni L......................................................................................................................................... 264
13.2 - Operatori linguaggio ST.................................................................................................................................. 265
13.3 - Statements linguaggio ST............................................................................................................................... 266
13.4 - Errori di esecuzione........................................................................................................................................ 267
Mnl151c060 Pag. 5/271
13.5 - Tabella codici Ascii.......................................................................................................................................... 270
13.5.1 - Tabella codici ASC standard................................................................................................................. 270
13.5.2 - Tabella codici ASC estesi...................................................................................................................... 271
Mnl151c060 Pag. 6/271
1 LogicLab
LogicLab un compilatore PLC EC61131-3 che supporta tutti i 5 linguaggi dello standard, la facilit e l'immediatezza
d'uso degli editor grafici e testuali, le funzioni di drag & drop estese a tutti i contesti del framework, le diverse utility
integrate ed i debugger grafici e testuali rendono LogicLab un ambiente di sviluppo efficiente e particolarmente
gradevole da utilizzare.
l compilatore di LogicLab genera direttamente il codice macchina per il processore del sistema target, garantendo una
alta efficienza prestazionale.l tool stato sviluppato da Axel, una azienda italiana con pluriennale esperienza nella
produzione di software per automazione industriale, e personalizzato per l'utilizzo con i nostri dispositivi.
Mnl151c060 Pag. 7/271
2 Risorse del sistema
Gli /O logici sono automaticamente gestiti in immagine di processo dal sistema operativo che provvede a trasferire lo
stato di tutti gli ingressi logici nella immagine degli ingressi in memoria di sistema ed a trasferire il valore presente nella
immagine delle uscite dalla memoria di sistema alle uscite logiche.
Quindi testando lo stato della immagine di memoria degli ingressi logici si testa lo stato del relativo punto di ingresso
(Esempio I5$.$ corrisponde all'ingresso 0 del modulo 0, I51. corrisponde all'ingresso 5 del modulo 1).
Scrivendo lo stato nella immagine di memoria delle uscite logiche si setta lo stato del relativo punto di uscita (Esempio
65$.$ corrisponde all'uscita 0 del modulo 0, 651. corrisponde all'uscita 5 del modulo 1).
Gli I,' logici possono anche essere gestiti tramite le funzioni S7sGetP*r8I e S7sGetP*r8'.
Gli I,' analogici sono gestiti tramite le funzioni S7sGet%nIn+ e S7sSet%n'9t
contatori sono acquisiti dal blocco funzione S7sGetCo9nter.
Gli ingressi encoder sono acquisiti dal blocco funzione S7sGetEncoder.
l C%: ;9s viene gestito dalle funzioni S7sC%:<=&sg e S7sC%:T=&sg.
Per accedere alle +orte seriali occorre utilizzare la funzione S7s>o+en definendo il nome della porta da utilizzare.
Esistono moduli di estensione che sono provvisti di porte seriali. L'accesso a queste porte esattamente uguale a
quello delle porte presenti sul modulo CPU: occorre utilizzare la funzione S7s>o+en definendo il nome della porta da
utilizzare. Si utilizza la definizione PC'&=.7 dove con = si indica l'indirizzo del modulo e con 7 il numero di porta
presente sul modulo. (Esempio PC'&$.$ definisce la porta 0 presente sul modulo 0, PC'&1.1 definisce la porta 2
presente sul modulo 1.
COM0 Porta seriale RS232 (Su modulo CPU)
PCOMx.y Porta seriale 7 sul modulo di estensione =. (PC'&$.1 definisce porta 2 sul modulo 0).
Mnl151c060 Pag. 8/271
2.1 Architettura memoria
La memoria del sistema cos suddivisa:
DB Dimensione Descrizione
X0 32 Bytes ngressi logici modulo 00 (R)
X255 32 Bytes ngressi logici modulo CPU (R)
QX0 32 Bytes Uscite logiche modulo 00 (R/W)
QX255 32 Bytes Uscite logiche modulo CPU (R/W)
MX0 512 Bytes Variabili di sistema sola lettura (R)
MX1 512 Bytes Variabili di sistema lettura/scrittura (R/W)
MX100 4096 Bytes Memoria utente (R/W). Da indirizzo 2048 a 4095 i dati sono ritentivi.
Mnl151c060 Pag. 9/271
2.2 Memoria di bacu! "Retain#
SlimLine dispone di 2048 bytes di memoria ritentiva nell'area memoria utente &51$$ ed ulteriori 2000 bytes di memoria
ritentiva a disposizione utente per allocare variabili mnemoniche.
Le variabili allocate nella memoria utente &51$$ da indirizzo 2048 ad indirizzo 4095 sono ritentive, mantengono il loro
valore anche allo spegnimento del sistema.
Qualsiasi variabile mnemonica a cui viene attribuito l'attributo <ET%I:, manterr il suo valore anche allo spegnimento
del sistema. Da quanto detto precedentemente l'area totale allocabile per le variabili <ET%I: di 2000 bytes.
Come si vede dalla foto la variabile Var1 dichiarata con l'attributo <ET%I: e manterr il suo valore anche allo
spegnimento del sistema. La variabile Var allocata nella memoria utente &81$$.1$02 pur essendo ritentiva non
necessita dell'attributo <ET%I: in quanto implicito dalla sua allocazione.
Nella finestra di navigazione progetto, tutte le variabili globali sono suddivise in base
alla loro definizione, e come si nota nella cartella delle variabili ritentive figureranno
solo le variabili mnemoniche Var1 e non le variabili allocate nella memoria utente
Var pur essendo anch'essa di tipo ritentivo.
Mnl151c060 Pag. 10/271
2.$ Accesso alla memoria
I5) Immagine di +rocesso ingressi logici
SlimLine esegue la lettura degli ingressi logici all'inizio di ogni loop di esecuzione programma. E' possibile accedere a
quest'area utilizzando variabili di tipo B''L, ogni indirizzo rappresenta lo stato booleano del relativo ingresso logico.
L'indirizzo I5$.$, rappresenta lo stato dell'ingresso 0 del modulo 0, l'indirizzo I5.11, rappresenta lo stato dell'ingresso
12 del modulo 5.
65) Immagine di +rocesso 9scite logic*e
SlimLine esegue la scrittura delle uscite logiche alla fine di ogni loop di esecuzione programma. E' possibile accedere a
quest'area utilizzando variabili di tipo B''L, ogni indirizzo rappresenta lo stato booleano della relativa uscita logica.
L'indirizzo 65$.$, rappresenta lo stato dell'uscita 0 del modulo 0,l'indirizzo 65.11, rappresenta lo stato dell'uscita 12
del modulo 5.
&5) %rea di memoria
A queste aree possibile accedere utilizzando tutti i tipi di variabili definiti. Siccome tutte le variabili utilizzano la stessa
area di memoria, occorre prestare attenzione alla dimensione in bytes del tipo definito per evitare sovrapposizioni di
indirizzo.
Ad esempio una variabile 8?'<8 allocata ad indirizzo &51$$.1$ utilizzer anche lo spazio di memoria &51$$.11,
&51$$.11 ed &51$$.13. Quindi allocando una variabile B(TE all'indirizzo &51$$.11 si andrebbe ad occupare uno
spazio di memoria gi utilizzato dalla variabile precedente.
E' comunque possibile allocare variabili sovrapponendone l'indirizzo, esempio allocare due variabili B(TE sugli stessi
indirizzi di una variabile ?'<8 per andarne a considerare la parte MSB od LSB. Oppure allocare due variabili ?'<8
sugli stessi indirizzi di una variabile 8?'<8 per andarne a considerare la parte MSW od LSW. Riporto una semplice
tabella esplicativa.
%ttenzione@ SlimLine A ;asato s9 arc*itett9ra %<& e B9esto ti+o di arc*itett9ra ass9me c*e)
Le variabili a 16 bits, ?'<8, I:T, CI:T siano allocate in memoria ad indirizzi diDisi;ili +er 1. Quindi una variabile a 16
bits potr assere allocata ad esempio ad indirizzo MW100.32 ma non ad indirizzo MW100.33.
Le variabili a 32 bits 8?'<8, 8I:T, C8I:T, <E%L siano allocate ad indirizzi diDisi;ili +er 0. Quindi una variabile a 32
bits potr assere allocata ad esempio ad indirizzo MD100.32 ma non ad indirizzo MD100.33, MD100.34, MD100.35.
Mnl151c060 Pag. 11/271
MB1%%.% M&1%%.% MD1%%.%
Byte address
Byte area identifier
Byte address
&ord area identifier
Byte address
Double word area identifier
MB100.0
MB100.0
LSB
MB100.0
LSB
MB100.1
MSB
MB100.1 MB100.2 MB100.3
MSB
MB1%%.%
M&1%%.%
MD1%%.%
$ De'inizione ti!o dati
Oltre ai dati standard definiti dalla normativa EC61131 sono stati definiti altri tipi di dato che possono essere utilizzati
nel programma PLC.
$.1 (ILE)* 'ile !ointer
Questo tipo di dati utilizzato dalle funzioni che eseguono accesso alle risorse di /O del sistema, una variabile di tipo
4ILEP punta ad una risorsa utilizzata per effettuare la lettura e/o scrittura di dati. Un esempio di file pointer il
puntatore ad una porta seriale od un file su disco.
$.2 +,++ERIALM-DE* modo comunicazione !orta seriale
Questo tipo di dati utilizzato dalle funzioni che eseguono lettura ed impostazione modo di comunicazione su porta
seriale. l tipo dati contiene tutte le informazioni per caratterizzare la comunicazione sulla porta seriale.
Name ./!e Descri!tion
Baudrate UDNT Valore di baud rate porta seriale (da 300 a 115200 baud)
Parity STRNG[1] Tipo di parit, valori possibili "E pari, "O dispari, "N nessuna.
DataBits USNT Numero di bit frame dato, valori possibili 7, 8.
StopBits USNT Numero di bit di stop, valori possibili 1, 2.
DTRManagement USNT Modo di gestione del segnale DTR sulla porta seriale, vedi Serial mode definition.
DTRComplement BOOL FALSE: DTR normale, TRUE: DTR complementato.
EchoFlush BOOL FALSE: dati trasmessi sono ritornati in ricezione. TRUE: dati trasmessi sono ignorati, su comunicazioni in
RS485.
DTROnTime UNT Tempo di attesa trasmissione caratteri su porta seriale dopo attivazione segnale DTR (mS). Questo
parametro assume significato solo se 8T<&anagement impostato nel modo 8T<E%CT'E?ETI&ES,
vedi Serial mode definition.
DTROffTime UNT Tempo di attesa dopo trasmissione ultimo dato e disattivazione segnale DTR (mS). Questo parametro
assume significato solo se 8T<&anagement impostato nel modo 8T<E%CT'E?ETI&ES, vedi Serial
mode definition.
$.$ +,+CANME++A0E* messaggio CAN
Questo tipo di dati utilizzato dalle funzioni che gestiscono il controller CAN. La struttura definisce il formato di un
messaggio CAN.
RmReq BOOL FALSE:Data frame, TRUE:Remote request.
Length USNT Lunghezza record dati da 0 a 8 bytes.
MsgD UDNT Message D, 11 o 29 bit di identificativo messaggio. l bit 31 il bit di FF.
Data ARRAY[0..7] OF USNT Array dati messaggio
Mnl151c060 Pag. 12/271
1 2ariabili di sistema
Con l'ambiente di sviluppo LogicLab vengono pubblicate variabili di sistema che possono essere referenziate nel
programma per accedere ad informazioni sul sistema. Le variabili sono visualizzate da LogicLab nella finestra delle
librerie.
Se la finestra non visualizzata, occorre abilitarne la visualizzazione dalla voce di men ?ie- Tool -indo-s
Li;rar7. Attivando il Tab Target Daria;les verr visualizzato un elenco con tutte le variabili pubblicate suddivise in
cartelle. Un doppio click del mouse sulla cartella S7stem Daria;les si aprir la cartella visualizzando tutte le variabili
pubblicate (Vedi foto a destra).
Agendo con il tasto destro del mouse su
ogni singola variabile possibile
visualizzarne la finestra delle propriet in
cui indicato il tipo e l'indirizzo di
allocazione, cosi come nella figura a lato.
Mnl151c060 Pag. 13/271
1.1 2ariabili sola lettura "+/stem 3ariables#
Queste variabili di sola lettura presenti nella cartella S7stem Daria;les, ritornano informazioni sul sistema. l
programma utente pu utilizzare le variabili a piacere ma non pu modificarne il valore.
SysClock100 BOOL Clock lampeggiante con duty cycle di 100 mS.
SysClock1000 BOOL Clock lampeggiante con duty cycle di 1 S.
SysBackupEnd BOOL Attiva per un loop di programma al termine di un ciclo di backup dati.
SysRestoreFault BOOL Si attiva alla accensione se i dati di backup sono in errore. Tutti i dati sono azzerati.
SysPLCnRun BOOL Sempre attiva.
SysFirstLoop BOOL Attiva per un loop alla prima esecuzione di ogni task PLC.
SysLLabCn BOOL Attiva se l'ambiente di sviluppo LogicLab connesso al sistema.
SyssDST BOOL Attiva se si nel periodo di Daylight Saving Time
SysDTSet BOOL Attiva per un loop esecuzione task background su modifica real time clock da sistema operativo.
SysUVSet BOOL Attiva per un loop esecuzione task background su modifica impostazioni utente da sistema
operativo, vedi esempio.
SysAlwaysOff BOOL Variabile mai attiva
SysAlwaysOn BOOL Variabile sempre attiva
SysFFBUspt BOOL l programma esegue almeno una funzione o blocco funzione non supportato
SysFFBPrt BOOL l programma esegue almeno una funzione o blocco funzione protetto
SysActTaskD USNT Numero di identificazione della task in corso, vedi tipi definiti.
SysErActTaskD USNT Numero di identificazione della task in cui l'errore si verificato, vedi tipi definiti.
SysModulesReady UNT Ogni bit della variabile se attivo indica la presenza del modulo connesso al bus SlimLine.
SysApllVMajor UNT Valore Major della versione dell'applicazione.
SysApllVMinor UNT Valore Minor della versione dell'applicazione.
SysTBackLpTm UDNT Tempo di loop attuale della task di background PLC (uS).
SysTBackLpTmMin UDNT Tempo di loop minimo della task di background PLC (uS). E' possibile inizializzarne il valore
settando il bit SysTimenit.
SysTBackLpTmMax UDNT Tempo di loop massimo della task di background PLC (uS). E' possibile inizializzarne il valore
SysTBootExTm UDNT Tempo di esecuzione attuale della task di boot PLC (uS).
SysTBootExTmMin UDNT Tempo di esecuzione minimo della task di boot PLC (uS). E' possibile inizializzarne il valore
SysTBootExTmMax UDNT Tempo di esecuzione massimo della task di boot PLC (uS). E' possibile inizializzarne il valore
SysTFastExTm UDNT Tempo di esecuzione attuale della task fast PLC (uS).
SysTFastExTmMin UDNT Tempo di esecuzione minimo della task fast PLC (uS). E' possibile inizializzarne il valore settando
il bit SysTimenit.
SysTFastExTmMax UDNT Tempo di esecuzione massimo della task fast PLC (uS). E' possibile inizializzarne il valore
SysTSlowExTm UDNT Tempo di esecuzione attuale della task slow (uS).
SysTSlowExTmMin UDNT Tempo di esecuzione minimo della task slow (uS). E' possibile inizializzarne il valore settando il
bit SysTimenit.
SysTSlowExTmMax UDNT Tempo di esecuzione massimo della task slow (uS). E' possibile inizializzarne il valore settando il
bit SysTimenit.
SysTBackExTm UDNT Tempo di esecuzione attuale della task background (uS).
SysTBackExTmMin UDNT Tempo di esecuzione minimo della task background (uS). E' possibile inizializzarne il valore
SysTBackExTmMax UDNT Tempo di esecuzione massimo della task background (uS). E' possibile inizializzarne il valore
SysStartTime UDNT Data ed ora di start esecuzione programma PLC (Epoch time).
SysTime UDNT Tempo di sistema si incrementa ad ogni 1 mS raggiunto il valore massimo si reinizializza.
Mnl151c060 Pag. 14/271
SysTFastLpTm UDNT Tempo di loop della task fast PLC. l tempo impostabile tramite la funzione SysSetTaskLpTime.
SysTSlowLpTm UDNT Tempo di loop della task slow PLC. l tempo impostabile tramite la funzione SysSetTaskLpTime.
SysApplD UDNT D applicazione, un numero univoco che identifica il programma utente attualmente in
esecuzione sul sistema.
SysMfcCode UDNT Codice manufacturer, questo codice v richiesto con il prodotto. Se non definito ritornato il
codice $.
SysCustomerCode UDNT Codice customer, questo codice pu essere impostato dall'utente che ha accesso come
amministratore al sistema. Se non definito ritornato il codice $.
SysErCode UDNT Numero dell'errore di esecuzione programma.
SysErTime UDNT Data ed ora in cui l'errore avvenuto (Epoch time).
SysSerialNr UDNT Numero di matricola del prodotto.
SysApllBTime UDNT Build time (Epoch time ) della dell'applicazione.
SysUniqueD UDNT D univoco prodotto, vedi note.
SysCode STRNG[10] Codice del prodotto.
SysFVersion STRNG[10] Versione firmware del prodotto.
SysErnfos STRNG[32] nformazioni aggiuntive sull'errore.
SysApllName STRNG[10] Nome dell'applicazione.
SysUSetA STRNG[16] Valore impostato da utente in variabile Set(A), vedi esempio.
SysUSetB STRNG[16] Valore impostato da utente in variabile Set(B), vedi esempio.
SysUSetC STRNG[16] Valore impostato da utente in variabile Set(C), vedi esempio.
SysUSetD STRNG[16] Valore impostato da utente in variabile Set(D), vedi esempio.
Mnl151c060 Pag. 15/271
1.2 2ariabili lettura e scrittura "+/stem 3ariables#
Queste variabili lettura e scrittura presenti nella cartella S7stem Daria;les, permettono di leggere e scrivere da
programma utente informazioni sul funzionamento del sistema. l programma utente pu utilizzare le variabili a piacere
ed anche modificarne il valore.
SysTimenit BOOL Attivata da programma utente o da debug permette di inizializzare il calcolo dei tempi di loop e di
esecuzione delle task PLC. La variabile viene automaticamente resettata dal sistema.
SysDateTime UDNT Data ed ora di sistema (Epoch time). Modificando il valore verr automaticamente aggiornato
anche il real time clock.
SysLastError UDNT Last error, ritorna il valore dell'ultimo errore verificatosi nella esecuzione di una funzione o di un
blocco funzione, elenco errori.
SysUnfoA STRNG[16] Valore ritornato ad utente in variabile nfo(A), vedi esempio.
SysUnfoB STRNG[16] Valore ritornato ad utente in variabile nfo(B), vedi esempio.
SysUnfoC STRNG[16] Valore ritornato ad utente in variabile nfo(C), vedi esempio.
SysUnfoD STRNG[16] Valore ritornato ad utente in variabile nfo(D), vedi esempio.
Mnl151c060 Pag. 16/271
1.$ ID uni3oco !rodotto
Ogni prodotto ha un D univoco che ritornato nella variabile CniB9eI8, il valore ottenuto in base al tipo di prodotto ed
al suo numero di matricola. La formula per il calcolo dell'UniqueD la seguente:
CniB9eI8F!131$31GPT7+e#HSerial n9m;er
Ad esempio un MPS050A030 con matricola 125 avr UniqueD=1310845. Ecco la tabella Pt7+e.
PT7+e Code 8escri+tion
0000 MPS046A000 SlimLine (Lite version)
0001 MPS046A100 SlimLine (Rs485 version)
0002 MPS046A200 SlimLine (CAN version)
0003 MPS048A100 SlimLine ARM9 RS485 (Linux Open)
0004 MPS048A200 SlimLine ARM9 CAN (Linux Open)
0005 MPS049A100 SlimLine ARM9 RS485 (Linux PLC)
0006 MPS049A200 SlimLine ARM9 CAN (Linux PLC)
0007 MPS050A000 SlimLine Low Cost ARM7 (Vers. Lite)
0008 MPS050A010 SlimLine Low Cost ARM7 (Vers. Base)
0009 MPS050A020 SlimLine Low Cost ARM7 (Vers. Full RS485)
0010 MPS050A030 SlimLine Low Cost ARM7 (Vers. Full CAN)
0011 PCB123B000 SlimLine OEM (Lite version)
0012 PCB123B100 SlimLine OEM (Rs485 version)
0013 PCB123B200 SlimLine OEM (CAN version)
0014 MPS046B000 SlimLine (Lite version)
0015 MPS046B100 SlimLine (Rs485 version)
0016 MPS046B200 SlimLine (CAN version)
0017 PCB123D000 SlimLine OEM (Lite version)
0018 PCB123D100 SlimLine OEM (Rs485 version)
0019 PCB123D200 SlimLine OEM (CAN version)
0020 PCB131A000 SlimLine ARM7 Compact Relay CPU Board (Lite vers.)
0021 PCB131A010 SlimLine ARM7 Compact Relay CPU Board (Base vers.)
0022 PCB131A020 SlimLine ARM7 Compact Relay CPU Board (Full RS485 v.)
0023 PCB131A030 SlimLine ARM7 Compact Relay CPU Board (Full CAN v.)
0024 MPS051A000 Netlog Base Relay
0025 MPS051A001 Netlog Full Relay (Rs485 version)
0026 MPS051A011 Netlog Full Relay and Display (Rs485 version)
0027 MPS051A002 Netlog Full Relay (CAN version)
0028 MPS051A012 Netlog Full Relay and Display (CAN version)
0029 MPS051A300 Netlog Base Static
0030 MPS051A301 Netlog Full Static (Rs485 version)
0031 MPS051A311 Netlog Full Static and Display (Rs485 version)
0032 MPS051A302 Netlog Full Static (CAN version)
0033 MPS051A312 Netlog Full Static and Display (CAN version)
Mnl151c060 Pag. 17/271
4 De'inizioni dati
Oltre alle cartelle delle variabili di sistema sono presenti anche cartelle con identificatori di tipo dati che permettono di
identificare in modo unifico un dato di sistema.
4.1 2ariable t/!es de'inition* de'inizione ti!o 3ariabili
Ogni tipo di variabile definito con un valore che lo identifica, il valore indicato con definizioni che si possono trovare
nella cartella Varia;le t7+es de>inition.
De'ine ./!e 2alue Descri!tion
BOOL_TYPE USNT 10 Variabile booleana (BOOL), 1 bit pu assumere solo significato FALSE o TRUE.
BYTE_TYPE USNT 20 Variabile byte (BYTE) 8 bits senza segno, range da 0 a 255.
SNT_TYPE USNT 21 Variabile byte (SNT) 8 bits con segno, range da -128 a +127.
USNT_TYPE USNT 22 Variabile byte (USNT) 8 bits senza segno, range da 0 a 255.
WORD_TYPE USNT 30 Variabile word (WORD) 16 bits senza segno, range da 0 a 65535.
NT_TYPE USNT 31 Variabile word (NT) 16 bits con segno, range da -32768 a 32767.
UNT_TYPE USNT 32 Variabile word (UNT) 16 bits senza segno, range da 0 a 65535.
DWORD_TYPE USNT 40 Variabile double word (DWORD) 32 bits senza segno, range da 0 a 4294967295.
DNT_TYPE USNT 41 Variabile double word (DNT) 32 bits con segno, range da -2147483648 a 2147483647.
UDNT_TYPE USNT 42 Variabile double word (UDNT) 32 bits senza segno, range da 0 a 4294967295.
REAL_TYPE USNT 43 Variabile floating (REAL) 32 bits con segno, range da -3.40E+38 a +3.40E+38.
STRNG_TYPE USNT 50 Variabile stringa (STRNG).
4.2 .as ID de'inition* identi'icatore di tas )LC
Le task PLC sono identificate da un un valore, il valore indicato con definizioni che si possono trovare nella cartella
TasI I8 de>inition.
D_TASK_BOOT USNT 0 dentifica la task di boot PLC. Questa task viene eseguita solo al primo loop di esecuzione
programma utente.
D_TASK_BACK USNT 1 dentifica la task di background. Questa task eseguita in background alle task slow e fast. l tempo
di loop di questa task non fisso ma dipende dal carico di lavoro della CPU nella esecuzione delle
altre tasks.
D_TASK_SLOW USNT 2 dentifica la task slow. Questa task eseguita con un tempo di loop fisso definito con la funzione
SysSetTaskLpTime. Di default il tempo fissato a 10 mS.
D_TASK_FAST USNT 3 dentifica la task fast. Questa task eseguita con un tempo di loop fisso definito con la funzione
SysSetTaskLpTime. Di default il tempo fissato a 1 mS.
Mnl151c060 Pag. 18/271
4.$ .ermI- de'inition* de'inizioni !er terminale di I5-
Nella gestione dei terminali di /O sono utilizzate delle definizioni che si possono trovare nella cartella TermI'
de>inition.
NULL FLEP 0 dentifica un puntatore vuoto. Utilizzato come ritorno da alcune funzioni in caso di errore.
EOF NT -1 dentifica il fine file. Utilizzato come valore di ritorno da alcune funzioni in caso di fine file raggiunto.
4.1 (+ee origin de'inition* de'inizioni !er see su 'ile
Nella gestione della ricerca su file sono utilizzate delle definizioni che si possono trovare nella cartella 4SeeI origin
de>inition.
D_SEEK_SET USNT 0 nizio del file
D_SEEK_CUR USNT 1 Posizione corrente file
D_SEEK_END USNT 2 Fine del file
4.4 +erial mode de'inition* de'inizioni modo seriale
Nella gestione dei terminali di /O sono utilizzate delle definizioni che si possono trovare nella cartella Serial mode
de>inition.
DTR_OFF USNT 0 Valore membro DTRManagement del dato SYSSERALMODE, indica segnale DTR sempre in
condizione di off.
DTR_ON USNT 1 Valore membro DTRManagement del dato SYSSERALMODE, indica segnale DTR sempre in
condizione di on.
DTR_AUTO_WO_TMES USNT 2 Valore membro DTRManagement del dato SYSSERALMODE, indica segnale DTR in
funzionamento automatico senza interposizione di tempi.
DTR_AUTO_W_TMES USNT 3 Valore membro DTRManagement del dato SYSSERALMODE, indica segnale DTR in
funzionamento automatico con interposizione di tempi.
4.6 CAN bit rate de'inition* de'inizioni bit rate CAN
Per la definizione dei valori di bit rate sul controller CAN sono utilizzate delle definizioni che si possono trovare nella
cartella C%: ;it rate de>inition.
CAN_50KBT USNT 0 Bit rate 50 KBit
CAN_1MBT USNT 5 Bit rate 1 MBit
Mnl151c060 Pag. 19/271
4.7 Digital in!ut mode* de'inizioni modo ac8uisizione ingressi digitali
Per la definizione del modo di acquisizione dei moduli di ingresso digitali, sono utilizzate delle definizioni che si possono
trovare nella cartella 8igital in+9t mode.
D_8_LL USNT 1 Read 0-7 input mode (Debounced)
D_8_L USNT 2 Read 8-15 input mode (Debounced)
D_8_M USNT 3 Read 16-23 input mode (Debounced)
D_8_MM USNT 4 Read 24-31 input mode (Debounced)
D_16_L USNT 5 Read 0-15 input mode (Debounced)
D_16_M USNT 6 Read 16-31 input mode (Debounced)
D_32 USNT 7 Read 0-31 input mode (Debounced)
D__8_LL USNT 11 Read 0-7 input mode (mmediate)
D__8_L USNT 12 Read 8-15 input mode (mmediate)
D__8_M USNT 13 Read 16-23 input mode (mmediate)
D__8_MM USNT 14 Read 24-31 input mode (mmediate)
D__16_L USNT 15 Read 0-15 input mode (mmediate)
D__16_M USNT 16 Read 16-31 input mode (mmediate)
D__32 USNT 17 Read 0-31 input mode (mmediate)
4.9 Digital out!ut mode* de'inizioni modo gestione uscite digitali
Per la definizione del modo di gestione dei moduli di uscita digitali, sono utilizzate delle definizioni che si possono
trovare nella cartella 8igital o9t+9t mode.
DO_8_LL USNT 1 Write 0-7 output mode
DO_8_L USNT 2 Write 8-15 output mode
DO_8_M USNT 3 Write 16-23 output mode
DO_8_MM USNT 4 Write 24-31 output mode
DO_16_L USNT 5 Write 0-15 output mode
DO_16_M USNT 6 Write 16-31 output mode
DO_32 USNT 7 Write 0-31 output mode
Mnl151c060 Pag. 20/271
4.: Analog to digital mode* de'inizioni modo ac8uisizione ingressi analogici
Per la definizione del modo di acquisizione degli ingressi analogici, sono utilizzate delle definizioni che si possono
trovare nella cartella %nalog to digital mode.
AD_DLE USNT 0 dle mode
AD_CURR_0_20_COMMON USNT 3 Current from 0 to 20 mA (Common mode)
AD_CURR_0_20_DFFER USNT 6 Current from 0 to 20 mA ( Differential mode)
AD_CURR_4_20_COMMON USNT 4 Current from 4 to 20 mA (Common mode)
AD_CURR_4_20_DFFER USNT 13 Current from 4 to 20 mA (Differential mode)
AD_N1000_DFFER USNT 12 Ni1000 sensor Celsius degree (Differential mode)
AD_N1000_DN_43760 USNT 48 Ni1000 DN_43760 standard Celsius degree
AD_PT100_AMERCAN USNT 33 Pt100 American standard Celsius degree
AD_PT100_DFFER USNT 10 Pt100 sensor Celsius degree (Differential mode)
AD_PT100_DN_43760 USNT 32 Pt100 DN_43760 standard Celsius degree
AD_PT100_EC_60751 USNT 35 Pt100 EC-60751 standard Celsius degree
AD_PT100_TS_90 USNT 34 Pt100 TS-90 standard Celsius degree
AD_PT1000_AMERCAN USNT 41 Pt1000 American standard Celsius degree
AD_PT1000_DFFER USNT 11 Pt1000 sensor Celsius degree (Differential mode)
AD_PT1000_DN_43760 USNT 40 Pt1000 DN_43760 standard Celsius degree
AD_PT1000_EC_60751 USNT 43 Pt1000 EC-60751 standard Celsius degree
AD_PT1000_TS_90 USNT 42 Pt1000 TS-90 standard Celsius degree
AD_THERMOCOUPLE_B USNT 64 Thermocouple B type Celsius degree
AD_THERMOCOUPLE_E USNT 65 Thermocouple E type Celsius degree
AD_THERMOCOUPLE_J USNT 66 Thermocouple J type Celsius degree
AD_THERMOCOUPLE_K USNT 67 Thermocouple K type Celsius degree
AD_THERMOCOUPLE_N USNT 68 Thermocouple N type Celsius degree
AD_THERMOCOUPLE_R USNT 69 Thermocouple R type Celsius degree
AD_THERMOCOUPLE_S USNT 70 Thermocouple S type Celsius degree
AD_THERMOCOUPLE_T USNT 71 Thermocouple T type Celsius degree
AD_VOLT_0_1_COMMON USNT 5 Voltage from 0 to 1 V (Common mode)
AD_VOLT_0_1_DFFER USNT 7 Voltage from 0 to 1 V ( Differential mode)
AD_VOLT_0_10_COMMON USNT 2 Voltage from 0 to 10 V (Common mode)
AD_VOLT_0_10_DFFER USNT 9 Voltage from 0 to 10 V (Differential mode)
AD_VOLT_0_125_COMMON USNT 1 Voltage from 0 to 1.25 V (Common mode)
AD_VOLT_0_125_DFFER USNT 8 Voltage from 0 to 1.25 V (Differential mode)
4.1%Digital to analog mode* de'inizioni modo gestione uscite analogiche
Per la definizione del modo di gestione delle uscite analogiche, sono utilizzate delle definizioni che si possono trovare
nella cartella 8igital to analog mode.
DA_CURR_0_20 USNT 5 Current from 0 to 20 mA
DA_CURR_4_20 USNT 6 Current from 4 to 20 mA
DA_VOLT_0_10 USNT 1 Voltage from 0 to 10 V
DA_VOLT_0_5 USNT 2 Voltage from 0 to 5 V
DA_VOLT_M10_10 USNT 3 Voltage from -10 to +10 V
DA_VOLT_M5_5 USNT 4 Voltage from -5 to +5 V
Mnl151c060 Pag. 21/271
6 (unzioni de'inite da LogicLab
LogicLab supporta in modo nativo una serie di funzioni che possono essere utilizzata dai vari programmi scritti nei
linguaggi supportati. Per utilizzare queste funzioni occorre dalla libreria nella sezione -!erator and standard blocs
attingere la funzione desiderata. Nei linguaggi testuali L ed ST anche possibile scrivere il nome della funzione
esattamente cos come definita.
Ecco alcuni esempi di utilizzo nei vari linguaggi.
De'inizione 3ariabili
Esem!io LD
Esem!io IL
LD Minuend
SUB Subtrahend
ST Result
Esem!io +.
Result:=SUB(Minuend, Subtrahend); (* Subtraction using SUBB *)
Result:MinuendSubtrahend; (* Subtraction as be!ore *)
Mnl151c060 Pag. 22/271
6.1 (unzioni matematiche e trigonometriche
LogicLab supporta tutte le funzioni matematiche richieste dalla norma CE EN 61131-3 nella Parte 3: Linguaggi di
programmazione. Riporto di seguito un elenco delle funzioni supportate ed un esempio di utilizzo in linguaggio ST.
AB+
AN,;N<M AB+"AN,;N<M#
Calcola il valore assoluto di un numero.
Result:="BS(#$%&); (* Result is #$%& *)
+=R.
AN,;REAL +=R."AN,;REAL#
Calcola la radice quadrata di un numero.
Result:=S'RT((%$); (* Result is )%$ *)
LN
AN,;REAL LN"AN,;REAL#
Calcola logaritmo naturale (Base "e" 2,71828) di un numero.
Result:=L*(#$%$); (* Result is +%)$+&( *)
L-0
AN,;REAL L-0"AN,;REAL#
Calcola logaritmo (Base "10") di un numero.
Result:=L,-(#$%$); (* Result is #%$ *)
E>)
AN,;REAL E>)"AN,;REAL#
Calcola numero elevato "e" 2,71828.
Result:=./0(#%$); (* Result is +%1#2+2 *)
+IN
AN,;REAL +IN"AN,;REAL#
Calcola il seno di un angolo in radianti.
Result:=S3*(#%&1); (* "ngle is ($4, Result is #%$ *)
C-+
AN,;REAL C-+"AN,;REAL#
Calcola il coseno di un angolo in radianti.
Result:=5,S()%#6#7); (* "ngle is #2$4, Result is #%$ *)
.AN
AN,;REAL .AN"AN,;REAL#
Calcola la tangente di un angolo in radianti.
Result:=T"*($%12&6); (* "ngle is 6&4, Result is #%$ *)
A+IN
AN,;REAL A+IN"AN,;REAL#
Calcola l'arcoseno di un angolo in radianti.
Result:="S3*(#%$); (* Result is: #%&1$2 *)
AC-+
AN,;REAL AC-+"AN,;REAL#
Calcola l'arcocoseno di un angolo in radianti.
Result:="5,S(#%$); (* Result is )%#6#&( *)
A.AN
AN,;REAL A.AN"AN,;REAL#
Calcola l'arcotangente di un angolo in radianti.
Result:="T"*(#%$); (* Result is )%#6#&( *)
ADD
AN,;N<M ADD"AN,;N<M* AN,;N<M#
Esegue somma tra due numeri.
Result:="DD(#%$, +%$); (* Result is )%$ *)
M<L
AN,;N<M M<L"AN,;N<M* AN,;N<M#
Esegue moltiplicazione tra due numeri.
Result:=MUL(#%$, +%$); (* Result is +%$ *)
+<B
AN,;N<M +<B"AN,;N<M* AN,;N<M#
Esegue sottrazione tra due numeri.
Result:=SUB(+%$, #%$); (* Result is #%$ *)
Mnl151c060 Pag. 23/271
DI2
AN,;N<M DI2"AN,;N<M* AN,;N<M#
Esegue divisione tra due numeri.
Result:=D38(+%$, #%$); (* Result is +%$ *)
Considerazione a parte v fatta per l'operatore modulo M-D. L'aritmetica modulare si applica ai soli numeri interi, nel
quale i numeri "si avvolgono su se stessi" ogni volta che raggiungono i multipli di un determinato numero n, detto
modulo.
L'operazione Result:=x MOD 10, dar come risultato valori compresi tra 0 e 10 per qualsiasi valore assuma x.
L'operazione Result:=x MOD 1000, dar come risultato valori compresi tra 0 e 1000 per qualsiasi valore assuma x.
Mnl151c060 Pag. 24/271
6.2 (unzioni stringa
LogicLab supporta tutte le funzioni di gestione stringa richieste dalla norma CE EN 61131-3 nella Parte 3: Linguaggi di
programmazione. Riporto di seguito un elenco delle funzioni supportate ed un esempio di utilizzo in linguaggio ST.
C-NCA.
+.RIN0 C-NCA."+.RIN0 +%* +.RIN0 +1#
Concatena le stringhe S0 ed S1.
"String:=9:ello 9;
BString:=9;orld <9;
5String:=5,*5"T("String, BString); (* 5String is 9:ello ;orld <9 *)
5String:=5,*5"T("String, 9;orld <9); (* 5String is 9:ello ;orld <9 *)
DELE.E
+.RIN0 DELE.E"+.RIN0 IN* AN,;IN. L* AN,;IN. )#
Cancella dalla stringa N, L caratteri partendo dalla posizione P a scendere.
"String:=9:ello ;orld <9;
BString:=D.L.T.("String, +, )); (* BString is 9:eo ;orld <9 *)
(IND
<IN. (IND"+.RIN0 +%* +.RIN0 +1#
Cerca la posizione della prima occorrenza di S1 in S0. Se non trovata torna 0.
i:==3*D("String, 9;orld9); (* Result is: 1 *)
>:==3*D(9:ello ;orld ;orld <9, 9;orld9); (* Result is 1 *)
?:==3*D(9;orld9, 9:ello9); (* Result is: $ *)
IN+ER.
+.RIN0 IN+ER."+.RIN0 +%* +.RIN0 +1* AN,;IN. )#
nserisce nella stringa S0 la stringa S1 partendo dalla posizione P.
"String:=9:ello e@erAbodA9;
BString:=9;orld <9;
5String:=3*S.RT("String, BString, 7); (* 5String is 9:ello ;orld <9*)
LE(.
+.RIN0 LE(."+.RIN0 IN* AN,;IN. L#
Ritorna gli L caratteri pi a sinistra della stringa N.
BString:=L.=T("String, 1); (* BString is 9:ello ;9
LEN
<IN. LEN"+.RIN0 IN#
Ritorna la lunghezza (Numero di caratteri) della stringa N.
i:=L.*("String); (* i is: #) *)
MID
+.RIN0 MID"+.RIN0 IN* AN,;IN. L* AN,;IN. )#
Ritorna gli L caratteri della stringa N partendo dal carattere in posizione P.
BString:=M3D("String, &, 1); (* BString is 9;orld9 *)
RE)LACE
+.RIN0 RE)LACE"+.RIN0 +%* +.RIN0 +1* AN,;IN. L* AN,;IN. )#
Rimpiazza L caratteri della stringa S0 con la stringa S1 a partire dalla posizione P.
BString:=R.0L"5.("String, 9to Aou 9, &, 1);
RI0?.
+.RIN0 RI0?."+.RIN0 IN* AN,;IN. L#
Ritorna gli L caratteri pi a destra della stringa N.
BString:=R3-:T("String, 1); (* BString is 9;orld <9 *)
Mnl151c060 Pag. 25/271
7 (unzioni ed (B
(unzioni
Le funzioni hanno numero di variabili in ingresso variabile e sempre una sola variabile in uscita. Per utilizzarle basta
inserirle nei programmi LD ed FBD e connetterle alle variabili. Nei programmi L devono essere chiamate con
l'istruzione CAL, nei programmi ST basta indicarne il nome per essere eseguite.
(unction Blocs
Le FB a differenza delle funzioni allocano nel programma una variabile che contiene tutte le variabili di input e di output
gestite dal blocco funzione. Per utilizzarle basta inserirle nei programmi LD ed FBD e connetterle alle variabili. Nei
programmi L devono essere chiamate con l'istruzione CAL, nei programmi ST basta indicarne il nome per essere
eseguite.
7.%.1 (unzioni ed (B embedded
Con l'ambiente di sviluppo LogicLab vengono fornite funzioni e blocchi funzione (FB) embedded che permettono di
accedere alle risorse hardware e software del sistema Slim line. Le funzioni e le FB embedded sono visualizzate da
LogicLab nella finestra delle librerie.
Se la finestra non visualizzata, occorre abilitarne la visualizzazione dalla voce di men 2ie- Tool -indo-s
Li;rar7. Attivando il Tab Target ;locIs verr visualizzato un elenco con tutte le funzioni (ndicate con 4) ed i blocchi
funzione (ndicati con B) embedded.
Agendo con il tasto destro del mouse su
ogni singola funzione o blocco funzione
possibile visualizzarne la finestra delle
propriet in cui sono indicate le variabili in
ingresso ed il ritorno delle funzioni,
mentre per i blocchi funzioni sono
indicate le variabili in ingresso ed in
uscita, cosi come nella figura a lato.
Mnl151c060 Pag. 26/271
7.%.2 Librerie
n aggiunta alle funzioni ed FB embedded sono fornite delle librerie che contengono una serie di funzioni e blocchi
funzioni che possono essere utilizzati nel proprio programma. Le librerie fornite con LogicLab si trovano nella directory
di installazione programma ProgrammiJElsistJIEC61131S9iteJLogicLa;1+$JLi;raries, ma possibile anche utilizzare
librerie fornite successivamente o di cui si eseguito il download dal sito. Esistono due possibilit per utilizzare le
librerie:
Im!ort libreria@ n questo modo vengono importati nel proprio programma tutti gli oggetti presenti nella libreria, gli
oggetti possono cos essere utilizzati nel programma. Questa una buona soluzione. La controindicazione quella di
aumentare la dimensione del file di progetto LogicLab (*.ppjs), in quanto deve contenere oltre al proprio programma
anche tutti gli oggetti della libreria importata. Il +rogramma eseg9i;ile generato conterrK com9nB9e solo gli oggetti
9tilizzati.
Im!ort oggetti@ n questo modo possibile importare da una libreria solo gli oggetti (Funzioni, FB, ecc) che
interessano, i quali diverranno parte integrante del proprio progetto.
7.%.$ Im!ort libreria
Con questa modalit vengono importati tutti gli oggetti presenti nella
libreria. Per importare nel proprio programma l'intera libreria dal
men selezionare la voce ProLect M Li;rar7 manager si aprir una
finestra come quella sotto riportata.
Agendo sul tasto %dd si aprir una finestra di browser del disco. Scegliere la directory dove si trova la libreria, e
selezionare i files di libreria da importare.
Agendo sul tasto Close, nella finestra Li;rar7 di
LogicLab (Ctrl-L) verranno visualizzati dei tabs
aggiuntivi, uno per ogni libreria importata.
Basta trascinare l'oggetto desiderato nel proprio
progetto per poterlo utilizzare.
Mnl151c060 Pag. 27/271
7.%.1 Lin a libreria
Eseguendo l'import delle librerie nel proprio
progetto come indicato al capitolo precedente
tutti gli oggetti della libreria importata vengono
trasferiti nel proprio file di progetto (*.ppjs), ma
viene comunque mantenuto un link alla libreria
di origine come si vede dalla finestra a lato.
Questo permette nel caso la libreria sorgente
venga modificata con una versione pi recente
di effettuare l'aggiornamento automatico della
nuova libreria nel proprio progetto.
Se la libreria sorgente non pi presente
oppure stata spostata dalla posizione da
dove stata importata, LogicLab non eseguir
pi il controllo senza segnalare errori.
Tramite il men ProLect M Li;rar7 manager
che apre la finestra a lato, come si vede,
possibile selezionare le varie librerie e con il tasto CnLinI rimuovere il link oppure con il tasto <eLinI eseguire un link
alla nuova posizione dove si trova la libreria.
Aprendo il progetto, LogicLab controlla
tutte le librerie importate e nel caso una
o pi librerie sorgenti siano pi recenti
delle versioni importate viene
visualizzato un messaggio di
avvertimento che chiede conferma se
eseguire oppure no l'aggiornamento
delle librerie.
Eseguendo l'aggiornamento tutti gli
oggetti della libreria importata presenti
nel proprio progetto vengono sovrascritti con gli oggetti presenti nella libreria sorgente ed eventuali nuovi oggetti sono
automaticamente importati.
Mnl151c060 Pag. 28/271
7.%.4 Im!ortazione oggetti
Per importare nel proprio programma oggetti dalle librerie occorre nel men
selezionare la voce ProLect M Im+ort o;Lect >rom li;rar7. Si aprir una finestra
di browser del disco. Scegliere la directory dove si trova la libreria, e selezionare
il file di libreria da cui si desidera importare gli oggetti.
Si aprir la finestra di ';Lect ;ro-ser che permetter
di visualizzare tutti gli oggetti presenti nella libreria.
Selezionando i vari tabulatori presenti possibile
visualizzare tutti gli oggetti della libreria ordinati per
nome.
Con un click del mouse si evidenzia l'oggetto o gli
oggetti desiderati. Con il tasto Im+ort o;Lect gli oggetti
selezionati verranno inclusi nel programma.
Come si nota dalla foto
a destra alcuni oggetti
appaiono visualizzati
con un simbolo di
lucchetto, questo sta
ad indicare che sono
oggetti protetti, cio
non possono essere
modificati. Una volta
importati nel proprio programma gli oggetti resteranno inclusi nel programma stesso e
sar possibile utilizzarli su qualsiasi PC anche se non si dispone della libreria
originale.
Mnl151c060 Pag. 29/271
7.%.6 Considerazioni su lin a libreria e su im!ort oggetti
Come visto nei paragrafi precedenti per utilizzare funzioni e/o blocchi funzione di libreria possibile usare due diversi
metodi, importare solo l'oggetto desiderato oppure tutta la libreria nel proprio progetto.
n entrambi i casi l'oggetto verr incluso nel proprio progetto, in questo modo si sicuri che anche nel futuro con
versioni successive di libreria sar sempre possibile ricompilare il progetto utilizzando l'oggetto con il quale si era
sviluppato e testato.
Nel caso si desideri sostituire l'oggetto con una versione pi recente dello stesso si user un diverso approccio in
funzione del fatto che l'oggetto sia presente in una libreria collegata oppure sia stato importato.
Libreria collegata
Come visto precedentemente, le librerie collegate mantengono un riferimento alla libreria di origine, nel percorso di
memorizzazione nella distribuzione di LogicLab le librerie sono incluse in directories il cui nome rappresenta la
versione. n questo modo potranno essere distribuite versioni successive di libreria, ma il progetto alla sua riapertura
far sempre il controllo con la versione originale senza eseguire l'aggiornamento automatico.
Per effettuare l'aggiornamento di un oggetto di una libreria collegata occorre eseguire un <eLinI alla nuova versione
della libreria. %ttenzione@ Questa operazione aggiorner tutti gli oggetti presenti nella libreria.
-ggetto im!ortato
Nel caso di oggetto importato, per effettuare l'aggiornamento, baster rimuovere l'oggetto attuale dal progetto ed
eseguire un import dello stesso oggetto dalla nuova versione della libreria.
Conclusioni
In generale si consiglia di non eseg9ire il collegamento della li;reria ma di incl9dere i singoli oggetti nel
+ro+rio +rogetto, questo permette una pi semplice gestione degli aggiornamenti.
Alcune librerie contengono una serie di oggetti (Funzioni e blocchi funzione) che sono di vasto impiego, in questo caso
consigliabile sempre collegare queste librerie. Ecco l'elenco delle librerie che si consiglia di collegare al progetto:
Libreria Codice Descrizione
ePLCStdLib SFR053*000 Libreria standard EC61131, contiene funzioni e blocchi funzione definiti dalla
normativa EC61131 e non presenti nella libreria embedded del prodotto.
ePLCAuxLib SFR058*000 Libreria ausiliaria, contiene funzioni e blocchi funzione di varia utilit.
Mnl151c060 Pag. 30/271
7.%.7 )rotezione 'unzioni e blocchi 'unzione
Alcune funzioni e/o blocchi funzione di libreria possono essere protetti da un codice
che deve essere ordinato separatamente. Per abilitarne l'esecuzione occorre
sbloccarle definendone il codice (Stringa alfabetica di 18 caratteri) con la funzione
S7sPCode%cce+t.
La funzione deve essere eseguita una sola volta passando il codice di protezione,
se il codice corretto la funzione ritorna T<CE e la relativa funzione sar sprotetta
fino al prossimo riavvio del programma. E' possibile eseguire pi chiamate alla
funzione una per ogni codice di protezione da definire.
l consiglio di inserire le varie chiamate alla funzione in un programma che verr
eseguito nella task di boot quindi prima di ogni chiamata ad altri programmi,
garantendo lo sblocco delle funzioni desiderate.
A lato si pu vedere come in un progetto il programma di definizione codici di
protezione PCodes sia definito nella esecuzione della task di boot. Di seguito
riportiamo il codice sorgente del programma PCodes realizzato in linguaggio ST.
Naturalmente i codici riportati sono di fantasia pertanto se eseguito la funzione
S7sPCode%cce+t ritorner sempre 4%LSE.
)rogramma +.
(* 5hec? the Brotection codes% *)
5odes,?C$D:=SAs05ode"cceBt(9abcde!ghi>?lEnoBFr9); (* 0rotection code o? (=unction #) *)
5odes,?C#D:=SAs05ode"cceBt(9rFBonEl?>ihg!edcba9); (* 0rotection code o? (=unction +) *)
5odes,?C+D:=SAs05ode"cceBt(9abcde!ghiihg!edcba9); (* 0rotection code o? (=unction )) *)
(* C.nd o! !ileD *)
Normalmente le funzioni ed i blocchi funzioni protetti possono funzionare in modo demo per un certo periodo di tempo
dalla loro prima esecuzione dopo l'accensione del sistema. Terminato il tempo di prova termina il funzionamento e viene
generato un errore che rilevabile con la funzione S7sGetLastError.
Mnl151c060 Pag. 31/271
7.1 (unzioni ed (B !er gestione (li!5(lo!
7.1.1 (;.RI0* (alling edge trigger
./!e Librar/ 2ersion
FB ePLCStdLib SFR053A000
Questo blocco funzione attiva l'uscita 6 per un loop di programma sul fronte di disattivazione dell'ingresso
di clock CLN.
CLA (BOOL) Clock, sul fronte di disattivazione del segnale, viene attivata l'uscita Q per un loop di programma.
= (BOOL) Uscita, attiva per un loop di programma sul fronte di disattivazione dell'ingresso di clock CLK.
Esem!i
Sul fronte di disattivazione dell'ingresso digitale 8i$$&$$ viene attivata per un loop di programma l'uscita digitale
8o$$&$$.
Esem!io LD (PTP115A000, F_TRIG_LD)
Esem!io IL
5"L =B=GTR3- (* 5all the =GTR3- !unction bloc? *)
LD Di$$M$$
ST =B=GTR3-%5LH (* Trans!er the digital inBut to the !unction bloc? cloc? *)
LD =B=GTR3-%'
ST Do$$M$$ (* ,n the !alling edge o! digital inBut the outBut is set *)
Esem!io +.
=B=GTR3-(); (* 5all the =GTR3- !unction bloc? *)
=B=GTR3-%5LH:=Di$$M$$; (* Trans!er the digital inBut to the !unction bloc? cloc? *)
Do$$M$$:==B=GTR3-%'; (* ,n the !alling edge o! digital inBut the outBut is set *)
Mnl151c060 Pag. 32/271
7.1.2 R;.RI0* Raising edge trigger
Questo blocco funzione attiva l'uscita 6 per un loop di programma sul fronte di attivazione dell'ingresso di
clock CLN.
CLA (BOOL) Clock, sul fronte di attivazione del segnale, viene attivata l'uscita Q per un loop di programma.
= (BOOL) Uscita, attiva per un loop di programma sul fronte di attivazione dell'ingresso di clock CLK.
Esem!i
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ viene attivata per un loop di programma l'uscita digitale
8o$$&$$.
Esem!io LD (PTP115A100, R_TRIG_LD)
Esem!io IL
5"L =BRGTR3- (* 5all the RGTR3- !unction bloc? *)
LD Di$$M$$
ST =BRGTR3-%5LH (* Trans!er the digital inBut to the !unction bloc? cloc? *)
LD =BRGTR3-%'
ST Do$$M$$ (* ,n the raising edge o! digital inBut the outBut is set *)
Esem!io +.
=BRGTR3-(); (* 5all the RGTR3- !unction bloc? *)
=BRGTR3-%5LH:=Di$$M$$; (* ,n the raising edge o! digital inBut the counter count uB *)
Do$$M$$:==BRGTR3-%'; (* ,n the raising edge o! digital inBut the outBut is set *)
Mnl151c060 Pag. 33/271
7.1.$ R+* Reset5+et 'li! 'lo!
Questo blocco funzione su attivazione del comando di set S attiva l'uscita 61 che rimane attiva anche
quando il comando viene disattivato. Per disattivare l'uscita occorre attivare il comando di reset <1.
Il comando di reset <1 A +rioritario s9l comando di set S.
+ (BOOL) Set, su attivazione del segnale, viene attivata l'uscita Q1 che rimane attiva anche quando il comando viene
disattivato.
R1 (BOOL) Reset, su attivazione del segnale, viene disattivata l'uscita Q1 prioritario sul comando di set S.
=1 (BOOL) Uscita, si attiva e disattiva in funzione dei comandi di S set e R1 reset.
Esem!i
Sulla attivazione dell'ingresso digitale 8i$$&$$ viene attivata l'uscita digitale 8o$$&$$ che rimane attiva anche quando
l'ingresso digitale 8i$$&$$ viene disattivato. Per disattivare l'uscita digitale 8o$$&$$ occorre attivare l'ingresso digitale
8i$1&$$.
NotaB L'ingresso digitale 8i$1&$$ ha la priorit sull'ingresso digitale 8i$$&$$.
Esem!io LD (PTP115A100, R_LD)
Esem!io IL
5"L =BRS (* 5all the RS- !unction bloc? *)
LD Di$$M$$
ST =BRS%S (* Trans!er the digital inBut to the set coEEand *)
LD Di$#M$$
ST =BRS%R# (* Trans!er the digital inBut to the reset coEEand *)
LD =BRS%'#
ST Do$$M$$ (* The !unction bloc? outBut is coBied to digital outBut *)
Esem!io +.
=BRS(); (* 5all the RS !unction bloc? *)
=BRS%S:=Di$$M$$; (* Trans!er the digital inBut to the set coEEand *)
=BRS%R#:=Di$#M$$; (* Trans!er the digital inBut to the reset coEEand *)
Do$$M$$:==BRS%'#; (* The !unction bloc? outBut is coBied to digital outBut *)
Mnl151c060 Pag. 34/271
7.1.1 +R* +et5Reset 'li! 'lo!
Questo blocco funzione su attivazione del comando di set S1 attiva l'uscita 61 che rimane attiva anche
quando il comando di set viene disattivato. Per disattivare l'uscita occorre attivare il comando di reset <.
Il comando di set S1 A +rioritario s9l comando di reset <.
+1 (BOOL) Set, su attivazione del segnale, viene attivata l'uscita Q1 che rimane attiva anche quando il comando viene
disattivato. l comando prioritario sul comando di reset R.
R (BOOL) Reset, su attivazione del segnale, viene disattivata l'uscita Q1.
=1 (BOOL) Uscita, si attiva e disattiva in funzione dei comandi di S set e R reset.
Esem!i
Sulla attivazione dell'ingresso digitale 8i$$&$$ viene attivata l'uscita digitale 8o$$&$$ che rimane attiva anche quando
l'ingresso digitale 8i$$&$$ viene disattivato. Per disattivare l'uscita digitale 8o$$&$$ occorre attivare l'ingresso digitale
8i$1&$$.
NotaB L'ingresso digitale 8i$$&$$ ha la priorit sull'ingresso digitale 8i$1&$$.
Esem!io LD (PTP115A100, R_LD)
Esem!io IL
5"L =BSR (* 5all the SR !unction bloc? *)
LD Di$$M$$
ST =BRS%S# (* Trans!er the digital inBut to the set coEEand *)
LD Di$#M$$
ST =BRS%R (* Trans!er the digital inBut to the reset coEEand *)
LD =BRS%'#
ST Do$$M$$ (* The !unction bloc? outBut is coBied to digital outBut *)
Esem!io +.
=BSR(); (* 5all the SR !unction bloc? *)
=BSR%S#:=Di$$M$$; (* Trans!er the digital inBut to the set coEEand *)
=BSR%R:=Di$#M$$; (* Trans!er the digital inBut to the reset coEEand *)
Do$$M$$:==BSR%'#; (* The !unction bloc? outBut is coBied to digital outBut *)
Mnl151c060 Pag. 35/271
7.2 (unzioni ed (B !er gestione timers
7.2.1 e.-(* .imer -''
Questo blocco funzione esegue la temporizzazione sulla disattivazione, attivando l'ingresso I: l'uscita 6 si
attiva immediatamente ed il tempo in uscita ET si azzera. Disattivando l'ingresso N inizia il conteggio e
dopo il tempo definito PT espresso in mS, si disattiva l'uscita 6. Sulla uscita ET viene ritornato il tempo
trascorso dalla disattivazione dell'ingresso espresso in mS.
IN (BOOL) ngresso timer, attivandolo l'uscita Q si attiva immediatamente ed il tempo in uscita ET si azzera.
Disattivandolo inizia il conteggio e dopo il tempo definito in PT, si disattiva l'uscita Q.
). (UDNT) Preset tempo, definisce il tempo di ritardo dalla disattivazione dell'ingresso N alla disattivazione dell'uscita
Q, espresso in mS.
= (BOOL) Uscita timer, si attiva su attivazione ingresso N, e si disattiva dopo il tempo definito in PT dalla
disattivazione dell'ingresso N.
E. (UDNT) Tempo timer, si azzera su attivazione ingresso N ed inizia conteggio da disattivazione ingresso N.
Raggiunto tempo impostato in PT si arresta conteggio, espresso in mS.
Esem!i
l timer presettato a 1 secondo (1000 mS). Attivando l'ingresso digitale 8i$$&$$ si attiva immediatamente l'uscita
digitale 8o$$&$$ ed il valore di tempo nella variabile Var'9t azzerato.
Disattivando l''ingresso digitale 8i$$&$$ il timer inizia il conteggio del tempo, il valore di tempo trascorso dalla
disattivazione trasferito nella variabile Var'9t. Trascorso il tempo l'uscita digitale 8o$$&$$ si disattiva.
Esem!io LD (PTP115A100, eT!F_LD)
Esem!io IL
5"L =BeT,= (* 5all the eT,= !unction bloc? *)
LD Di$$M$$
ST =BeT,=%3* (* Trans!er the digital inBut to tiEer inBut *)
LD #$$$
ST =BeT,=%0T (* Set the delaA tiEe *)
LD =BeT,=%'
ST Do$$M$$ (* ;hen tiEe is Bassed the digital outBut is set *)
LD =BeT,=%.T
ST ,ut8alue (* The counting tiEe is coBied to @ariable *)
Mnl151c060 Pag. 36/271
7.2.2 e.-N* .imer -n
Questo blocco funzione esegue la temporizzazione sulla attivazione, attivando l'ingresso I: inizia il
conteggio e dopo il tempo definito PT espresso in mS, si attiva l'uscita 6. Sulla uscita ET viene ritornato il
tempo trascorso dalla attivazione dell'ingresso espresso in mS. Disattivando l'ingresso I: l'uscita 6 si
disattiva istantaneamente ed il valore di tempo su uscita ET si azzera.
IN (BOOL) ngresso timer, attivandolo inizia il conteggio e dopo il tempo definito in PT, si attiva l'uscita Q.
Disattivandolo l'uscita Q si disattiva immediatamente ed il tempo in uscita ET si azzera.
). (UDNT) Preset tempo, definisce il tempo di ritardo dalla attivazione dell'ingresso N alla attivazione dell'uscita Q,
espresso in mS.
= (BOOL) Uscita timer, si attiva dopo il tempo definito in PT dalla attivazione dell'ingresso N e si disattiva su
disattivazione ingresso N.
E. (UDNT) Tempo timer, inizia conteggio da attivazione ingresso N, raggiunto tempo impostato in PT si arresta
conteggio. Si azzera su disattivazione ingresso N, espresso in mS.
Esem+i
Su attivazione dell'ingresso digitale 8i$$&$$ dopo 1 S (1000 mS) viene attivata l'uscita digitale 8o$$&$$. Disattivando
l'ingresso digitale 8i$$&$$ l'uscita digitale 8o$$&$$ si disattiva immediatamente.
Esem!io LD (PTP115A100, eT!"_LD)
Esem!io IL
5"L =BeT,* (* 5all the eT,* !unction bloc? *)
LD Di$$M$$
ST =BeT,*%3* (* Trans!er the digital inBut to tiEer inBut *)
LD #$$$
ST =BeT,*%0T (* Set the delaA tiEe *)
LD =BeT,*%'
LD =BeT,*%.T
Esem!io +.
=BeT,*(0T:=#$$$); (* 5all the eT,* !unction bloc? *)
=BeT,*%3*:=Di$$M$$; (* Trans!er the digital inBut to tiEer inBut *)
,ut8alue:==BeT,*%.T; (* The counting tiEe is coBied to @ariable *)
Do$$M$$:==GeT,*%'; (* ;hen tiEe is Bassed the digital outBut is set *)
Mnl151c060 Pag. 37/271
7.2.$ e.)* .imer !ulse
Questo blocco funzione esegue la temporizzazione su impulso di attivazione, attivando l'ingresso I: l'uscita
6 si attiva, in uscita ET ritornato il tempo trascorso (in mS) dall'impulso di attivazione. Raggiunto il tempo
impostato PT (in mS), indipendentemente dallo stato dell'ingresso I:, l'uscita 6 si azzera, mentre il tempo
in uscita su ET si azzera solo se ingresso I: non pi attivo.
IN (BOOL) ngresso timer, attivandolo si attiva l'uscita Q ed inizia il conteggio, dopo il tempo definito in PT
indipendentemente dallo stato dell'ingresso N, l'uscita Q si azzera.
). (UDNT) Preset tempo, definisce il tempo di attivazione dell'uscita Q, espresso in mS.
= (BOOL) Uscita timer, si attiva all'attivazione dell'ingresso N per il tempo definito in PT.
E. (UDNT) Tempo timer, inizia conteggio da attivazione ingresso N, raggiunto tempo impostato in PT si arresta
conteggio, espresso in mS.
Esem!i
l timer presettato a 5 secondi (5000 mS). Attivando l'ingresso digitale 8i$$&$$ si attiva immediatamente l'uscita
digitale 8o$$&$$ ed il valore di tempo nella variabile Var'9t inizia il conteggio. Raggiunto il tempo definito 5 secondi,
l'uscita 8o$$&$$ si azzera mentre il valore di tempo nella variabile Var'9t rimane bloccato sul valore di preset (5000
mS) sino alla disattivazione dell'ingresso 8i$$&$$.
Disattivando l'ingresso digitale 8i$$&$$ durante la temporizzazione non si hanno ripercussioni n sullo stato dell'uscita
8o$$&$$, n sul valore della variabile Var'9t.
Esem!io LD (PTP115A100, eTP_LD)
Esem!io IL
5"L =BeT0 (* 5all the eT0 !unction bloc? *)
LD Di$$M$$
ST =BeT0%3* (* Trans!er the digital inBut to tiEer inBut *)
LD &$$$
ST =BeT0%0T (* Set the delaA tiEe *)
LD =BeT0%'
LD =BeT0%.T
Esem!io +.
=BeT0(0T:=&$$$); (* 5all the eT0 !unction bloc? *)
=BeT0%3*:=Di$$M$$; (* Trans!er the digital inBut to tiEer inBut *)
,ut8alue:==BeT0%.T; (* The counting tiEe is coBied to @ariable *)
Do$$M$$:==BeT0%'; (* ;hen tiEe is Bassed the digital outBut is set *)
Mnl151c060 Pag. 38/271
7.$ (unzioni ed (B !er gestione counters
7.$.1 C.D* Counter DoCn
Questo blocco funzione esegue la gestione di un counter in decremento. Agendo sull'ingresso di load L8
possibile in qualsiasi momento trasferire il valore di preset definito su PV nel counter CV. Ad ogni fronte di
attivazione dell'ingresso C8, il valore del counter CV viene decrementato, quando il valore raggiunge 0,
l'uscita 6 viene settata ed il conteggio si arresta. Solo agendo sull'ingresso di load L8 possibile
presettare il counter e fare ripartire un nuovo conteggio.
LOingresso di load L8 A +rioritario s9llOingresso di decremento C8.
CD (BOOL) Comando decremento counter, ad ogni fronte attivazione il valore del counter CV si decrementa.
LD (BOOL) Comando di load, attivando l'ingresso il valore di preset PV, viene trasferito nel valore del counter CV.
)2 (NT) Valore di preset, attivando l'ingresso di load LD, viene trasferito nel valore del counter CV.
= (BOOL) Uscita counter, attiva se il valore del counter CV raggiunge il valore 0.
C2 (NT) Valore counter, valore di conteggio counter, quando raggiunge il valore 0, l'uscita Q si attiva ed il counter
non si decrementa pi.
Esem!i
l counter presettato a 10 ed il suo valore in uscita CV copiato nella variabile '9tVal9e. Attivando l'ingresso digitale
8i$1&$$ il counter viene presettato ed il suo valore in uscita CV posto a 10, resettando anche l'uscita Q.
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ il counter decrementato di 1, quando il valore di conteggio si
azzera, il conteggio si arresta e viene attivata l'uscita del counter Q che attiva l'uscita digitale 8o$$&$$. Per fare
ripartire il conteggio occorre attivare l'ingresso digitale 8i$1&$$ che presetta il counter.
Esem!io LD (PTP115A100, CTD_LD)
Mnl151c060 Pag. 39/271
Esem!io IL
5"L =BG5TD (* 5all the 5TD !unction bloc? *)
LD #$
ST =BG5TD%08 (* 0reset @alue *)
LD Di$$M$#
ST =BG5TD%5D (* ,n the raising edge o! digital inBut the counter count doIn *)
LD Di$#M$$
ST =BG5TD%LD (* 3! the digital inBut is set the 08 @alue is loaded *)
LD =BG5TD%'
ST Do$$M$$ (* 3! the counter @alue is $ the digital outBut is set *)
LD =BG5TD%58
ST ,ut8alue (* The counter @alue is coBied to the @ariable *)
Esem!io +.
=BG5TD(08:=#$); (* 5all the 5TD !unction bloc? and Breset counter *)
=BG5TD%5D:=Di$$M$$; (* ,n the raising edge o! digital inBut the counter count doIn *)
=BG5TD%LD:=Di$#M$$; (* 3! the digital inBut is set the 08 @alue is loaded *)
Do$$M$$:==BG5TD%'; (* 3! the counter @alue is $ the digital outBut is set *)
,ut8alue:==BG5TD%58; (* The counter @alue is coBied to the @ariable *)
Mnl151c060 Pag. 40/271
7.$.2 C.<* Counter <!
Questo blocco funzione esegue la gestione di un counter in incremento. Agendo sull'ingresso di reset <
possibile in qualsiasi momento azzerare il valore del counter CV. Ad ogni fronte di attivazione dell'ingresso
CC, il valore del counter CV viene incrementato. Quando il valore del counter CV raggiunge il valore di
preset, definito su PV, l'uscita 6 viene settata ed il conteggio si arresta. Solo agendo sull'ingresso di reset
< si potr resettare il counter e fare ripartire un nuovo conteggio.
LOingresso di reset < A +rioritario s9llOingresso di incremento CC.
C< (BOOL) Comando incremento counter, ad ogni fronte attivazione il valore del counter CV si incrementa.
R (BOOL) Comando di reset, attivando l'ingresso il valore del counter CV si resetta.
)2 (NT) Valore di preset, quando il valore del counter CV raggiunge questo valore l'uscita Q si attiva ed il counter
non si incrementa pi.
= (BOOL) Uscita counter, attiva se il valore del counter CV raggiunge il valore definito in preset PV.
C2 (NT) Valore counter, valore di conteggio counter, quando raggiunge il valore di preset PV, l'uscita Q si attiva ed il
counter non si incrementa pi.
Esem!i
l counter presettato a 10 ed il suo valore in uscita CV copiato nella variabile '9tVal9e. Attivando l'ingresso digitale
8i$1&$$ il counter viene resettato ed il suo valore in uscita CV posto a 0, resettando anche l'uscita Q.
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ il counter incrementato di 1, quando il valore di conteggio
raggiunge il valore di preset, il conteggio si arresta e viene attivata l'uscita del counter Q che attiva l'uscita digitale
8o$$&$$. Per fare ripartire il conteggio occorre attivare l'ingresso digitale 8i$1&$$ che resetta il counter.
Esem!io LD (PTP115A100, CT#_LD)
Esem!io IL
5"L =B5TU (* 5all the 5TU !unction bloc? *)
LD #$
ST =B5TU%08 (* 0reset counter *)
LD Di$$M$$
ST =BG5TU%5U (* ,n the raising edge o! digital inBut the counter count uB *)
LD Di$#M$$
ST =BG5TU%R (* 3! the digital inBut is set the counter is reset *)
LD =B5TU%'
ST Do$$M$$ (* 3! the counter @alue has reached the Breset the digital outBut is set *)
LD =BG5TU%58
Mnl151c060 Pag. 41/271
7.$.$ C.<D* Counter <!5DoCn
Questo blocco funzione esegue la gestione di un counter in incremento e decremento. Agendo
sull'ingresso di reset R possibile in qualsiasi momento azzerare il valore del counter CV. Agendo
sull'ingresso di load L8 possibile in qualsiasi momento trasferire il valore di preset definito su PV nel
counter CV.
Ad ogni fronte di attivazione dell'ingresso CC, il valore del counter CV viene incrementato. Quando il
valore del counter CV raggiunge il valore di preset, definito su PV, l'uscita 6 viene settata ed il conteggio si
arresta. Solo agendo sull'ingresso di reset < si potr resettare il counter e fare ripartire un nuovo
conteggio.
Ad ogni fronte di attivazione dell'ingresso C8, il valore del counter CV viene decrementato, quando il valore raggiunge
0, l'uscita 6 viene settata ed il conteggio si arresta. Solo agendo sull'ingresso di load L8 possibile presettare il
counter e fare ripartire un nuovo conteggio.
C< (BOOL) Comando incremento counter, ad ogni fronte attivazione il valore del counter CV si incrementa
CD (BOOL) Comando decremento counter, ad ogni fronte attivazione il valore del counter CV si decrementa.
R (BOOL) Comando di reset, attivando l'ingresso il valore del counter CV si resetta.
LD (BOOL) Comando di load, attivando l'ingresso il valore di preset PV, viene trasferito nel valore del counter CV.
)2 (NT) Valore di preset, quando il valore del counter CV raggiunge questo valore l'uscita Q si attiva ed il counter
non si incrementa pi.
=< (BOOL) Uscita counter up, attiva se il valore del counter CV raggiunge il valore definito in preset PV.
=D (BOOL) Uscita counter down, attiva se il valore del counter CV raggiunge il valore 0.
C2 (NT) Valore counter, valore di conteggio counter, quando raggiunge il valore di preset PV, l'uscita Q si attiva ed il
counter non si incrementa pi.
Esem!i
l counter presettato a 10 ed il suo valore in uscita CV copiato nella variabile Var'9t. Attivando l'ingresso digitale
8i$1&$$ il counter viene resettato ed il suo valore in uscita CV posto a 0, resettando anche l'uscita QU. Attivando
l'ingresso digitale 8i$3&$$ il counter viene presettato ed il suo valore in uscita CV posto a 10, resettando anche
l'uscita QD.
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ il counter incrementato di 1, quando il valore di conteggio
raggiunge il valore di preset, il conteggio si arresta e viene attivata l'uscita del counter QU che attiva l'uscita digitale
8o$$&$$. Per fare ripartire il conteggio occorre attivare l'ingresso digitale 8i$1&$$ che resetta il counter.
Sul fronte di attivazione dell'ingresso digitale 8i$1&$$ il counter decrementato di 1, quando il valore di conteggio si
azzera, il conteggio si arresta e viene attivata l'uscita del counter QD che attiva l'uscita digitale 8o$1&$$. Per fare
ripartire il conteggio occorre attivare l'ingresso digitale 8i$3&$$ che presetta il counter.
Mnl151c060 Pag. 42/271
Esem!io LD (PTP115A100, CT#D_LD)
Esem!io IL
5"L =BG5TUD (* 5all the 5TUD !unction bloc? *)
LD #$
ST =BG5TUD%08 (* 0reset @alue *)
LD Di$$M$$
ST =BG5TUD%5U (* ,n the raising edge o! digital inBut the counter count uB *)
LD Di$#M$$
ST =BG5TUD%5D (* ,n the raising edge o! digital inBut the counter count doIn *)
LD Di$+M$$
ST =BG5TUD%R (* 3! the digital inBut is set the counter is reset *)
LD Di$)M$$
ST =BG5TUD%LD (* 3! the digital inBut is set the 08 @alue is loaded *)
LD =BG5TUD%'U
ST Do$$M$$ (* 3! the counter @alue has reached the Breset the digital outBut is set *)
LD =BG5TUD%'D
ST Do$#M$$ (* 3! the counter @alue is $ the digital outBut is set *)
LD =BG5TUD%58
Esem!io +.
=BG5TUD(08:=#$); (* 5all the 5TD !unction bloc? and Breset counter *)
=BG5TUD%5U:=Di$$M$$; (* ,n the raising edge o! digital inBut the counter count uB *)
=BG5TUD%5D:=Di$#M$$; (* ,n the raising edge o! digital inBut the counter count doIn *)
=BG5TUD%R:=Di$+M$$; (* 3! the digital inBut is set the counter is reset *)
=BG5TUD%LD:=Di$)M$$; (* 3! the digital inBut is set the 08 @alue is loaded *)
Do$$M$$:==BG5TUD%'U; (* 3! the counter @alue has reached the Breset the digital outBut is set *)
Do$#M$$:==BG5TUD%'D; (* 3! the counter @alue is $ the digital outBut is set *)
,ut8alue:==B5TUD%58; (* The counter @alue is coBied to the @ariable *)
Mnl151c060 Pag. 43/271
7.1 (unzioni ed (B !er con3ersione dati
7.1.1 2Bit.est* 2ariable bit test
Function ePLCAuxLib SFR058A000
Questa funzione esegue il test di un bit in una variabile.
Parametri funzione:
2ariable (UDNT) Variabile in cui testare il bit.
Bit (USNT) Numero del bit da testare (Range da 0 a 31).
La funzione ritorna:
(BOOL)
Stato bit indicato.
Esem!i
Lo stato del bit 4 della variabile VarIn+ viene trasferito sull'uscita digitale 8o$$&$$.
Esem!io LD
Esem!io IL
LD 8ar3nB (* 8ariable inBut *)
8BitTest 6 (* 8ariable bit test *)
ST Do$$M$$ (* Trans!er bit status to digital outBut *)
Esem!io +.
Do$$M$$:=8BitTest(8ar3nB, 6); (* 8ariable bit test *)
Mnl151c060 Pag. 44/271
7.1.2 2Bit+et* 2ariable bit set
Questa funzione esegue il set di un bit in una variabile.
Parametri funzione:
2alue (BOOL) Valore bit da settare.
2ariable (UDNT) Variabile in cui settare il bit.
Bit (USNT) Numero del bit da settare (Range da 0 a 31).
(UDNT)
Valore variabile dopo il set del bit.
Esem!i
Lo stato dell'ingresso digitale 8i$$&$$ trasferito nel bit 8 della variabile Var'9t.
Esem!io LD
Esem!io IL
LD Di$$M$$ (* 8ariable inBut *)
8BitSet 8ar,ut, 2 (* 8ariable bit set *)
ST 8ar,ut (* Trans!er result to @ariable *)
Esem!io +.
8ar,ut:=8BitSet(Di$$M$$, 8ar,ut, 2); (* 8ariable bit set *)
Mnl151c060 Pag. 45/271
7.1.$ Bit.oB/te* Bit to b/te con3ersion
FB ePLCUtyLib SFR054A000
Questo blocco funzione permette di convertire 8 variabili B''L in una variabile B(TE.
b% (BOOL) Bit 0 del byte di '9t.
... ...
b7 (BOOL) Bit 7 del byte di '9t.
-ut (BYTE) Risultato conversione ingressi a bit.
Esem!i
Gli 8 ingressi digitali del modulo 0 sono trasferiti nella variabile Var'9t. Attivando il solo ingresso digitale 8i$$&$$ la
variabile Var'9t assumer valore 1, attivando il solo ingresso digitale 8i$1&$$ la variabile Var'9t assumer valore 2,
e cos via fino all'ingresso 8i$3&$$ attivando il quale la variabile Var'9t assumer valore 128. Attivando pi ingressi
contemporaneamente la variabile Var'9t assumer valore pari alla somma degli ingressi attivati.
Per semplicit negli esempi L e ST non vengono riportati tutti i bit.
Esem!io LD (PTP11$A100, LD_%i&To%'&e)
Esem!io IL (PTP11$A100, IL_%i&To%'&e)
LD Di$$M$$
ST =BData%b$ (* Trans!er digital inBut to inBut bit *)
LD Di$1M$$
ST =BData%b1 (* Trans!er digital inBut to inBut bit *)
5"L =BData (* 5all the BitToBAte !unction bloc? *)
LD =BData%,ut
ST 8ar,ut (* Trans!er the result to @ariable *)
Mnl151c060 Pag. 46/271
Esem!io +. (PTP11$A100, T_%i&To%'&e)
=BData%b$:=Di$$M$$; (* Trans!er digital inBut to inBut bit *)
=BData%b1:=Di$1M$$; (* Trans!er digital inBut to inBut bit *)
=BData(); (* 5all the BitToBAte !unction bloc? *)
8ar,ut:==BData%,ut; (* Trans!er the result to @ariable *)
Mnl151c060 Pag. 47/271
7.1.1 B/te.oBit* B/te to bit con3ersion
Questo blocco funzione permette di convertire una variabile B(TE in 8 variabili B''L.
In (BYTE) Valore byte da convertire
b% (BOOL) Bit 0 di In.
... ...
b7 (BOOL) Bit 7 di In.
Esem!i
Lo stato del bit 0 della variabile VarIn+ viene trasferito sull'uscita digitale 8o$$&$$ lo stato del bit 1 della variabile
VarIn+ viene trasferito sull'uscita digitale 8o$1&$$ e cos via fino allo stato del bit 7 della variabile VarIn+ viene
trasferito sull'uscita digitale 8o$3&$$. Per semplicit negli esempi L e ST non vengono riportati tutti i bit.
Esem!io LD (PTP11$A100, LD_%'&eTo%i&)
Esem!io IL (PTP11$A100, IL_%'&eTo%i&)
LD 8ar3nB
ST =BData%3n (* Trans!er the @ariable to inBut *)
5"L =BData (* 5all the BAteToBit !unction bloc? *)
LD =BData%b$
ST Di$$M$$ (* Trans!er outBut bit to digital outBut *)
Esem!io +. (PTP11$A100, T_%'&eTo%i&)
=BData(3n:=8ar3nB); (* 5all the BAteToBit !unction bloc? *)
Do$$M$$:==BData%b$; (* Trans!er outBut bit to digital outBut *)
Do$#M$$:==BData%b#; (* Trans!er outBut bit to digital outBut *)
Mnl151c060 Pag. 48/271
7.1.4 B/te.o&ord* B/te to Cord con3ersion
Questo blocco funzione permette di convertire due variabili B(TE in una variabile ?'<8.
M+B (BYTE) MSB del valore in uscita '9t
L+B (BYTE) LSB del valore in uscita '9t
-ut (WORD) Valore in uscita
Esem!i
Le due variabili &SBB7te e LSBB7te sono uniti nella variabile Var'9t in uscita.
Esem!io LD (PTP11$A100, LD_%'&eTo(or))
Esem!io IL (PTP11$A100, IL_%'&eTo(or))
LD MSBBAte
ST =BData%MSB (* Trans!er the MSB @ariable to inBut *)
LD LSBBAte
ST =BData%LSB (* Trans!er the LSB @ariable to inBut *)
5"L =BData (* 5all the BAteTo;ord !unction bloc? *)
LD =BData%,ut
ST 8ar,ut (* Trans!er outBut to @ariable *)
Esem!io +. (PTP11$A100, T_%'&eTo(or))
=BData%MSB:=MSBBAte; (* Trans!er the MSB @ariable to inBut *)
=BData%LSB:=LSBBAte; (* Trans!er the LSB @ariable to inBut *)
=BData(); (* 5all the BAteTo;ord !unction bloc? *)
8ar,ut:==BData%,ut; (* Trans!er outBut to @ariable *)
Mnl151c060 Pag. 49/271
7.1.6 &ord.oB/te* &ord to b/te con3ersion
Questo blocco funzione permette di convertire una variabile ?'<8 in due variabili B(TE.
IN (WORD) Variabile da convertire.
M+B (BYTE) MSB del valore in ingresso.
L+B (BYTE) LSB del valore in ingresso.
Esem!i
Le variabile VarIn+ divisa nelle due variabili &SBB7te e LSBB7te.
Esem!io LD (PTP11$A100, LD_(or)To%'&e)
Esem!io IL (PTP11$A100, IL_(or)To%'&e)
LD 8ar3nB
5"L =BData (* 5all the ;ordToBAte !unction bloc? *)
LD =BData%MSB
ST MSBBAte (* Trans!er the MSB outBut to @ariable *)
LD =BData%LSB
ST LSBBAte (* Trans!er the LSB outBut to @ariable *)
Esem!io +. (PTP11$A100, T_(or)To%'&e)
=BData%3n:=8ar3nB; (* Trans!er the @ariable to inBut *)
=BData(); (* 5all the ;ordToBAte !unction bloc? *)
MSBBAte:==BData%MSB; (* Trans!er the MSB outBut to @ariable *)
LSBBAte:==BData%LSB; (* Trans!er the LSB outBut to @ariable *)
Mnl151c060 Pag. 50/271
7.1.7 Double.o&ord* Double to Cord con3ersion
Questo blocco funzione permette di convertire una variabile DWORD in due variabili WORD.
IN (DWORD) Variabile da convertire.
M+& (WORD) MSW del valore in ingresso.
L+& (WORD) LSW del valore in ingresso.
Esem!i
Le variabile VarIn+ divisa nelle due variabili &SB?ord e LSB?ord.
Esem!io LD (PTP11$A100, LD_Do*+,eTo(or))
Esem!io IL (PTP11$A100, IL_Do*+,eTo(or))
LD 8ar3nB
5"L =BData (* 5all the DoubleTo;ord !unction bloc? *)
LD =BData%MS;
ST MSB;ord (* Trans!er the MS; outBut to @ariable *)
LD =BData%LS;
ST LSB;ord (* Trans!er the LS; outBut to @ariable *)
Esem!io +. (PTP11$A100, T_Do*+,eTo(or))
=BData%3n:=8ar3nB; (* Trans!er the @ariable to inBut *)
=BData(); (* 5all the DoubleTo;ord !unction bloc? *)
MSB;ord:==BData%MS;; (* Trans!er the MS; outBut to @ariable *)
MSB;ord:==BData%LS;; (* Trans!er the LS; outBut to @ariable *)
Mnl151c060 Pag. 51/271
7.1.9 &ord.oDouble* &ord to double con3ersion
Questo blocco funzione permette di convertire due variabili ?'<8 in una variabile 8?'<8.
M+& (WORD) MSB del valore in uscita '9t
L+& (WORD) LSB del valore in uscita '9t
-ut (DWORD) Valore in uscita
Esem!i
Le due variabili &SB?ord e LSB?ord sono uniti nella variabile Var'9t in uscita.
Esem!io LD (PTP11$A100, LD_(or)ToDo*+,e)
Esem!io IL (PTP11$A100, IL_(or)ToDo*+,e)
LD MSB;ord
ST =BData%MS; (* Trans!er the MS; @ariable to inBut *)
LD LSB;ord
ST =BData%LS; (* Trans!er the LS; @ariable to inBut *)
5"L =BData (* 5all the ;ordToDouble !unction bloc? *)
LD =BData%,ut
ST 8ar,ut (* Trans!er outBut to @ariable *)
Esem!io +. (PTP11$A100, T_(or)ToDo*+,e)
=BData%MS;:=MSB;ord; (* Trans!er the MS; @ariable to inBut *)
=BData%LS;:=LSB;ord; (* Trans!er the LS; @ariable to inBut *)
=BData(); (* 5all the ;ordToDouble !unction bloc? *)
8ar,ut:==BData%,ut; (* Trans!er outBut to @ariable *)
Mnl151c060 Pag. 52/271
7.1.: .oLoCer* <!!ercase to loCercase letter con3ersion
Questa funzione converte un carattere dal formato maiuscolo nel corrispondente carattere in
formato minuscolo.
Parametri funzione:
Char (USNT) Carattere da convertire.
(USNT)
Carattere nel formato minuscolo.
Esem!i
La variabile C++er viene convertita nel corrispondente valore minuscolo e trasferita in Lo-er. l valore di
inizializzazione 16#41 che corrisponde alla lettera %, viene convertito nel valore 16#61 che corrisponde alla lettera a.
Esem!io LD
Esem!io IL
LD UBBer (* UBBercase letter *)
ToLoIer (* UBBercase to loIercase letter con@ersion *)
ST LoIer (* LoIercase letter *)
Esem!io +.
LoIer:=ToLoIer(UBBer); (* UBBercase to loIercase letter con@ersion *)
Mnl151c060 Pag. 53/271
7.1.1% .o<!!er* LoCercase to u!!ercase letter con3ersion
Questa funzione converte un carattere dal formato minuscolo nel corrispondente carattere in
formato maiuscolo.
Parametri funzione:
Char (USNT) Carattere da convertire.
(USNT)
Carattere nel formato maiuscolo.
Esem!i
La variabile Lo-er viene convertita nel corrispondente valore maiuscolo e trasferita in C++er. l valore di
inizializzazione 16#61 che corrisponde alla lettera a, viene convertito nel valore 16#41 che corrisponde alla lettera %.
Esem!io LD
Esem!io IL
LD LoIer (* LoIercase letter *)
ToUBBer (* LoIercase to uBBercase letter con@ersion *)
ST UBBer (* LoIercase letter *)
Esem!io +.
UBBer:=ToUBBer(LoIer); (* LoIercase to uBBercase letter con@ersion *)
Mnl151c060 Pag. 54/271
7.4 (unzioni ed (B di utilitD sistema
7.4.1 +/s0et+/s.ime* get s/stem time
Function Embedded 3.0
Questa funzione ritorna il tempo di sistema espresso in S. E' possibile definire con il valore
di Cmd se si vuole avere il tempo di sistema attuale (Cmd)FT<CE) oppure quello
memorizzato con la precedente esecuzione della funzione (Cmd)F4%LSE).
Parametri funzione:
Cmd (BOOL) ndica il valore di tempo che deve essere ritornato.
T<CE) Viene salvato e ritornato il valore attuale di tempo.
4%LSE) Viene ritornato il tempo salvato dalla precedente chiamata con Cmd)FT<CE.
(UDNT)
Tempo di sistema espresso in S.
Esem!i
Viene calcolato il tempo in cui l'ingresso digitale 8i$$&$$ rimane nella condizione di attivo.
Esem!io +. (PTP116A000, T_'-Ge&'-Time)
(* 5hec? i! inBut is acti@ated% *)
3= (Di$$M$$ JK 0ulse) T:.*
0ulse:=Di$$M$$; (* 0ulse !lag *)
(* ,n inBut raising edge relate tiEe is sa@ed% *)
3= (Di$$M$$) T:.* StartTiEe:=SAs-etSAsTiEe(TRU.); .*DG3=;
(* ,n inBut !alling edge the set tiEe is calculated% *)
3= (*,T(Di$$M$$)) T:.* SetTiEe:=SAs-etSAsTiEe(TRU.)StartTiEe; .*DG3=;
.*DG3=;
Calcolo timeout
Essendo il valore di tempo di sistema ritornato dalla funzione un numero C8I:T che si incrementa ogni S, ed al valore
massimo esegue overflow a zero, non possibile effettuare comparazioni dirette con il tempo di riferimento ma occorre
sempre eseguire la differenza.
Nel seguente esempio viene attivato Timeo9t se l'ingresso 8i$$&$$ rimane attivo per pi di un secondo.
3= *,T(Di$$M$$) T:.* TiEeB!:=SAs-etSAsTiEe(TRU.);
.LS. 3= ((SAs-etSAsTiEe(TRU.)TiEeB!) K= #$$$$$$) T:.* TiEeout:=TRU.; .*DG3=;
.*DG3=;
Lo stesso esempio scritto in questo modo non funziona correttamente.
3= *,T(Di$$M$$) T:.* TiEeB!:=SAs-etSAsTiEe(TRU.);
.LS. 3= (SAs-etSAsTiEe(TRU.) K= (TiEeB!L#$$$$$$)) T:.* TiEeout:=TRU.; .*DG3=;
.*DG3=;
Mnl151c060 Pag. 55/271
+em!lice cronometro
Questo esempio realizza un semplice cronometro per misurare il tempo che intercorre tra un comando di start ed il
comando di stop. Utilizzando ad esempio due fotocellule una sulla linea di start ed una sulla linea di stop di un percorso
possibile calcolare il tempo di percorrenza espresso in S.
Attivando l'ingresso di start 8i$$&$$ viene salvato il tempo di sistema allo start nella variabile StartTime, attivando
l'ingresso di stop 8i$1&$$ viene calcolato il tempo trascorso tra il tempo salvato allo start ed il tempo nel momento di
stop. l tempo calcolato salvato nella variabile 8ela7Time.
Esem!io LD (PTP11.A000)
Mnl151c060 Pag. 56/271
7.4.2 +/s+et.asL!.ime* set tas loo! time
Questa funzione permette di impostare il tempo di esecuzione delle tasks PLC. Esistono
due tasks eseguite a tempo la task slow I8ET%SNESL'? e la task fast
I8ET%SNE4%ST, ad ognuna di queste task pu essere assegnato un tempo di
esecuzione.
Se il tempo impostato non compreso nel range definito o se il rapporto tra i tempi di
esecuzione della task fast rispetto alla slow non sono coerenti la funzione non modifica i tempi di esecuzione e ritorna
4%LSE. Di seguito sono riportati i range di tempo definibili per le varie tasks.
I8ET%SNE4%ST Range da 100 S a 10 mS
I8ET%SNESL'? Range da 1 a 100 mS
Parametri funzione:
.asID (USNT) dentifica la task a cui si vuole definire il tempo di esecuzione secondo le definizioni in Task D.
.ime (UDNT) ndica il valore di tempo di esecuzione task espresso in S.
(BOOL)
T<CE) Se funzione eseguita correttamente
4%LSE) n caso di errore esecuzione, esempio parametri errati.
Esem!i
Attivando l'ingresso 8i$$&$$ viene impostato un tempo di esecuzione di 5 ms per la task PlcFast.
%ttenzione@ Per aumentare i tempi di esecuzione delle tasks dal valore di default occorre eseguire la funzione nella
task di boot.
Esem!io LD (PTP116A000, LD_'-e&Ta-/L0Time)
Esem!io +.
.nabled:=Di$$M$$; (* =unction enabled *)
3= Di$$M$$ T:.*
.Mecution,?:=SAsSetTas?LBTiEe(Tas?3D:=3DGT"SHG="ST, TiEe:=&$$$); (* =unction eMecution o? *)
.*DG3=;
Mnl151c060 Pag. 57/271
7.4.$ +/s0etRandom* get random number
Questa funzione ritorna un numero random compreso tra 0.0 e 1.0. E' possibile definire con
il valore di Cmd se si vuole avere un nuovo numero random (Cmd)FT<CE) oppure quello
Parametri funzione:
Cmd (BOOL) ndica il numero random ritornato.
T<CE) Viene salvato e ritornato un nuovo numero random.
4%LSE) Viene ritornato il numero salvato dalla precedente chiamata con Cmd)FT<CE.
(REAL)
Un numero random compreso nel range da 0.0 a 1.0.
Esem!i
Attivando l'ingresso digitale 8i$$&$$ viene inviato sulla porta seriale C'&$ una sequenza di 10 numeri random.
Esem!io +. (PTP116A000, T_'-Ge&Ran)om)
(* :ere the 5,M$ Bort is oBened in readNIrite% *)
3= (=B = *ULL) T:.*
=B:=SAs!oBen(95,M$9, 9rI9); (* 0ort 5,M$ !ile Bointer *)
.*DG3=;
= (Di$$M$$ JK 0ulse) T:.*
(* ,n inBut raising edge Brint out #$ randoE nuEbers% *)
3= (Di$$M$$) T:.*
=,R i:=$ T, (() BO # D,
RandoE*r:=T,GU3*T(SAs-etRandoE(TRU.)*#$$$%$); (* RandoE nuEber *)
*r,!5hars:=SAs8ar!Brint!(=B, 9Rn:P$)dQrQn9, U3*TGTO0., "DR(RandoE*r));
.*DG=,R;
.*DG3=;
.*DG3=;
Collegando un terminale seriale alla porta C'&$ impostato a 111$$,e,2,1 vedremo un elenco del tipo:
Rn:6)1
Rn:622
Rn:2(2
%%%
Rn:+7#
Rn:(66
Mnl151c060 Pag. 58/271
7.4.1 +/s0etLastError* get last error
Questa funzione ritorna il numero dell'ultimo errore rilevato da una funzione e/o da un blocco
funzione (Errori di esecuzione). Occorre eseguire la funzione su abilitazione del bit di fault in
uscita dalla funzione e/o blocco funzione da controllare. E' possibile definire con il valore di
Cmd se si vuole avere il valore attuale dell'ultimo errore (Cmd)FT<CE) oppure quello
Parametri funzione:
Cmd (BOOL) ndica il numero di errore ritornato.
T<CE) Viene ritornato l'ultimo valore di errore.
4%LSE) Viene ritornato il numero salvato dalla precedente chiamata con Cmd)FT<CE.
(UDNT)
l numero dell'ultimo errore rilevato
Esem!i
Viene salvato l'eventuale errore durante l'esecuzione del blocco funzione CPC&od9leI'. n caso di errore il numero di
errore trasferito nella variabile Error:r.
Esem!io LD
Mnl151c060 Pag. 59/271
7.4.4 +/s)CodeAcce!t* acce!ts the !rotection code
Alcune funzioni di programma e/o blocchi funzione possono essere protetti da un codice che
deve essere ordinato separatamente. Per abilitare l'esecuzione della funzione e/o del blocco
funzione occorre sbloccarlo definendone il codice con questa funzione.
La funzione controlla il codice fornito e ritorna T<CE se codice accettato. Vedere capitolo
Protezione >9nzioni e ;locc*i >9nzione per ulteriori informazioni.
Parametri funzione:
Code (STRNG[20]) Codice di protezione.
(BOOL)
T<CE) Codice verificato D relativo sbloccato. 4%LSE) Codice non verificato.
Codici di errore
n caso di errore la funzione torna 4%LSE e con S7sGetLastError possibile rilevare il codice di errore.
9991100 Lunghezza Code non corretta.
9991110 5 Codice definito in Code non corretto.
9991200 Non vi pi spazio per eseguire ulteriori funzioni protette.
Esem!i
E' riportato un semplice programma che esegue il controllo sul codice di sblocco "a;cde>g*iLIlmno+Brst". Se il codice
corretto viene attivata la variabile Code%cce+ted.
Esem!io LD (PTP116A000,LD_'-PCo)eA11e0&)
Esem!io +.
(* 5hec? the Brotection code% *)
5ode"cceBted:=SAs05ode"cceBt(9abcde!ghi>?lEnoBFrst9); (* 0rotection code acceBted *)
Mnl151c060 Pag. 60/271
7.4.6 +/s0etCrc* get CRC 3alue
FB Embedded 3.0
Questa funzione esegue il calcolo del CRC C7clic <ed9ndanc7 C*ecI, (Controllo Ciclico di
Ridondanza) su di un'area dati. l calcolo effettuato secondo le specifiche richieste dal protocollo
mod;9s <t9
Occorre passare alla funzione l'indirizzo del buffer di memoria B9> ed il numero di bytes B7te:r su cui
eseguire il calcolo del CRC.
Bu' (@USNT) ndirizzo dell'area di memoria su cui eseguire il calcolo del CRC.
B/teNr (UNT) Numero di bytes su cui eseguire il calcolo del CRC a partire dall'indirizzo definito in B9>.
CRCIni (UNT) Valore di inizializzazione del CRC da calcolare.
CRC (UNT) Valore CRC calcolato.
Codici di errore
n caso di errore con S7sGetLastError possibile rilevare il codice di errore.
9978050 Errore allocazione blocco funzione.
9978070 Errore versione blocco funzione.
Esem!i
Viene calcolato il CRC di un frame modbus Rtu per il comando di lettura registri <ead *olding registers.
Esem!io +. (PTP116A100, T_'-Ge&Cr1)
(* *)
(* 5alculate 5R5 o! a Eodbus Rtu !raEe !or coEEand RRead holding registersR% *)
(* LLLLLLLLL *)
(* S*dS$)S"ddr S*uER S5R5S *)
(* LLLLLLLLL *)
(* *)
(* De!ine the registers address and the nuEber o! registers to read% *)
Regs"ddress:=#7T$#+$; (* Registers address *)
*r,!Regs:=2; (* *uEber o! registers *)
(* 0reBare the coEEand !raEe% *)
=raEeC$D:=#; (* *ode address *)
=raEeC#D:=); (* =unction code (#7T$)) *)
=raEeC+D:=T,GUS3*T(Regs"ddressN+&7); (* MSB registers address *)
=raEeC)D:=T,GUS3*T(Regs"ddressU+&&); (* LSB registers address *)
=raEeC6D:=$; (* MSB nuEber o! registers to read *)
=raEeC&D:=*r,!Regs; (* LSB nuEber o! registers to read *)
(* 5alculate the !raEe 5R5% *)
-et5R5%Bu!:="DR(=raEeC$D); (* Bu!!er address *)
-et5R5%BAte*r:=7; (* BAte nuEber *)
-et5R5%5rc3ni:=#7T====; (* 5R5 ini @alue *)
-et5R5(); (* 5alculate 5R5 *)
5R58alue:=-et5R5%5rc; (* 5R5 @alue *)
=raEeC7D:=T,GUS3*T(5R58alueN+&7); (* MSB o! 5R5 @alue *)
=raEeC1D:=T,GUS3*T(5R58alueU+&&); (* LSB o! 5R5 @alue *)
Mnl151c060 Pag. 61/271
l valore del CRC del frame modbus Rtu 16#443A, l'intero frame
visibile ponendo nella finestra di watch la variabile 4rame cos come
riportato nella figura.
Mnl151c060 Pag. 62/271
7.4.7 +/sMAlloc* Memor/ allocation
Questa funzione esegue l'allocazione di uno spazio di memoria della dimensione in byte definita
da parametro Size. La funzione ritorna il puntatore allo spazio di memoria allocato.
La memoria allocata nella memoria di sistema e quindi non utilizza la memoria a disposizione
del programma utente. Nel caso in cui non vi sia spazio in memoria per l'allocazione del buffer definito, la funzione
ritorna $.
Parametri funzione:
+ize (UDNT) Dimensione in bytes dell'area da allocare.
(@USNT)
ndirizzo allocazione buffer. :CLL se non vi spazio per allocare il buffer.
Esem!i
Su fronte attivazione ingresso 8i$$&$$ viene incrementata la variabile Co9nter e la stampa del suo valore trasferita
nell'array String'9t. l valore presente in String'9t viene poi inviato sulla porta seriale C'&$.
Esem!io +. (PTP116A300, T_'-2A,,o1)
(* *)
(* RSAsM"llocR eMaEBle *)
(* *)
(* :ere at !irst BrograE eMecution looB allocate EeEorA and oBen 5,M% *)
3= (SAs=irstLooB) T:.*
String,ut:=SAsM"lloc(#7); (* String outBut Bointer *)
.*DG3=;
3= ((String,ut = $) ,R (=B = $)) T:.* R.TUR*; .*DG3=;
(* ,n inBut raising edge the counter @alue is Brinted% *)
3= (Di$$M$$ JK 0ulse) T:.*
3= (Di$$M$$) T:.*
5ounter:=5ounterL#; (* 5ounter *)
*r,!5hars:=SAs8arsnBrint!(String,ut, )+, 95ounter:P$6dQrQn9, UD3*TGTO0., "DR(5ounter));
=,R i:=$ T, *r,!5hars D,
5h:=SAs!Butc(T,G3*T(VString,ut), =B); (* ;ritten character *)
String,ut:=String,utL#; (* String outBut Bointer *)
.*DG=,R;
.*DG3=;
.*DG3=;
(* C.nd o! !ileD *)
Mnl151c060 Pag. 63/271
7.6 (unzioni ed (B !er gestione Data5-ra
7.6.1 +/sE.ime.oDate* e!och time to date con3ersion
FB Embedded 3.0
Questo blocco funzione esegue la conversione della data espressa in epoch time. Occorre
fornire al blocco funzione la data espressa nel formato epoch ime come presente nella
variabile di sistema S7s8ateTime, in uscita dal blocco funzione avremo i valori di data espressi
nel formato Giorno/Mese/Anno ed Ora:Minuti:Secondi.
E!och.ime (UDNT) Occorre specificare la data espressa in epoch time.
Done (BOOL) Attivato al termine della conversione.
(ault (BOOL) Errore di conversione, viene attivato in caso di errore nella conversione.
,ear (UNT) Ritorna il valore di anno (Range da 1970 a 2099)
Month (USNT) Ritorna il valore di mese dell'anno (Range da 1 a 12)
Da/ (USNT) Ritorna il valore di giorno del mese (Range da 1 a 31)
&eeDa/ (USNT) Ritorna il valore di giorno della settimana (Range da 0 a 6)
0: Domenica, 1:Luned, 2:Marted, 3:Mercoled, 4:Gioved, 5:Venerd, 6:Sabato
?our (USNT) Ritorna il valore di ora (Range da 0 a 23)
Minute (USNT) Ritorna il valore di minuti (Range da 0 a 59)
+econd (USNT) Ritorna il valore di secondi (Range da 0 a 59)
Codici di errore
n caso di errore si attiva l'uscita 4a9lt, con S7sGetLastError possibile rilevare il codice di errore.
Mnl151c060 Pag. 64/271
Esem!i
Viene convertito il valore di data ed ora espresso in epoch time dalla variabile S7s8ateTime e viene ritornato il valore di
anno, mese e giorno nelle tre variabili definite.
Esem!io LD (PTP116A100, LD_'-ETimeToDa&e)
Esem!io IL (PTP116A100, IL_'-ETimeToDa&e)
(* Trans!er sAsteE date e tiEe to =B inBut @ariable% *)
LD SAsDateTiEe
ST =BGSAs.TiEeToDate%.BochTiEe
5"L =BGSAs.TiEeToDate (* 5all the SAs.TiEeToDate !unction bloc? *)
(* Trans!er the =B outBut @ariables to BrograE @ariables% *)
LD =BGSAs.TiEeToDate%Oear
ST Oear
LD =BGSAs.TiEeToDate%Month
ST Month
LD =BGSAs.TiEeToDate%DaA
ST DaA
Esem!io +. (PTP116A100, T_'-ETimeToDa&e)
(* :ere =B SAs.TiEeToDate is eMecuted and @ariables coBied% *)
=BGSAs.TiEeToDate%.BochTiEe:=SAsDateTiEe;
=BGSAs.TiEeToDate();
Oear:==BGSAs.TiEeToDate%Oear; (* Oear *)
Month:==BGSAs.TiEeToDate%Month; (* Month *)
DaA:==BGSAs.TiEeToDate%DaA; (* DaA *)
Mnl151c060 Pag. 65/271
7.6.2 +/sDate.oE.ime* date to e!och time con3ersion
FB Embedded 3.0
Questo blocco funzione esegue la conversione della data-ora in epoch time. Occorre fornire al
blocco funzione la data e l'ora ed in uscita dal blocco funzione avremo un valore in epoch time.
,ear (UNT) Definisce il valore di anno (Range da 1970 a 2099)
Month (USNT) Definisce il valore di mese dell'anno (Range da 1 a 12)
Da/ (USNT) Definisce il valore di giorno del mese (Range da 1 a 31)
?our (USNT) Definisce il valore di ora (Range da 0 a 23)
Minute (USNT) Definisce il valore di minuti (Range da 0 a 59)
+econd (USNT) Definisce il valore di secondi (Range da 0 a 59)
Done (BOOL) Attivato al termine della conversione.
(ault (BOOL) Errore di conversione, viene attivato in caso di errore nella conversione.
E!och.ime (UDNT) Ritorna data espressa in epoch time.
Codici di errore
9987200 Errore durante l'esecuzione del blocco funzione.
Mnl151c060 Pag. 66/271
Esem!i
Viene convertito il valore di data ed ora in epoch time. Esempio definendo il valore di data 9/4/2010 e ora 14:20:15
avremo in uscita il valore 1270822815.
Esem!io LD (PTP116A100, LD_'-Da&eToETime)
Esem!io IL (PTP116A100, IL_'-Da&eToETime)
(* Trans!er date e tiEe to =B inBut @ariable% *)
LD Oear
ST =BGSAsDateTo.tiEe%Oear
LD Month
ST =BGSAsDateTo.tiEe%Month
LD DaA
ST =BGSAsDateTo.tiEe%DaA
5"L =BGSAsDateTo.tiEe (* 5all the SAsDateTo.tiEe !unction bloc? *)
(* Trans!er the =B outBut @ariables to BrograE @ariables% *)
LD =BGSAsDateTo.tiEe%.BochTiEe
ST .BochTiEe
Esem!io +. (PTP116A100, T_'-Da&eToETime)
(* :ere =B SAsDateTo.TiEe is eMecuted and @ariables coBied% *)
=BGSAsDateTo.tiEe%Oear:=Oear;
=BGSAsDateTo.tiEe%Month:=Month;
=BGSAsDateTo.tiEe%DaA:=DaA;
=BGSAsDateTo.tiEe(); (* 5all the SAsDateTo.tiEe !unction bloc? *)
.BochTiEe:==BGSAsDateTo.tiEe%.BochTiEe; (* .Boch tiEe *)
Mnl151c060 Pag. 67/271
7.7 (unzioni ed (B !er gestione terminale di I5-
7.7.1 +/s'o!en* 'ile o!en
Questa funzione permette l'apertura del collegamento tra la risorsa indicata dal parametro
4:ame, ed un flusso di dati stream da impiegare nelle successive chiamate alle funzioni di
/O. La funzione ritorna il pointer alla risorsa.
Se la risorsa indicata gi aperta oppure il nome della risorsa errato, la funzione ritorna
:CLL. Se si sta aprendo un file su disco per crearlo, accertarsi che il disco sia formattato.
Parametri funzione:
(Name (STRNG[20]) E' il nome della risorsa da utilizzare.
Name Resource
COM0 Serial port COM0
PCOMx.y Porta seriale y su modulo periferico con indirizzo x
UDPSKT UDP socket
TCPSKT TCP socket
pathname Percorso completo comprensivo del nome file (es.: 'Storage/myFile.txt')
Mode (STRNG[4]) ndica il modo in cui la risorsa aperta: r=read; w=write ; a=append. Per le porte seriali definire 'rw'.
Per creare un file su disco, occorre eseguire l'apertura in 'w' o 'a'.
L'apertura in 'w' su un file esistente, provoca la cancellazione del contenuto.
L'apertura in 'r' o 'w' posizionano l'indicatore di posizione dello stream all'inizio del file, l'apertura in 'a'
lo posiziona alla fine.
"(ILE)# Pointer alla risorsa.
:CLL) n caso di errore.
Codici di errore
n caso di errore la funzione torna con :CLL e con S7sGetLastError possibile rilevare il codice di errore.
9996100 Nome risorsa 4:ame ha lunghezza errata.
9996110 Nome risorsa 4:ame ha lunghezza errata.
9996200~2 mpossibile utilizzare porta da programma utente.
Esem!i
Viene aperta la porta seriale in read/write.
Esem!io LD
Esem!io +. (PTP116A100, T_'-3o0en)
Mnl151c060 Pag. 68/271
3= (=B = *ULL) T:.*
.*DG3=;
Mnl151c060 Pag. 69/271
7.7.2 +/s'close* 'ile close
Questa funzione permette la chiusura del collegamento alla risorsa indicata dal parametro 4ile,
precedentemente aperto dalla funzione Sysfopen.
n caso di errore chiusura, la funzione ritorna E'4.
Parametri funzione:
(ile (FLEP) Flusso dati stream ritornato dalla funzione S7s>o+en.
(NT)
$) Se esecuzione corretta.
E'4) n caso di errore.
Codici di errore
n caso di errore la funzione torna con E'4 e con S7sGetLastError possibile rilevare il codice di errore.
9973100 Terminale di /O usato in task fast o slow.
9973200 Errore nella chiusura della risorsa.
Esem!i
Viene aperta e successivamente chiusa la porta seriale C'&$. Se la porta correttamente aperta viene attivata l'uscita
8o$$&$$. Se la porta correttamente chiusa viene attivata l'uscita 8o$1&$$.
Esem!io +. (PTP116A100, T_'-31,o-e)
3= (=B = *ULL) T:.*
Do$$M$$:=(=B JK *ULL); (* ,utBut is set i! Bort is oBened *)
.*DG3=;
(* :ere the 5,M$ Bort is closed% *)
3= (=B JK *ULL) T:.*
Do$#M$$:=(SAs!close(=B) JK .,=); (* ,utBut is set i! Bort is closed *)
.*DG3=;
Mnl151c060 Pag. 70/271
7.7.$ +/s'getc* get character 'rom 'ile
Questa funzione ritorna un carattere dal flusso dati stream indicato dal parametro 4ile,
La funzione ritorna il carattere letto dallo stream. n caso di errore o se nessun dato dallo stream, la
funzione ritorna E'4. Per essere certi che vi siano caratteri dallo stream possibile utilizzare la
funzione SysGetChars che ne ritorna il numero.
Parametri funzione:
(NT)
Carattere letto dal flusso di dati.
E'4) n caso di errore o se nessun dato dallo stream.
Codici di errore
Esem!i
Viene eseguita apertura porta seriale C'&$ e controllato se caratteri disponibili dalla porta. Se almeno un carattere
disponibile ne viene eseguita lettura ed il carattere letto trasferito nella variabile C*.
Esem!io +. (PTP116A100, T_'-3ge&1)
3= (=B = *ULL) T:.*
.*DG3=;
(* :ere chec? i! a character is a@ailable !roE Bort and read it% *)
3= (=B JK *ULL) T:.*
3= (T,GB,,L(SAs-et35hars(=B))) T:.*
5h:=SAs!getc(=B); (* -et inBut character *)
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 71/271
7.7.1 +/s'!utc* !ut character to 'ile
Questa funzione invia un carattere sul flusso dati stream indicato dal parametro 4ile,
La funzione ritorna il carattere scritto sullo stream. n caso di errore o se lo stream non accetta il
dato, la funzione ritorna EOF. Per essere certi che vi sia spazio sullo stream per accettare il
carattere, possibile utilizzare la funzione SysGetOSpace che ritorna lo spazio disponibile.
Parametri funzione:
Ch (NT) Carattere da inviare sul flusso dati.
(ile "(ILE)# Flusso dati stream ritornato dalla funzione S7s>o+en.
(NT)
Carattere scritto sul flusso di dati. E'4) n caso di errore o se lo stream non accetta il dato.
Codici di errore
Esem!i
E' riportato un semplice programma che esegue l'eco dei caratteri ricevuti dalla porta seriale C'&$. Viene eseguita
apertura porta seriale C'&$ e controllato se caratteri disponibili dalla porta. Se almeno un carattere disponibile ne
viene eseguita lettura e successiva ritrasmissione.
Esem!io +. (PTP116A100, T_'-30*&1)
3= (=B = *ULL) T:.*
.*DG3=;
(* :ere eMecute the recei@ed characters echo% *)
3= (=B JK *ULL) T:.*
3= (T,GB,,L(SAs-et35hars(=B))) "*D (T,GB,,L(SAs-et,SBace(=B))) T:.*
5h:=SAs!Butc(5h, =B); (* 0ut inBut character *)
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 72/271
Utilizzando le funzioni di gestione terminale di /O possibile realizzare un semplice programma che esegue l'echo del
carattere ricevuto dalla porta seriale C'&$. La porta viene aperta con il modo impostato di default (115200, e, 8, 1), se
ricevuto un carattere dalla porta si attiva <=Cmd ed il carattere ricevuto copiato in <=C*ar. La ricezione di un
carattere provoca la trasmissione del carattere ricevuto.
Esem!io LD (PTP1.A000, eria,E14o)
Mnl151c060 Pag. 73/271
7.7.4 +/s'read* read data 'rom 'ile
Questa funzione esegue la lettura di un numero definito di stringhe di lunghezza definita dal flusso
dati stream indicato dal parametro 4ile, precedentemente aperto dalla funzione Sysfopen.
La funzione ritorna il numero di stringhe dati lette. Se nello stream non ci sono abbastanza
stringhe da soddisfare i parametri, viene ritornato un numero minore di stringhe lette rispetto al
valore definito.
Parametri funzione:
Bu' (@STRNG) ndirizzo della stringa dove trasferire le stringhe lette.
+ize (NT) Lunghezza in caratteri delle stringhe da leggere.
Count (NT) Numero di stringhe da leggere.
(NT)
Numero di stringhe lette, se il valore ritornato minore di Co9nt, significa che non vi erano abbastanza
dati nello stream.
Codici di errore
n caso di errore la funzione torna con $ e con S7sGetLastError possibile rilevare il codice di errore.
Esem!i
Vengono attesi almeno 5 caratteri ricevuti dalla porta seriale e quando ricevuti viene letta una stringa di 5 caratteri (5
stringhe di 1 carattere), la stringa letta trasferita nella variabile <=String. La stringa letta viene poi ritrasmessa sulla
porta seriale, notare come anche nella trasmissione trasmessa una stringa di 5 caratteri (1 stringa di 5 caratteri) .
Esem!io +. (PTP116A100, T_'-3rea))
3= (=B = *ULL) T:.*
.*DG3=;
(* :ere Iait until at least & chars are recei@ed and echoes theE% *)
3= (=B JK *ULL) T:.*
3= (SAs-et35hars(=B) K= &) T:.*
RM5hars:=SAs!read("DR(RMString), #, &, =B); (* Recei@ed characters *)
TM5hars:=SAs!read("DR(RMString), &, #, =B); (* Recei@ed characters *)
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 74/271
7.7.6 +/s'Crite* Crite data to 'ile
Questa funzione esegue la scrittura di un numero definito di stringhe di lunghezza definita nel
flusso dati stream indicato dal parametro 4ile, precedentemente aperto dalla funzione Sysfopen.
La funzione ritorna il numero di stringhe dati scritte. Se nello stream non c' abbastanza spazio
per contenere il numero di stringhe definito, viene ritornato un numero minore di stringhe scritte
rispetto al valore definito.
Parametri funzione:
Bu' (@STRNG) ndirizzo della stringa da scrivere.
+ize (NT) Lunghezza in caratteri delle stringhe da scrivere.
Count (NT) Numero di stringhe da scrivere.
(NT)
Numero di stringhe scritte, se valore ritornato minore di Co9nt, non vi era abbastanza spazio nello
stream.
Codici di errore
Esem!i
Vengono attesi almeno 5 caratteri ricevuti dalla porta seriale e quando ricevuti viene letta una stringa di 5 caratteri (5
stringhe di 1 carattere), la stringa letta trasferita nella variabile <=String. La stringa letta viene poi ritrasmessa sulla
porta seriale, notare come anche nella trasmissione trasmessa una stringa di 5 caratteri (1 stringa di 5 caratteri) .
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;
(* :ere Iait until at least & chars are recei@ed and echoes theE% *)
3= (=B JK *ULL) T:.*
3= (SAs-et35hars(=B) K= &) T:.*
RM5hars:=SAs!read("DR(RMString), #, &, =B); (* Recei@ed characters *)
TM5hars:=SAs!Irite("DR(RMString), &, #, =B); (* TransEitted characters *)
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 75/271
7.7.7 +/s0etIChars* get in!ut a3ailable characters 'rom 'ile
Questa funzione ritorna il numero di caratteri disponibili per la lettura dal flusso dati stream
indicato dal parametro 4ile, precedentemente aperto dalla funzione Sysfopen.
Se il valore ritornato diverso da $ i caratteri potranno essere letti con la funzione Sysfgetc.
Parametri funzione:
(NT)
Numero di caratteri disponibili dal flusso dati.
Codici di errore
Esem!i
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;
3= (=B JK *ULL) T:.*
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 76/271
7.7.9 +/s0et-+!ace* get out!ut a3ailable s!ace on 'ile
Questa funzione ritorna lo spazio disponibile per la scrittura dati sul flusso dati stream indicato
dal parametro 4ile, precedentemente aperto dalla funzione S7s>o+en.
Se il valore ritornato diverso da $ i caratteri potranno essere scritti con la funzione S7s>+9tc.
Parametri funzione:
(NT)
Spazio disponibile sul flusso dati per trasferire caratteri.
Se buffer vuoto viene ritornata la dimensione del buffer di trasmissione.
Codici di errore
Esem!i
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;
3= (=B JK *ULL) T:.*
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 77/271
7.7.: +/s0etREB+ize* get 'ile RE in!ut bu''er size
Questa funzione ritorna la dimensione del buffer di input (Ricezione) sul flusso dati stream
indicato dal parametro 4ile, precedentemente aperto dalla funzione S7s>o+en.
Parametri funzione:
(UDNT)
Dimensione buffer di input espressa in numero di caratteri (Bytes).
Codici di errore
Esem!i
E' riportato un semplice programma che ritorna la dimensione del buffer di input (Ricezione) della porta seriale C'&1. l
valore ritornato espresso in numero di caratteri (Bytes), trasferito nella variabile S+ace.
Esem!io LD
Mnl151c060 Pag. 78/271
7.7.1% +/s0et.EB+ize* get 'ile .E out!ut bu''er size
Questa funzione ritorna la dimensione del buffer di output (Trasmissione) sul flusso dati stream
indicato dal parametro 4ile, precedentemente aperto dalla funzione S7s>o+en.
Parametri funzione:
(UDNT)
Dimensione buffer di output espressa in numero di caratteri (Bytes).
Codici di errore
Esem!i
E' riportato un semplice programma che ritorna la dimensione del buffer di output (Trasmissione) della porta seriale
C'&1. l valore ritornato espresso in numero di caratteri (Bytes), trasferito nella variabile S+ace.
Esem!io LD
Mnl151c060 Pag. 79/271
7.7.11 +/s(IB'Clear* 'ile in!ut bu''er clear
Questa funzione elimina tutti i caratteri in lettura presenti sul flusso dati stream indicato dal
parametro 4ile, precedentemente aperto dalla funzione S7s>o+en.
La funzione ritorna 4%LSE in caso di errore.
Parametri funzione:
(BOOL)
4%LSE) Errore esecuzione.
T<CE) Funzione eseguita correttamente.
Codici di errore
Esem!i
Se attivo l'ingresso 8i$$&$$ tutti i caratteri in ingresso dalla porta seriale saranno cancellati e l'uscita 8o$$&$$
attivata.
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;
(* 3! the inBut is acti@e the inBut bu!!er is cleared% *)
3= (=B JK *ULL) T:.*
3= (Di$$M$$) T:.* Do$$M$$:=SAs=3B!5lear(=B); .*DG3=;
.*DG3=;
Mnl151c060 Pag. 80/271
7.7.12 +/s(-B'Clear* 'ile out!ut bu''er clear
Questa funzione elimina tutti i caratteri in uscita presenti sul flusso dati stream indicato dal
Parametri funzione:
(BOOL)
Codici di errore
Esem!i
Se attivo l'ingresso 8i$$&$$ tutti i caratteri in uscita dalla porta seriale saranno cancellati e l'uscita 8o$$&$$ attivata.
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;
(* 3! the inBut is acti@e the ouBut bu!!er is cleared% *)
3= (=B JK *ULL) T:.*
3= (Di$$M$$) T:.* Do$$M$$:=SAs=,B!5lear(=B); .*DG3=;
.*DG3=;
Mnl151c060 Pag. 81/271
7.7.1$ +/s(-B'(lush* 'ile out!ut bu''er 'lush
Questa funzione forza l'uscita immediata dei caratteri presenti sul flusso dati stream indicato
dal parametro 4ile, precedentemente aperto dalla funzione S7s>o+en, sulla risorsa connessa.
Parametri funzione:
(BOOL)
Codici di errore
Esem!i
Se attivo l'ingresso 8i$$&$$ tutti i caratteri presenti nel buffer di uscita della porta seriale saranno trasmessi e l'uscita
8o$$&$$ attivata.
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;
(* 3! the inBut is acti@e the ouBut bu!!er is cleared% *)
3= (=B JK *ULL) T:.*
3= (Di$$M$$) T:.* Do$$M$$:=SAs=,B!=lush(=B); .*DG3=;
.*DG3=;
Mnl151c060 Pag. 82/271
7.7.11 +/s2ar'!rint'* 3ariable !rint to 'ile
Questa funzione esegue la stampa formattata di una variabile sullo stream collegato al
La stringa 4ormat specifica il formato con il quale stampare la variabile. Mentre in VarT7+e
indicato il tipo di variabile ed in Var%dd il suo indirizzo.
La funzione ritorna il numero di caratteri trasferiti nello stream, E'4 in caso di errore.
Parametri funzione:
(ormat (STRNG[80]) Ha due tipi di argomenti, i caratteri ordinari che vengono copiati nello stream di uscita, e le
specifiche di conversione, contraddistinte dal simbolo percentuale (%) e da un carattere che
specifica il formato con il quale stampare la variabile definita.
2ar./!e (USNT) Tipo variabile, come indicato nella tabella Varia;le t7+es de>inition .
2arAdd (UDNT) ndirizzo variabile.
(NT)
Numero di caratteri trasferiti nello stream. E'4) Errore esecuzione.
Codici di errore
9998010 Valore di 4ile non definito.
9998200 Tipo variabile non gestito, controllare VarT7+e.
Esem!i
Su fronte attivazione ingresso 8i$$&$$ viene incrementata la variabile Co9nter ed il suo valore inviato sulla porta
seriale C'&$. Nella variabile :r'>C*ars viene caricato il numero di caratteri inviati in uscita sulla porta seriale.
Esem!io +. (PTP116A300, T_'-5ar30rin&3)
3= (=B = *ULL) T:.* =B:=SAs!oBen(95,M$9, 9rI9); .*DG3=;
3= (=B JK *ULL) T:.*
3= (Di$$M$$ JK 0ulse) T:.*
3= (Di$$M$$) T:.*
*r,!5hars:=SAs8ar!Brint!(=B, 95ounter:P$6dQrQn9, UD3*TGTO0., "DR(5ounter));
.*DG3=;
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 83/271
7.9 (ile s/stem
Le "CPU SlimLine ARM7 a partire dal firmware versione S4?163C1$$, possono gestire il file system. n tali CPU
esistono due directories predefinite:
Storage) Directory allocata sulla memoria EEPROM presente su SlimLine (Tutte le versioni).
S8Card) Directory allocata sul chip SD Card che deve essere inserito nell'apposito connettore.
Per le operazioni di formattazione del file system si rimanda al manuale utente, il file system raggiungibile da FTP,
quindi utilizzando un client FTP possibile creare nuovi files, cancellare files esistenti, rinominare files esistenti, leggere
e scrivere dati nei files.
Mnl151c060 Pag. 84/271
7.9.1 +/sremo3e* 'ile remo3e
Questa funzione esegue la rimozione (cancellazione) di un file. n :ame occorre definire il
nome del file da eliminare specificando l'intero percorso (Esempio Storage/File.txt).
Se l'operazione di rimozione va a buon fine la funzione ritorna T<CE, in caso di errore viene
ritornato 4%LSE.
Parametri funzione:
Name (STRNG[32]) Nome del file da cancellare.
(BOOL)
T<CE) Ok esecuzione.
Codici di errore
9961100 Funzione richiamata in task fast o slow.
9961150 Errore nella dichiarazione del nome file.
9961160 Directory non accessibile da utente "Admin.
9961200 Errore nella cancellazione del file.
Esem+i
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ viene eliminato il file 4ile.t=t presente nella directory Storage.
Esem!io LD
Mnl151c060 Pag. 85/271
7.9.2 +/srename* 'ile rename
Questa funzione esegue il cambiamento del nome di un file. n 'ld:ame occorre definire il
nome del file da rinominare specificando l'intero percorso (Esempio Storage/OldFile.txt), in
:e-:ame occorre definire il nuovo nome del file specificando l'intero percorso (Esempio
Storage/NewFile.txt).
Se l'operazione di rinomina va a buon fine la funzione ritorna T<CE, in caso di errore viene
ritornato 4%LSE.
Parametri funzione:
-ldName (STRNG[32]) Nome del file da rinominare.
NeCName (STRNG[32]) Nuovo nome da dare al file.
(BOOL)
T<CE) Ok esecuzione.
Codici di errore
9960150 Errore nella dichiarazione 'ld:ame.
9960160 Directory file 'ld:ame non accessibile da utente "Admin.
9960170 Errore nella dichiarazione :e-:ame.
9960180 Directory file :e-:ame non accessibile da utente "Admin.
9960200 Errore nella rinominazione del file.
Esem+i
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ viene rinominato il file 'ld4ile.t=t presente nella directory
Storage. l file assumer il nuovo nome di :e-4ile.t=t.
Esem!io LD
Mnl151c060 Pag. 86/271
7.9.$ +/s'ilelength* 'ile lengh
Questa funzione ritorna la lunghezza in bytes di un file. n :ame occorre definire il nome del file
di cui si vuole conoscere la lunghezza specificando l'intero percorso (Esempio Storage/File.txt).
Se il file indicato non presente, la funzione ritorna -1.
Parametri funzione:
Name (STRNG[32]) Nome del file di cui si vuole conoscere la lunghezza.
(DNT)
Lunghezza file (Bytes). E'4 se file non presente.
Codici di errore
n caso di errore la funzione torna E'4 e con S7sGetLastError possibile rilevare il codice di errore.
Esem+i
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ viene ritornata la lunghezza del file 4ile.t=t presente nella
directory Storage.
Esem!io LD
Mnl151c060 Pag. 87/271
7.9.1 +/s'see* 'ile see
Questa funzione permette di cambiare l'indicatore di posizione dello stream collegato al parametro
4ile, precedentemente aperto dalla funzione S7s>o+en.
'>>set specifica il numero di bytes dall'origine dove andrebbe posizionato l'indicatore di posizione.
'rigin specifica la posizione di origine rispetto alla quale spostare l'indicatore di posizione.
La funzione ritorna il valore attuale dell'indicatore di posizione. n caso di errore di posizionamento,
l'indicatore di posizione rimane inalterato e la funzione ritorna E'4.
Parametri funzione:
-''set (DNT) Numero di bytes dall'origine dove posizionare l'indicatore di posizione
-rigin (NT) Occorre specificare la posizione di origine, 4SeeI origin de>inition.
(NT)
Valore attuale dell'indicatore di posizione. E'4 se errore.
Codici di errore
n caso di errore la funzione torna E'4 e con S7sGetLastError possibile rilevare il codice di errore.
Esem+i
Sul fronte di attivazione dell'ingresso 8i$$&$$ viene posizionato l'indicatore di posizione all'inizio del file 4ile.t=t
presente nella directory Storage.
Esem!io LD
Mnl151c060 Pag. 88/271
7.9.4 +/sDirListing* director/ listing
FB Embedded SFW184A200
Questo blocco funzione esegue il listing di tutti i files contenuti in una directory, occorre
passare il nome della directory di cui eseguire il listing in Pat*:ame. Attivando l'ingresso Init
si inizializza la lista dei files e viene ritornato il primo file trovato. Ad ogni comando :e=t si
esegue la ricerca di un nuovo file nella directory selezionata.
Se file trovato l'uscita 4o9nd si attiva per un loop e ne viene rtornato il nome in 4ile:ame.
Terminato l'elenco di tutti i files presenti nella directory su comando :e=t non viene pi
attivata l'uscita 4o9nd e 4ile:ame abblencato. L'uscita Is8ir si attiva se il nome del file
ritornato quello di una sottodirectory.
Init (BOOL) Alla attivazione viene inizializzato l'indice dei files nella directory indicata e viene ritornato il
nome del primo file trovato.
NeEt (BOOL) Alla attivazione viene ritornato il nome del file puntato dall'indice nella directory indicata.
L'indice si incrementa puntando il successivo file.
)athName (STNG[32]) Definizione directory di cui eseguire il listing. E' possibile definire anche eventuale filtro di
ricerca (Esempio Storage\*.log).
(ound (BOOL) Si attiva per un loop se su comando Init o :e=t stato trovato un nuovo file da listare.
(ault (BOOL) Si attiva per un loop se errore esecuzione.
IsDir (BOOL) Attiva se il nome di file ritornato appartiene ad una sottodirectory.
+ize (UDNT) Dimensione in bytes del file.
.ime (UDNT) Data ultima modifica del file in Epoch time (UTC).
(ileName (STNG[16]) Nome del file comprensivo di eventuale estensione.
Codici di errore
n caso di errore si attiva l'uscita Fault, con S7sGetLastError possibile rilevare il codice di errore.
9952060 Terminato spazio memoria rilocabile, non possibile eseguire l''FB.
9952100 FB richiamata in task fast o slow.
9952200 Errore esecuzione directory listing.
Mnl151c060 Pag. 89/271
Esem+i
Sul fronte di attivazione dell'ingresso digitale 8i$$&$$ viene inizializzato il puntatore ai files presenti nella directory
Storage. Ad ogni attivazione dell'ingresso digitale 8i$1&$$ viene ritornato il nome del file presente nella directory. Se
file presente si attiva per un loop 'I, se si tratta di una sottodirectory si attiva per un loop 8ir.
Esem!io LD
Mnl151c060 Pag. 90/271
7.: (unzioni ed (B !er gestione !orta seriale
sistemi SlimLine dispongono di pi porte seriali in base alla versione del prodotto. Le porte seriali vengono identificate
con un nome del tipo C'&= dove al posto della = vi il numero di porta seriale.
Per la corrispondenza tra il numero di porta ed il connettore fisico ad essa connesso, si rimanda al manuale hardware
del prodotto.
Mnl151c060 Pag. 91/271
7.:.1 +/s0et+erialMode* get serial mode
Questa funzione ritorna il modo di comunicazione impostato sulla porta seriale connessa
al parametro 4ile, precedentemente aperto dalla funzione S7s>o+en.
Nel parametro &ode occorre definire l'indirizzo della struttura S(SSE<I%L&'8E in cui
dovr essere trasferito il modo seriale attualmente impostato sulla porta. La funzione
ritorna 4%LSE in caso di errore.
Parametri funzione:
Mode (@SYSSERALMODE) ndirizzo struttura S(SSE<I%L&'8E in cui trasferire il modo letto.
(BOOL)
4%LSE) Errore esecuzione. T<CE) Funzione eseguita correttamente.
Codici di errore
9995020 ndirizzo struttura S(SSE<I%L&'8E non corretto, verificare &ode.
9995100 1 Errore esecuzione funzione.
Esem!i
Su fronte attivazione ingresso 8i$$&$$ viene salvato il modo impostato sulla porta seriale C'&$ nella variabile Sm e
viene attivata l'uscita 8o$$&$$.
Esem!io +. (PTP116A300, T_'-Ge&eria,2o)e)
3= (=B = *ULL) T:.*
.*DG3=;
(* 5hec? i! the 5,M$ Bort is oBen% *)
3= (=B JK *ULL) T:.*
3= (Di$$M$$ JK 0ulse) T:.*
(* ,n inBut raising edge the serial Eode is read% *)
3= (Di$$M$$) T:.*
Do$$M$$:=SAs-etSerialMode("DR(SE), =B);
.*DG3=;
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 92/271
Mettendo in watch la variabile Sm di tipo S(SSE<I%L&'8E
possiamo vedere i valori di tutti i suoi membri come riportato
nella figura a lato. n questo caso visualizzata la
configurazione di default 111$$, e, 2, 1.
Mnl151c060 Pag. 93/271
7.:.2 +/s+et+erialMode* set serial mode
Questa funzione imposta il modo di comunicazione definito nella struttura
S(SSE<I%L&'8E sulla porta seriale connessa al parametro 4ile, precedentemente
aperto dalla funzione S7s>o+en.
Nel parametro &ode occorre definire l'indirizzo della struttura S(SSE<I%L&'8E in cui
definito il modo seriale da impostare sulla porta. La funzione ritorna 4%LSE in caso di
errore.
Parametri funzione:
Mode (@SYSSERALMODE) ndirizzo struttura S(SSE<I%L&'8E con il modo da impostare.
(BOOL)
Codici di errore
9994020 ndirizzo struttura S(SSE<I%L&'8E non corretto, verificare &ode.
9994050 Errore valore di baud rate.
9994051 Errore valore di parit.
9994052 Errore valore bit di dato.
9994053 Errore valore bit di stop.
9995100 Errore esecuzione funzione.
Esem!i
Su fronte attivazione ingresso 8i$$&$$ viene salvato il modo impostato sulla porta seriale C'&$ nella variabile Sm.
Poi vengono modificati alcuni dati e poi impostata la porta seriale. Viene attivata l'uscita 8o$$&$$.
Esem!io +. (PTP116A300, T_'-e&eria,2o)e)
(* ,n inBut raising edge the serial Eode is changed% *)
3= (Di$$M$$ JK 0ulse) T:.*
3= (Di$$M$$) T:.*
3= (=B = *ULL) T:.* =B:=SAs!oBen(95,M$9, 9rI9); .*DG3=;
Do$$M$$:=SAs-etSerialMode("DR(SE), =B);
SE%Baudrate:=#(+$$;
SE%0aritA:=9*9;
SE%DTRManageEent:=DTRG"UT,G;,GT3M.S;
Do$#M$$:=SAsSetSerialMode("DR(SE), =B);
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 94/271
7.:.$ +et+Mode* +et serial mode
FB PLCUtyLib SFR054A000
Questo blocco funzione esegue impostazione parametri di comunicazione porta
seriale. Occorre passare al blocco funzione il puntatore al file di porta seriale su cui
eseguire l'impostazione dei parametri di comunicazione cosi come viene ritornato
dalla funzione di apertura file S7s>o+en. Per ulteriori chiarimenti sui vari parametri
fare riferimento alla definizione modo comunicazione porta seriale
S(SSE<I%L&'8E.
n caso di errore esecuzione (Esempio definizione di un parametro fuori range) il
valore di impostazione della porta seriale non viene modificato e si attiver l'uscita
4a9lt.
Attivando il modo di funzionamento 8T<E%CT'E?ETI&ES su 8T<&anagement
possibile con il parametro 8T<'nTime, definire un tempo di attesa dopo attivazione
segnale DTR prima della trasmissione dei dati su seriale. Con il parametro
8T<'>>Time possibile definire un tempo di attesa dopo la trasmissione dell'ultimo
dato prima della disattivazione del segnale DTR.
Queste temporizzazioni sula gestione del segnale DTR permettono di gestire in modo automatico apparecchiature
radiomodem, su cui deve essere attivato il comando di trasmissione prima di eseguire l'invio dei dati.
(! (FLEP) Puntatore al file di porta seriale come ritornato da funzione S7s>o+en.
Baudrate (UDNT) Valore di baud rate porta seriale (da 300 a 115200 baud)
)arit/ (STRNG[1]) Tipo di parit, valori possibili "E pari, "O dispari, "N nessuna.
DataBits (USNT) Numero di bit frame dato, valori possibili 7, 8.
+to!Bits (USNT) Numero di bit di stop, valori possibili 1, 2.
D.RManagement (USNT) Modo di gestione del segnale DTR sulla porta seriale, vedi definizione.
D.RCom!lement (BOOL) 4%LSE) DTR normale, T<CE) DTR complementato.
Echo(lush (BOOL) 4%LSE) dati trasmessi sono ritornati in ricezione. T<CE) dati trasmessi sono ignorati.
D.R-n.ime (UNT) Tempo di attesa dopo attivazione segnale DTR prima di trasmissione caratteri (mS).
D.R-''.ime (UNT) Tempo di attesa dopo trasmissione ultimo dato prima e disattivazione segnale DTR (mS).
Done (BOOL) mpostazione modo eseguito correttamente.
(ault (BOOL) Errore su esecuzione blocco funzione
Codici di errore
10006010 Lettura modo corrente in errore la funzione S7sGetSerial&ode ritornata con errore probabilmente
non stato indicato correttamente il file pointer 4+.
10006020 mpostazione modo in errore la funzione S7sSetSerial&ode ritornata con errore probabilmente uno
dei parametri definiti non nel range corretto.
Mnl151c060 Pag. 95/271
Esem!i
Al primo loop di esecuzione programma viene aperta la porta seriale C'&$, viene impostato il modo di comunicazione
19200, e, 8, 1. Ogni secondo viene inviato sulla porta seriale il carattere 'A' codice ascii 16#41.
Esem!io LD (PTP11.A000, en)C4ara1&er)
Mnl151c060 Pag. 96/271
7.:.1 +/s0et+erialC.+* get serial C.+ signal status
Questa funzione ritorna lo stato del segnale CTS della porta seriale connessa al parametro
4ile, precedentemente aperto dalla funzione S7s>o+en.
Parametri funzione:
(BOOL)
4%LSE) Segnale CTS non attivo. T<CE) Segnale CTS attivo.
Codici di errore
Esem!i
Lo stato del segnale CTS della porta seriale C'&$ appoggiato sull'uscita 8o$1&$$.
Esem!io LD
Mnl151c060 Pag. 97/271
7.:.4 +/s+et+erialD.R* set D.R signal status
Questa funzione imposta lo stato del segnale 8T< della porta seriale connessa al
Per poter gestire il segnale DTR occorre avere definito sulla porta seriale il valore
8T<E'44 nella variabile 8T<&anagement nella struttura S(SSE<I%L&'8E.
Parametri funzione:
+tatus (BOOL) Stato segnale DTR su porta seriale
(BOOL)
4%LSE) Errore esecuzione. T<CE) Ok esecuzione.
Codici di errore
Esem!i
Lo stato dell'ingresso 8i$$&$$ viene trasferito sul segnale DTR della porta seriale C'&$.
Esem!io LD
Mnl151c060 Pag. 98/271
7.1%(unzioni ed (B !er gestione CAN bus
l Controller Area Network, noto anche come CAN-bus, uno standard seriale per bus di campo di tipo multicast, per
collegare diverse unit di controllo elettronico (ECU). l CAN stato espressamente progettato per funzionare senza
problemi anche in ambienti fortemente disturbati dalla presenza di onde elettromagnetiche e pu utilizzare come mezzo
trasmissivo una linea a differenza di potenziale bilanciata come la RS-485. L'immunit ai disturbi EMC pu essere
ulteriormente aumentata utilizzando cavi di tipo twisted pair (doppino intrecciato).
Sebbene inizialmente applicata in ambito automotive, come bus per autoveicoli, attualmente usata in molte
applicazioni industriali di tipo embedded, dove richiesto un alto livello di immunit ai disturbi. l bit rate pu
raggiungere 1 Mbit/s per reti lunghe meno di 40 m. Velocit inferiori consentono di raggiungere distanze maggiori (ad
es. 125 kbit/s per 500 m). l protocollo di comunicazione del CAN standardizzato come SO 11898-1 (2003).
Mnl151c060 Pag. 99/271
7.1%.1 +/sCAN+etMode* set the CAN controller mode
Questa funzione imposta il modo sul controller CAN. E' possibile definire il valore di bit
rate, il filtro e la maschera di accettazione pacchetti.
La funzione ritorna TRUE se eseguita correttamente, FALSE se errore.
Parametri funzione:
BitRate (USNT) Valore definizione bit rate CAN bus, C%: ;it rate de>inition.
(ilter (UDNT) Valore di filtro pacchetti CAN.
Mas (UDNT) Valore di maschera filtro pacchetti CAN.
(BOOL)
T<CE) Eseguita correttamente.
4%LSE) n caso di errore esecuzione, esempio parametri errati.
Codici di errore
9957005 Funzione non supportata.
Esem!i
E' riportato un semplice programma che esegue l'impostazione del controller CAN con bit rate a 125 Kbit. Tutti i
pacchetti in arrivo sono ricevuti dal controller.
Esem!io LD
Mnl151c060 Pag. 100/271
7.1%.2 +/sIsCANRE.EA3* checs i' CAN RE or .E is a3ailable
Questa funzione controlla:
Select)F4%LSE) Se vi almeno un messaggio nel buffer di ricezione CAN.
Select)FT<CE) Se vi spazio per un messaggio nel buffer di trasmissione CAN.
La funzione ritorna TRUE se la condizione selezionata vera.
Parametri funzione:
+elect (BOOL) 4%LSE) Se vi almeno un messaggio nel buffer di ricezione CAN.
T<CE) Se vi spazio per un messaggio nel buffer di trasmissione CAN.
(BOOL)
T<CE) Condizione selezionata vera.
Codici di errore
Esem!i
E' riportato un semplice programma che esegue il controllo se un messaggio CAN stato ricevuto, ne esegue la
ricezione ed invia in uscita sulla porta seriale C'&$ la struttura del messaggio ricevuto.
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;

(* :ere chec? i! a 5"* Eessage is a@ailable and recei@e it% *)
3= (SAs3s5"*RMTM"@(="LS.)) T:.*
3= (SAs5"*RMMsg(#7T$$$$$$$$, #7T$$$$$$$$, "DR(5"*Msg))) T:.*
*r,!5hars:=SAs8ar!Brint!(=B, 9Length:P$6dQrQn9, US3*TGTO0., "DR(5"*Msg%Length));
*r,!5hars:=SAs8ar!Brint!(=B, 9Msg3D:P$6dQrQn9, UD3*TGTO0., "DR(5"*Msg%Msg3D));
*r,!5hars:=SAs8ar!Brint!(=B, 9DataC$D:P$+/QrQn9, UD3*TGTO0., "DR(5"*Msg%DataC$D));
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 101/271
7.1%.$ +/sCANREMsg* recei3es a CAN message
Questa funzione riceve un messaggio CAN e lo trasferisce nella variabile il cui indirizzo
definito in &sg. E' possibile definire un &asI ed un I8 per ricevere i soli messaggi CAN
desiderati.
La funzione ricerca nello stack dei messaggi un messaggio il cui D posto in AND con &asI
coincide con I8 messo in AND con &asI. La funzione ritorna TRUE se messaggio ricevuto.
Parametri funzione:
Mas (UDNT) Codice maschera D messaggio.
ID (UDNT) D check D messaggio.
Msg (@SYSCANMESSAGE) ndirizzo buffer messaggio ricevuto.
(BOOL)
T<CE) Messaggio ricevuto.
Codici di errore
Esem!i
E' riportato un semplice programma che esegue la ricezione di qualsiasi messaggio CAN ed esegue l'invio in uscita
sulla porta seriale C'&$ della struttura del messaggio ricevuto.
Esem!io +.
3= (=B = *ULL) T:.*
.*DG3=;

(* :ere recei@e a 5"* Eessage% *) *)
3= (SAs5"*RMMsg(#7T)=======, #7T$$$$$$$$, "DR(5"*Msg))) T:.*
*r,!5hars:=SAs8ar!Brint!(=B, 9Length:P$6dQrQn9, US3*TGTO0., "DR(5"*Msg%Length));
*r,!5hars:=SAs8ar!Brint!(=B, 9Msg3D:P$6dQrQn9, UD3*TGTO0., "DR(5"*Msg%Msg3D));
*r,!5hars:=SAs8ar!Brint!(=B, 9DataC$D:P$+/QrQn9, UD3*TGTO0., "DR(5"*Msg%DataC$D));
.*DG3=;
Mnl151c060 Pag. 102/271
7.1%.1 +/sCAN.EMsg* transmit a CAN message
Questa funzione trasmette un messaggio CAN, occorre creare il messaggio e poi passarne alla
funzione l'indirizzo in &sg.
La funzione ritorna TRUE se messaggio trasmesso.
Parametri funzione:
Msg (@SYSCANMESSAGE) ndirizzo buffer messaggio da trasmettere.
(BOOL)
T<CE) Messaggio trasmesso.
Codici di errore
Esem!i
E' riportato un semplice programma che esegue la trasmissione di un messaggio CAN.
Esem!io +.
(* :ere chec? i! there is a sBace in TM bu!!er and send a 5"* Eessage% *)
3= (SAs3s5"*RMTM"@(TRU.)) T:.*
5"*Msg%REReF:=="LS.; (* e="LS.:Data !raEe, eTRU.:ReEote reFuest *)
5"*Msg%Length:=+; (* Data length *)
5"*Msg%Msg3D:=#7T$$$$$$$$; (* Message 3D (==:Bit )#) (## or +( Bit) *)
5"*Msg%DataC$D:=#7T$#; (* Message data *)
5"*Msg%DataC#D:=#7T$$; (* Message data *)
TM,?:=SAs5"*TMMsg("DR(5"*Msg)); (* TransEission ,? *)
.*DG3=;
Mnl151c060 Pag. 103/271
7.11 (unzioni ed (B !er gestione stringhe
7.11.1 eLEN* string length
Function ePLCStdLib SFR053A200
Questa funzione ritorna la lunghezza (Espressa in numero di caratteri) della stringa definita in Str.
Parametri funzione:
+tr (@USNT) Pointer alla stringa di cui calcolare lunghezza.
(NT)
Numero di caratteri della stringa.
Esem!i
Viene calcolata la lunghezza della stringa OPello@O ed il numero di caratteri che compongono la stringa viene trasferito
nella variabile Lengt*. l risultato del calcolo 6.
Esem!io LD
Mnl151c060 Pag. 104/271
7.11.2 e(IND* string 'ind
Function ePLCStdLib SFR053A200
Questa funzione cerca la posizione del carattere di inizio della prima apparizione di In1 in In1. Se
nessuna apparizione viene trovata, la funzione ritorna $.
Se la stringa In1 trovata nella stringa In1, viene ritornata la posizione dove si trova.
Esempio: e4I:8!In1)FOa;cdO, In1)FO;cO#. Ha come risultato 1.
Parametri funzione:
In1 (@USNT) Pointer alla stringa dove effettuare la ricerca.
In1 (@USNT) Pointer alla stringa da ricercare.
(NT)
Posizione dove la stringa In1 stata trovata. $ se stringa non trovata.
Esem!i
Viene eseguita la ricerca della stringa OloO nella stringa OPello -orld@O. La posizione trovata 4 e viene trasferita nella
variabile Position.
Esem!io +.
(* =ind the Bosition Ihere is StrTo=ind in StrSource% *)
StrSource:=9:ello Iorld<9;
StrTo=ind:=9lo9;
0osition:=e=3*D("DR(StrSource), "DR(StrTo=ind));
Mnl151c060 Pag. 105/271
7.11.$ Mem+et* memor/ set
Questa funzione trasferisce in B9>>er il valore definito in Val9e per il numero di bytes definito in
Size.
La funzione ritorna il numero definito in Size.
Parametri funzione:
Bu''er (@USNT) Pointer al buffer di memoria dove trasferire Val9e.
2alue (USNT) Valore da trasferire nel buffer di memoria.
+ize (UDNT) Numero di volte in cui Val9e trasferito in B9>>er.
(UDNT)
Valore definito in Size.
Esem!i
Viene eseguito l'azzeramento di tutti i bytes della stringa StrB9>>er scrivendo il valore $ in tutta la sua lunghezza.
Esem!io +.
(* The 9StrBu!!er9 @ariable is set to 9$9% *)
Ret8alue:=MeESet("DR(StrBu!!er), $, )+); (* Return @alue *)
Mnl151c060 Pag. 106/271
7.11.1 MemCo!/* memor/ co!/
Questa funzione copia al massimo il numero di bytes definito in Size a partire dall'area di
memoria a cui punta So9rce, verso l'area che inizia da 8estination.
La funzione ritorna il numero definito in Size.
Parametri funzione:
Destination (@USNT) Pointer al buffer di memoria di destinazione.
+ource (@USNT) Pointer al buffer memoria sorgente.
+ize (UDNT) Numero di bytes da trasferire.
(UDNT)
Valore definito in Size.
Esem!i
Viene eseguita la copia della stringa SString nella stringa 8String. Al termine la stringa risultante sar "HelloHello.
Esem!io +.
(* The 9SString9 is coBied tIice into 9DString9% *)
Ret8alue:=MeE5oBA("DR(DString), "DR(SString), S3W.,=(SString)); (* Return @alue *)
Ret8alue:=MeE5oBA("DR(DString)LL.*(DString), "DR(SString), S3W.,=(SString)); (* Return @alue *)
Mnl151c060 Pag. 107/271
7.11.4 +/s2arsn!rint'* 3ariable !rint to string
Questa funzione trasferisce in String la stampa formattata di una variabile. l valore
stampato ritornato nella variabile stringa non pu superare la lunghezza definita in Size.
La stringa 4ormat specifica il formato con il quale stampare la variabile. Mentre in VarT7+e
La funzione ritorna il numero di caratteri trasferiti nella variabile String. EOF in caso di
errore.
Parametri funzione:
+tring (@USNT) Pointer all'array dove deve essere trasferito il risultato della stampa.
+ize (UNT) Numero di caratteri da trasferire nella variabile String. l numero definito comprensivo del codice di
fine stringa '\0'. Se la lunghezza della stringa di output supera il limite di Size byte, viene troncata al
numero di byte indicato.
(ormat (STRNG[80]) Ha due tipi di argomenti, i caratteri ordinari che vengono copiati nella variabile String di uscita, e le
(NT)
Numero di caratteri comprensivo codice fine stringa '\0' trasferiti in variabile String.
E'4) Errore esecuzione.
Codici di errore
9997200 l valore di Size limita la formattazione della stringa in uscita.
Esem!i
Su fronte attivazione ingresso 8i$$&$$ viene incrementata la variabile Co9nter e la stampa del suo valore trasferita
nell'array String'9t. l valore presente in String'9t viene poi inviato sulla porta seriale C'&$. Nella variabile
:r'>C*ars viene caricato il numero di caratteri trasferiti in String'9t ed inviati in uscita sulla porta seriale.
Esem!io +. (PTP116A100, T_'-5ar-n0rin&3)
3= (=B = *ULL) T:.*
.*DG3=;
(* 5hec? i! the 5,M$ Bort is oBen% *)
3= (=B JK *ULL) T:.*
Mnl151c060 Pag. 108/271
3= (Di$$M$$ JK 0ulse) T:.*
(* ,n inBut raising edge the counter @alue is Brinted% *)
3= (Di$$M$$) T:.*
*r,!5hars:=SAs8arsnBrint!("DR(String,ut), )+, 95ounter:P$6dQrQn9, UD3*TGTO0., "DR(5ounter));
(* 5oBA the Brinted result to serial Bort% *)
=,R i:=$ T, *r,!5hars D, 5h:=SAs!Butc(T,G3*T(String,utCiD), =B); .*DG=,R;
.*DG3=;
.*DG3=;
.*DG3=;
n questo esempio viene eseguito il merge tra le stampe del valore di due variabili. Eseguire il merge pu essere molto
utile per avere un unica stringa contenente la stampa del valore di piu variabili.
Mettendo in debug la variabile <es9lt vedremo la stringa VarQ$R)11 VarQ1R)30. Avendo bloccato la stampa a 12 caratteri
il valore di VarQ$R sar stampato correttamente fino ad un massimo di 4 cifre (7 caratteri stringa, 4 caratteri valore pi
terminatore stringa '\0'). Per valori di VarQ$R superiori a 9999 non saranno pi stampate le cifre meno significative.
l valore di VarQ1R sar stampato immediatamente dopo il valore di VarQ$R. Da notare l'offset decrementato di 1 per
sovrascrivere il terminatore stringa '\0'. Per garantire la stampa di un massimo di 4 anche per VarQ1R stato definito un
Size di 13, la stringa di testo inizia infatti con un carattere di space per separarla dalla stampa del valore della variabile
precedente.
Esem!io +.
(* *)
(* ./.5UT. " 8"R3"BL.S 0R3*T M.R-. *)
(* *)
(* 0rint the @ariable @alues, Eerging theE into a single string% *)
*r,!5hars:=SAs8arsnBrint!("DR(Result), #+, 98arC$D:Pd9, UD3*TGTO0., "DR(8arC$D));
*r,!5hars:=SAs8arsnBrint!("DR(ResultCL.*(Result)D), #), 9 8arC#D:Pd9, UD3*TGTO0., "DR(8arC#D));
(* C.nd o! !ileD *)
Mnl151c060 Pag. 109/271
7.11.6 +/s2arsscan'* eEtracts 3alues 'rom string
Questa funzione legge la stringa String e ne interpreta il contenuto basandosi sul parametro
4ormat.
La stringa 4ormat specifica il formato con il quale interpretare la variabile, in VarT7+e
La funzione ritorna TRUE se valore variabile trovato, in caso contrario FALSE.
Parametri funzione:
+tring (@USNT) Pointer alla stringa da leggere.
(ormat (STRNG[80]) Ha due tipi di argomenti, i caratteri ordinari che vengono copiati nella variabile String di uscita, e le
(BOOL)
T<CE) Valore variabile acquisito.
Codici di errore
n caso di errore la funzione torna con 4%LSE e con S7sGetLastError possibile rilevare il codice di errore.
Esem!i
E' riportato un programma che esegue la lettura di una stringa In+9tString valorizzata con il testo Val9e)113. Su fronte
attivazione ingresso 8i$$&$$ sono eseguite tre diverse funzioni S7sVarsscan> tutte sulla stringa In+9tString ma con
diverse definizioni di 4ormat. Le prime due hanno esito positivo e le variabili Varia;leQ$R e Varia;leQ1R saranno
valorizzate con il valore 113. La terza avr esito negativo, la variabile Varia;leQ1R sar azzerata.
Esem!io +. (PTP116A600, T_'-5ar--1an3)
3= (Di$$M$$ JK 0ulse) T:.*
3= (Di$$M$$) T:.*
ResultC$D:=SAs8arsscan!("DR(3nButString), 98alue:Pd9, UD3*TGTO0., "DR(8ariableC$D));
ResultC#D:=SAs8arsscan!("DR(3nButString)L7, 9Pd9, UD3*TGTO0., "DR(8ariableC#D));
ResultC+D:=SAs8arsscan!("DR(3nButString), 9Pd9, UD3*TGTO0., "DR(8ariableC+D));
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 110/271
7.12(unzioni ed (B !er gestione moduli !eri'erici
7.12.1 +/s)hrIn'os* get in'os 'rom !eri!heral modules
Funzione Embedded 5.0
Questa funzione esegue l'acquisizione di informazioni dai moduli periferici. Viene trasferita nella
variabile stringa il cui indirizzo passato in In>o, l'informazione indicata da In>oI8 relativa al
modulo indicato in &od9le.
La funzione ritorna T<CE se correttamente eseguita, in caso contrario 4%LSE.
Parametri funzione:
Module (USNT) Occorre specificare l'indirizzo di modulo da cui eseguire l'acquisizione (Range da 0 a 15). l valore 0
indica il primo modulo di estensione, 1 il secondo e cos di seguito.
In'oID (USNT) Occorre specificare l'D della informazione richiesta.
2alue Descri!tion
0 Ritorna codice prodotto
1 Ritorna codice programma
In'o (STRNG[10]) ndirizzo variabile dove trasferire l'informazione.
(BOOL)
Codici di errore
n caso di errore la funzione torna con 4%LSE e con S7sGetLastError possibile rilevare il codice di errore.
9990100 l modulo indirizzato in &od9le non presente.
9990110 l valore di In>oI8 non corretto.
9990200 L'informazione richiesta non supportata dal modulo.
9990210 Errore durante la richiesta della informazione dal modulo.
Esem!i
E' riportato un programma che esegue la lettura del codice prodotto dal modulo di estensione con indirizzo 0. l codice
ritornato trasferito nella variabile In>o. l ritorno della funzione trasferito sull'uscita 8o$1&$$.
Esem!io LD
Mnl151c060 Pag. 111/271
7.12.2 +/s0et)hrDI* get !eri!heral digital in!ut
FB Embedded 3.0
Questo blocco funzione esegue l'acquisizione degli ingressi digitali dai moduli periferici. l blocco
funzione ritorna lo stato degli ingressi digitali dal modulo indicato in %ddress in base al comando di
&ode definito.
Per acquisire gli ingressi digitali presenti sul modulo CPU occorre definire %ddress 255 e &ode
D_8_LL.
Address (USNT) Occorre specificare l'indirizzo di modulo da cui eseguire l'acquisizione degli ingressi digitali (Range
da 0 a 255). l valore 0 indica il primo modulo di estensione, 1 il secondo e cos di seguito. L'indirizzo
255 indica il modulo CPU.
Mode (USNT) Occorre specificare il modo di acquisizione ingressi digitali, 8igital in+9t mode.
Done (BOOL) Dato acquisito, viene attivato se acquisizione ingressi digitali terminata.
(ault (BOOL) Errore di acquisizione, viene attivato in caso di errore nella sequenza di acquisizione.
2alue (UDNT) Ritorna lo stato degli ingressi digitali acquisiti.
Codici di errore
9985100 l modulo indirizzato in %ddress non presente.
9985110~24 l modo acquisizione definito in &ode non corretto.
9985200~13 Errore durante l'esecuzione della lettura ingressi dal modulo periferico.
Mnl151c060 Pag. 112/271
Esem!i
Viene acquisito lo stato degli 8 ingressi bassi (Da np 0 a np 7) del modulo di con indirizzo 0. Se dato valido viene
attivata la variabile 4B8one se errore di acquisizione viene attivata la variabile 4B4a9lt. l valore acquisito nel range da
0x00 a 0xFF trasferito nella variabile In+Val9e.
Esem!io LD (PTP116A100, LD_'-Ge&P4rDI)
Esem!io IL (PTP116A100, IL_'-Ge&P4rDI)
(* Read 3nB $ to 1 !roE Eodule Iith address $% *)
LD $
ST =BData%"ddress

LD D3G2GLL
ST =BData%Mode

5"L =BData

LD =BData%8alue
ST 3nB8alue
Esem!io +. (PTP116A100, T_'-Ge&P4rDI)
(* Read 3nB $ to 1 !roE Eodule Iith address $% *)
=BData%"ddress:=$;
=BData%Mode:=D3G2GLL;
=BData(); (* .Mecute =B *)
3nB8alue:==BData%8alue; (* Digital inBut @alue *)
Mnl151c060 Pag. 113/271
Questo esempio una evoluzione dell'esempio precedente. Utilizzando il blocco funzione B7teToBit lo stato degli 8
ingressi bassi (Da np 0 a np 7) del modulo con indirizzo 0, appoggiato su di un array di BOOL.
Esem!io LD (PTP11.A000, Logi1In0*&A17*i-i&ion)
Mnl151c060 Pag. 114/271
7.12.$ +/s+et)hrD-* set !eri!heral digital out!ut
FB Embedded 3.0
Questo blocco funzione esegue impostazione delle uscite digitali sui moduli periferici indirizzati con
%ddress ed in base al comando di &ode definito.
Per gestire le uscite digitali presenti sul modulo CPU occorre definire %ddress 255 e &ode
DO_8_LL. Si raccomanda di utilizzare in alternativa il blocco funzione CPC&od9leI'.
Address (USNT) Occorre specificare l'indirizzo del modulo su cui eseguire l'impostazione delle uscite digitali (Range
Mode (USNT) Occorre specificare il modo di gestione uscite digitali, 8igital o9t+9t mode.
2alue (UDNT) mpostare il valore da trasferire sulle uscite digitali.
Done (BOOL) Dato settato. Viene attivato per un loop al termine del settaggio delle uscite digitali.
(ault "B--L# Errore. Viene attivato in caso di errore nella sequenza di settaggio.
Codici di errore
9984110~8 l modo gestione definito in &ode non corretto.
9984200~6 Errore durante l'esecuzione gestione uscite digitali sul modulo periferico.
Mnl151c060 Pag. 115/271
Esem!i
Viene trasferito il valore della variabile '9tVal9e sulle 8 uscite basse (Da Out 0 a Out 7) del modulo con indirizzo 0.
Esem!io LD (PTP116A100, LD_'-e&P4rD!)
Esem!io IL (PTP116A100, IL_'-e&P4rD!)
(* Manage digital outButs ,ut $ to ,ut 1 on Eodule Iith address $% *)
LD $
ST =BData%"ddress
LD D,G2GLL
ST =BData%Mode
LD ,ut8alue
LD =BData%8alue
5"L =BData
Esem!io +. (PTP116A100, T_'-e&P4rD!)
(* Manage digital outButs ,ut $ to ,ut 1 on Eodule Iith address $% *)
=BData%"ddress:=$;
=BData%Mode:=D,G2GLL;
=BData%8alue:=,ut8alue; (* Digital ouBut @alue *)
=BData(); (* .Mecute =B *)
Mnl151c060 Pag. 116/271
Questo esempio una evoluzione dell'esempio precedente. Utilizzando il blocco funzione BitToB7te un array di 8
BOOL trasferito in uscita sulle 8 uscite basse (Da Out 0 a Out 7) del modulo con indirizzo 0.
Esem!io LD (PTP11.A000, Logi1!*&0*&2anagemen&)
Mnl151c060 Pag. 117/271
7.12.1 +/s0etAnIn!* get analog in!ut
FB Embedded 3.0
Questo blocco funzione esegue l'acquisizione dell'ingresso analogico dal modulo di acquisizione.
l blocco funzione gestisce vari modi di acquisizione in funzione del modulo analogico a cui fa
riferimento.
Per acquisire gli ingressi digitali presenti sul modulo CPU occorre definire %ddress 255 e &ode
AD_VOLT_0_10_COMMON.
Address (USNT) Occorre specificare l'indirizzo di modulo da cui eseguire l'acquisizione degli ingressi digitali (Range
Channel (USNT) Occorre specificare l'indirizzo del canale sul modulo (Range da 0x00 a 0x0F). Se viene settato un
indirizzo di canale non presente, si interrompe l'esecuzione e viene settato il bit di 4a9lt.
Mode (USNT) Occorre specificare il modo di acquisizione analogica, %nalog to digital mode.
Done (BOOL) Dato analogico acquisito, viene attivato al termine della acquisizione analogica.
2alue (REAL) Ritorna il valore di acquisizione espresso nella unit definita dal modo di acquisizione. Potrebbe
essere un valore NaN (Not A Number) ad indicare un problema nell'acquisizione, tipicamente
sensore rotto.
Codici di errore
9983080 mpossibile inizializzare il modulo.
9983110~1 l modulo indirizzato non supporta i comandi acquisizione analogica.
9983150 l valore ritornato dal modulo analogico non corretto.
9983200 l modo di acquisizione definito in &ode non gestito dal modulo.
9983210 Errore nella acquisizione analogica dal modulo.
9983300 l canale definito in C*annel non gestito dal modulo.
Mnl151c060 Pag. 118/271
Esem!i
Viene eseguita l'acquisizione analogica dal canale 0 del modulo 0 in modo 0-10 Volt. Se dato valido viene attivata
l'uscita digitale 8o$$&$$ se errore di conversione viene attivata l'uscita digitale 8o$1&$$. l dato analogico acquisito
nel range da 0.000 a 9.999 trasferito nella variabile %naIn+.
Esem!io LD (PTP116A100, LD_'-Ge&AnIn0)
Esem!io IL (PTP116A100, IL_'-Ge&AnIn0)
(* "cFuires analog inBut $ !roE Eodule% *)
LD $
ST =BData%"ddress (* Set Eodule address *)
LD $
ST =BData%5hannel (* Set channel *)
LD "DG8,LTG$G#$G5,MM,*
ST =BData%Mode (* Set acFuisition Eode *)

5"L =BData (* 5all the SAs-et"n3nB !unction bloc? *)
LD =BData%Done
ST Do$$M$$ (* The outBut is acti@e i! data is acFuired *)
LD =BData%=ault
ST Do$#M$$ (* The outBut is acti@e i! eMecution !ault *)
LD =BData%8alue
ST "na3nB (* Store the acFuired @alue *)
Esem!io +. (PTP116A100, T_'-Ge&AnIn0)
(* "cFuires analog inBut $ !roE Eodule% *)
=BData("ddress:=$, 5hannel:=$, Mode:="DG8,LTG$G#$G5,MM,*); (* 5all the SAs-et"n3nB =B *)
Do$$M$$:==BData %Done; (* The outBut is acti@e i! data is acFuired *)
Do$#M$$:==BData %=ault; (* The outBut is acti@e i! eMecution !ault *)
8arReal:==BData %8alue; (* Store the acFuired @alue *)
Mnl151c060 Pag. 119/271
7.12.4 +/s+etAn-ut* set analog out!ut
FB Embedded 3.0
Questo blocco funzione esegue il set del valore sull'uscita analogica sul modulo di uscita. l
blocco funzione gestisce vari modi di uscita in funzione del modulo analogico a cui fa riferimento.
Address (USNT) Occorre specificare l'indirizzo del modulo su cui settare il valore analogico (Range da 0x00 a 0x0F).
l valore 0x00 indica il primo modulo di estensione, 0x01 il secondo e cos di seguito.
Channel (USNT) Occorre specificare l'indirizzo del canale sul modulo (Range da 0x00 a 0x0F). Se viene settato un
indirizzo di canale non presente, si interrompe l'esecuzione e viene settato il bit di 4a9lt.
Mode (USNT) Occorre specificare il modo di gestione uscita analogica, 8igital to analog mode.
2alue (REAL) Occorre specificare il valore di uscita espresso nella unit definita dal modo di gestione.
Done (BOOL) Dato settato. Viene attivato per un loop al termine del settaggio dell'uscita analogica.
(ault (BOOL) Errore. Viene attivato in caso di errore nella sequenza di settaggio.
Codici di errore
9982110~1 l modulo indirizzato non supporta i comandi uscita analogica.
9982150 l valore da impostare sul modulo analogico non corretto.
9982200 l modo di gestione definito in &ode non gestito dal modulo.
9982210 Errore nella gestione uscita analogica sul modulo.
Mnl151c060 Pag. 120/271
Esem!i
Viene eseguita l'uscita analogica dal canale 0 del modulo 0 in modo 0-10 Volt. Se dato valido viene attivata l'uscita
digitale 8o$$&$$ se errore di conversione viene attivata l'uscita digitale 8o$1&$$. l dato analogico da impostare in
uscita nel range da 0.000 a 9.999 presente nella variabile %na'9t.
Esem!io LD (PTP116A100, LD_'-e&An!*&)
Esem!io IL (PTP116A100, IL_'-e&An!*&)
(* Manage analog outBut $ on Eodule $% *)
LD $
LD $
LD D"G8,LTG$G#$
ST =BData%Mode (* Set EanageEent Eode *)
LD "na,ut
ST =BData%8alue (* Store the outBut @alue *)
5"L =BData (* 5all the SAsSet"n,ut !unction bloc? *)
LD =BData%Done
ST Do$$M$$ (* The outBut is acti@e i! data is set *)
LD =BData%=ault
Esem!io +. (PTP116A100, T_'-e&An!*&)
(* Manage analog outBut $ on Eodule $% *)
=BData%8alue:="na,ut; (* Store the ouBut @alue *)
=BData("ddress:=$, 5hannel:=$, Mode:=D"G8,LTG$G#$); (* 5all the SAsSet"n,ut !unction bloc? *)
Do$$M$$:==BData%Done; (* The outBut is acti@e i! data is set *)
Do$#M$$:==BData%=ault; (* The outBut is acti@e i! eMecution !ault *)
Mnl151c060 Pag. 121/271
7.12.6 +/s0etCounter* get counter
FB Embedded 5.0
Questo blocco funzione esegue la lettura di un contatore. l blocco funzione pu essere utilizzato per
acquisire il valore del contatore presente sul modulo CPU SlimLine e dai moduli che gestiscono la
funzione contatore.
E' prevista la gestione del reset valore di conteggio e della inversione conteggio. n base alla
definizione di &ode possibile gestire conteggio su fronte positivo, negativo o su entrambi i fronti
dell'ingresso clock del contatore. Se il modulo che gestisce il contatore lo prevede possibile anche
definire comandi hardware (ngressi logici) di reset conteggio e di inversione conteggio.
Address (USNT) Occorre specificare l'indirizzo di modulo da cui eseguire l'acquisizione counter (Range da 0 a 255). l
valore 0 indica il primo modulo di estensione, 1 il secondo e cos di seguito.
L'indirizzo 255 indica il modulo CPU.
Se viene settato un indirizzo di modulo non presente, si interrompe l'esecuzione e viene settato il bit
di 4a9lt.
Channel (USNT) Occorre specificare l'indirizzo del canale sul modulo (Range da 0 a 15).
Se viene settato un indirizzo di canale non presente, si interrompe l'esecuzione e viene settato il bit
di 4a9lt.
Mode (UDNT) Modo acquisizione, espresso su 32 bit secondo lo schema riportato.
Cloc
nput Definisce ingresso logico da utilizzare come clock
Mode 0: Conta su fronte salita
1: Conta su fronte discesa
2: Conta su entrambi i fronti
Reset
nput Definisce ingresso logico da utilizzare come reset
Mode 0: Non utilizzato ingresso di reset
1: Reset counter se ingresso attivo
2: Reset conter se ingresso non attivo
Re3erse
nput Definisce ingresso logico da utilizzare come inversione conteggio
Mode 0: Non utilizzato ingresso di reverse
1: nverte conteggio counter se ingresso attivo
2: nverte conteggio conter se ingresso non attivo
Per calcolare il valore di mode si applica la formula:
!!<eDerse mode#G1$/311#H!!<eDerse in+9t#G636#H!!<eset mode#G21/1#H!!<eset in+9t#G16#H!!ClocI mode#G31#H!ClocI in+9t#
Se viene settato un valore non corretto, si interrompe l'esecuzione e viene settato il bit di 4a9lt.
RCount (BOOL) Reverse counting, attivando questo ingresso Val9e viene decrementato ad ogni variazione di
conteggio.
Reset (BOOL) Attivando questo ingresso si ha il reset del valore di conteggio Val9e.
Done (BOOL) Dato counter acquisito, viene attivato per un loop al termine della acquisizione counter.
2alue (UDNT) Valore contatore.
Mnl151c060 Pag. 122/271
31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00
nput Mode
Clock Reset Reverse
nput Mode nput Mode
Codici di errore
9981110 l canale definito in C*annel non gestito.
9981200~1 l modo di gestione definito in &ode non gestito dal modulo.
9981210 Errore nella gestione lettura counter dal modulo.
Esem!i
Viene eseguita l'acquisizione del contatore dal modulo CPU di SlimLine, viene eseguito il conteggio su entrambi i fronti
dell'ingresso di clock. l valore di conteggio trasferito nella variabile Val9e. Su fine conversione viene attivata l'uscita
digitale 8o$1&$$ se errore di conversione viene attivata l'uscita digitale 8o$1&$$.
Attivando l'ingresso 8i$$&$$ viene eseguita l'inversione del conteggio ad ogni variazione dell'ingresso di clock viene
decrementato il valore di Val9e in uscita.
Attivando l'ingresso 8i$1&$$ viene eseguito il reset del conteggio il valore di Val9e in uscita resettato.
Esem!io LD
Mnl151c060 Pag. 123/271
7.12.7 +/s0etEncoder* get encoder in!ut
FB Embedded 3.0
Questo blocco funzione esegue la lettura di un canale encoder. l blocco funzione pu essere
utilizzato solo su sistemi che hanno moduli in grado di acquisire encoders incrementali.
E' prevista la gestione della tacca di zero e la possibilit di acquisire valori di quota all'interno di un
segnale logico di gate.
Address (USNT) Occorre specificare l'indirizzo di modulo da cui eseguire l'acquisizione encoder (Range da 0 a 15). l
valore 0 indica il primo modulo di estensione, 1 il secondo e cos di seguito.
Se viene settato un indirizzo di modulo non presente, si interrompe l'esecuzione e viene settato il bit
di 4a9lt.
Channel (USNT) Occorre specificare l'indirizzo del canale sul modulo (Range da 0 a 15).
Se viene settato un indirizzo di canale non presente, si interrompe l'esecuzione e viene settato il bit
di 4a9lt.
RCount (BOOL) Reverse counting, attivando questo ingresso si inverte l'incremento di quota E69ote in funzione
della direzione di rotazione encoder.
FeroEn (BOOL) Attivando questo ingresso si ha il reset della quota E69ote al passaggio della tacca di zero encoder.
0ateEn (BOOL) Attivando questo ingresso sul fronte di variazione dell'ingresso di Gate viene trasferito il valore di
E69ote in G69ote.
R0ate (BOOL) Attivando questo ingresso viene gestito il fronte di disattivazione dell'ingresso Gate.
Done (BOOL) Dato encoder acquisito, viene attivato per un loop al termine della acquisizione encoder.
FeroD (BOOL) Tacca di zero encoder acquisita, viene settata su acquisizione tacca di zero encoder, si resetta
disattivando l'ingresso "eroEn.
0ateD (BOOL) Segnale di Gate acquisito, viene attivato per un loop alla acquisizione del segnale Gate.
0=uote (UNT) Quota di gate, valore di quota encoder E69ote memorizzata sul fronte selezionato del segnale
Gate.
E=uote (UNT) Quota encoder, valore di quota encoder, al raggiungimento del valore minimo o massimo viene
eseguito il roll over.
Codici di errore
9980110~2 l modulo indirizzato non supporta i comandi acquisizione encoder.
9980200 l modo di gestione definito in &ode non gestito dal modulo.
9980210~2 Errore nella gestione lettura encoder dal modulo.
Mnl151c060 Pag. 124/271
Esem!i
Viene eseguita l'acquisizione dell'ingresso encoder dal canale 0 del modulo 0, il valore di quota encoder trasferito
nella variabile Encoder6te. Su fine conversione viene attivata l'uscita digitale 8o$$&$$ se errore di conversione viene
attivata l'uscita digitale 8o$1&$$.
Esem!io LD (PTP116A100, LD_'-Ge&En1o)er)
Esem!io IL (PTP116A100, IL_'-Ge&En1o)er)
(* "cFuires encoder $ !roE Eodule% *)
LD $
LD $
LD ="LS.
ST =BData%R5ount (* Re@erse counting *)
ST =BData%-ate.n (* -ate enable *)
ST =BData%R-ate (* Re@erse gate *)
5"L =BData (* 5all the SAs-et.ncoder !unction bloc? *)
LD =BData%Done
ST Do$$M$$ (* The outBut is acti@e i! data is acFuired *)
LD =BData%=ault
LD =BData%-'uote
ST -ate'te (* -ate Fuote *)
LD =BData%.'uote
ST .ncoder'te (* .ncoder Fuote *)
Mnl151c060 Pag. 125/271
7.12.9 +/s)hr2Rd* read 3ariable 'rom !eri!heral module
Questa funzione esegue la lettura di una variabile dal modulo periferico di estensione.
Occorre definire l'indirizzo di modulo &od9le, l'indirizzo della variabile da leggere sul modulo
periferico <d%dd, il tipo di variabile VarT7+e e l'indirizzo del buffer dove trasferire il valore letto
Var%dd.
Parametri funzione:
Module (USNT) Occorre specificare l'indirizzo di modulo da cui eseguire la lettura (Range da 0 a 15). l valore 0
RdAdd (UNT) ndirizzo variabile da leggere come allocata sul modulo periferico.
(BOOL)
Codici di errore
9989110 l tipo variabile definito in VarT7+e non corretto.
9989200 Errore durante l'esecuzione della lettura della variabile dal modulo periferico.
Esem!i
Attivando l'ingresso 8i$$&$$ viene eseguita la lettura della variabile C8I:T da indirizzo 16 dal modulo periferico $. l
valore della variabile trasferito nella 8B1$$ ad offset 2.
Esem!io LD
Mnl151c060 Pag. 126/271
7.12.: +/s)hr2&r* Crite 3ariable to !eri!heral module
Questa funzione esegue la scrittura di una variabile sul modulo periferico di estensione.
Occorre definire l'indirizzo di modulo &od9le, l'indirizzo della variabile da scrivere sul modulo
periferico ?r%dd, il tipo di variabile VarT7+e e l'indirizzo del buffer dove si trova il valore da
scrivere Var%dd.
Parametri funzione:
Module (USNT) Occorre specificare l'indirizzo di modulo su cui eseguire la scrittura (Range da 0 a 15). l valore 0
&rAdd (UNT) ndirizzo variabile da scrivere come allocata sul modulo periferico.
(BOOL)
Codici di errore
9988110 l tipo variabile definito in VarT7+e non corretto.
9988200 Errore durante l'esecuzione della scrittura della variabile sul modulo periferico.
Esem!i
Attivando l'ingresso 8i$$&$$ viene eseguita la scrittura della variabile C8I:T ad indirizzo 16 sul modulo periferico $. l
valore da scrivere presente nella 8B1$$ ad offset 2.
Esem!io LD
Mnl151c060 Pag. 127/271
7.12.1% C)<ModuleI-* C)< module I5- management
Questo blocco funzione esegue la lettura dei due ingressi digitali e la gestione delle due uscite
digitali presenti sul modulo CPU dello SlimLine.
Enable (BOOL) Abilitazione gestione /O, attivando l'ingresso vengono acquisiti gli ingressi logici e gestite le uscite
logiche. Disattivando l'ingresso vengono disattivate anche le uscite logiche sul modulo CPU.
D-%% (BOOL) Stato della uscita logica DO00 presente sul modulo CPU.
D-%1 (BOOL) Stato della uscita logica DO01 presente sul modulo CPU.
Enabled (BOOL) Blocco funzione abilitato.
Done (BOOL) Acquisizione input e gestione output eseguita.
(ault (BOOL) Errore su acquisizione input e gestione output.
DI%% (BOOL) Stato dell'ingresso logico D00 presente sul modulo CPU.
DI%1 (BOOL) Stato dell'ingresso logico D01 presente sul modulo CPU.
Codici di errore
10001100 Errore su esecuzione funzione lettura ingressi logici da modulo CPU
10001200 Errore su esecuzione funzione di set uscite logiche su modulo CPU
Esem!i
Viene eseguita la lettura dei due ingressi digitali e la gestione delle due uscite digitali presenti sul modulo CPU. Lo stato
dei due ingressi logici copiato nelle uscite 8o$$&$$ e 8o$1&$$. Lo delle variabili 8i$$&$$ e 8i$1&$$ trasferito
sulle due uscite logiche.
Esem!io LD (PTP11$A600, LD_CP#2o)*,eI!)
Mnl151c060 Pag. 128/271
7.12.11 +/sI2C&rRd* Crites5reads on I2C eEtension bus
Questa funzione gestisce la scrittura/lettura sul bus 2C di estensione. L'utilizzo di questa
funzione permette di poter gestire qualsiasi componente 2C connesso al bus di estensione.
La funzione protetta e non possibile eseguirla se non si provvede allo sblocco, vedi
+rotezione >9nzioni e ;locc*i >9nzione.
Parametri funzione:
Address (USNT) ndirizzo dispositivo 2C range da 16#00 a 16#1F, da 16#30 a 16#7F.
&rB/tes (USNT) Numero di bytes dati da scrivere. 0 se solo lettura.
&rBu''er (@USNT) ndirizzo buffer memoria che contiene i dati da scrivere. NULL se solo lettura.
RdB/tes (USNT) Numero di bytes dati da leggere. 0 se solo scrittura.
RdBu''er (@USNT) ndirizzo buffer memorizzazione dati letti. NULL se solo scrittura.
(BOOL)
T<CE) Comando eseguito correttamente.
Codici di errore
9953020 Funzione protetta.
9953100 ndirizzo 2C nel range di allocazione moduli di estensione.
9953105 ndirizzo 2C fuori range (Valore superiore a 16#7F).
Esem!i
E' riportato un semplice programma che esegue la lettura e scrittura di un chip /O expander PCF9670 su bus 2C. l
chip ha indirizzo 16#38.
Esem!io LD
Mnl151c060 Pag. 129/271
7.1$(unzioni ed (B di utilitD generale
7.1$.1 DB1%%Add-''set* returns DB1%% address o''set
Questa funzione ritorna l'indirizzo della locazione di memoria all'interno della 8B1$$, il cui offset
fornito come parametro.
Parametri funzione:
-''set (UNT) Offset locazione memoria
(UDNT)
ndirizzo della locazione di memoria
Esem!i
La variabile Val9eToPrint allocata nella 8B1$$ ad offset 2, ogni secondo ne viene incrementato il valore e su porta
seriale C'&$ viene inviata la stringa Val9e is) ====.
De'inizione 3ariabili globali
Esem!io LD
Mnl151c060 Pag. 130/271
7.1$.2 BLINA* blin command
Questo blocco funzione gestisce una uscita lampeggiante con tempo di ciclo definibile.
Attivando l'ingresso E:%BLE l'uscita 'CT inizia a lampeggiare con tempi di ciclo alto e basso
definiti.
ENABLE (BOOL) Abilitazione blocco funzione, attivandolo viene gestita l'uscita OUT lampeggiante. Disattivandolo
l'uscita OUT viene resettata.
.IMEL-& (UDNT) Definisce il tempo in cui l'uscita OUT rimane nello stato logico low, espresso in mS.
.IME?I0? (UDNT) Definisce il tempo in cui l'uscita OUT rimane nello stato logico high espresso in mS.
-<. (BOOL) Stato uscita lampeggiante.
Esem!i
Viene impostato un lampeggio con 100 mS di tempo On e 1000 mS di tempo Off. Attivando l'ingresso digitale 8i$$&$$
l'uscita digitale 8o$$&$$ lampeggia con i tempi definiti.
Disattivando l'ingresso digitale 8i$$&$$ l'uscita digitale 8o$$&$$ si azzera immediatamente.
Esem!io LD (PTP1$A100, LD_%LI"8)
Esem!io IL (PTP1$A100, IL_%LI"8)
5"L =BGBL3*H (* 5all the BL3*H !unction bloc? *)
LD Di$$M$$
ST =BGBL3*H%.*"BL. (* Trans!er the digital inBut to enable inBut *)
LD #$$$
ST =BGBL3*H%T3M.L,; (* Set the tiEe loI *)
LD #$$
ST =BGBL3*H%T3M.:3-: (* Set the tiEe high *)
LD =BGBL3*H%,UT
ST Do$$M$$ (* 5oBA =B outBut to logic outBut *)
Esem!io +. (PTP1$A100, T_%LI"8)
=BGBL3*H(T3M.L,;:=#$$$, T3M.:3-::=#$$); (* 5all the BL3*H !unction bloc? *)
=BGBL3*H%.*"BL.:=Di$$M$$; (* Trans!er the digital inBut to =B enable *)
Do$$M$$:==BGBL3*H%,UT; (* Trans!er the =B outBut to digital outBut *)
Mnl151c060 Pag. 131/271
7.1$.$ Blin2alue* blin out 3alue
Questo blocco funzione gestisce una uscita lampeggiante con possibilit di definire il numero di
lampeggi. Attivando l'ingresso Ena;le e definendo il numero di lampeggi in BlinI:r, l'uscita '9tBit
inizia a lampeggiare con il numero di lampeggi definito.
l numero di lampeggi definito in decine ed unit, il valore delle decine riportato con un lampeggio
lento (1 Sec), mentre il numero delle unit riportato con un lampeggio veloce (250 mS). Una pausa
di 3 Sec separa le sequenze di lampeggio.
Enable (BOOL) Abilitazione blocco funzione, attivandolo viene gestita l'uscita '9tBit lampeggiante. Disattivandolo
l'uscita viene resettata.
BlinNr (USNT) Definisce il numero di lampeggi dell'uscita '9tBit. Definendo tempo 0 l'uscita si disattiva.
-utBit (BOOL) Stato uscita lampeggiante.
Esem!i
Attivando l'ingresso digitale 8i$$&$$ l'uscita digitale 8o$$&$$ lampeggia con 2 lampeggi lenti (1 Sec), 3 lampeggi
veloci (250 mS) ed una pausa di 3 Sec.
Disattivando l'ingresso digitale 8i$$&$$ l'uscita digitale 8o$$&$$ si azzera immediatamente.
Esem!io LD (PTP1$A100, LD_%,in/5a,*e)
Esem!io IL (PTP1$A100, IL_%,in/5a,*e)
5"L =BData (* 5all the RBlin?8alueR !unction bloc? *)
LD Di$$M$$
ST =BData%.nable (* Trans!er the digital inBut to enable inBut *)
LD +)
ST =BData%Blin?*r (* Set the nuEber o! blin? *)
LD =BData%,utBit
ST Do$$M$$ (* 5oBA =B outBut to logic outBut *)
Esem!io +. (PTP1$A100, T_%,in/5a,*e)
=BData(Blin?*r:=+)); (* 5all the BL3*H !unction bloc? *)
=BData%.nable:=Di$$M$$; (* Trans!er the digital inBut to =B enable *)
Do$$M$$:==BData%,utBit; (* Trans!er the =B outBut to digital outBut *)
Mnl151c060 Pag. 132/271
7.1$.1 ModbusR.<Master;31* modbus Rtu master
FB PLCUtyLib SFR054B100
Questo blocco funzione esegue la gestione del protocollo modbus master, possibile definire il
terminale di /O su cui effettuare la comunicazione 4ile. Attivando Ena;le sul terminale di /O
viene inviato un frame per eseguire la funzione modbus definita in 4Code. Terminata
l'esecuzione del comando viene attivata l'uscita 8one. Se l'esecuzione comando ha esito
positivo si attiva per un loop di programma l'uscita 'I. Disattivando Ena;le si azzera 8one e
l'eventuale 4a9lt, per eseguire nuovamente il comando occorre riabilitare l'ingresso Ena;le.
Se 4Code una funzione di lettura, il valore delle variabili a partire dall'indirizzo definito in
%ddress per il numero di variabili definito da Points, viene letto dal sistema slave e trasferito
nelle variabili indirizzate da B9>>er.
Se 4Code una funzione di scrittura, il valore delle variabili presenti nel buffer di memoria
indirizzato da B9>>er per il numero di variabili definito da Points, inviato al dispositivo slave
che lo trasferir nelle sue variabili a partire dall'indirizzo definito in %ddress.
n caso di errore esecuzione o tempo di esecuzione comando superiore al tempo definito in Timeo9t, viene attivata per
un loop di programma l'uscita 4a9lt ed incrementato il valore in Errors.
Enable (BOOL) Comando abilitazione esecuzione comando modbus. Per rieseguire il comando disabilitare e poi
riabilitare questo ingresso.
Node (USNT) Numero di nodo modbus su cui effettuare il comando (Range da 0 a 255).
(Code (USNT) Codice funzione modbus da eseguire nel comando (Range da 0 a 255).
Codice Descrizione
16#01 Read coil status (Massimo 255 coils)
16#02 Read input status (Massimo 255 inputs)
16#03 Read holding registers (Massimo 32 registri)
16#04 Read input registers (Massimo 32 registri)
16#06 Preset single register
16#0F Force multiple coils (Massimo 255 coils)
16#10 Preset multiple registers (Massimo 32 registri)
Address (UNT) ndirizzo di allocazione variabili su sistema slave. n accordo alle specifiche modbus l'indirizzo inviato
nel frame dati (%ddress-1) (Range da 16#0001 a 16#FFFF).
)oints (USNT) Numero di variabili consecutive su cui opera il comando (Range da 1 a 32).
Bu''er (@USNT) ndirizzo buffer dati letti o da scrivere.
.imeout (UNT) Tempo massimo esecuzione comando espresso in mS. Se il comando non termina nel tempo
definito viene abortito ed attivata l'uscita 4a9lt.
Done (BOOL) Si attiva al termine della esecuzione comando.
- (BOOL) Attivo per un loop se esecuzione comando corretta.
(ault (BOOL) Attivo per un loop se errore esecuzione comando.
Errors (UDNT) Numero di errori, incrementato ad ogni nuovo errore, raggiunto valore massimo riparte da 0.
Dela/ (UNT) Tempo di pausa dopo l'esecuzione del comando modbus espresso in mS.
Mnl151c060 Pag. 133/271
Codici di errore
10007050 Timeout esecuzione.
10007060 Errore esecuzione.
10007100 Codice funzione definito in 49nction non gestito.
10007120 Valore di Points errato.
10007200~1 Errore trasmissione frame comando.
10007500 Errore in ricezione frame (Codice comando errato).
10007520 Errore in ricezione frame (CRC frame errato).
10007540~1 Errore in ricezione frame (Dati errati).
Esem!i
Viene presentato un esempio di lettura da un sistema SlimLine slave. Viene eseguita la lettura di 16 coils a partire da
indirizzo 16#01 dal nodo modbus 1. l valore dei coils letti trasferito nell'array <=Coils. Terminata la lettura si attiver
per un loop l'uscita logica 8o$1&$$.
Nella variabile B''L ad indirizzo <=CoilsQ$R verr trasferita la variabile B''L &51$$.$ del sistema slave, ad indirizzo
<=CoilsQ1R la variabile &51$$.1, ad indirizzo <=CoilsQ1R la variabile &51$$.1 e cos via.
Esem!io LD (PTP11$A610, LD_2o)+*-RT#2a-&er)
Mnl151c060 Pag. 134/271
7.1$.4 Modbus+la3e* modbus sla3e
Sui sistemi SlimLine il protocollo modbus slave gi implementato dal sistema operativo, pertanto
non occorre inserire blocchi funzione appositi nel programma utente. Questo blocco esegue l'override
della gestione di sistema operativo e si utilizza in casi particolari, dove non possibile utilizzare la
gestione implementata nel sistema operativo. Per esempio quando si vuole consentire l'accesso ad
un propria area di memoria diversa dalla DB100.
Questo blocco funzione esegue la gestione del protocollo modbus slave selezionabile T7+e per tutti e
3 i tipi di protocollo RTU, Ascii ed over P, possibile definire il terminale di /O su cui effettuare la
comunicazione 4ile.
Occorre definire il nodo modbus :ode, e l'eventuale offset di indirizzo frame modbus '>>set.
comandi modbus ricevuti operano sul buffer di memoria il cui indirizzo definito in B9>>er e la
dimensione in bytes definita in Size.
n I4Time occorre definire il tempo di interframe dei comandi modbus, cio il tempo che intercorre tra la ricezione di un
comando ed il comando successivo. Su linea seriale questo tempo coincide con il tempo di ricezione di 3 caratteri al
baud rate definito.
Alla ricezione di ogni comando modbus corretto si attiva per un loop l'uscita 8one, in caso di errore comando viene
attivata per un loop l'uscita 4a9lt ed incrementato il valore in Errors.
Enable (BOOL) Comando di abilitazione blocco funzione.
./!e (USNT) Tipo di protocollo modbus. 0:RTU, 1:Ascii, 2:TCP
Node (USNT) Numero di nodo modbus (Range da 0 a 255).
-''set (UNT) Offset su indirizzo modbus ricevuto nel frame dati (Range da 16#0000 a 16#FFFF).
Bu''er (@USNT) ndirizzo buffer dati su cui operano i comandi modbus.
+ize (UNT) Dimensione in byte del buffer dati su cui operano i comandi modbus.
I(.ime (UDNT) Tempo che intercorre tra la ricezione di un comando ed il comando successivo (S).
Se comunicazione su porta seriale il tempo deve essere definito in base al baud rate.
Baud rate .em!o Baud rate .em!o
300 112000 19200 1720
600 56000 38400 860
1200 28000 57600 573
2400 14000 76800 429
4800 7000 115200 286
9600 3430
Nel caso di comunicazione su rete ethernet possibile definire il valore minimo.
Done (BOOL) Attivo per un loop alla ricezione di comando modbus.
(ault (BOOL) Attivo per un loop su errore ricezione comando modbus.
Errors (UDNT) Numero di errori riscontrati. Viene incrementato ad ogni nuovo errore, raggiunto il valore massimo il
conteggio riparte da 0.
Mnl151c060 Pag. 135/271
Comandi su!!ortati
l blocco funzione supporta solo alcuni comandi previsti dal protocollo modbus, i comandi supportati sono:
Codice Descrizione
01 Read coil status (Massimo 250 coils)
02 Read input status (Massimo 250 coils)
03 Read holding registers (Massimo 125 registri)
04 Read input registers (Massimo 125 registri)
05 Force single coil
06 Preset single register
08 Loopback diagnostic test
0F Force multiple coils (Massimo 250 coils)
10 Preset multiple registers (Massimo 125 registri)
Codici di errore
n caso di errore si attiva l'uscita 4a9lt, con S7sGetLastError possibile rilevare il codice di errore. n caso di
eccezione su comando modbus viene riportato il codice di errore ma non viene attivata l'uscita 4a9lt.
10038050 Errore di timeout esecuzione.
10038080 Errore definizione T7+e.
10038100~19 Errore in ricezione frame (Carattere errato, lunghezza errata).
10038150~1 Errore in ricezione frame (CRC/LRC modbus errato).
10038200~2 Errore trasmissione frame risposta.
10038501 Eccezione 01.Illegal >9nction, comando ricevuto non tra quelli gestiti.
10038502 Eccezione 02. Illegal data address, comando ricevuto ha indirizzo o numero dati fuori range.
10038503 Eccezione 03. Illegal data Dal9e, comando ricevuto ha campo dati fuori range.
10038504 Eccezione 04.4ail9re in associated deDice, comando ricevuto contiene imprecisioni.
Mnl151c060 Pag. 136/271
Esem!i
Viene gestito il protocollo modbus slave su porta seriale C'&$, si utilizza le impostazioni seriali di default 111$$, e, 2,
1. comandi modbus possono agire sull'array di WORD 8%rra7.
Esem!io LD (PTP11$A610, LD_2o)+*-,a9e)
Mnl151c060 Pag. 137/271
7.1$.6 -N-((C,CLE* on5o'' c/cle Cith random times
Questo blocco funzione esegue la temporizzazione di un ciclo On/Off con tempi random di
On e di Off definibili tra valori minimo e massimo.
Attivando il comando di Ena;le l'uscita '9t esegue un lampeggio On/Off con tempi random
compresi tra i valori minimo e massimo definiti. Disabilitando l'ingresso l'uscita Out si
disattiva.
La variabile 8ela7 ritorna il valore di ritardo attualmente attivo.
Enable (BOOL) Comando di abilitazione.
Min-''.ime (UDNT) Valore minimo di tempo off comando (mS).
MaE-''.ime (UDNT) Valore massimo di tempo off comando (mS).
Min-n.ime (UDNT) Valore minimo di tempo on comando (mS).
MaE-n.ime (UDNT) Valore massimo di tempo on comando (mS).
-ut (BOOL) Stato comando On/Off in uscita.
Dela/ (UDNT) Valore di tempo attualmente in temporizzazione (mS).
Esem!i
Viene eseguito il lampeggio della uscita 8o$$&$$ con tempi random variabili tra i 2 ed i 4 secondi.
Esem!io LD (PTP11$A100, LD_!"!FFC:CLE)
Esem!io IL (PTP11$A100, IL_!"!FFC:CLE)
5"L =BData (* 5all the ,*,==5O5L. !unction bloc? *)
LD Di$$M$$
ST =BData%.nable (* Trans!er the digital inBut to .nable inBut *)
LD +$$$
ST =BData%Min,!!TiEe (* Set the EiniEuE o!! tiEe *)
LD 6$$$
ST =BData%MaM,!!TiEe (* Set the EaMiEuE o!! tiEe *)
LD +$$$
ST =BData%Min,nTiEe (* Set the EiniEuE on tiEe *)
LD 6$$$
Mnl151c060 Pag. 138/271
ST =BData%MaM,nTiEe (* Set the EaMiEuE on tiEe *)
LD =BData%,ut
ST Do$$M$$ (* 5oBA the ,ut @alue to logic outBut *)
LD =BData%DelaA
ST 8ar,ut (* The DelaA tiEe is coBied to @ariable *)
Esem!io +. (PTP11$A100, T_!"!FFC:CLE)
=BData(); (* 5all the ,*,==5O5L. !unction bloc? *)
=BData%.nable:=Di$$M$$; (* Trans!er the digital inBut to .nable inBut *)
=BData%Min,!!TiEe:=+$$$; (* Set the EiniEuE o!! tiEe *)
=BData%MaM,!!TiEe:=6$$$; (* Set the EaMiEuE o!! tiEe *)
=BData%Min,nTiEe:=+$$$; (* Set the EiniEuE on tiEe *)
=BData%MaM,nTiEe:=6$$$; (* Set the EaMiEuE on tiEe *)
Do$$M$$:==BData%,ut; (* 5oBA the ,ut @alue to logic outBut *)
8ar,ut:==BData%DelaA; (* The DelaA tiEe is coBied to @ariable *)
Mnl151c060 Pag. 139/271
7.1$.7 )IDMng* )ID management
Questo blocco funzione esegue la regolazione PD. E' prevista la possibilit di abilitare
singolarmente i vari tipi di azione (P)roporzionale (I)ntegrativa, (8)erivativa.
Un comando di <eDerse permette di invertire il segno del segnale in uscita '9t.
)IDEnable (BOOL) Abilitazione regolazione PD, attivando l'ingresso si abilita la regolazione. Disattivando l'ingresso si
azzera il valore in uscita '9t.
IEnable (BOOL) Abilitazione regolazione integrativa, attivando l'ingresso si abilita la regolazione integrativa.
DEnable (BOOL) Abilitazione regolazione derivativa, attivando l'ingresso si abilita la regolazione derivativa.
Re3erse (BOOL) nversione segno su valore in uscita '9t.
+et)oint (REAL) Set point, il valore espresso nell'unit di misura del processo da controllare.
)2alue (REAL) Valore acquisito dal processo, il valore espresso nell'unit di misura del processo da controllare.
)Band (REAL) Banda proporzionale, questo valore definisce il valore di errore oltre al quale la regolazione viene
disabilitata forzando l'uscita '9t al massimo 1$$S. l valore espresso nell'unit di misura del
processo da controllare.
+. (REAL) Tempo di scansione, occorre impostare il tempo in cui si desidera vengano eseguite le regolazioni
integrativa e derivativa se abilitate, il valore in mS.
A) (REAL) Costante proporzionale, si ricorda che pi elevato il valore pi pronta la regolazione con un
conseguente aumento del valore di overshot. l valore un numero.
I. (REAL) Tempo integrativo, si ricorda che pi elevato il valore meno veloce la regolazione integrativa a
recuperare l'errore. l valore espresso in Sec.
D. (REAL) Tempo derivativo, si ricorda che pi elevato il valore pi veloce la regolazione derivativa a
recuperare l'errore. l valore espresso in Sec.
Enabled (BOOL) Regolazione PD abilitata.
Error (BOOL) Errore nella esecuzione.
-<. (REAL) Valore di correzione in uscita dalla regolazione PD. Questo valore deve essere utilizzato per il
comando del processo. l valore espresso in S. l range compreso tra 0 e 100 %.
Codici di errore
n caso di errore si attiva l'uscita Error, con S7sGetLastError possibile rilevare il codice di errore.
10012050 Non stato definito valore di ST.
Esem!i
Nell'esempio gestita una regolazione di temperatura su di un termoriscaldatore. Viene acquisita la sonda di
temperatura da una Pt100 e viene gestita una uscita PWM 8o$$&$$ per il comando. Le costanti del loop PD sono
allocate in memoria backup e sono mantenute allo spegnimento, inoltre sono accessibili da modbus.
Mnl151c060 Pag. 140/271
Esem!io LD (PTP11$A100, LD_PID2ng)
Mnl151c060 Pag. 141/271
7.1$.9 )&M-ut* )&M out!ut management
Questo blocco funzione esegue la gestione di una uscita PWM.
Enable (BOOL) Abilitazione gestione uscita PWM, attivando l'ingresso si abilita la gestione. Disattivando l'ingresso si
azzera l'uscita '9t.
+E. (REAL) Valore di set PWM, il valore espresso in S.
.C/cle (REAL) Tempo di di ciclo PWM, il valore espresso in S.
.Min (REAL) Tempo minimo comando uscita '9t, il valore espresso in S.
-ut (BOOL) Uscita PWM.
Esem!i
Nell'esempio gestita una uscita PWM definendo un tempo di ciclo di 5 secondi con un tempo minimo di 0.5 secondi.
mpostando come set point il valore 50% attivando l'ingresso 8i$$&$$ avremo che l'uscita 8o$$&$$ sar attivata per
2.5 secondi e disattivata per 2,5 secondi.
Esem!io LD (PTP11$A100, LD_P(2!*&)
Mnl151c060 Pag. 142/271
7.1$.: +/sDM>Mng* DM> management
FB Embedd 3.0
Questo blocco funzione esegue la gestione del protocollo DMX, questo un blocco funzione protetto
per utilizzarlo occorre richiedere il codice di protezione, vedi +rotezione >9nzioni e ;locc*i
>9nzione. E' comunque possibile utilizzarlo liberamente in modo test per 15 Min.
Attivando l'ingresso di Start viene inviato sulla porta seriale identificata da 4ile un frame DMX che
inizia con il valore di Stat9s e segue con il valore di preset dei dispositivi definiti da 8eDices. l valore
di preset dei vari dispositivi deve essere caricato in un array di dati il cui indirizzo passato in
8ataPtr. Mantenendo sempre attivo l'ingresso Start verranno inviati consecutivamente frames DMX.
Al termine dell'invio del comando DMX si attiver per un loop di programma l'uscita 8one.
+tart (BOOL) Comando di invio frame DMX su porta seriale, si resetta automaticamente all'invio del frame.
+tatus (USNT) Valore byte di stato inviato nel protocollo DMX prima dei byte di preset dispositivi.
De3ices (UNT) Numero di dispositivi connessi al bus DMX.
Dela/ (UNT) Tempo di pausa trasmissione frames DMX (mSec)
Data)tr (@USNT) Pointer all'array dati valori di preset dispositivi DMX.
Done (BOOL) Attivo per un loop al termine dell'invio frame DMX del comando
(ault (BOOL) Attivo in caso di errore nella gestione.
Codici di errore
9979085 FB protetta, terminato tempo funzionamento in modo demo.
9979200 Protocollo DMX non supportato dal dispositivo definito in 4ile.
Mnl151c060 Pag. 143/271
Esem!i
Dovendo gestire puntatori a memoria preferibile utilizzare il blocco funzione all'interno di un programma ST,
nell'esempio viene attivato il protocollo DMX sulla porta seriale C'&1. Vengono gestiti 5 dispositivi con indirizzi da 1 a
5. l frame DMX continuamente inviato ai dispositivi.
Attivando l'ingresso digitale 8i$$&$$ viene impostato il valore 0, su tutti i dispositivi. Attivando l'ingresso digitale
8i$1&$$ su dispositivo 1 viene impostato il valore 10, sul 2 il valore 20, e cos via fino al quinto in cui viene impostato il
valore 50.
Esem!io +.
(* *)
(* .S.-U, "0.RTUR" 0,RT" S.R3"L. *)
(* *)
(* :ere the 5,M# Bort is oBened in readNIrite% *)
3= (=BDM/%=ile = *ULL) T:.*
=BDM/%=ile:=SAs!oBen(95,M#9, 9rI9); (* 0ort 5,M# !ile Bointer *)
.*DG3=;
(* *)
(* .S.-U, "TT38"W3,*. 5,M"*D3 *)
(* *)
(* "tti@aXione coEandi su inBut Di$$M$$% *)
Di0lsC$D(5LH:=Di$$M$$);
3= (Di0lsC$D%') T:.*
DM/DataC$D:=$; (* 0reset disBositi@o con indiriXXo # *)
DM/DataC#D:=$; (* 0reset disBositi@o con indiriXXo + *)
DM/DataC+D:=$; (* 0reset disBositi@o con indiriXXo ) *)
DM/DataC)D:=$; (* 0reset disBositi@o con indiriXXo 6 *)
DM/DataC6D:=$; (* 0reset disBositi@o con indiriXXo & *)
=BDM/%Start:=TRU.; (* Start *)
.*DG3=;
(* "tti@aXione coEandi su inBut Di$#M$$% *)
Di0lsC#D(5LH:=Di$#M$$);
3= (Di0lsC#D%') T:.*
DM/DataC$D:=#$; (* 0reset disBositi@o con indiriXXo # *)
DM/DataC#D:=+$; (* 0reset disBositi@o con indiriXXo + *)
DM/DataC+D:=)$; (* 0reset disBositi@o con indiriXXo ) *)
DM/DataC)D:=6$; (* 0reset disBositi@o con indiriXXo 6 *)
DM/DataC6D:=&$; (* 0reset disBositi@o con indiriXXo & *)
=BDM/%Start:=TRU.; (* Start *)
.*DG3=;
(* *)
(* .S.-U, -.ST3,*. 0R,T,5,LL, DM/ *)
(* *)
(* -estione Brotocollo DM/% *)
=BDM/%Status:=$; (* Status bAte *)
=BDM/%De@ices:=&; (* *uEber o! de@ices *)
=BDM/%DelaA:=$; (* 3nter!raEe delaA (ESec) *)
=BDM/%Data0tr:="DR(DM/Data); (* Data arraA Bointer *)
=BDM/(); (* =B gestione Brotocollo DM/ *)
3= (=BDM/%Done) T:.* =BDM/%Start:=="LS.; .*DG3=;
(* C.nd o! !ileD *)
Mnl151c060 Pag. 144/271
7.1$.1% I-Encoder* incremental encoder o3er I5-
Questo blocco funzione esegue la lettura di un encoder incrementale connesso agli ingressi logici.
Basta appoggiare sui due ingressi %P*ase e BP*ase del blocco funzione i due ingressi di
acquisizione del canale % e del canale B di un encoder incrementale. l blocco funzione esegue la
quadratura dei segnali, il controllo della direzione di rotazione e gestisce il valore di 69ote in
uscita.
La quadratura dei segnali esegue la moltiplicazione per 4 delle tacche encoder quindi il valore di
69ote al termine di un giro completo dell'encoder pari al numero di tacche encoder moltiplicato
per 4.
Enable (BOOL) Abilitazione gestione conteggio encoder.
Reset (BOOL) Comando di reset quota encoder. Attivando l'ingresso si azzera il valore di 69ote.
A)hase (BOOL) ngresso canale % encoder.
B)hase (BOOL) ngresso canale B encoder.
Enabled (BOOL) Conteggio encoder abilitato.
Error (BOOL) Attivo per un loop su errore acquisizione encoder. Si attiva se la frequenza di ingresso dei segnali
encoder maggiore rispetto al tempo di esecuzione del blocco funzione.
=uote (UDNT) Valore di quota encoder espresso in impulsi. Numero tacche giro encoder moltiplicato per 4.
Esem!i
Nell'esempio gestita l'acquisizione di un encoder incrementale connesso agli ingressi del modulo CPU. Ruotando di
un giro l'encoder, il valore di 69ote verr incrementato se la rotazione oraria (CW) oppure decrementato se la
rotazione antioraria (CCW), del numero di tacche giro moltiplicato per 4.
Esem!io LD
Mnl151c060 Pag. 145/271
7.1$.11 0etI+-1144Crc* calculate CRC according I+-1144
Function PLCUtyLib SFR054A400
Questa funzione esegue il calcolo del CRC C7clic <ed9ndanc7 C*ecI, (Controllo Ciclico di
Ridondanza) su di un'area dati. l calcolo effettuato secondo le specifiche IS' 11.
Occorre passare alla funzione l'indirizzo del buffer di memoria B9>>er ed il numero di bytes
B7te:r su cui eseguire il calcolo del CRC.
Bu''er (@USNT) ndirizzo dell'area di memoria su cui eseguire il calcolo del CRC.
B/teNr (UNT) Numero di bytes su cui eseguire il calcolo del CRC a partire dall'indirizzo definito in B9>>er.
CRC (UNT) Valore CRC calcolato.
Esem!i
Viene calcolato il CRC di una richiesta di lettura del registro 1.8.1 da un contatore di energia elettrica secondo lo
standard EC 62056-2. l frame di richiesta OTS'PU<1TST5U1.2.1!#TET5UTC<CUO.
l valore del CRC ritornato in C<CVal9e 16#5A (90 decimale).
Esem!io +.
(* ************************************************************************** *)
(* 3.5##&& 5R5 5"L5UL"T3,* *)
(* ************************************************************************** *)
(* Register read coEEand 9JS,:KR#JST/K#%2%#()J.T/KJ5R5K9% *)
Data=raEe:=9Q$#R#Q$+#%2%#()Q$)9; (* Data !raEe *)
5R58alue:=-et3S,##&&5rc("DR(Data=raEe), #+); (* 5R5 8alue *)
Mnl151c060 Pag. 146/271
7.1$.12 I-DataEEchange* eEchange data b/ using logic I5-
Questo blocco funzione permette lo scambio di dati tra due sistemi, uno master ed uno slave,
utilizzando una connessione tramite /O logici. Sono utilizzati due ingressi e due uscite digitali per
ogni sistema, possibile definire il numero di bytes di dati da scambiarsi.
Occorre connettere l'uscita digitale 'Stro;e di un sistema con l'ingresso digitale IStro;e dell'altro
sistema e l'uscita '8ata con l'ingresso digitale I8ata dell'altro.
l trasferimento dati bidirezionale, i dati presenti nel buffer T=8ata di un sistema sono trasferiti
nel buffer <=8ata dell'altro sistema e viceversa, per il numero di bytes definito in B7te:r. La
comunicazione verificata mediante l'invio di un CRC secondo lo standard SO 1155.
Ad ogni >ine trasferimento dati si attiva per un loop l'uscita 8one, sulla sua attivazione occorre
provvedere a trasferire i dati da trasmettere nel buffer di trasmissione e leggere i dati dal buffer di
ricezione.
n caso di errore nella comunicazione si attiva per un loop l'uscita 4a9lt, ed i due sistemi si risincronizzano per
riprendere una nuova trasmissione.
Enable (BOOL) Abilitazione gestione comunicazione.
IsMaster (BOOL) T<CE) Modo master, 4%LSE) Modo slave.
I+trobe (BOOL) Occorre appoggiare l'ingresso digitale di strobe.
IData (BOOL) Occorre appoggiare l'ingresso digitale di dato.
REData (UDNT) ndirizzo buffer dati ricevuti.
.EData (UDNT) ndirizzo buffer dati da trasmettere.
B/teNr (USNT) Numero bytes da scambiare con altro sistema (Da 1 a 30).
.rigDela/ (UNT) Tempo attesa tra uscita dato '8ata ed uscita strobe 'Stro;e (Da 0 a 30 mS).
-+trobe (BOOL) Da appoggiare su uscita digitale di strobe.
-Data (BOOL) Da appoggiare su uscita digitale di dato.
Done (BOOL) Si attiva per un loop al termine dello scambio dati.
(ault (BOOL) Si attiva per un loop in caso di errore su scambio dati.
Codici di errore
10011080 Errore definizione valore B7te:r.
10011082 Errore definizione valore Trig8ela7.
10011100~1 Timeout attesa attivazione segnale IStro;e.
10011110~1 Timeout attesa disattivazione segnale IStro;e.
10011200~1 Errore CRC dati ricevuti.
Mnl151c060 Pag. 147/271
Esem!i
Utilizzando due sistemi attivando modo master (8i$1&$$ attivo) su di un sistema e modo slave (8i$1&$$ disattivo)
sull'altro, possibile eseguire lo scambio di 4 bytes di memoria tra i sistemi. 4 bytes allocati ad indirizzo &81$$.$ di
un sistema saranno trasferiti su 4 bytes allocati ad indirizzo &81$$.16 dell'altro sistema.
Al termine del trasferimento, i dati ricevuti dalla memoria &81$$.$ sono trasferiti nella variabile <=8ata, mentre la
variabile T=8ata trasferita in memoria &81$$.16.
Esem!io LD (P&0161A000)
Mnl151c060 Pag. 148/271
7.1$.1$ A3erage* 3alue a3erage
Questo blocco funzione esegue la media su di un valore. L'azione di media definita da un
parametro Coe>>icient, maggiore il valore del parametro e maggiore sar l'azione di media
sul valore in uscita %Derage.
2alue (REAL) Valore su cui effettuare l'azione di media
Coe''icient (REAL) Valore del coefficiente di media.
A3erage (REAL) Valore mediato in uscita.
Esem!i
Viene eseguita una acquisizione analogica dall'ingresso $ del modulo con indirizzo $, in modo 010 volt. l valore
acquisito viene mediato e poi trasferito nella variabile %naVal9e.
Esem!io (BD (PTP11$A500, F%D_A9erage)
Mnl151c060 Pag. 149/271
7.1$.11 ?IDClDtaReader* ?ID R(ID cloc5data reader
Questo blocco funzione esegue l'acquisizione di un lettore HD tipo clock e dato. La gestione del
lettore deve essere eseguita almeno ogni 400 uSec, quindi si consiglia di utilizzarlo in un
programma eseguito nella task fast, definendo il tempo di esecuzione della task a 400 uS tramite la
funzione S7sSetTasIL+Time.
l blocco funzione pu acquisire tags RFD con codice di lunghezza fino ad 8 bytes, il codice letto
viene trasferito nel buffer indirizzato da C8ata, occorre definire la lunghezza del codice in
C8Lengt*.
Cloc (BOOL) ngresso di clock del lettore RFD.
Data (BOOL) ngresso di dato del lettore RFD.
CData (@BYTE) ndirizzo buffer codice letto dal tag RFD.
CDLength (USNT) Numero bytes codice letto dal tag RFD.
Done (BOOL) Attivo per un loop al termine della lettura tag RFD.
(ault (BOOL) Attivo per un loop su errore lettura tag RFD.
Codici di errore
10039050 Errore definizione valore C8Lengt*.
10039100~2 Errore lettura dati tag RFD.
Mnl151c060 Pag. 150/271
Esem!i
Viene gestita la lettura di un reader della HD clock e dato connesso agli ingressi digitali del modulo CPU. Ricordo che il
programma deve essere eseguito almeno ogni 400 uS quindi si consiglia di eseguilo nella task Fast impostando il
tempo di esecuzione a 400 uS. l valore di codice letto dal TAG RFD trasferito nell'array C8ata.
Esem!io LD (PTP11$A610, LD_;IDCar)Rea))
Mnl151c060 Pag. 151/271
7.1$.14 Linearize* linearize a non linear 3alue
Function PLCUtyLib SFR054B100
Questa funzione esegue la linearizzazione di un valore. Occorre fornire alla funzione
l'indirizzo dell'array definizione valore in ingresso da linearizzare 2inRe'erence,
l'indirizzo dell'array definizione del corrispondente valore in uscita linearizzato
2-utRe'erence ed il numero di valori presenti nell'array Re'erenceNr. E' importante
definire i dati negli array in modo crescente, quindi a partire dal valore pi piccolo.
La funzione esegue la ricerca nell'array 2inRe'erence del valore immediatamente
superiore a 2in interpolando linearmente tra il valore trovato e quello precedente,
calcolando il valore in uscita in base ai due valori presenti nelle stesse posizioni dell'array 2-utRe'erence.
2In (REAL) Valore su cui effettuare la linearizzazione
2InRe'erence (@REAL) Puntatore all'array definizione valore in ingresso da linearizzare.
2-utRe'erence (@REAL) Puntatore all'array definizione valore in uscita linearizzato.
Re'erenceNr (USNT) Numero di valori negli arrays di definizione linearizzazione.
(REAL)
Valore linearizzato in uscita.
Esem!i
Viene eseguita tramite una acquisizione analogica la lettura di un livello di un serbatoio di forma irregolare, tramite la
funzione viene ritornato il valore dei litri presenti nel serbatoio. l valore di livello viene mediato per avere una lettura piu
regolare.
Ad 1 volt corrispondono 1000 litri, a 2 volt corrispondono 4000 litri, a 3 volt corrispondono 6000 litri.
Esem!io (BD (PTP11$A610, F%D_Linearize)
Mnl151c060 Pag. 152/271
7.1$.16 2alue+cale* scales a 3alue
Function PLCUtyLib SFR054B100
Questa funzione esegue la messa in scala di un valore. E' possibile definire il limite minimo e
massimo del valore in ingresso da scalare (ILo-, IPig*) ed il valore minimo e massimo del
valore in uscita scalato ('Lo-, 'Pig*).
L'utilizzo di questa funzione particolarmente indicato per convertire valori acquisiti da sensori
in corrente (4-20 mA) nella corrispondente unit di misura rilevata dal trasduttore.
In!ut (REAL) Valore in ingresso da scalare.
ILoC (REAL) Limite minimo del valore in ingresso da scalare.
I?igh (REAL) Limite massimo del valore in ingresso da scalare.
-LoC (REAL) Limite minimo del valore in uscita scalato.
-?igh (REAL) Limite massimo del valore in uscita scalato.
(REAL)
Valore scalato in uscita.
Esem!i
Viene eseguita una acquisizione analogica di un sensore di temperatura con uscita in corrente 4-20 mA, il sensore ha
come valore in uscita la corrente di 4 mA a -50 C e la corrente di 20 mA a 150 C. Utilizzando la funzione si esegue
direttamente la conversione in gradi centigradi del valore acquisito.
Esem!io (BD (PTP11$A610, F%D_1a,e)
Mnl151c060 Pag. 153/271
7.11)rotocollo DLM+* o IEC 62%46G21
Con il nuovo protocollo standard DLMS (Device Language Message Specification), la comunicazione con i sistemi di
metering viene immensamente semplificata. Questo protocollo ha una struttura orientata agli 'ggetti che rende
possibile leggere con la stessa identica modalit dati applicativi provenienti da contatori di diversi costruttori.
Lo standard EC 61107 o EC 62056-21 uno standard internazionale che descrive il protocollo DLMS per la lettura da
parte di un computer dei dati da contatori tariffari di energia elettrica, acqua e gas.
l protocollo prevede una fase di Sign-'n con il contatore durante la quale occorre fornire un codice di accesso
(Solitamente il numero di serie del contatore), ed il contatore fornisce una password in uscita che pu essere utilizzata
per criptare i dati.
Terminata questa fase possibile richiedere al contatore il valore dei suoi registri utilizzando i codici di identificazione
'BIS a 5 caratteri (EC 62056-61).
Per la famiglia SlimLine abbiamo sviluppato un apposito blocco funzione che automatizza tutte le operazioni, occorre
passare il numero di serie del contatore ed il codice OBS del registro da leggere. l blocco funzione esegue il Sign-On
sul contatore e ritorna il valore del registro indicato.
Inter>accia con il contatore
Per interfacciarsi con il contatore possibile utilizzare un apposito
accoppiatore ottico che si appoggia alla finestra di lettura del contatore e si
connette ad una delle porte seriali dello SlimLine.
Oppure nel caso di contatori predisposti con l'uscita RS485 possibile
connettersi direttamente alla porta RS485 dello SlimLine.
Mnl151c060 Pag. 154/271
7.11.1 IEC62%46;21Rd* IEC62%46G21 !rotocol read
Questo blocco funzione esegue la gestione della lettura di registri da sistemi di metering
utilizzando il protocollo EC62056-21.Questo un blocco funzione protetto per utilizzarlo
occorre richiedere il codice di protezione, vedi +rotezione >9nzioni e ;locc*i >9nzione. E'
comunque possibile utilizzarlo liberamente in modo test per 30 Min.
Occorre in Serial:r definire il numero seriale del contatore (Utilizzato come chiave di accesso
alla lettura) e in <egister l'indirizzo del registro da leggere secondo la normativa OBS. Se la
lettura ha esito positivo viene attivata l'uscita 8one e le variabili &eterCode, Pass-ord e
Val9e sono valorizzate con i dati letti dal contatore.
Enable (BOOL) Attivando l'ingresso viene gestita la lettura del contatore.
(ile (FLEP) Pointer al file della risorsa cos come ritornato dalla funzione S7s>o+en.
+erialNr (STRNG[16]) Numero di serie del contatore, viene utilizzato come chiave di accesso.
Register (STRNG[16]) ndirizzo registro da leggere secondo la codifica OBS.
Done (BOOL) Viene attivato per un loop al termine della acquisizione.
(ault (BOOL) Viene attivato per un loop in caso di errore nella sequenza di acquisizione.
.E+tring (STRNG[32]) Contiene la stringa di comando inviata al contatore, pu essere utilizzato in debug per
verificare i comandi inviati.
RE+tring (STRNG[32]) Contiene la stringa di risposta ritornata dal contatore, pu essere utilizzato in debug per
verificare le risposte ricevute.
MeterCode (STRNG[32]) Contiene stringa con il codice del contatore acquisita durante fase di acceso (Sign-on).
)assCord (UDNT) Contiene valore password acquisita dal contatore durante fase di acceso (Sign-on).
2alue (STRNG[32]) Contiene stringa con valore registro richiesto acquisita dal contatore.
Codici di errore
10016070 Errore case gestione.
10016100~1 Errore ricezione tipo da contatore.
10016110~2 Errore ricezione password da contatore.
10016120~2 Errore ricezione valore parametro da contatore.
10016200 Overflow ricezione stringa da contatore.
Mnl151c060 Pag. 155/271
Esem+i
E' disponibile un programma di esempio Ptp122*000 che esegue la lettura da un contatore di energia di 3 registri. A
titolo indicativo diamo un esempio di massima per la lettura di un registro.
Su attivazione dell'ingresso digitale 8i$$&$$ viene eseguita la lettura del registro 1.2.$ (Potenza in Kw). Se la lettura
ha esito positivo si attiva per un loop l'uscita digitale 8i$$&$$. Le variabili &eterCode, Pass-ord e Val9e, saranno
valorizzate con i valori letti dal contatore.
Esem!io LD (PTP11$A000, LD_IEC66056_61R))
Mnl151c060 Pag. 156/271
7.14(unzioni ed (B gestione modem "eModemLib#
Le funzioni ed i blocchi funzione per la gestione del modem utilizzano un modem GSM connesso ad un terminale di /O
del sistema (Tipicamente utilizzata una porta seriale). Nel modem deve essere inserita una tessera SM non +rotetta
dal codice PI:.
Per utilizzare la gestione del modem occorre importare la libreria S4<$3GG$$ nel proprio progetto, si rimanda al
capitolo relativo all'import delle librerie per ulteriori informazioni in merito.
Nella descrizioni successive si fa riferimento alle seguenti definizioni generali.
:9mero di tele>ono
l numero di telefono consiste in una stringa lunga da 10 a 16 caratteri numerici conforme al seguente formato:
Prefisso internazionale senza lo zero davanti (es. +39 per talia, +49 per Germania, +44 per Gran Bretagna ecc.)
Codice dell'operatore mobile (es. 338, 320, 347, ecc.)
Numero di telefono (es. 7589951)
Esempio: +393337589951,+3933812345,+49172123456
&essaggio S&S
Un messaggio SMS pu essere lungo fino a 160 caratteri alfanumerici facenti parte del seguente set:
A.Z, a.z, 0.9, Spazio bianco, sono da evitare tutti gli altri caratteri.
Mnl151c060 Pag. 157/271
7.14.1 ModemCore;32* modem core management
FB eModemLib SFR057D000
Questo blocco funzione gestisce un modem connesso al dispositivo di /O definito in 4ile,
questo un blocco funzione protetto per utilizzarlo occorre richiedere il codice di
protezione, vedi +rotezione >9nzioni e ;locc*i >9nzione. E' comunque possibile utilizzarlo
liberamente in modo test per 30 Min.
L'FB gestisce il dialogo con il modem, ne esegue l'inizializzazione e ne controlla lo stato,
controlla se il modem connesso alla rete GSM e ritorna l'operatore di rete '+erator ed il
livello del segnale <ssi. Nel caso in cui il modem si sganci dalla rete l'FB provvede al suo
riaggancio automatico. L'FB ritorna un &odemI8 che deve essere passato alle FB
collegate (Esempio invio SMS, ricezione SMS, ecc.). Le uscite S+7Trg e S+7Ptr possono
essere utilizzate per gestire la FB S+78ata.
L'uscita 8one si attiva se il modem correttamente inizializzato, mentre l'uscita 4a9lt si
attiva per un loop di programma in caso di errori di gestione.
E' previsto un comando Po-er'n per la gestione della alimentazione del modem, in
questo modo l'FB pu spegnere e riaccendere il modem in caso riscontri una non
funzionalit dello stesso.
Su ricezione chiamata telefonica viene rilevato il CLP del chiamante che ritornato in uscita CLIP:9m;er,
contemporaneamente ad ogni squillo del telefono si attiva per un loop di programma l'uscita CLIP<=d. Su connessione
GPRS viene ritornato l'indirizzo P assegnato dal gestore alla connessione IP%ddress.
Enable (BOOL) Abilitazione blocco funzione, attivandolo viene gestito il modem.
Auto?ang<! (BOOL) Abilita l'HangUp automatico alla ricezione di una chiamata telefonica, viene comunque
ritornato il CLP.
A)N (STNG[32]) Definizione APN per connessione GPRS.
DN+ (STNG[16]) Definizione indirizzo P server DNS.
Done (BOOL) Modem correttamente inizializzato e funzionante.
(ault (BOOL) Attivo per un loop di programma se errore gestione modem.
)oCer-n (BOOL) Comando di gestione uscita alimentazione modem.
CLI)REd (BOOL) Attivo per un loop di programma ad ogni ricezione CLP (Tipicamente ad ogni RNG del
modem).
ModemID (UDNT) D modem da passare alle FB collegate (Esempio &odemS&SSend, &odemS&S<eceiDe,
ecc.).
+!/.rg (UDNT) Trigger per FB SpyData.
+!/)tr (@USNT) Puntatore a buffer dati da spiare.
-!erator (STRNG[16]) Contiene la stringa con il nome dell'operatore telefonico.
Rssi (USNT) Valore potenza segnale radio.
CLI)Number (STRNG[16]) Contiene la stringa con il numero di CLP ricevuto.
I)Address (STNG[16]) ndirizzo P assegnato dal gestore su connessione GPRS.
Mnl151c060 Pag. 158/271
Codici di errore
Codice Descrizione
10002100 Errore ricezione dati da modem.
10002200~3 Errore ricezione CLP.
10002300~3 Errore nelle sequenze power on del modem.
10002400~9 Errore nelle sequenze di controllo del modem.
10002500~7 Errore nella ricezione del messaggio SMS.
Esem!i
Nell'esempio gestito un modem connesso al terminale di /O definito nella variabile 4+, per la definizione delle variabili
e per una migliore comprensione del funzionamento si rimanda agli esempi successivi.
Esem!io LD
Mnl151c060 Pag. 159/271
7.14.2 Modem+M+Recei3e* recei3e a +M+ message
Questo blocco funzione esegue la ricezione di un messaggio SMS, si collega al blocco
funzione di gestione modem &odemCore, occorre passare il &odemI8 in uscita dal blocco
funzione di gestione modem.
Alla ricezione di un messaggio SMS si attiva per un loop di programma l'uscita 8one, sull'uscita
S&STe=t viene ritornato il messaggio ricevuto, all'uscita CLIP:9m;er della FB &odemCore
ritornato il numero di telefono da cui il messaggio stato ricevuto. l testo del messaggio
ricevuto rimane presente in uscita sino alla ricezione di un altro messaggio.
Enable (BOOL) Abilita la ricezione dei messaggi SMS.
ModemID (UDNT) D modem fornito in uscita dalla &odemCore.
Done (BOOL) Attivo per un loop se ricevuto messaggio SMS.
(ault (BOOL) Attivo per un loop se errore.
.eEt (STRNG[160]) Testo del messaggio SMS ricevuto.
Codici di errore
10003010 &odemI8 non definito.
10003020 &odemI8 non corretto.
Esem!i
Nell'esempio gestita la ricezione di un messaggio SMS dal modem definito nella variabile &odemI8, per la
definizione delle variabili e per una migliore comprensione del funzionamento si rimanda agli esempi successivi.
Esem!io LD (P&011<a600, Re1ei9e22e--age)
Mnl151c060 Pag. 160/271
7.14.$ Modem+M+RECmd;31* recei3e a +M+ command
Questo blocco funzione esegue la ricezione di un comando tramite un messaggio SMS, si
collega al blocco funzione di gestione modem &odemCore, occorre passare il &odemI8 in
uscita dal blocco funzione di gestione modem.
Alla ricezione di un messaggio SMS se nel testo del messaggio presente la stringa definita in
Command, si attiva per un loop di programma l'uscita 8one, all'uscita CLIP:9m;er della FB
&odemCore ritornato il numero di telefono da cui il messaggio stato ricevuto.
Attivando Cin il controllo sulla stringa definita in Command verr fatto non considerando il case
(Maiuscolo/minuscolo) dei caratteri.
Enable (BOOL) Abilita la ricezione del comando.
CIn (BOOL) Se attivo, controllo di Command non considerando case (Maiuscolo/minuscolo) dei caratteri.
Command (@USNT) Pointer al testo del comando da eseguire.
Done (BOOL) Attivo per un loop se ricevuto messaggio SMS contenente il testo indicato in Command.
Codici di errore
Esem!i
Esem!io LD (P&011<+000, Re1ei9e2Comman))
Mnl151c060 Pag. 161/271
7.14.1 Modem+M++end;31* send a +M+ message
Questo blocco funzione esegue l'invio di un messaggio SMS, si collega al blocco funzione di
gestione modem &odemCore, occorre passare alla FB il &odemI8 in uscita dal blocco
Su fronte attivazione ingresso di Send viene prenotato l'invio del messaggio, non appena sar
possibile il messaggio definito in Te=t verr inviato al numero definito in :9m;er. Terminato
l'invio verr attivata per un loop di programma l'uscita 8one.
+end (BOOL) Sul fronte di attivazione comanda l'invio del messaggio SMS. %ttenzione@ l messaggio sar inviato
non appena il modem libero per l'invio.
Number (@USNT) Pointer al numero di telefono a cui eseguire l'invio del messaggio.
.eEt (@USNT) Pointer al testo messaggio da inviare.
Done (BOOL) Attivo per un loop al termine dell'invio del messaggio SMS.
(ault (BOOL) Attivo per un loop se errore invio messaggio SMS.
Codici di errore
10005100~3 Errore gestione invio SMS.
Esem!i
Nell'esempio gestito l'invio di un messaggio SMS sul modem definito nella variabile &odemI8, per la definizione delle
variabili e per una migliore comprensione del funzionamento si rimanda agli esempi successivi.
Esem!io LD (P&011<+000, en)22e--age)
Mnl151c060 Pag. 162/271
In3io di un messaggio a !iH numeri
Molte volte succede di dover inviare su un evento (Esempio ingresso digitale) diversi messaggi SMS ognuno con il
proprio testo a diversi numeri telefonici. l blocco funzione S&SSend permette la gestione dell'invio sullo stesso evento
di pi messaggi, ogni messaggio contraddistinto dal numero di telefono e dal testo del messaggio.
Nell'esempio gestito l'invio di un messaggio a pi numeri di telefono. Come si pu vedere attivando l'ingresso digitale
8i$$&$$ verranno inviati due messaggi a due diversi numeri di telefono. E' possibile aggiungere altri rami con il blocco
funzione S&SSend ognuno con il proprio messaggio e numero di telefono sempre attivati da 8i$$&$$.
Esem!io LD (P&011<+000, 2*,&i0,e2en))
Mnl151c060 Pag. 163/271
Mnl151c060 Pag. 164/271
7.14.4 Modem)honeCall;31* eEecutes a !hone call
Questo blocco funzione esegue una chiamata telefonica al numero indicato, si collega al blocco
Su fronte attivazione ingresso di Call viene prenotata l'esecuzione della chiamata, non appena
sar possibile verr eseguita la chiamata al numero definito in :9m;er. Terminato il tempo
definito in Time la chiamata verr terminata. Se non vi sono problemi verr attivata per un loop
di programma l'uscita 8one.
Call (BOOL) Sul fronte di attivazione comanda 'esecuzione della chiamata. %ttenzione@ La chiamata verr
eseguita non appena il modem libero.
Number (@USNT) Pointer al numero di telefono da chiamare.
.ime (UNT) Tempo di durata chiamata (Sec).
Done (BOOL) Attivo per un loop al termine della esecuzione chiamata.
(ault (BOOL) Attivo per un loop se errore esecuzione chiamata.
Codici di errore
10037100~3 Errore gestione chiamata telefonica.
Esem!i
Nell'esempio gestita una chiamata al numero indicato. Dopo 15 secondi la chiamata viene conclusa.
Esem!io LD (P&011<+000, 2a/eP4oneCa,,)
Mnl151c060 Pag. 165/271
7.14.6 Modem?..)0et* eEecutes a ?..) 0et re8uest
Questo blocco funzione esegue una richiesta HTTP inserendo in linea dei parametri GET, si
collega al blocco funzione di gestione modem &odemCore, occorre passare il &odemI8 in
uscita dal blocco funzione di gestione modem.
Su fronte attivazione ingresso Send viene eseguita la connessione al SerDer HTPP sulla porta
Port, e richiesta la pagina Page. La pagina viene richiesta con i parametri GET definiti nel buffer
puntato da GETPars. La pagina ricevuta dal server viene trasferita nel buffer puntato da
<=B9>>er, i dati ricevuti che superano la dimensione del buffer <=S+ace sono scartati.
Terminata la ricezione della pagina richiesta si attiva per un loop l'uscita 8one, se pagina non
ritornata nel tempo definito in Time'9t l'esecuzione termina con errore.
+end (BOOL) Sul fronte di attivazione comanda richiesta pagina HTTP. %ttenzione@ La richiesta verr
+er3er (@USNT) Pointer alla stringa di definizione del server HTTP.
)ort (UNT) Porta su cui effettuare la connessione.
)age (@USNT) Pointer alla stringa di definizione pagina richiesta.
0E.)ars (@USNT) Pointer alla stringa parametri GET da inserire nella richiesta.
REBu''er (@USNT) Pointer al buffer di ricezione pagina richiesta.
R>+!ace (UNT) Dimensione in bytes del buffer di ricezione pagina.
.ime-ut (UNT) Tempo massimo attesa ricezione pagina (mS).
Done (BOOL) Attivo per un loop al termine della ricezione pagina.
(ault (BOOL) Attivo per un loop se errore ricezione pagina.
L.ime (UDNT) Tempo di caricamento pagina (mS).
Codici di errore
10042100~8 Errore gestione richiesta pagina da server HTTP.
Mnl151c060 Pag. 166/271
Esem!i
L'utilizzo tipico di questa FB di collegarsi ad un server HTTP dove sono eseguite pagine script (ASP, PHP, Phyton,
ecc) richiedendo la pagina fornendo in linea alla chiamata dei parametri in GET. Lo script della pagina potr eseguire
operazioni con i dati passati in linea e ritornare dei valori come risultato. Ecco un semplice esempio che tramite una
pagina script PHP sul server permette di inviare una Email.
Esem!io +. (P&011<+000, Emai,(i&4;TTPGe&)
(* ************************************************************************** *)
(* 0R,-R"M R.Eail;ith:TT0-etR *)
(* ************************************************************************** *)
(* This BrograE sends an .Eail bA contacting a 0:0 scriBt% *)
(* *)
(* *)
(* 3*3T3"L3W"T3,* *)
(* *)
(* -eneral initialiXations% *)
(* ,Bening the serial Bort on Iich the EodeE is connected% *)
MdE%=ile:=SAs!oBen(95,M$9, 9rI9); (* 5,M Bort !ile Bointer *)
(* Set the serial coEEunication Eode% *)
"B!:=SAs-etSerialMode("DR(SE), MdE%=ile);
SE%Baudrate:=##&+$$; (* Baudrate *)
SE%0aritA:=9*9; (* 0aritA *)
SE%DataBits:=2; (* Data bits *)
SE%StoBBits:=#; (* StoB bits *)
SE%DTRManageEent:=DTRG,==; (* DTR EanageEent *)
SE%DTR5oEBleEent:=="LS.; (* DTR coEBleEent *)
SE%.cho=lush:=TRU.; (* =lush the echo caracters *)
"B!:=SAsSetSerialMode("DR(SE), MdE%=ile);
(* ModeE BaraEeters% 0lease change theE according Aour reFuireEents% *)
MdE%"uto:angUB:=TRU.; (* "uto hanguB *)
MdE%"0*:="DR(9M+Mbis%@oda!one%it9); (* "0* de!inition *)
MdE%D*S:="DR(92%2%2%29); (* D*S de!inition *)
(* :TT0 BaraEeters% 0lease change theE according Aour reFuireEents% *)
:TT0%Ser@er:="DR(9III%MASer@er%coE9); (* :TT0 ser@er *)
:TT0%0ort:=2$; (* :TT0 Bort *)
:TT0%0age:="DR(9eMailSend%BhB9); (* 0age naEe *)
:TT0%TiEe,ut:=&$$$; (* 5onnection tiEeout (ES) *)
:TT0%-.T0ars:="DR(TMD); (* -.T BaraEeters Bointer *)
:TT0%RMBu!!er:="DR(RMD); (* RM bu!!er Bointer *)
:TT0%RMSBace:=S3W.,=(RMD); (* RM bu!!er sBace *)
.*DG3=;
(* *)
(* =Bs M"*"-.M.*T *)
(* *)
(* Manage the EodeE core% *)
Mnl151c060 Pag. 167/271
MdE(.nable:=TRU.); (* ModeE core EanageEent *)
:TT0%ModeE3D:=MdE%ModeE3D; (* ModeE 3D *)
(* Manage the :TT0 connection% *)
:TT0();
:TT0%Send:=="LS.;
(* *)
(* -.T T:. :TT0 0"-. "*D S.*D T:. .M"3L *)
(* *)
(* ,n digital inBut acti@ation the :TT0 Bage is reFuested% *)
3= (Di$$M$$ JK 0ulse) T:.*
0ulse:=Di$$M$$; (* "uMiliarA Bulse *)
3= (0ulse) T:.*
"B!:=SAs8arsnBrint!("DR(TMD), #+2, 9To=Ps9, STR3*-GTO0., "DR(9sbertanaVelsist%it9));
"B!:=SAs8arsnBrint!("DR(TMD)LL.*(TMD), #+2L.*(TMD), 9Q+7Sub>ect=Ps9, STR3*-GTO0.,
"DR(9Sub>ect9));
"B!:=SAs8arsnBrint!("DR(TMD)LL.*(TMD), #+2L.*(TMD), 9Q+7TeMt=Ps9, STR3*-GTO0., "DR(9TeMt9));
:TT0%Send:=TRU.;
.*DG3=;
.*DG3=;
(* 5hec? the :TT0 reFuest ansIer% *)
3= (:TT0%Done) T:.*
3= (=3*D(RMD, 9,?9) = $) T:.* Result:=="LS.; .LS. Result:=TRU.; .*DG3=;
.*DG3=;
(* C.nd o! !ileD *)
Vediamo di spiegare come funziona il programma, sul fronte di attivazione dell'ingresso 8i$$&$$ viene effettuata la
connessione al server ---.&7SerDer.com e richiesta l pagina e&ailSend.+*+. n linea alla chiamata della pagina
sono posti i campi GET .oIsbertanaJelsist.itK+ubLectI+ubLectK.eEtI.eEt. Da notare che il carattere "& stato
sostituito da "$26.
La pagina e&ailSend.+*+ sul server contiene uno script PHP del tipo:
JYBhB
Q:eaders=RM3M.8ersion: #%$ZnR;
Q:eaders%=R5ontenttABe: teMtNhtEl; charset=iso22&(#ZnR;
Q:eaders%=RTo: R%QGR.'U.STC9To9D%RZnR;
Q:eaders%=R=roE: ZnR;
Eail(QGR.'U.STC9To9D, QGR.'U.STC9Sub>ect9D, QGR.'U.STC9TeMt9D, Q:eaders);
echo R,?R;
eMit();
YK
Come si vede lo script invia una mail tramite il comando mail i cui campi sono valorizzati dai parametri posti in GET alla
richiesta. Lo statement VE<E6CESTQOToOR valorizzato con il testo definito in ToF, VE<E6CESTQOS9;LectOR
valorizzato con il testo definito in S9;LectF, e cos via. Come si vede possibille passare allo script tutti i valori che si
desiderano.
l valore di ritorno dallo script definito con lo statement echo verr trasferito nel buffer <=8 del nostro programma e
quindi possibile operare su di esso con le istruzioni di gestione stringa.
Mnl151c060 Pag. 168/271
7.16(unzioni ed (B gestione -neG&ire "e)LC1&ireLib#
La rete da campo 1 Wire un protocollo standard basato su di un solo filo di comunicazione, come indica lo stesso
nome, che include numerosi dispositivi e sensori frequentemente utilizzati nel campo dell'automazione industriale e
domestica.
dispositivi sono interconnessi da soli due fili, uno per la massa ed uno per il segnale e l'alimentazione; su questi due
fili possono essere collegati tutti i dispositivi in rete scegliendo la disposizione fisica necessaria.
l protocollo 1 Wire dotato di tutte le modalit di comunicazione che consentono di ottenere un elevato trasferimento
dati ed una sicurezza intrinseca sulla loro validit. Questo avviene grazie a tecniche di indirizzamento univoche, CRC
polinomiali di controllo, numerosi comandi di verifica e complessi algoritmi di gestione.
Sui sistemi SlimLine possibile connettere un convertitore
Seriale/One-Wire su una delle porte seriali COM0 o COM1 presenti
sul modulo CPU, oppure utilizzare una qualunque porta seriale
presente su un modulo di estensione per poter disporre di uno o pi
bus One-Wire.
l blocco funzione s'?ire&ng gestisce il convertitore permettendo
la gestione dei dispositivi ad esso connessi.
Mnl151c060 Pag. 169/271
7.16.1 s-&ireMng* -neG&ire management
FB ePLC1WireLib SFR059B000
Questo blocco funzione gestisce il convertitore Seriale/One-Wire connesso al dispositivo di /O
definito in 4ile, l'FB gestisce l'inizializzazione e la gestione del convertitore.
L'uscita 'n?orI si attiva se Ena;le attivo, l'uscita 4a9lt si attiva in caso di errori di gestione e
rimane attiva fino a quando l'errore permane. L'uscita %ctiDit7 si attiva durante l'attivit sul bus One-
Wire. L'FB ritorna un &ngI8 che deve essere passato alle FB collegate.
Enable (BOOL) Abilitazione blocco funzione, attivandolo viene gestito il convertitore Seriale/One-Wire.
-n&or (BOOL) Function block attivata ed in lavoro.
Acti3it/ (BOOL) Attivo se attivit sul bus One-Wire.
(ault (BOOL) Attivo se errore gestione bus One-Wire.
MngID (UDNT) One-Wire management D, da passare alle FB collegate (Esempio s'?<dIdenti>ier,
s'?<dTem+erat9re, ecc.).
Codici di errore
10008200 Timeout invio stringa comando.
10008300~9 Errore nelle configurazione convertitore.
10008400~1 Errore nella verifica configurazione.
10008500~2 Errore nelle sequenze indirizzamento device One-Wire.
10008600 Errore risposta a comando di reset pulse.
10008601 Bus One-Wire in cortocircuito.
10008602 Errore dispositivi su bus One-Wire.
10008603 Nessun dispositivo su bus One-Wire.
Mnl151c060 Pag. 170/271
7.16.2 s-&RdIdenti'ier* -neG&ire read R-M identi'ier
Questo blocco funzione esegue la lettura del codice di identificazione di un dispositivo One-Wire,
si collega al blocco funzione s'?ire&ng di gestione convertitore Seriale/One-Wire. Occorre
passare &ngI8 in uscita dal blocco funzione di gestione convertitore.
Attivando Ena;le, viene eseguita la lettura del ROM D dal dispositivo connesso al bus One-Wire
%ttenzione@ Bisogna aDere 9n solo dis+ositiDo connesso al ;9s. Al termine della lettura del
codice si attiva l'uscita 8one. Se la lettura ha esito positivo si attiva per un loop di programma
l'uscita 'I. Gli 8 bytes del ROM D sono trasferiti nell'array indirizzato da I8Code. Disattivando Ena;le si azzera 8one
e l'eventuale 4a9lt, per eseguire una nuova lettura occorre riabilitare l'ingresso Ena;le.
Enable (BOOL) Abilita il blocco funzione.
MngID (UDNT) One-Wire management D, fornito in uscita dal blocco funzione s'?ire&ng.
IDCode (@USNT) Puntatore array memorizzazione ROM D, deve essere almeno 8 bytes.
Done (BOOL) Si attiva al termine della esecuzione lettura del ROM D.
- (BOOL) Attivo per un loop se lettura ROM D eseguita correttamente.
(ault (BOOL) Attivo se errore lettura ROM D.
Codici di errore
10009010 &ngI8 non definito.
10009020 &ngI8 non corretto.
10009030 I8Code non definito.
10009100 FB '?ire&ng, gestione convertitore Seriale/One-Wire, impegnata.
10009200~2 Errore gestione sequenze One-Wire lettura D.
Mnl151c060 Pag. 171/271
Esem!i
Ecco un semplice esempio di gestione di dispositivi iButton per il riconoscimento
personale. nserendo il TAG nel lettore viene eseguita la lettura del ROM identifier, il
valore acquisito trasferito in un array di 8 bytes <'&I8.
Ciclicamente viene eseguita l'acquisizione, se un TAG inserito nel lettore viene
attivato T%GInserted.
Per semplicit nel programma non viene eseguito alcun controllo sull'D letto, ma in
un sistema di controllo accessi ad esempio possibile dall'D letto identificare la
persona ed abilitare o no l'accesso.
Esem!io LD (PTP160A600, LD_TAGRea)er)
Mnl151c060 Pag. 172/271
7.16.$ s-&Rd.em!erature* -neG&ire read tem!erature
Questo blocco funzione esegue l'acquisizione di un sensore One-Wire di temperatura
(Maxim DS18B20), si collega al blocco funzione s'?ire&ng di gestione convertitore
Seriale/One-Wire. Occorre passare &ngI8 in uscita dal blocco funzione di gestione
convertitore.
Attivando Ena;le, viene eseguita la lettura del valore di temperatura dal dispositivo
connesso al bus One-Wire, terminata l'acquisizione si attiva l'uscita 8one, se acquisizione
corretta si attiva per un loop l'uscita 'I e su Tem+erat9re, sar riportato il valore di
temperatura acquisito.
L'uscita 4a9lt si attiva in caso di errori di gestione. Disattivando Ena;le si azzera 8one e l'eventuale 4a9lt, per
eseguire una nuova lettura occorre riabilitare l'ingresso Ena;le.
Se sul bus One-Wire connesso un unico dispositivo, si pu evitare di settare I8Code oppure si pu forzare a $. Se
invece sul bus One-Wire sono presenti pi dispositivi parallelati, in I8Code occorre definire l'indirizzo dell'array di 8
bytes che contiene il ROM D del dispositivo che si vuole acquisire.
IDCode (@USNT) Puntatore ad array definizione ROM D dispositivo da acquisire. Se 0 viene eseguita lettura con
comando Skip ROM (Viene acquisito qualsiasi device connesso).
Done (BOOL) Si attiva al termine della esecuzione lettura temperatura.
- (BOOL) Attivo per un loop se lettura temperatura eseguita correttamente.
(ault (BOOL) Attivo se errore lettura temperatura.
.em!erature (REAL) Valore di temperatura acquisito (C). Range di lettura da -55 (C) a +125 (C). Precisione 0.5
(C) tra -10 (C) e +85 (C). Risoluzione di lettura 0.0625 (C).
Codici di errore
10010200~5 Errore nelle sequenze acquisizione temperatura.
Mnl151c060 Pag. 173/271
Esem!i
Viene eseguita la lettura della temperatura da un dispositivo One-Wire. Non essendo definito I8Code viene acquisito
qualsiasi dispositivo presente sul bus One-Wire %ttenzione@ 8eDe essere +resente 9n solo dis+ositiDo s9l ;9s. Se
esecuzione corretta viene attivata l'uscita 8o$$&$$ ed il valore acquisito trasferito nella variabile Tem+erat9re.
Esem!io LD (PTP160A600, LD_ing,eTem0/i0R!2)
Mnl151c060 Pag. 174/271
7.16.1 s-&Rd?umidit/* -neG&ire read humidit/
Questo blocco funzione esegue gestione di un sensore One-Wire di acquisizione umidit e
temperatura basato (Maxim DS2438). Si collega al blocco funzione '?ire&ng di gestione
convertitore Seriale/One-Wire. Occorre passare &ngI8 in uscita dal blocco funzione di
gestione convertitore.
Attivando Ena;le, viene eseguita la lettura del valore di umidit e temperatura dal
dispositivo connesso al bus One-Wire, terminata l'acquisizione si attiva l'uscita 8one, se
acquisizione corretta si attiva per un loop l'uscita 'I e su P9midit7 e Tem+erat9re, sar
riportato il valore di temperatura acquisito.
L'uscita 4a9lt si attiva in caso di errori di gestione. Disattivando Ena;le si azzera 8one e l'eventuale 4a9lt, per
eseguire una nuova lettura occorre riabilitare l'ingresso Ena;le.
Se sul bus One-Wire connesso un unico dispositivo, si pu evitare di settare I8Code oppure si pu forzare a $. Se
invece sul bus One-Wire sono presenti pi dispositivi parallelati, in I8Code occorre definire l'indirizzo dell'array di 8
bytes che contiene il ROM D del dispositivo che si vuole acquisire.
IDCode (@USNT) Puntatore ad array definizione ROM D dispositivo da acquisire.
Done (BOOL) Si attiva al termine della esecuzione lettura umidit e temperatura.
- (BOOL) Attivo per un loop se lettura umidit e temperatura eseguita correttamente.
(ault (BOOL) Attivo se errore lettura umidit e temperatura.
.em!erature (REAL) Valore di temperatura acquisito (C). Range di lettura da -55 (C) a +125 (C). Precisione 0.5
(C) tra -10 (C) e +85 (C). Risoluzione di lettura 0.03125 (C).
?umidit/ (REAL) Valore di umidit acquisito (RH%).
Codici di errore
10015200~3 Errore nelle sequenze conversione temperatura.
10015300~8 Errore nelle sequenze acquisizione tensione alimentazione sensore.
10015400~8 Errore nelle sequenze acquisizione sensore umidit.
Mnl151c060 Pag. 175/271
Esem!i
Viene eseguita la lettura della temperatura ed umidit da un dispositivo One-Wire. Non essendo definito I8Code viene
acquisito qualsiasi dispositivo presente sul bus One-Wire %ttenzione@ 8eDe essere +resente 9n solo dis+ositiDo s9l
;9s. Se acquisizione corretta viene attivata l'uscita 8o$$&$$ ed i valori acquisiti sono trasferiti nelle variabili
Tem+erat9re e P9midit7.
Esem!io LD (PTP160A600, LD_;*mi)i&'/i0R!2)
Mnl151c060 Pag. 176/271
7.17(unzioni ed (B gestione netCoring
Da linguaggio EC sono disponibili funzioni e blocchi funzione per la gestione networking.
Mnl151c060 Pag. 177/271
7.17.1 +/sI)Reach* I) address is reachable
FB Embedded 6.0
Questo blocco funzione esegue controllo se un indirizzo P raggiungibile, viene eseguito l'invio del
comando Ping al sistema e se si ottiene risposta viene attivato 8one.
La variabile <e>res* ritorna la percentuale di tempo trascorsa dall'ultima esecuzione del comando
Ping sul sistema. Raggiunto il 50% del tempo circa 25 Secondi viene eseguito un nuovo comando
Ping.
Enable (BOOL) Abilitazione blocco funzione, attivandolo viene eseguito un ping ogni 25 Sec
)eerI) (STRNG[15]) Stringa di definizione indirizzo P di cui eseguire la ricerca.
Done (BOOL) Attivo se indirizzo P raggiungibile (Risposta da Ping).
(ault (BOOL) Attivo per un loop di programma se errore gestione.
Re'resh (USNT) Percentuale di tempo da ultima esecuzione Ping.
Codici di errore
Codice Descrizione
9974005 Blocco funzione non supportato.
9974100 Blocco funzione eseguito in una task diversa da Back.
9974110 Errore indirizzo P definito PeerIP.
9974200 Errore invio richiesta Ping.
9974300 Errore risposta a richiesta Ping.
Esem!i
Nell'esempio viene controllato se l'indirizzo P 1/1.162.$.33 raggiungibile, in tal caso si attiva l'uscita <eac*ed.
Esem!io LD
Mnl151c060 Pag. 178/271
7.17.2 +/s+tListen* +ocet listen
FB Embedded 6.0
Questo blocco funzione forza il socket nella condizione di listening, occorre passare alla FB un
flusso dati stream indicato dal parametro 4ile, precedentemente aperto dalla funzione
S7s>o+en.
parametri &7IP e &7Port indicano l'interfaccia di rete e la porta su cui il socket in ascolto,
&7IP pu essere lasciato non connesso ed in tal caso viene utilizzata l'interfaccia ethernet.
parametri Li>eTm, 4l9s*Tm, <=Size, T=Size, devono essere definiti solo se si tratta di socket
TCP, possono essere lasciati non connessi nel caso di socket UDP.
L'uscita 8one si attiva se tutti i parametri sono corretti ed il socket stato messo in condizione
di listening. Quando un client si connette (Solo socket TCP) si attiva l'uscita Connect e nelle
variabili ClientIP e ClientPort sono ritornati l'indirizzo P e la porta connessa al socket.
Enable (BOOL) Abilitazione blocco funzione, attivandolo si forza socket in condizione di listening.
M/I) (STRNG[15]) Stringa di definizione indirizzo P interfaccia di rete su cui il socket gestito. Lasciandolo non
connesso o definendo O1.1.1.1O sar utilizzata interfaccia ethernet.
M/)ort (UNT]) Porta su cui sar posto in ascolto il socket.
Li'e.m (UNT]) Tempo di vita socket, se non sono ricevuti o inviati dati dopo il tempo definito il socket viene
automaticamente chiuso (Sec) (Solo per socket TCP).
(lush.m (UNT]) Tempo di flush dati, se non sono caricati dati nel socket dopo il tempo definito i dati presenti
vengono automaticmente inviati (mS) (Solo per socket TCP).
RE+ize (UNT]) Dimensione buffer ricezione dati (Solo per socket TCP).
.E+ize (UNT]) Dimensione buffer trasmissione dati (Solo per socket TCP).
Done (BOOL) Attivo se socket in condizione di listening.
Connect (BOOL) Si attiva se un client si connette al socket (Solo per socket TCP).
ClientI) (STRNG[15]) Stringa di definizione indirizzo P del client connesso al socket (Solo per socket TCP).
Client)ort (UNT]) Porta del client attualmente connesso al socket (Solo per socket TCP).
Codici di errore
Codice Descrizione
9977050 Errore allocazione blocco funzione
9977110 Tipo di stream definito in 4ile non corretto.
9977150 Errore indirizzo P dispositivo client ClientIP.
9977200 Errore indirizzo P interfaccia di rete &7IP.
9977300 Valore dimensione buffer ricezione <=Size fuori range.
9977310 Valore dimensione buffer trasmissione T=Size fuori range.
9977350 Errore nel set dei parametri TCP.
9977400 Errore set socket in listening.
Mnl151c060 Pag. 179/271
Esem!i
Nell'esempio posto in ascolto un socket TCP sulla porta 1000. Se ci si connette con un client telnet (Esempio
Hyperterminal) al sistema SlimLine sulla porta 1000, si attiver la variabile SItConnect. nviando caratteri dalla finestra
del terminale telnet, si attiver la variabile C*rs%D, i caratteri inviati saranno ricevuti dalla funzione S7s>getc e inviati in
echo verso il client telnet dalla funzione S7s>+9tc.
Esem!io LD (PTP11.A600, TCPo1/e&E14o)
Mnl151c060 Pag. 180/271
7.17.$ +/s<D)+tRc3* <D) socet recei3e
FB Embedded 6.0
Questo blocco funzione esegue la ricezione dati da un socket UDP, occorre passare alla FB un
S7s>o+en ed il socket deve essere stato posto in condizione di listening dalla funzione
S7sSItListen.
parametri PeerIP e PeerPort indicano l'indirizzo P e la porta da cui sono accettati i dati, se
non connessi sono accettate connessioni da tutti gli P e da tutte le porte.
Nel parametro <=8ata bisogna definire l'indirizzo del buffer di memoria in cui verranno trasferiti
i dati ricevuti, ed in Size occorre definire la dimensione del buffer.
Su ricezione dati si attiva l'uscita 8one e nelle variabili ClientIP e ClientPort sono ritornati
l'indirizzo P e la porta da cui sono stati ricevuti i dati, mentre in <=Size ritornato il numero di bytes dati ricevuti.
Enable (BOOL) Abilitazione blocco funzione.
)eerI) (STRNG[15]) Stringa di definizione indirizzo P da cui saranno accettate le connessioni. Lasciandolo non
connesso o definendo O1.1.1.1O saranno accettate connessioni da tutti gli P.
)eer)ort (UNT]) Porta da cui saranno accettate le connessioni, Lasciandolo non connesso o definendo 636
saranno accettate connessioni da tutte le porte.
REData (@USNT]) Puntatore al buffer dove devono essere trasferiti i dati ricevuti.
+ize (UNT]) Dimensione buffer ricezione dati.
Done (BOOL) Attivo per un loop di programma su ricezione dati.
ClientI) (STRNG[15]) Stringa di definizione indirizzo P del client da cui sono stati ricevuti i dati.
Client)ort (UNT]) Porta del client da cui sono stati ricevuti i dati.
RE+ize (UNT]) Numero di bytes di dato ricevuti.
Codici di errore
Codice Descrizione
9975050 Errore allocazione blocco funzione
9975200 Errore indirizzo P connessioni accettate PeerIP.
9975300 Errore ricezione dati da socket UDP
9975350 Errore indirizzo P client ClientIP.
Mnl151c060 Pag. 181/271
7.17.1 +/s<D)+t+end* <D) socet send
Questa funzione esegue la trasmissione dati su di un socket UDP, occorre passare un
S7s>o+en.
Nel parametro T=8ata bisogna definire l'indirizzo del buffer di memoria che contiene i
dati da trasmettere, ed in Size occorre definire il numero di bytes di dati da trasmettere.
parametri PeerIP e PeerPort indicano l'indirizzo P e la porta a cui saranno inviati i dati.
Se la trasmissione riuscita verr ritornato il numero di bytes trasmessi (Solitamente
uguale al valore definito in Size), in caso di errore viene ritornato E'4.
Parametri funzione:
.EData (@USNT]) Puntatore al buffer che contiene i dati da trasmettere.
+ize (UNT]) Numero di bytes dati da trasmettere.
)eerI) (STRNG[15]) Stringa di definizione indirizzo P a cui trasmettere i dati.
)eer)ort (UNT]) Porta a cui trasmettere i dati.
(NT)
Numero bytes trasmessi, E'4 in caso di errore
Codici di errore
n caso di errore la funzione torna con E'4, con S7sGetLastError possibile rilevare il codice di errore.
Codice Descrizione
9976100 Errore indirizzo P connessioni accettate PeerIP.
9976200 Errore trasmissione dati su socket UDP
Esem!i
Nell'esempio inviando caratteri al sistema SlimLine sulla porta 1000 da una connessione UDP, i caratteri inviati saranno
ritrasmessi sulla porta UDP del sistema client da cui sono stati ricevuti.
Mnl151c060 Pag. 182/271
Esem!io LD (PTP11.A600, #DPo1/e&E14o)
Mnl151c060 Pag. 183/271
7.17.4 <D)Data.E'er* <D) data trans'er
Questo blocco funzione esegue il trasferimento di un blocco di memoria tra due sistemi
utilizzando una connessione UDP su rete ethernet. Occorre passare alla FB un flusso dati
stream indicato dal parametro 4ile, precedentemente aperto dalla funzione S7s>o+en ed il
socket deve essere stato posto in condizione di listening dalla funzione S7sSItListen.
l parametro PeerIP indica l'indirizzo P del sistema con cui avviene il trasferimento dati,
Port indica la porta tramite la quale il trasferimento avviene (Deve assumere lo stesso
valore su entrambi i sistemi).
l parametro Timeo9t definisce il tempo massimo per il trasferimento dei dati, l'invio dei dati
si conclude con la ricezione di un acknowledge da parte dell'altro sistema, un ciclo di invio
dati e ricezione acknowledge richiede 2 loop di esecuzione programma. Se dopo l'invio non
viene ricevuto Ack entro un tempo pari a Timeo9t,0, viene effettuato un altro invio e cosi di
seguito fino allo scadere del tempo definito. Per garantire almeno 3 retries si consiglia di im+ostare come tem+o di
timeo9t 9n Dalore +ari a 1$ Dolte il tem+o massimo di loo+ (Scegliendo quello maggiore tra i due sistemi in
comunicazione).
L'invio dei dati automatico sulla variazione di uno qualsiasi dei bytes del buffer di trasmissione, per garantire il
controllo sul collegamento tra i due sistemi, ogni tempo pari a Timeo9t viene comunque eseguito un invio del buffer di
memoria.
Se i due sistemi sono in comunicazione si attiva l'uscita 8one, <=8ata'I si attiva per un loop ad ogni ricezione del
buffer dati dall'altro sistema, mentre T=8ataSent si attiva per un loop al termine della trasmissione del buffer dati verso
l'altro sistema.
)eerI) (STRNG[15]) Stringa di definizione indirizzo P del sistema con cui avviene il trasferimento dati.
)ort (UNT]) Porta tramite la quale avviene il trasferimento dati (Stesso valore su entrambi i sistemi).
REDBu''er (@USNT]) Puntatore al buffer dove devono essere trasferiti i dati ricevuti.
.EDBu''er (@USNT]) Puntatore al buffer dove sono presenti i dati da trasmettere.
B/teNr (UNT]) Numero di bytes scambiati.
.imeout (UNT]) Tempo massimo per il trasferimento del buffer dati (mS).
Done (BOOL) Attivo se i due sistemi sono in comunicazione tra di loro.
REData- (BOOL) Attivo per un loop di programma su ricezione buffer dati da altro sistema.
.EData+ent (BOOL) Attivo per un loop di programma al termine trasmissione buffer dati verso altro sistema.
Errors (UNT]) Numero di errori, incrementato ad ogni nuovo errore, raggiunto valore massimo riparte da 0.
Codici di errore
Codice Descrizione
10014200~2 Errore ricezione frame dati blocco di memoria.
10014300~2 Errore ricezione frame acknowledge.
10014400 Ricevuto comando non gestito.
10014500~1 Errore sequenze di trasmissione.
10014600 Timeout invio frame dati blocco di memoria.
Mnl151c060 Pag. 184/271
Esem!i
Nell'esempio viene scambiato un blocco di memoria di 16 bytes verso il sistema con P 192.168.0.126.
Esem!io LD (PTP11.A300, #DPDa&aTran-3er)
Mnl151c060 Pag. 185/271
7.19(unzioni ed (B su!!orto !rodotti ?C 0rou! "e?C0+!Lib#
La ditta della repubblica Ceca Hw Group http://www.hw-group.com produce dispositivi per Networking e prodotti per
telecontrollo, monitoraggio e gestione dati.
Tutti i prodotti Hw Group dispongono di connettivit su rete ethernet con protocolli TCP/P, UDP, SNMP, ed per facilitare
la connessione di questi prodotti con l'ambiente di sviluppo LogicLab, sono fornite funzioni e blocchi funzioni specifici.
Mnl151c060 Pag. 186/271
7.19.1 +.E+nm!Ac8* +.E termometer ac8uisition o3er +NM)
FB eHwGSpLib SFR060A000
Questo blocco funzione gestisce l'acquisizione del valore di temperatura delle due sonde
connesse al termometro P STE. La connessione tra il termometro e lo SlimLine avviene su rete
ethernet utilizzando il protocollo SNMP.
Occorre passare alla FB un flusso dati stream indicato dal parametro 4ile, precedentemente
aperto dalla funzione S7s>o+en come socket UDP e posto in ascolto con il blocco funzione
S7sSItListen.
Su fronte attivazione del comando %cB9ire, viene effettuata la lettura SNMP dal termometro
STE definito da indirizzo P )eerI), su porta PeerPort (Di default la porta SNMP la 161). Se il
comando %cB9ire mantenuto attivo, la lettura viene effettuata in modo ciclico.
L'uscita 8one si attiva per un loop al termine della acquisizione dei due valori di temperatura.
Ac8uire (BOOL) Comando acquisizione termometro STE. Sul fronte di attivazione si esegue la lettura del
valore di temperatura. Mantenuto attivo la lettura viene effettuata in modo ciclico.
)eerI) (STRNG[15]) Stringa di definizione indirizzo P del termometro P.
)eer)ort (UNT]) Porta utilizzata per la connessione (Di default la porta SNMP la 161).
Done (BOOL) Attivo per un loop di programma su fine lettura dati.
+ensor1 (REAL) Valore di temperatura letto dal sensore 1 (C).
+ensor2 (REAL) Valore di temperatura letto dal sensore 2 (C).
Codici di errore
10013060 Errore case gestione lettura.
10013100 Errore controllo indirizzo P del dispositivo STE.
10013120 Errore ricezione dati da dispositivo STE.
10013200~1 Errore lettura sensore 1.
10013300~1 Errore lettura sensore 2.
Mnl151c060 Pag. 187/271
Esem!i
Nell'esempio gestita l'acquisizione dei due valori di temperatura da un termometro STE ogni secondo. l valore di
temperatura in gradi centigradi ritornato sulle variabili Tem+erat9reQ$R e Tem+erat9reQ1R. L'uscita logica 8o$$&$$ si
attiva alla prima esecuzione della acquisizione, mentre l'uscita logica 8o$1&$$ si attiva in caso di errore di
acquisizione.
Esem!io LD (PTP166A000, LD_TEnm0A17)
Mnl151c060 Pag. 188/271
7.19.2 s?&g+)rotocol* ?& grou! serial !rotocol
FB eHwGSpLib SFR060A200
Questo blocco funzione gestisce la lettura di dispositivi HW group con il protocollo seriale RS485.
Occorre passare alla FB il puntatore al file di porta seriale stream indicato dal parametro 4ile,
precedentemente aperto dalla funzione S7s>o+en.
Attivando l'ingresso Ena;le viene effettuata la lettura del valore dal dispositivo connesso alla
porta seriale definita, terminata l'esecuzione si attiva l'uscita 8one. Se il comando ha avuto esito
positivo si attiva l'uscita 'I, in caso contrario si attiva l'uscita 4a9lt.
Per seguire nuovamente il comando occorre riabilitare l'ingresso Ena;le, l blocco funzione
stato realizzato per permetterne la connessione in cascata. n pratica possibile connettere al
8one di un FB l'Ena;le di un'altro e cos di seguito.
Address (STRNG[1]) Stringa di definizione indirizzo dispositivo.
- (BOOL) Si attiva se acquisizione valore riuscita.
(ault (BOOL) Si attiva su errore gestione.
.E(rame (STRNG[8]) Contiene il frame inviato al dispositivo, pu essere utilizzato in debug.
RE(rame (STRNG[16]) Contiene il frame ricevuto dal dispositivo, pu essere utilizzato in debug.
2alue (REAL) Valore acquisito dal dispositivo.
Codici di errore
n caso di errore si attiva l'uscita 4a9lt, il valore di Errors si incrementa e con S7sGetLastError possibile rilevare il
codice di errore.
10032100 FB usata in task fast o slow.
10013200~1 Errore nella gestione del protocollo di comunicazione.
10032300 Errore lettura valore.
Mnl151c060 Pag. 189/271
Esem!i
Nell'esempio gestita l'acquisizione del valore di temperatura e di umidit da un HTemp.
Esem!io LD (PTP166A000, LD_;T%o=Rea))
Mnl151c060 Pag. 190/271
7.1:(unzioni ed (B su!!orto !rotocollo NMEA "eNMEALib#
NMEA 0183 (O pi comunemente NMEA) uno standard di comunicazione di dati utilizzato soprattutto in nautica e
nella comunicazione di dati satellitari GPS. L'ente che gestisce e sviluppa il protocollo la National Marine Electronics
Association.
Questo protocollo si basa sul principio che la fonte, detta talker, pu soltanto inviare i dati (sentences) e la ricevente,
detta listener, pu soltanto riceverli.
La libreria e:&E%Li; fornisce una serie di funzioni e blocchi funzione per gestire le sentenze NMEA, in pratica
possibile realizzare programmi con l'ambiente di sviluppo LogicLab che si comportano come listeners di sentenze
NMEA.
Mnl151c060 Pag. 191/271
7.1:.1 NMEA+Inter'ace* NMEA s/stem inter'ace
FB eNMEALib SFR061A000
Questo blocco funzione gestisce l'interfaccia verso un dispositivo che invia sentenze NMEA
connesso al dispositivo di /O definito in 4ile, questo un blocco funzione protetto per utilizzarlo
occorre richiedere il codice di protezione, vedi +rotezione >9nzioni e ;locc*i >9nzione. E'
comunque possibile utilizzarlo liberamente in modo test per 30 Min.
L'FB riceve le sentenze NMEA dal dispositivo, ne controlla il prefisso comparandolo con la
stringa definita in 8I8, controlla se la sentenza ricevuta corretta (Controllo sul CRC). L'uscita
8one si attiva per un loop ad ogni ricezione di sentenza NMEA corretta.
L'FB ritorna un :&E%I8 che deve essere passato alle FB collegate (FB di gestione sentenze NMEA). L'uscita
<=String riportano la stringa ricevuta dal dispositivo, in questo modo possibile visualizzare in debug la
comunicazione con il dispositivo permettendo di visualizzare eventuali errori.
DID (STRNG[2]) Stringa di definizione prefisso dispositivo.
Done (BOOL) Attivo per un loop di programma su ricezione sentenza corretta.
NMEAID (UDNT) D interfaccia con sistema NMEA da passare alle FB collegate.
RE+tring (STRNG[82]) Contiene la stringa ricevuta dal dispositivo, pu essere utilizzato in debug per verificare le
sentenze ricevute.
Codici di errore
10017100~4 Errore ricezione sentenza NMEA.
Mnl151c060 Pag. 192/271
7.1:.2 0LL+entence* 0eogra!hic )osition sentence
Questo blocco funzione esegue la ricezione della sentenza GLL Geographic Position, si
collega al blocco funzione :&E%SInter>ace di gestione dispositivo NMEA. Occorre
passare :&E%I8 in uscita dal blocco funzione di gestione dispositivo.
La sentenza GLL contiene le informazioni di latitudine, longitudine ora e fix, esempio di
sentenza VIIGLL,001/.$133,:,$$21/.663,E,$20$.$$,%,1G$/.
L'FB controlla correttezza dei campi della sentenza e ne estrae le informazioni di latitudine,
longitudine e tempo. L'uscita 8one si attiva per un loop ad ogni ricezione di sentenza GLL
corretta.
NMEAID (UDNT) D interfaccia con sistema NMEA fornito in uscita dal blocco funzione :&E%SInter>ace.
Done (BOOL) Attivo per un loop di programma su ricezione sentenza GLL corretta.
(ault (BOOL) Attivo per un loop di programma se errore sentenza.
Latitude (REAL) Valore di latitudine indicato nella sentenza, il valore espresso in frazione di gradi. Valori
positivi indicano latitudine nord, valori negativi latitudine sud.
Longitude (REAL) Valore di longitudine indicato nella sentenza, il valore espresso in frazione di gradi. Valori
positivi indicano longitudine est, valori negativi longitudine ovest.
<.C?our (USNT) Valore di ora UTC indicato nella sentenza.
<.CMinute (USNT) Valore di minuti UTC indicato nella sentenza.
<.C+econd (USNT) Valore di secondi UTC indicato nella sentenza.
Codici di errore
10018010 :&E%I8 non definito.
10018020 :&E%I8 non corretto.
10018100~2 Errore nel valore di latitudine.
10018200~2 Errore nel valore di longitudine.
10018300~2 Errore nel valore ora UTC.
Mnl151c060 Pag. 193/271
Esem!i
E' disponibile un programma di esempio Ptp123*000 che gestisce l'interfaccia verso un navigatore satellitare con
l'interpretazione di alcune sentenze NMEA.
Nell'esempio riportato gestita la ricezione di una sentenza GLL.
Esem!io LD
Mnl151c060 Pag. 194/271
7.1:.$ M&2+entence* &ind +!eed and Angle sentence
Questo blocco funzione esegue la ricezione della sentenza MWV wind speed and angle, si
collega al blocco funzione :&E%SInter>ace di gestione dispositivo NMEA. Occorre passare
:&E%I8 in uscita dal blocco funzione di gestione dispositivo.
La sentenza MWV contiene le informazioni di velocit e direzione del vento, esempio di sentenza
VII&?V,11$.$/,<,0.3,:,%G3.
L'FB controlla correttezza dei campi della sentenza e ne estrae le informazioni di velocit e
direzione. L'uscita 8one si attiva per un loop ad ogni ricezione di sentenza MWv corretta.
NMEAID (UDNT) D interfaccia con sistema NMEA fornito in uscita dal blocco funzione :&E%SInter>ace.
Done (BOOL) Attivo per un loop di programma su ricezione sentenza MWV corretta.
(ault (BOOL) Attivo per un loop di programma se errore sentenza.
&+!eed (REAL) Valore di velocit del vento (Nodi).
&)Angle (REAL) Valore angolo polare (Relative) direzione vento.
Codici di errore
10020010 :&E%I8 non definito.
10020020 :&E%I8 non corretto.
10020100 Errore nel valore di velocit vento.
Mnl151c060 Pag. 195/271
7.2%(unzioni ed (B su!!orto in3erter )oCer -ne "e)oCer-neLib#
Power One uno dei principali produttori mondiale di sistemi di alimentazione. Power One di diritto anche nel settore
delle energie alternative con applicazioni per sistemi eolici ed inverter fotovoltaici. Oggi una strategia convincente
nell'ambito delle energie alternative non pu prescindere dallo sviluppo di soluzioni per il risparmio energetico.
La linea di nverter fotovoltaici Aurora, comprende sia modelli per la connessione in rete sia isolati, con o senza
trasformatore e concepiti per applicazioni da esterno e da interno. Tutti i prodotti della gamma si posizionano per
soluzioni di progetto e tecnologia costruttiva ai vertici del mercato e sono caratterizzati da elevatissima affidabilit,
innovazione ed efficienza.
InDerter %9rora
Alta efficienza di conversione e estrema facilit di manutenzione grazie alla possibilit di inserzione e disinserzione
rapida dei moduli fotovoltaici. La scalabilit del sistema grazie alla architettura "Add-on" consente di coprire un'ampia
gamma di applicazioni (fino a 300kW su singolo armadio).
Disponibile anche la versione senza trasformatore BT per connessione diretta ad una cella di media tensione (con trasf.
MT).
Mnl151c060 Pag. 196/271
7.2%.1 AuroraD+)Measure* Aurora measure re8uest to D+)
FB ePowerOneLib SFR062A000
Questo blocco funzione esegue la lettura delle misure dal DSP di un inverter Aurora della Power
One, connesso al dispositivo di /O definito in 4ile. Questo un blocco funzione protetto per
utilizzarlo occorre richiedere il codice di protezione, vedi +rotezione >9nzioni e ;locc*i
>9nzione. E' comunque possibile utilizzarlo liberamente in modo test per 30 Min. Viene utilizzato il
FB C<CPolinomial per il calcolo del CRC dei frame dati da e verso l'inverter.
La connessione con gli inverters in RS485 multidrop, occorre definire in %ddress l'indirizzo
dell'inverter con cui si vuole dialogare. n &eas9re occorre indicare il codice della misura da
leggere (Vedi codici misura).
Attivando l'ingresso Start viene eseguita la lettura della misura indicata, terminata la lettura viene attivata per un loop
l'uscita 8one, in caso di errore esecuzione viene attivata per un loop l'uscita 4a9lt ed incrementato il valore in Errors.
+tart (BOOL) Comando di esecuzione lettura misura.
Address (USNT) ndirizzo inverter (Range da 0 a 255).
Measure (USNT) Tipo misura da effettuare su inverter (Vedi codici misura).
Done (BOOL) Attivo per un loop al termine della esecuzione del comando.
(ault (BOOL) Attivo per un loop su errore esecuzione del comando.
2alue (REAL) Valore misura acquisito da inverter (E' nella relativa unit di misura).
Codici misura
Nella variabile &eas9re occorre definire il codice della misura da effettuare dall'inverter secondo la tabella.
Codice Descrizione <m
1 Grid Voltage (For three-phases systems is the mean) V
2 Grid Current (For three-phases systems is the mean) A
3 Grid Power (For three-phases systems is the mean) W
4 Frequency (For three-phases systems is the mean) Hz
5 Vbulk (For nverter with more Bulk is the sum) V
6 leak (Dc/Dc) A
7 leak (nverter) A
21 nverter Temperature C
22 Booster Temperature C
23 nput 1 Voltage (nput Voltage for single channel module) V
25 nput 1 Current (nput Current for single channel module) A
26 nput 2 Voltage (nput Voltage for single channel module) V
27 nput 2 Current (nput Current for single channel module) A
28 Grid Voltage (Dc/Dc) V
29 Grid Frequency (Dc/Dc) Hz
Mnl151c060 Pag. 197/271
30 solation Resistance (Riso)
31 Vbulk (Dc/Dc) V
32 Average Grid Voltage (VgridAvg) V
33 VbulkMid V
34 Power Peak W
35 Power Peak Today W
36 Grid Voltage neutral V
37 Wind Generator Frequency Hz
38 Grid Voltage neutral-phase V
39 Grid Current phase r A
40 Grid Current phase s A
41 Grid Current phase t A
42 Frequency phase r Hz
43 Frequency phase s Hz
44 Frequency phase t Hz
45 Vbulk + V
46 Vbulk - V
47 Supervisor Temperature C
48 Alim. Temperature C
49 Heat Sink Temperature C
61 Grid Voltage phase r V
62 Grid Voltage phase s V
63 Grid Voltage phase t V
Codici di errore
10030100 Errore CRC risposta da inverter Aurora.
10030200 Errore ricezione "Transmission state da inverter Aurora.
10030251 Errore da inverter Aurora "Command is not implemented.
10030252 Errore da inverter Aurora "Variable does not exist.
10030253 Errore da inverter Aurora "Variable value is out of range.
10030254 Errore da inverter Aurora "EEprom not accessible.
10030255 Errore da inverter Aurora "Not Toggled Service Mode.
10030256 Errore da inverter Aurora "Can not send the command to internal micro.
10030257 Errore da inverter Aurora "Command not Executed.
10030258 Errore da inverter Aurora "The variable is not available, retry.
Mnl151c060 Pag. 198/271
Esem!i
Viene eseguita la lettura della misura 21 (nverter Temperature) dall'inverter con indirizzo 4, il valore ritornato trasferito
nella variabile Val9e. Di default la porta seriale v impostata a 1/1$$, n 2, 1.
Esem!io LD
Mnl151c060 Pag. 199/271
7.2%.2 AuroraCEnerg/* Aurora cumulated energ/ reading
Questo blocco funzione esegue la lettura della energia generata da un inverter Aurora della
Power One, connesso al dispositivo di /O definito in 4ile. Questo un blocco funzione
protetto per utilizzarlo occorre richiedere il codice di protezione, vedi +rotezione >9nzioni e
;locc*i >9nzione. E' comunque possibile utilizzarlo liberamente in modo test per 30 Min.
Viene utilizzato il FB C<CPolinomial per il calcolo del CRC dei frame dati da e verso
l'inverter.
La connessione con gli inverters in RS485 multidrop, occorre definire in %ddress l'indirizzo
dell'inverter con cui si vuole dialogare. n Parameter occorre indicare il parametro da leggere
(Vedi codici parametro).
Attivando l'ingresso Start viene eseguita la lettura della misura indicata, terminata la lettura viene attivata per un loop
l'uscita 8one, in caso di errore esecuzione viene attivata per un loop l'uscita 4a9lt ed incrementato il valore in Errors.
+tart (BOOL) Comando di esecuzione lettura misura.
Address (USNT) ndirizzo inverter (Range da 0 a 255).
)arameter (USNT) Codice parametro da acquisire da inverter (Vedi codici parametro).
2alue (UDNT) Valore parametro acquisito da inverter (E' nella relativa unit di misura).
Codici !arametro
Nella variabile Parameter occorre definire il codice del parametro da leggere dall'inverter secondo la tabella.
0 Daily energy Kw
1 Weekly Energy Kw
3 Month Energy (Energy from the first day of current calendar month) Kw
4 Year Energy (Energy from the first day of current calendar year) Kw
5 Total Energy (Total lifetime) Kw
6 Partial Energy (Cumulated since reset) Kw
Codici di errore
10031060 Codice parametro errato.
10031100 Errore CRC risposta da inverter Aurora.
Mnl151c060 Pag. 200/271
Esem!i
Viene eseguita la lettura del totale energia prodotta dall'inverter con indirizzo 1, il valore ritornato trasferito nella
variabile Val9e. Di default la porta seriale v impostata a 1/1$$, n 2, 1.
Esem!io LD
Mnl151c060 Pag. 201/271
7.2%.$ CRC)olinomial* CRC !olinomial calculation
Questo blocco funzione esegue il calcolo del CRC su di un array di dati in accordo allo standard
CCTT. Questo tipo di CRC utilizzato come controllo sul frame dati da e verso l'inverter Aurora.
n 8ata occorre indicare l'indirizzo dell'array di dati su cui calcolare il CRC, Lengt* indica la
lunghezza dell'array in byte. n C<C ritornato il valore del CRC calcolato.
Data (@USNT) ndirizzo array dati su cui eseguire il calcolo del CRC.
Length (USNT) Lunghezza array in bytes.
CRC (UNT) CRC calcolato.
Esem!i
Viene eseguito il calcolo del CRC su di un array di dati. Supponendo di avere un array di 8 bytes allocato in DB100
all'indirizzo 16 che contiene i valori 16#04, 16#3B, 16#1B, 16#00, 16#00, 16#00, 16#00, 16#00 , il CRC calcolato sar
16#5AF0.
Esem!io LD
Mnl151c060 Pag. 202/271
7.21(unzioni ed (B su!!orto log "eLogLib#
Questa libreria rende disponibili una serie di funzioni e di blocchi funzione per la gestione di logs.
0estione in3io noti'iche a ser3er +/slog
SYSLOG (System Log) un protocollo appartenente alla Suite di protocolli nternet utilizzato per trasmettere attraverso
una rete semplici informazioni di log. l protocollo stato standardizzato dall' ETF.
Generalmente viene utilizzato via UDP attraverso la porta 514; in particolari applicazioni dove il monitoraggio
fondamentale oppure certi eventi possono innescare azioni da parte del server SYSLOG, si ricorre ad implementazioni
TCP e/o a crittografia.
l client invia un certo messaggio di testo, al massimo 1024 caratteri, al server, comunemente definito come "syslogd",
"syslog daemon" o "syslog server". La semplicit del protocollo fa s che il server possa gestire messaggi provenienti da
una variegata tipologia di macchine, da computer, stampanti, dispositivi di rete, macchinari, ecc. l server pu limitarsi a
registrare l'evento, per avere un archivio centrale degli avvenimenti, oppure reagire a particolari livelli di severit
chiamando programmi, inviando e-mail, ecc. ecc.
Un messaggio di notifica inviato al server Syslog inizia con un indicatore di impianto 4acilit7 e di gravit SeDerit7. Di
seguito tabelle con indicazione dei codici assegnati.
4acilit7 codes
0 Kernel messages
1 User-level messages
2 Mail system
3 System daemons
4 Security/authorization messages
5 Messages generated internally by syslogd
6 Line printer subsystem
7 Network news subsystem
8 UUCP subsystem
9 Clock daemon
10 Security/authorization messages
11 FTP daemon
12 NTP subsystem
SeDerit7 codes
0 Emergencies Sistema inutilizzabile
1 Alerts Richiede intervento immediato
2 Critical Condizioni critiche
3 Errors Condizione d'errore
4 Warnings Condizioni di warning
5 Notifications Condizioni di anomalia non critici (bugs)
6 nformational Messaggi informativi
7 Debugging Messaggi di debug
l messaggio prosegue poi con l'indicazione di data e ora, del nome del dispositivo che ha inviato il messaggio
Postname ed il testo del messaggio &essage.
Mnl151c060 Pag. 203/271
+er3er +/slog
Un server SYSLOG un punto centrale dove far arrivare tutti i messaggi di errore dei vari apparati hardware e software
di una rete quali router, switch, server, stampanti ecc... per avere un controllo centralizzato degli errori degli apparati.
SYSLOG particolarmente diffuso in unix e conseguentemente sotto linux, in ambiente windows esistono programmi
freeware e/o a pagamento per la gestione del server. l server pu selezionare (filtrare) i messaggi in arrivo in base a
diversi criteri, ad ogni selezione corrisponde almeno una azione.
n pratica si tratta di stabilire dei criteri di selezione e l'azione da intraprendere in funzione della provenienza e tipo di
messaggio
Il criterio di selezione +9W essere ad esem+io)
Priorit, ndirizzo P del mittente del messaggio, Nome del Host, Testo (o parte di esso) del messaggio, ntervallo di
tempo di uno o pi giorni della settimana.
Le azioni +ossono essere ad esem+io)
Nessuna (ignorare il messaggio), Visualizzarlo nel programma di monitoraggio, nviarlo ad un altro Syslog server,
Emettere un suono di allarme, Eseguire un programma, nviare un E-mail, Memorizzare il messaggio in un Database
(esempio MySQL), Memorizzare il messaggio in un logfile, Eseguire uno script, ecc...
Per le mie necessit ho utilizzato S7slog ?atc*er (Sito http://www.snmpsoft.com), un ottimo programma gratuito, di
seguito uno screenshot con la visualizzazione di notifiche inviate da un sistema SlimLine.
Come si vede le varie notifiche sono suddivise con colori in base alla loro importanza e nel testo del messaggio
possibile riportare qualsiasi informazione ad esempio il codice operatore che ha avuto accesso all'ingresso rilevato da
un lettore RFD.
Mnl151c060 Pag. 204/271
7.21.1 +/sLogRe!ort* send a re!ort to +/slog ser3er
FB eLogLib SFR065A000
Questo blocco funzione esegue l'invio di messaggi di notifica ad un server Syslog il cui
indirizzo P definito in S7slogIP e la porta in S7slogPort. Questo un blocco funzione
protetto per utilizzarlo occorre richiedere il codice di protezione, vedi +rotezione >9nzioni e
;locc*i >9nzione. E' comunque possibile utilizzarlo liberamente in modo test per 30 Min.
E' possibile impostare sia il codice di impianto 4acilit7 che di gravit SeDerit7 oltre al nome
del sistema host Postname.
Attivando l'ingresso Send viene inviata la notifica al server Syslog, eseguito l'invio viene
attivata per un loop l'uscita 8one, in caso di errore esecuzione viene attivata per un loop
l'uscita 4a9lt.
+end (BOOL) Comando di invio notifica.
Mode (USNT) Modo operativo, 0:UDP.
+/slogI) (STRNG[16]) ndirizzo P server Syslog
+/slog)ort (UNT) Porta utilizzata dal server Syslog.
(acilit/ (USNT) Codice impianto.
+e3erit/ (USNT) Codice gravit.
?ostName (STRNG[32]) Nome sistema che invia il messaggio di notifica.
Message (STRNG[160]) Testo descrittivo del messaggio di notifica.
Enabled (BOOL) Attivo su abilitazione blocco funzione.
Done (BOOL) Attivo per un loop al termine dell'invio del messaggio di notifica.
Codici di errore
10034100 Server Syslog non raggiungibile, il server non risponde al ping.
Mnl151c060 Pag. 205/271
Esem!i
Nel seguente esempio sono acquisiti gli /O del modulo CPU, utilizzando i due ingressi possibile eseguire l'invio di un
messaggio di notifica al server Syslog con P 192.168.0.81 sulla porta 514 in UDP.
Esem!io LD
Mnl151c060 Pag. 206/271
7.21.2 +tring.oLog(ile* sal3a una stringa in un 'ile di log
Questo blocco funzione effettua il log della stringa StringToLog nel file su disco di
nome 4ilename. Ogni riga viene terminata con CR-LF. Al raggiungimento di
&a=<o-sIn4ile righe nel file, se Circ9lar settato, si riprende a salvare dall'inizio del
file sovrascrivendo le righe gi presenti. Se Circ9lar non settato non viene pi
effettuato il log segnalando errore. La variabile &a=<o-sLen permette di limitare la
lunghezza massima di ciascuna riga presente nel file di log.
Se Circ9lar settato se la lunghezza di StringToLog inferiore a &a=<o-sLen,
vengono aggiunti degli spazi sino ad avere lunghezza definita. n <o-Inde=Ptr
occorre inserire l'indirizzo della variabile usata come indice della successiva riga in cui
fare log. Normalmente deve essere una variabile tamponata per permettere di scrivere
nel punto giusto anche dopo uno spegnimento-accensione del sistema. Se invece non
si usa una variabile tamponata, ad ogni spegnimento-accensione, si ripartir a scrivere
dall'inizio del file. Quindi si pu scegliere il comportamento voluto.
Questo un blocco funzione protetto. Per utilizzarlo occorre richiedere il codice di protezione, vedi +rotezione >9nzioni
e ;locc*i >9nzione. E' comunque possibile utilizzarlo liberamente in modo test per 30 Min.
Attivando l'ingresso ?rite viene salvata su disco la stringa StringToLog. Eseguito il salvataggio, viene attivata per un
loop l'uscita 8one. n caso di errore esecuzione viene attivata per un loop l'uscita 4a9lt.
&rite (BOOL) Comando di scrittura di StringToLog nel file.
+tring.oLog (STRNG[160]) Stringa di cui fare log.
(ilename (STRNG[32]) Percorso e nome del file in cui fare log (es.: 'SDCard/MyFile.txt').
Circular (BOOL) ndica se effettuare il riporto circolare delle righe di log.
MaERoCLen (USNT) Numero massimo di caratteri costituenti la singola riga del file di log.
MaERoCsIn(ile (UDNT) Numero massimo di righe nel file.
RoCIndeE)tr (@UDNT) Pointer alla variabile usata come indice della successiva riga di log.
Done (BOOL) Attivo per un loop se la scrittura nel file riuscita.
Codici di errore
n caso di errore si attiva l'uscita 4a9lt e con S7sGetLastError possibile rilevare il codice di errore.
10035020 FB protetta. Terminato il tempo di funzionamento in modo demo.
10035100 l valore di &a=<o-Len troppo grande.
10035110 Raggiunto il massimo numero di righe di log.
10035120 Errore apertura file.
10035130 Errore posizionamento nel file.
10035140 Errore scrittura nel file.
10035150 Errore chiusura file.
Mnl151c060 Pag. 207/271
Esem!i
Nel seguente esempio ad ogni attivazione dell'input 8i$$&$$, viene salvata la stringa presente in Str nel file di nome
S8Card,&7Log.t=t. Avendo impostato Circ9lar uguale T<CE, al raggiungimento di 10 log, l'undicesimo sovrascrive il
primo. La variabile LogInde= una variabile mappata nell'area delle variabili tamponate.
Esem!io LD
Mnl151c060 Pag. 208/271
7.21.$ (ileMemor/Dum!* dum! memoria su 'ile
Questo blocco funzione effettua il dump di una zona di memoria memoria a partire da
indirizzo definito in &B9>>erPtr per il numero di bytes definito in &B9>>erSize su di un file
su disco di nome 4ilename.
Con un comando impulsivo su ingresso ?rite viene creato il file ed il contenuto della
memoria viene scritto nel file. Con un comando impulsivo su ingresso <ead viene letto il
file ed il suo contenuto trasferito in memoria.
Terminato il comando viene attivata per un loop l'uscita 8one, in caso di errore esecuzione
viene attivata per un loop l'uscita 4a9lt.
l file di dump su disco un file ascii quindi possibile editarlo con un qualsiasi text editor, ecco un esempio di file.
$$$$$$$$: $$ "B #+ )6 $$ $$ $$ $$ S $$ $$ $$ #+ $$ $= $" 55
$$$$$$#$: $+ $$ $$ $$ $$ $$ $$ $$ S .= 5$ DD $$ $$ $$ $# $$
Read (BOOL) Comando di lettura da dump file in memoria.
&rite (BOOL) Comando di scrittura memoria su dump file.
(ilename (STRNG[32]) Percorso e nome del file in cui fare log (es.: 'Storage/Dump.txt').
MBu''er)tr (@USNT) Pointer a buffer di memoria su cui opera il dump.
MBu''er+ize (UDNT) Dimensione in bytes del buffer di memoria.
Done (BOOL) Attivo per un loop se comando eseguito.
Codici di errore
10036200 Errore apertura file su comando di lettura.
10036210 Errore posizionamento file su comando di lettura.
10036220 Errore lettura da file su comando di lettura.
10036230 Errore chiusura file su comando di lettura.
10036240~4 Errore dati presenti su file di dump su comando di lettura.
10036400 Errore apertura file su comando di scrittura.
10036410 Errore posizionamento file su comando di scrittura.
10036420 Errore scrittura su file su comando di scrittura.
10036430 Errore chiusura file su comando di scrittura.
Mnl151c060 Pag. 209/271
Esem!i
Nel seguente esempio sul fronte di attivazione dell'input 8i$1&$$ viene eseguito il dump del buffer di memoria
89m+B9>>er nel file Storage,89m+.t=t. Dopo aver eseguito il dump attivando l'input 8i$1&$$ possibile rileggere i
dati dal file di dump e ritrasferirli nel buffer di memoria.
Esem!io LD
Mnl151c060 Pag. 210/271
7.21.1 +!/Data(ile* s!ia i dati e li memorizza su 'ile
Questo blocco funzione spia i dati puntati da S+7Ptr e li salva nel file 4ilename, il file viene
inizializzato sulla abilitazione del blocco funzione. l comando di memorizzazione viene dato dal
valore in S+7Trg. La variabile S+7Trg un UDNT di cui i 2 bytes alti sono trasferiti sul file come
caratteri e servono ad identificare i dati spiati, mentre i 2 bytes bassi indicano la dimensione in
bytes del dato da spiare.
Se il valore di bytes del dato da spiare diverso da "0 viene eseguita la memorizzazione nel file
con una riga di log di lunghezza massima <o-Len. Terminata la scrittura del numero di righe
4ile<o-s la scrittura riparte dall'inizio sovrascrivendo le vecchie righe di log.
Se la dimensione in bytes dei dati da spiare supera la lunghezza della riga del file i dati vengono
troncati. Nel calcolo dei bytes di spy disponibili per ogni riga di file occorre ricordare che ogni riga
viene preceduta da un timestamp ed un header che in totale usano 22 caratteri. Ecco come si presentano le righe
salvate nel file:
##:)6:)+%2&(SRMS$$$#7S"TL5L30=#%%%,H%%
##:)6:))%#1#SRMS$$$+6S"TL5*M3=$,$,$,$,#%%%,H%%
La riga inizia con il valore di data/ora a cui aggiunta l'indicazione dei millisecondi, segue il campo che riporta i due
caratteri definiti in S+7Trg (Se non presenti viene ritornato ), il campo che riporta la lunghezza in bytes dei dati da
spiare, ed infine il dato spiato.
(ormat (USNT) Definizione formato memorizzazione dati spiati.
0 %scii, dati sono ritornati come caratteri ascii. caratteri non stampabili sono sostituiti
dal carattere "..
1 %scii -it* 9n+rinta;le c*ars, dati sono ritornati come caratteri ascii. caratteri non
stampabili sono ritornati in esadecimale nel formato [hh].
2 Pe=adecimal, dati sono scritti in formato esadecimale.
+!/.rg (UDNT) Comando trigger spy dati. Nei due bytes pi alti possibile definire due caratteri ascii che
saranno ritornati nella riga sul file. Nei due bytes bassi possibile definire la dimensione in
bytes del dato da spiare.
+!/)tr (@USNT) Puntatore al buffer che contiene i dati da spiare.
(ilename (STRNG[32]) Percorso e nome del file in cui fare log (es.: 'Storage/Spy.csv').
RoCLen (UDNT) Numero massimo di caratteri costituenti la singola riga del file.
(ileRoCs (UDNT) Numero massimo di righe nel file.
(ault (BOOL) Attivo per un loop su errore esecuzione.
Codici di errore
10043020 Non stato definito il valore di S+7Ptr.
10043100~1 Errore cancellazione file.
10043200~3 Errore scrittura file.
Mnl151c060 Pag. 211/271
Esem!i
Nel seguente esempio sul fronte di attivazione dell'input 8i$$&$$ viene eseguito lo spy della stringa "Test message nel
file Storage,S+7.csD. Nel comando di trigger S+7Trg sono definiti come caratteri ascii il valore "Rx definito il codice
ascii del carattere "R 16#52 e del carattere "x 16#78.
Dopo aver attivato alcune volte l'input 8i$$&$$ troveremo nel file S+7.csD qualcosa di simile a questo:
#1:&+:#6%()#SRMS$$$#)STest Eessage%
#1:&+:#&%+)#SRMS$$$#)STest Eessage%
Esem!io +.
(* *)
(* D"T" S0O *)
(* *)
(* Set =B BaraEeters% *)
SBA%=ilenaEe:=9StorageNSBA%cs@9; (* =ile naEe *)
SBA%=orEat:=$; (* SBA !orEat *)
SBA%RoILen:=2$; (* =ile roI length *)
SBA%=ileRoIs:=#$$; (* =ile roIs nuEber *)
SBA(.nable:=TRU.); (* =B calling *)
SBA%SBATrg:=$; (* SBA trigger (RM)*)
SBA%SBA0tr:="DR(9Test EessageQr9); (* Data to sBA Bointer *)
(* BA acti@ating the logic inBut the sBA is done% *)
3= (Di$$M$$ JK 0ulseC$D) T:.*
0ulseC$D:=Di$$M$$; (* ,ne shot *)
3= (Di$$M$$) T:.*
SBA%SBATrg:=#7T&+12$$$$LeL.*(SBA%SBA0tr); (* SBA trigger (RM) *)
.*DG3=;
.*DG3=;
Mnl151c060 Pag. 212/271
7.22(unzioni ed (B comunicazione multimaster "eMMasterD.E'erLib#
Questa libreria rende disponibili una serie di funzioni e di blocchi funzione per la gestione della comunicazione
multimaster su linea seriale. La possibilit di fare dialogare su una unica linea seriale RS422/485 pi dispositivi master
permette di velocizzare il dialogo tra i sistemi ottimizzando l'impegno della linea seriale.
Questa particolarit molto apprezzata nelle connessioni radio, dove radiomodems che sfruttano tutti la stessa
frequenza possono dialogare tra di loro minimizzando l'impegno della banda ed aumentando i tempi di trasferimento
delle informazioni.
Nelle comunicazioni tra diversi sistemi su doppino seriale e/o con radiomodems tipicamente si utilizza un protocollo a
pacchetto (Esempio modbus) ed uno dei sistemi che funge da master dialoga ciclicamente con tutti gli altri sistemi della
rete scambiando le informazioni tra di loro. Come si pu ben capire questa soluzione ha i seguenti difetti:
a) Tutta la comunicazione delegata al sistema master, nel caso di guasto di quest'ultimo tutta la rete ferma.
b) l sistema master deve interrogare i vari sistemi slaves per conoscere se hanno dati da inviare al master od agli
altri slaves. Questo implica un impegno del canale di comunicazione anche quando gli slaves non hanno
informazioni utili da scambiare.
c) Lo scambio dati tra due sistemi slaves deve passare dal sistema master e questo rallenta l'invio dei dati da un
sistema all'altro oltre ad un maggiore impegno del canale di comunicazione.
Utilizzando questa libreria possibile fare dialogare i diversi sistemi direttamente tra di loro in modalit peer to peer. n
questo modo un sistema invia dati all'altro solo quando necessario garantendo un rapido invio dei dati con il minimo
impegno del canale di comunicazione.
Mnl151c060 Pag. 213/271
7.22.1 MMasterData.E'er* multimaster data trans'er
FB eMMasterDTxferLib SFR068A110
Questo blocco funzione esegue l'interfaccia con il terminale di /O definito in 4ile per
gestire la comunicazione multimaster su rete multidrop. Questo un blocco funzione
protetto per utilizzarlo occorre richiedere il codice di protezione, vedi +rotezione >9nzioni
e ;locc*i >9nzione. E' comunque possibile utilizzarlo liberamente in modo test per 30 Min.
l blocco funzione agisce da server di comunicazione gestendo il dispositivo di /O,
verranno poi connessi dei blocchi funzione client che gestiscono lo scambio dati tra i
sistemi. L'FB ritorna un &&8tT=>I8 che deve essere passato alle FB client (Esempio
8ataT=>erClient).
n &7:ode occorre definire il numero di nodo del sistema, in una rete il numero di nodo
deve essere univoco. Tutti i messaggi che hanno come nodo di destinazione il valore di
&7:ode saranno ricevuti dalla FB che li passer alle FB clients per la verifica.
La comunicazione multimaster si basa sul controllo del canale di comunicazione libero e sulla gestione delle collisioni, i
parametri per questa gestione sono impostabili in &in4reeTm e &a=4reeTm. n questi parametri occorrer definire
tempi piccoli per comunicazioni su linea seriale e tempi pi lunghi nel caso di comunicazione via radiomodem.
n &inC*ITm e &a=C*ITm possibile impostare un tempo per l'invio di un messaggio di controllo verso gli altri
sistemi della rete. L'FB abiliter a turno sequenzialmente le varie FB clients per uno scambio dati con il peer con cui
l'FB dialoga controllando la connessione.
n <=Errors ritornato il conteggio degli errori di ricezione, l'FB monitora continuamente il canale di comunicazione e
se i dati ricevuti sono in errore viene incrementato il contatore. Errori possono manifestarsi in caso di collisioni sul
canale di comunicazione. n caso di errore esecuzione viene attivata per un loop l'uscita 4a9lt.
(ile (FLEP) Flusso dati stream ritornato dalla funzione Sysfopen.
M/Node (USNT) Nodo identificativo del sistema.
.imeout (UDNT) Tempo attesa frame di acknowledge dal sistema peer (mS).
&in4reeTm (REAL) Tempo minimo attesa canale di comunicazione libero (S).
&a=4reeTm (REAL) Tempo massimo attesa canale di comunicazione libero (S).
&inC*ITm (REAL) Tempo minimo attesa invio frame controllo verso sistema peer (S).
&a=C*ITm (REAL) Tempo massimo attesa invio frame controllo verso sistema peer (S).
MMDt.E'ID (UDNT) D server multimaster da passare alle FB clients (Esempio 8ataT=>erClient).
RE(rames (UDNT) Counter frame dati ricevuti. Sono conteggiati tutti i frames corretti indipendentemente se diretti
a questo nodo.
.E(rames (UDNT) Counter frame dati trasmessi.
REErrors (UDNT) Counter errori frame dati ricevuti.
Codici di errore
Mnl151c060 Pag. 214/271
7.22.2 Data.E'erClient* Data trans'er client
FB eMMasterDTxferLib SFR068A110
Questo blocco funzione esegue lo scambio dati con un altro sistema su canale di
comunicazione. Si collega al blocco funzione &&aster8ataT=>er di gestione dispositivo di
comunicazione, occorre passare &&8tT=>I8 in uscita dal blocco funzione server.
l blocco funzione scambia i dati con il sistema definito in To:ode. n pratica il valore di
To:ode deve coincidere con il valore di &7:ode della FB &master8ataT=>er dell'altro
sistema.
n <=8ata ed in T=8ata occorre definire l'indirizzo del buffer dati che si vuole scambiare con il
sistema peer. n 8Len la dimensione in bytes del buffer dati in scambio ( buffers <=8ata e
T=8ata devono avere la stessa dimensione). L'FB controlla se vi una variazione dei dati nel
buffer T=8ata e ne esegue immediatamente l'invio al sistema peer che risponde con i dati del
proprio buffer T=8ata che saranno trasferiti nel buffer <=8ata.
L'uscita Peer'I attiva se la comunicazione con il sistema peer operativa, in caso di errori di comunicazione l'uscita
si disattiva. n <=4rames e T=4rames ritornato il conteggio dei frames dati ricevuti ed inviati dalla FB verso il sistema
peer, in %cIErrors il numero di errori di acknowledge da parte del sistema peer. n caso di errore esecuzione viene
attivata per un loop l'uscita 4a9lt.
MMDt.E'ID (UDNT) D server multimaster in uscita dalla FB server (&master8ataT=>er).
.oNode (USNT) Nodo identificativo del sistema peer con cui scambiare i dati.
REData (@USNT) Puntatore al buffer dove devono essere trasferiti i dati ricevuti.
.EData (@USNT) Puntatore al buffer dove sono presenti i dati da trasmettere.
8Len (UDNT) Numero di bytes scambiati (Max 32).
RE- (BOOL) Attivo per un loop ad ogni ricezione dati da sistema peer.
)eer- (BOOL) Attivo se scambio dati con sistema peer Ok.
<=4rames (UDNT) Counter frame dati ricevuti.
T=4rames (UDNT) Counter frame dati trasmessi.
AcErrors (UDNT) Counter errori acknowledge dati da sistema peer.
Codici di errore
10041010 &&8tT=>I8 non definito.
10041020 &&8tT=>I8 non corretto.
10041050 Valore DLen errato.
10041200 Frame dati ricevuto da sistema peer ha lunghezza errata. Verificare 8Len sistema peer.
Mnl151c060 Pag. 215/271
Esem!i
Nell'esempio gestito lo scambio di 8 BOOL con il sistema peer nodo 1 (&7:ode=1).
Esem!io LD
Mnl151c060 Pag. 216/271
9 (unzioni ed (B obsolete
Alcune funzioni e/o blocchi funzione presenti nelle librerie, a causa della implementazione di nuove funzionalit che le
modificano graficamente e/o funzionalmente, devono essere sostituite. n alcuni casi ne viene modificato
completamente il nome, in altri casi viene mantenuto lo stesso nome ma cambiata la versione (Esempio Nome_v1
diventa Nome_v2).
Per mantenere la compatibilit con i programmi gi realizzate tutte le funzioni ed i blocchi funzioni sostituiti da nuove
versioni vengono salvati in una libreria apposita e-bsoleteLib. Ecco l'elenco degli oggetti presenti in questa libreria.
Funzione o FB obsoleta Sostituita da Descrizione
MDBRTUMASTER ModbusRTUMaster Gestione protocollo modbus RTU master
ModbusRTUMaster sModbusRTUMaster
sModbusRTUMaster ModbusRTUMaster_v1
ModbusRTUSlave ModbusSlave Gestione protocollo modbus RTU slave
ModbusAsciiSlave Gestione protocollo modbus Ascii slave
ModemCore ModemCore_v1 Gestione modem
ModemCore_v1 ModemCore_v2
ModemSMSRxCmd ModemSMSRxCmd_v1 Ricezione comando da messaggio SMS
ModemSMSSend ModemSMSSend_v1 nvio messaggio SMS
ModemPhoneCall ModemPhoneCall_v1 Esecuzione chiamata telefonica
Mnl151c060 Pag. 217/271
9.1.1 MDBR.<MA+.ER* modbus Rtu master
FB eObsoleteLib SFR066A000
terminale di /O su cui effettuare la comunicazione 4ile.
Attivando il comando di read <dCmd sul terminale di /O viene inviato un frame modbus con il
comando di <ead Polding <egisters (0x03) ed il valore ritornato dei registri viene trasferito nella
variabile indirizzata da B9>>er.
Attivando il comando di write ?rCmd sul terminale di /O viene inviato un frame modbus con il
comando di Preset &9lti+le <egisters (0x10) con il valore dei registri acquisito dalla variabile
indirizzata da B9>>er.
Terminato il comando viene attivato per un loop l'uscita 8one, in caso di errore esecuzione
comando viene attivata per un loop l'uscita 4a9lt.
(ile (FLEP) Pointer al file della risorsa come ritornato dalla funzione S7s>o+en.
RdCmd (BOOL) Comando di esecuzione lettura registri.
&rCmd (BOOL) Comando di esecuzione scrittura registri.
Register (UDNT) ndirizzo di inizio lettura o scrittura registri su nodo modbus. n accordo alle specifiche modbus
l'indirizzo inviato nel frame dati (<egister-1) (Range da 16#0001 a 16#FFFF).
Nr-'Regs (USNT) Numero di registri consecutivi da leggere o scrivere (Range da 1 a 32).
Bu''er (@UNT) ndirizzo buffer dati letti o da scrivere.
Codici di errore
10000050 Timeout esecuzione
20000060 Errore sequenze gestione comando
10000100
10000102
Valore di <egister errato
10000200 Frame risposta a comando read in errore
10000300 Frame risposta a comando write in errore
10000400 Errore in ricezione frame (Codice comando errato)
10000410 Errore in ricezione frame (CRC frame errato)
Mnl151c060 Pag. 218/271
Esem!i
Viene eseguita la lettura ogni 100 mS di 6 registri a partire da indirizzo 16#100 dal nodo modbus 1. l valore dei registri
letti trasferito nell'array <egisters.
Spiando la porta seriale COM2 con un programma di emulazione terminale in grado di visualizzare i caratteri
esadecimali vedremo ogni 100 mS la stringa con il comando modbus di <ead Polding <egister: 01 03 01 00 00 06 C4
34.
Esem!io +. (P&011$a600)
(* *)
(* ,0.* T:. 5,MMU*35"T3,* 0,RT *)
(* *)
(* :ere oBen the 5,M+ Bort in readNIrite% *)
3= (=B = *ULL) T:.*
=B:=SAs!oBen(95,M+9, 9rI9); (* TerEinal 3N, Bointer *)
.*DG3=;
(* *)
(* 3*3T3"L3W"T3,* *)
(* *)
(* Set the serial Eode% *)
"=lag:=SAs-etSerialMode("DR(SE), =B); (* -et serial Eode *)
SE%Baudrate:=&17$$;
SE%0aritA:=9.9;
SE%DTRManageEent:=DTRG"UT,G;,GT3M.S;
"=lag:=SAsSetSerialMode("DR(SE), =B); (* Set serial Eode *)
.*DG3=;
(* *)
(* M,DBUS M"ST.R *)
(* *)
(* 0reset the Eodbus Easter =B BaraEeters% *)
Mdb%.nable:=TRU.; (* =unction enable *)
Mdb%=ile:==B; (* TerEinal 3N, Bointer *)
Mdb%*ode:=#; (* *ode nuEber *)
Mdb%Register:=+&1; (* Start register address *)
Mdb%*r,!Regs:=7; (* *uEber o! registers *)
Mdb%Bu!!er:="DR(Registers); (* "ddress o! data bu!!er *)
(* 5all the Eodbus Easter =B an eMecute read coEEand e@erA #$$ ES% *)
Trigger(5LH:=SAs5loc?#$$);
Mdb(Rd5Ed:=Trigger%');
(* 5hec? i! done or error and count theE% *)
3= (Mdb%Done) T:.* 5ounter:=5ounterL#; .*DG3=;
3= (Mdb%=ault) T:.* .rrors:=.rrorsL#; .*DG3=;
(* C.nd o! !ileD *)
Mnl151c060 Pag. 219/271
9.1.2 ModbusR.<Master* modbus Rtu master
terminale di /O su cui effettuare la comunicazione 4ile. Attivando il comando di Start sul terminale
di /O viene inviato un frame per eseguire la funzione modbus definita in 49nction.
l comando Start se attivato in modo impulsivo permette l'esecuzione del comando definito una
sola volta. Se sempre attivo permette l'esecuzione ciclica del comando definito.
%ddress per il numero di variabili definito da Points, viene letto dal sistema slave e trasferito
nelle variabili indirizzate da B9>>er.
Se 4code una funzione di scrittura, il valore delle variabili presenti nel buffer di memoria
indirizzato da B9>>er per il numero di variabili definito da Points, inviato al dispositivo slave che
lo trasferir nelle sue variabili a partire dall'indirizzo definito in %ddress.
Terminato il comando viene attivata per un loop l'uscita 8one, in caso di errore esecuzione comando o tempo di
esecuzione comando superiore al tempo definito in Timeo9t, viene attivata per un loop l'uscita 4a9lt ed incrementato il
valore in Errors.
+tart (BOOL) Comando di esecuzione comando modbus.
Codice Descrizione
Mnl151c060 Pag. 220/271
Codici di errore
10007540 Errore in ricezione frame (Dati errati).
Esem!i
Viene presentato un esempio di lettura da un sistema SlimLine slave. Attivando l'ingresso digitale 8i$$&$$ viene
eseguita ogni secondo la lettura di 16 coils a partire da indirizzo 16#01 dal nodo modbus 1. l valore dei coils letti
trasferito nella DB100 a partire da indirizzo 16. Terminata la lettura si attiver per un loop l'uscita logica 8o$$&$$.
Nella variabile BOOL ad indirizzo MX100.16 verr trasferita la variabile BOOL MX100.0 del sistema slave, ad indirizzo
MX100.17 la variabile MX100.1, ad indirizzo MX100.18 la variabile MX100.2 e cos via.
Esem!io LD (P&011$a300)
Mnl151c060 Pag. 221/271
9.1.$ sModbusR.<Master* modbus Rtu master
terminale di /O su cui effettuare la comunicazione 4ile. Attivando Ena;le sul terminale di /O viene
inviato un frame per eseguire la funzione modbus definita in 4Code. Terminata l'esecuzione del
comando viene attivata l'uscita 8one. Se l'esecuzione comando ha esito positivo si attiva per un
loop di programma l'uscita 'I. Disattivando Ena;le si azzera 8one e l'eventuale 4a9lt, per
eseguire nuovamente il comando occorre riabilitare l'ingresso Ena;le.
%ddress per il numero di variabili definito da Points, viene letto dal sistema slave e trasferito nelle
variabili indirizzate da B9>>er.
Se 4Code una funzione di scrittura, il valore delle variabili presenti nel buffer di memoria
indirizzato da B9>>er per il numero di variabili definito da Points, inviato al dispositivo slave che
lo trasferir nelle sue variabili a partire dall'indirizzo definito in %ddress.
n caso di errore esecuzione o tempo di esecuzione comando superiore al tempo definito in Timeo9t, viene attivata per
un loop di programma l'uscita 4a9lt ed incrementato il valore in Errors.
Enable (BOOL) Comando abilitazione esecuzione comando modbus. Per rieseguire il comando disabilitare e poi
riabilitare questo ingresso.
Codice Descrizione
- (BOOL) Attivo per un loop se esecuzione comando corretta.
(ault (BOOL) Attivo per un loop se errore esecuzione comando.
Mnl151c060 Pag. 222/271
Codici di errore
10007200~1 Errore trasmissione frame comando.
10007540 Errore in ricezione frame (Dati errati).
Esem!i
Viene presentato un esempio di lettura da un sistema SlimLine slave. Viene eseguita la lettura di 16 coils a partire da
indirizzo 16#01 dal nodo modbus 1. l valore dei coils letti trasferito nell'array <=Coils. Terminata la lettura si attiver
per un loop l'uscita logica 8o$1&$$.
Nella variabile B''L ad indirizzo <=CoilsQ$R verr trasferita la variabile B''L &51$$.$ del sistema slave, ad indirizzo
<=CoilsQ1R la variabile &51$$.1, ad indirizzo <=CoilsQ1R la variabile &51$$.1 e cos via.
Esem!io LD (PTP11$A600, LD_2o)+*-RT#2a-&er)
Mnl151c060 Pag. 223/271
9.1.1 ModbusR.<+la3e* modbus Rtu sla3e
Sui sistemi SlimLine il protocollo modbus slave gi implementato dal sistema operativo, pertanto
non occorre inserire blocchi funzione appositi nel programma utente. Questo blocco esegue
l'override della gestione di sistema operativo e si utilizza in casi particolari, dove non possibile
utilizzare la gestione implementata nel sistema operativo. Per esempio quando si vuole consentire
l'accesso ad un propria area di memoria diversa dalla DB100.
Questo blocco funzione esegue la gestione del protocollo modbus slave, possibile definire il
n I4Time occorre definire il tempo di interframe dei comandi modbus, cio il tempo che intercorre tra la ricezione di un
comando ed il comando successivo. Su linea seriale questo tempo coincide con il tempo di ricezione di 3 caratteri al
baud rate definito.
Alla ricezione di ogni comando modbus corretto si attiva per un loop l'uscita 8one, in caso di errore comando viene
attivata per un loop l'uscita 4a9lt ed incrementato il valore in Errors.
I(.ime (UDNT) Tempo che intercorre tra la ricezione di un comando ed il comando successivo (S).
Se comunicazione su porta seriale il tempo deve essere definito in base al baud rate.
Baud rate .em!o Baud rate .em!o
300 112000 19200 1720
600 56000 38400 860
1200 28000 57600 573
2400 14000 76800 429
4800 7000 115200 286
9600 3430
Mnl151c060 Pag. 224/271
Comandi su!!ortati
Codice Descrizione
Codici di errore
10019150 Errore in ricezione frame (LRC modbus errato).
Mnl151c060 Pag. 225/271
Esem!i
Viene gestito il protocollo modbus slave su porta seriale C'&1, si utilizza le impostazioni seriali di default 111$$, e, 2,
1. comandi modbus possono agire su tutta l'area della 8B1$$.
Esem!io LD
Mnl151c060 Pag. 226/271
9.1.4 ModbusAscii+la3e* modbus Ascii sla3e
Questo blocco esegue la gestione del protocollo modbus slave Ascii, possibile definire il
Alla ricezione di ogni comando modbus corretto si attiva per un loop l'uscita 8one, in caso di errore
comando viene attivata per un loop l'uscita 4a9lt ed incrementato il valore in Errors.
Comandi su!!ortati
Codice Descrizione
Mnl151c060 Pag. 227/271
Codici di errore
10033150 Errore in ricezione frame (LRC modbus errato).
Esem!i
Viene gestito il protocollo modbus slave su porta seriale C'&$, si utilizza le impostazioni seriali di default 111$$, e, 2,
1. comandi modbus possono agire sull'array 8%rra7 di 100 words (200 bytes).
Esem!io LD
Mnl151c060 Pag. 228/271
9.1.6 ModemCore* modem core management
FB eModemLib SFR057A100
riaggancio automatico.
L'FB ritorna un &odemI8 che deve essere passato alle FB collegate (Esempio invio SMS,
ricezione SMS, ecc.).
Le uscite &odemT= e &odem<= riportano i comandi inviati e ricevuti dal modem, in questo modo possibile
visualizzare in debug la comunicazione con il modem permettendo di visualizzare eventuali errori nell'interfaccia con il
modem.
contemporaneamente ad ogni squillo del telefono si attiva per un loop di programma l'uscita CLIP<=d.
modem).
ecc.).
Modem.E (STRNG[256]) Contiene la stringa di comando inviata al modem, pu essere utilizzato in debug per verificare
i comandi inviati al modem.
ModemRE (STRNG[256]) Contiene la stringa di risposta ritornata dal modem, pu essere utilizzato in debug per
verificare le risposte ricevute dal modem.
Mnl151c060 Pag. 229/271
Codici di errore
Codice Descrizione
10002210~7 Errore nella acquisizione dell'operatore telefonico.
10002220~2 Errore nella acquisizione del livello del segnale.
10002300~4 Errore nell'invio messaggio SMS.
Esem!i
Esem!io LD
Mnl151c060 Pag. 230/271
9.1.7 ModemCore;31* modem core management
FB eModemLib SFR057C000
riaggancio automatico.
L'FB ritorna un &odemI8 che deve essere passato alle FB collegate (Esempio invio SMS,
ricezione SMS, ecc.).
Le uscite &odemT= e &odem<= riportano i comandi inviati e ricevuti dal modem, in questo modo possibile
visualizzare in debug la comunicazione con il modem permettendo di visualizzare eventuali errori nell'interfaccia con il
modem.
contemporaneamente ad ogni squillo del telefono si attiva per un loop di programma l'uscita CLIP<=d.
Auto?ang<! (BOOL) Abilita l'HangUp automatico alla ricezione di una chiamata telefonica, viene comunque
ritornato il CLP.
modem).
ecc.).
Modem.E (STRNG[256]) Contiene la stringa di comando inviata al modem, pu essere utilizzato in debug per verificare
i comandi inviati al modem.
ModemRE (STRNG[256]) Contiene la stringa di risposta ritornata dal modem, pu essere utilizzato in debug per
verificare le risposte ricevute dal modem.
Mnl151c060 Pag. 231/271
Codici di errore
Codice Descrizione
10002210~7 Errore nella acquisizione dell'operatore telefonico.
10002220~2 Errore nella acquisizione del livello del segnale.
10002300~4 Errore nell'invio messaggio SMS.
Esem!i
Esem!io LD
Mnl151c060 Pag. 232/271
9.1.9 Modem+M+RECmd* recei3e a +M+ command
Questo blocco funzione esegue la ricezione di un comando tramite un messaggio SMS, si collega
al blocco funzione di gestione modem &odemCore, occorre passare il &odemI8 in uscita dal
blocco funzione di gestione modem.
Alla ricezione di un messaggio SMS se nel testo del messaggio presente la stringa definita in
Command, si attiva per un loop di programma l'uscita 8one, all'uscita CLIP:9m;er della FB
&odemCore ritornato il numero di telefono da cui il messaggio stato ricevuto.
Attivando Cin il controllo sulla stringa definita in Command verr fatto non considerando il case
(Maiuscolo/minuscolo) dei caratteri.
Enable (BOOL) Abilita la ricezione del comando.
CIn (BOOL) Se attivo, controllo di Command non considerando case (Maiuscolo/minuscolo) dei caratteri.
Command (STRNG[32]) Testo comando da eseguire.
Done (BOOL) Attivo per un loop se ricevuto messaggio SMS contenente il testo indicato in Command.
Codici di errore
Esem!i
Esem!io LD (P&011<a600, Re1ei9e2Comman))
Mnl151c060 Pag. 233/271
9.1.: Modem+M++end* send a +M+ message
Questo blocco funzione esegue l'invio di un messaggio SMS, si collega al blocco funzione di
gestione modem &odemCore, occorre passare alla FB il &odemI8 in uscita dal blocco funzione
di gestione modem.
Su fronte attivazione ingresso di Send viene prenotato l'invio del messaggio, non appena sar
possibile il messaggio definito in Te=t verr inviato al numero definito in :9m;er. Terminato l'invio
verr attivata per un loop di programma l'uscita 8one.
+end (BOOL) Sul fronte di attivazione comanda l'invio del messaggio SMS. %ttenzione@ l messaggio sar inviato
non appena il modem libero per l'invio.
Number (STRNG[16]) Numero di telefono a cui eseguire l'invio del messaggio.
.eEt (STRNG[160]) Testo messaggio da inviare.
Done (BOOL) Attivo per un loop al termine dell'invio del messaggio SMS.
(ault (BOOL) Attivo per un loop se errore invio messaggio SMS.
Codici di errore
Esem!i
Nell'esempio gestito l'invio di un messaggio SMS sul modem definito nella variabile &odemI8, per la definizione delle
variabili e per una migliore comprensione del funzionamento si rimanda agli esempi successivi.
Esem!io LD (P&011<a600, en)22e--age)
Mnl151c060 Pag. 234/271
9.1.1% Modem)honeCall* eEecutes a !hone call
FB eModemLib SFR057C000
Questo blocco funzione esegue una chiamata telefonica al numero indicato, si collega al blocco
Su fronte attivazione ingresso di Call viene prenotata l'esecuzione della chiamata, non appena
sar possibile verr eseguita la chiamata al numero definito in :9m;er. Terminato il tempo
definito in Time la chiamata verr terminata. Se non vi sono problemi verr attivata per un loop di
programma l'uscita 8one.
Call (BOOL) Sul fronte di attivazione comanda 'esecuzione della chiamata. %ttenzione@ La chiamata verr
Number (STRNG[16]) Numero di telefono da chiamare.
.ime (UNT) Tempo di durata chiamata (Sec).
Done (BOOL) Attivo per un loop al termine della esecuzione chiamata.
(ault (BOOL) Attivo per un loop se errore esecuzione chiamata.
Codici di errore
Esem!i
Nell'esempio gestita una chiamata al numero indicato. Dopo 15 secondi la chiamata viene conclusa.
Esem!io LD (P&011<a100, 2a/eP4oneCa,,)
Mnl151c060 Pag. 235/271
: )rotocolli di comunicazione
:.1 )rotocollo modbus
l modbus un protocollo di comunicazione seriale diventato uno standard de facto nella comunicazione di tipo
industriale, ed ora il protocollo di connessione pi diffuso fra i dispositivi elettronici industriali. E' un protocollo di tipo
richiesta/risposta ed offre dei servizi specificati da function codes.
SlimLine supporta il protocollo modbus Rtu sulle porte seriali, e modbus Over P su connessione ethernet su porta $1.
l protocollo modbus Rtu sulla porta seriale ha come parametri di comunicazione di default 111$$, e, 2, 1, e l'indirizzo
di nodo sia su porta seriale che su TCP/P 1.
:.1.1 Accesso 3ariabili da modbus
Le funzioni del protocollo accedono tutte alla memoria utente &51$$, le funzioni supportate sono:
Code (unction .i!o oggetto .i!o accesso Range indirizzo
01h Read coil status Bit singolo Read 40000-44095 (20000-24095) !:ote 1#
02h Read input status Bit singolo Read 40000-44095 (20000-24095) !:ote 1#
03h Read holding registers Word (16 Bit) Read 40000-42047 (20000-22047) !:ote 1#
04h Read input registers Word (16 Bit) Read 40000-42047 (20000-22047) !:ote 1#
05h Force single coil Bit singolo Write 40000-44095 (20000-24095) !:ote 1#
06h Preset single register Word (16 Bit) Write 40000-42047 (20000-22047) !:ote 1#
10h Preset multiple registers Word (16 Bit) Write 40000-42047 (20000-22047) !:ote 1#
Da versione SFW167D000 l'area indirizzabile anche nel range da 20000 a 2xxxx.
:ote 1# Nelle funzioni che accedono al bit singolo (n realt ogni bit equivale ad un byte di memoria) si utilizza nel
comando l'indirizzo della variabile, quindi dovendo accedere alla locazione &51$$.$ utilizzeremo come indirizzo il
valore 0$$$.
:ote 1# Nelle funzioni che accedono ai registri (16 Bits) occorre considerare l'indirizzo della variabile diviso per 2, quindi
dovendo raggiungere da modbus la locazione &51$$.$ utilizzeremo come indirizzo il valore 0$$1.
:.1.2 Lettura 3ariabili da modbus
Per la lettura delle variabili si utilizza il comando <ead *olding registers (Codice $=$3). potizzando di dover accedere
in lettura ad una variabile 8?'<8 allocata in memoria all'indirizzo &51$$.60 calcoleremo l'indirizzo di lettura nel
modo:
!!Indirizzo Daria;ile,1#H'>>set#-1 M !!60,1#H0$$$$#-1F0$$31 M $=/C4
Essendo una variabile 8?'<8 dovremo leggere 2 registri consecutivi a partire dal suo indirizzo di allocazione,
ipotizzando che il valore della variabile sia $=1130632 avremo.
Frames modbus RTU
Stringa di comando: $1 $3 /C 4 $$ $1 8% 0/
Stringa di risposta: $1 $3 $0 6 32 11 30 66 8
Frames modbus TCP/P
Stringa di comando: $$ $$ $$ $$ $$ $6 $1 $3 /C 4 $$ $1
Stringa di risposta: $$ $$ $$ $$ $$ $3 $1 $3 $0 6 32 11 30
La rappresentazione dei dati in SlimLine nel formato Little-Endian, la numerazione inizia dal byte meno significativo
per finire col pi significativo, quindi come si nota dalla stringa di risposta il valore della variabile a 32 bits $=1130632
viene ritornato suddiviso in due registri a 16 bits con i valori $=632, $=1130.
Mnl151c060 Pag. 236/271
:.1.$ +crittura 3ariabili da modbus
Per la scrittura delle variabili si utilizza il comando Preset m9lti+le registers (Codice $=1$). potizzando di dover
accedere in scrittura ad una variabile 8?'<8 allocata in memoria all'indirizzo &51$$.60 calcoleremo l'indirizzo di
scrittura nel modo:
!!Indirizzo Daria;ile,1#H'>>set#-1 M !!60,1#H0$$$$#-1F0$$31 M $=/C4
Essendo una variabile 8?'<8 dovremo scrivere 2 registri consecutivi a partire dal suo indirizzo di allocazione,
ipotizzando di dover scrivere nella variabile il valore $=1130632 avremo.
Frames modbus RTU
Stringa di comando: $1 1$ /C 4 $$ $1 $0 6 32 11 30 83 33
Stringa di risposta: $1 1$ /C 4 $$ $1 4 2%
Frames modbus TCP/P
Stringa di comando: $$ $$ $$ $$ $$ $B $1 1$ /C 4 $$ $1 $0 6 32 11 30
Stringa di risposta: $$ $$ $$ $$ $$ $6 $1 1$ /C 4 $$ $1
La rappresentazione dei dati in SlimLine nel formato Little-Endian, la numerazione inizia dal byte meno significativo
per finire col pi significativo, quindi come si nota dalla stringa di comando il valore da scrivere a 32 bits $=1130632
viene definito suddiviso in due registri a 16 bits con i valori $=632, $=1130.
Mnl151c060 Pag. 237/271
:.1.1 Accesso Real time cloc da modbus
E' possibile accedere al real time clock utilizzando i comandi modbus di accesso ai registri le funzioni supportate sono:
Code (unction .i!o oggetto .i!o accesso Range indirizzo
03h Read holding registers Word (16 Bit) Read 100-105 (150 per l'Epoch time)
04h Read input registers Word (16 Bit) Read 100-105 (150 per l'Epoch time)
06h Preset single register Word (16 Bit) Write 100-105 (150 per l'Epoch time)
10h Preset multiple registers Word (16 Bit) Write 100-105 (150 per l'Epoch time)
registri (16 Bits) del real time clock sono allocati in locazioni consecutive a partire dall'indirizzo modbus 100. registri
contengono il valore attuale del real time clock e scrivendo un nuovo valore il real time clock verr automaticamente
aggiornato.
Address Register Note
100 Second Valore secondi (Range da 0 a 59)
101 Minute Valore minuti (Range da 0 a 59)
102 Hour Valore ora (Range da 0 a 23)
103 Day Valore giorno (Range da 1 a 31)
104 Month Valore mese (Range da 1 a 12)
105 Year Valore anno (Range da 1900 a 2037)
:.1.4 Lettura R.C da modbus
Per la lettura dei registri del real time clock si utilizza il comando <ead *olding registers (Codice $=$3). Dovremo
leggere 6 registri consecutivi a partire dall'indirizzo di allocazione, l'indirizzamento di modbus prevede un offset di 1,
quindi // ($=$$63).
Frames modbus RTU
Stringa di comando: $1 $3 $$ 63 $$ $6 3 86
Stringa di risposta: $1 $3 $C $$ 1E $$ 3$ $$ $B $$ 18 $$ $/ $3 8% %1 31
Frames modbus TCP/P
Stringa di comando: $$ $$ $$ $$ $$ $6 $1 $3 $$ 63 $$ $6
Stringa di risposta: $$ $$ $$ $$ $$ $4 $1 $3 $C $$ 1E $$ 3$ $$ $B $$ 18 $$ $/ $3 8%
Come si vede dalla risposta il valore :
Secondi: 30 ($=$$1E)
Minuti: 48 ($=$$3$)
Ora: 11 ($=$$$B)
Giorno: 29 ($=$$18)
Mese: 9 ($=$$$/)
Anno: 2010 (%E%7DA)
Mnl151c060 Pag. 238/271
:.1.6 +crittura R.C da modbus
Per la scrittura dei registri del real time clock si utilizza il comando Preset m9lti+le registers (Codice $=1$). Dovremo
scrivere 6 registri consecutivi a partire dall'indirizzo di allocazione, l'indirizzamento di modbus prevede un offset di 1,
quindi // ($=$$63). potizziamo di dover impostare nel real time clock i valori:
Secondi: 30 ($=$$1E)
Minuti: 48 ($=$$3$)
Ora: 11 ($=$$$B)
Giorno: 29 ($=$$18)
Mese: 9 ($=$$$/)
Anno: 2010 (%E%7DA)
Frames modbus RTU
Stringa di comando: $1 1$ $$ 63 $$ $6 $2 $$ 1E $$ 3$ $$ $B $$ 18 $$ $/ $3 8% 8 C2
Stringa di risposta: $1 1$ $$ 63 $$ $6 B$ 1
Frames modbus TCP/P
Stringa di comando: $$ $$ $$ $$ $$ 13 $1 1$ $$ 63 $$ $6 $2 $$ 1E $$ 3$ $$ $B $$ 18 $$ $/ $3 8%
Stringa di risposta: $$ $$ $$ $$ $$ $6 $1 1$ $$ 63 $$ $6
Mnl151c060 Pag. 239/271
:.1.7 Accesso E!och time da modbus
E' allocato anche un registro a 32 bits per il valore di data/ora in Epoch time, l'acceso a questo registro in lettura e/o
scrittura v sempre effettuato usando due registri a 16 bits.
Address Register Note
150 Epoch time Epoch time
:.1.9 Lettura E!och time da modbus
Per la lettura dell'epoch time si utilizza il comando <ead *olding registers (Codice $=$3). Dovremo leggere 2 registri
consecutivi a partire dall'indirizzo di allocazione, l'indirizzamento di modbus prevede un offset di 1, quindi 10/ ($=$$/).
Frames modbus RTU
Stringa di comando: $1 $3 $$ / $$ $1 80 13
Stringa di risposta: $1 $3 $0 3$ B 0C %3 /$ 6C
Frames modbus TCP/P
Stringa di comando: $$ $$ $$ $$ $$ $6 $1 $3 $$ / $$ $1
Stringa di risposta: $$ $$ $$ $$ $$ $3 $1 $3 $0 3$ B 0C %3
Come si vede dalla risposta il valore : $=0C%33$B M 11236313 M G&T) ?ed, 1/ Se+ 1$1$ 11)13)33 CTC.
:.1.: +crittura E!och time da modbus
Per la scrittura dell'epoch time si utilizza il comando Preset m9lti+le registers (Codice $=1$). Dovremo scrivere 2
registri consecutivi a partire dall'indirizzo di allocazione, l'indirizzamento di modbus prevede un offset di 1, quindi 10/
($=$$/). potizziamo di dover impostare il valore:
G&T) ?ed, 1/ Se+ 1$1$ 11)13)33 CTC M 11236313 M $=0C%33$B
Frames modbus RTU
Stringa di comando: $1 1$ $$ / $$ $1 $0 3$ B 0C %3 $ %3
Stringa di risposta: $1 1$ $$ / $$ $1 1 E0
Frames modbus TCP/P
Stringa di comando: $$ $$ $$ $$ $$ $B $1 1$ $$ / $$ $1 $0 3$ B 0C %3
Stringa di risposta: $$ $$ $$ $$ $$ $6 $1 1$ $$ / $$ $1
Mnl151c060 Pag. 240/271
1% Creazione !agine Ceb utente
Con il nuovo sistema operativo SFW184 stata implementata la possibilit di creare pagine web direttamente
dall'utente, queste pagine potranno essere trasferite nelle directory del sistema e verranno visualizzate accedendo da
browser web.
Per trasferire le pagine web create dall'utente nel file system del sistema SlimLine occorre utilizzare un client Ftp
(Esempio FileZillla) ma possibile usare anche il semplice esplora risorse di Windows. Come si vede dalla figura
sottostante, impostando nella barra indirizzo le credenziali di accesso al sistema ed il suo indirizzo P
>t+),,%dmin)%dmin.1/1.162.$.161, possibile connettersi e visualizzare il file system.
Ecco come si presenta la visualizzazione del file system alla connessione. Le cartelle ProLect e S7stem sono riservate
al sistema e si consiglia di non modi>icarne il conten9to. file delle pagine utente possono essere trasferiti nelle
cartelle Storage e S8Card (Se presente).
Quindi l'utente pu creare le sue pagine web utilizzando un qualsiasi editor html ma anche semplicemente usando un
semplice editor di testo come il blocco note, certo deve conoscere la sintassi del linguaggio html. Le pagine create
saranno trasferite nella directory desiderata ed accedendo da un normale browser alla pagina la pagina sar
visualizzata.
Mnl151c060 Pag. 241/271
1%.1Criteri !er realizzazione !agina
Naturalmente il web server integrato nello SlimLine ha solo un ridotto set di funzioni e quindi nella creazione delle
pagine web occorre sottostare a certe regole, vediamole:
a) La pagina non pu contenere inclusione di altre pagine (Esempio pagine di stile o di scripts).
b) La pagina non pu contenere inclusione di immagini (Esempio file gif o jpg), eventuali immagini possono essere
embedded nella pagina stessa.
Vediamo ad esempio una semplice pagina che visualizza un messaggio di presentazione.
+orgente html !agina
JhtElK
JheadK
JEeta httBeFui@=R5ontentTABeR content=RteMtNhtEl; charset=iso22&(#R NK
JtitleKSliELine SiEBle BageJNtitleK
JNheadK
JbodAK
This Bage is ser@ed bA the JbKSliELineJNbK
JNbodAK
JNhtElK
Salvando il testo riportato in un file, esempio SPage.*tm, e trasferendo il file nella directory Storage di SlimLine, sar
possibile visualizzare la pagina web risultante semplicemente digitando nel proprio browser l'indirizzo della pagina.
Naturalmente la pagina pu contenere links ad altre pagine, sar cos possibile realizzare una propria navigazione tra
diverse pagine. Ecco lo stesso esempio di prima con incluso la definizione di uno stile.
JhtElK
JheadK
JstAle tABe=RteMtNcssRK
%Bolded [!ont!aEilA: "rial, :el@etica, sansseri!; !ontsiXe: +$BM; !ontstAle: norEal;!ontIeight: bold;\
JNstAleK
JNheadK
JbodAK
This Bage is ser@ed bA the JsBan class=RBoldedRKSliELineJNsBanK
JNbodAK
JNhtElK
Mnl151c060 Pag. 242/271
1%.2)agine dinamiche
La caratteristica pi importante del server web integrato in SlimLine possibilit di gestire le +agine dinamic*e. Una
pagina web dinamica una pagina il cui contenuto, in tutto o in parte, generato sul momento dal server, potendo
dunque essere diversa ogni volta che viene richiamata, consentendo quindi un'interattivit con l'utente.
Ecco quindi che sar possibile realizzare pagine che riportano valori di variabili PLC e permettono di modificare il valore
di variabili PLC. Nell'esempio seguente riporto il sorgente html di una semplice pagine che visualizza il valore di una
variabile PLC di tipo UNT allocata all'indirizzo DB100.10 e permette di impostare il valore di una variabile PLC di tipo
UNT allocata all'indirizzo DB100.12.
JhtElK
JheadK
JscriBt language=R>a@ascriBtRK
!unction Set(=ield, 8alue) [docuEent%MA=orEC=ieldD%@alue=8alue;\
!unction Set8alues() [Set(RU3*T#+R, RJ<CRPdR, U3*T, #+DKR);\
JNscriBtK
JNheadK
JbodA onLoad=RSet8alues();RK
DB#$$%#$ 8alue:UnbsB;J<CRPdR, U3*T, #$DKJNbrK
J!orE id=RMA=orER naEe=RMA=orER Eethod=RBostR action=RD0age%htERK
DB#$$%#+ 8alue:UnbsB;JinBut naEe=RU3*T #+R tABe=RteMtR id=RU3*T#+R siXe=R&R EaMlength=R#$RKUnbsB;
JinBut naEe=RMAButtonR tABe=RsubEitR id=RMAButtonR @alue=RSa@eRNK
JN!orEK
JNbodAK
JNhtElK
Salvando il testo riportato in un file, esempio 8Page.*tm, e trasferendo il file nella directory Storage di SlimLine, sar
possibile visualizzare la pagina web risultante semplicemente digitando nel proprio browser l'indirizzo della pagina.
Come si vede nella riga superiore viene visualizzato il valore della variabile PLC DB100.10 mentre impostando un
valore nella casella di testo della riga inferiore e agendo sul tasto SaDe sar possibile impostare il valore della variabile
PLC DB100.12.
Naturalmente in una pagina web possono essere visualizzate e possono essere impostate tutte le variabili desiderate,
si consiglia comunque di non esagerare con il numero di variabili, preferibile suddividerle in pi pagine.
Mnl151c060 Pag. 243/271
1%.$(ormato .A0s
Come si visto in una pagina dinamica parte del contenuto viene generato sul momento dal server Http (l modulo CPU
SlimLine), vediamo quali sono i meccanismi per definire le T%Gs da visualizzare. All'interno del sorgente della pagina
Html possibile definire dei campi di commento del tipo .
campi sono interpretati come commenti e quindi sono gestibili da qualsiasi editor Html (Esempio Macromedia), ma il
server Http nel momento in cui invia la pagina al client (l browser che la visualizza) sostituisce al campo il valore della
variabile indicata. Nell TAG sono riportate tutte le informazioni necessarie secondo la sintassi
MBGGN(ormat* ./!e* AddressOGGP
1%.$.1 Cam!o (ormat
La stringa di formattazione 4ormat, pu contenere elementi di due tipi, il primo consiste in caratteri che vengono
ritornati nella pagina inalterati. l secondo consiste in direttive di conversione che descrivono il modo in cui gli argomenti
devono essere visualizzati. Le direttive di conversione iniziano con il simbolo % seguito dalle direttive secondo il
formato:
S Q4lagsR Q?idt*R Q.PrecisionR QLengt*R ConDersion
(lags
+ La visualizzazione delle variabili con segno, inizier sempre con il segno - o +.
space La visualizzazione delle variabili con segno, inizier sempre con il segno - o con lo spazio.
x valori diversi da 0 vengono prefissati con 0x.
0 Al valore visualizzato vengono aggiunti 0 fino al raggiungimento del numero di cifre desiderato (Per
variabili di tipo d, i, o, u, x, X, e, E, f, g, G).
&idth@ Definisce il numero di cifre che devono essere visualizzate.
)recision@ Definisce il numero di cifre decimali da visualizzare (Per variabili di tipo e, E, f).
Length
h Prima di (d, i, u, x, X, o) denota una variabile short int o unsigned short int.
l (elle) Prima di (d, i, u, x, X, o) denota una variabile long int o unsigned long int.
L Prima di (e, E, f, g, G) denota una variabile long double.
Con3ersion
d Valore decimale con segno.
i Valore decimale con segno.
o Valore ottale senza segno.
u Valore decimale senza segno.
x Valore esadecimale, viene visualizzato utilizzando lettere minuscole (Da 0 a 9, da a a f).
X Valore esadecimale, viene visualizzato utilizzando lettere maiuscole (Da 0 a 9, da A a F).
e Valore decimale in virgola mobile, visualizzato con indicazione dell'esponente (Esempio: [-]d.ddde+dd).
E Valore decimale in virgola mobile, visualizzato con indicazione dell'esponente (Esempio: [-]d.dddE+dd).
f Valore decimale in virgola mobile (Esempio: [-]d.ddd).
c Singolo carattere.
s Stringa.
Mnl151c060 Pag. 244/271
1%.$.2 Cam!o ./!e
l campo T7+e indica il tipo di variabile che si vuole visualizzare, sono gestiti tutti i tipi definiti nella EC61131.
1%.$.$ Cam!o Address
l campo Address indica l'indirizzo della variabile, ricordo che possibile indicare solo variabili allocate nella DB 100.
1%.$.1 Esem!i di .A0s
Per meglio comprendere il formato di visualizzazione delle TAGs riporto alcuni esempi.
 Visualizza il valore della variabile UNT allocata all'indirizzo DB 100.10
con un numero di cifre intere variabili in base al valore.
 Visualizza il valore della variabile UNT allocata all'indirizzo DB 100.10
sempre espresso con 4 cifre.
 Visualizza il valore della variabile REAL allocata all'indirizzo DB 100.32
con 3 cifre intere e nessuna cifra decimale.
 Visualizza il valore della variabile REAL allocata all'indirizzo DB 100.50
con 2 cifre intere e 2 cifre decimali.
Mnl151c060 Pag. 245/271
1%.1(ormato AR0s
La principale peculiarit del web dinamico la possibilit di variare i contenuti delle pagine in base alle richieste degli
utenti. Questa possibilit si materializza attraverso i meccanismi che permettono agli utenti, oltre che di richiedere una
pagina ad un web server, anche di specificare determinati parametri da inviare al server web. Per impostare da pagina
web valori di variabili PLC viene gestita una richiesta di tipo POST, il metodo utilizzato con i moduli: quando una
pagina Html contiene un tag T>ormU. dati impostati nei vari oggetti contenuti nel T>ormU sono inviati in maniera da
non essere direttamente visibili per l'utente, attraverso la richiesta HTTP che il browser invia al server.
Se ci riferiamo all'esempio precedente vediamo che la parte di pagina Html che permette l'impostazione della variabile
PLC UNT allocata all'indirizzo DB 100.12 la seguente.
J!orE id=RMA=orER naEe=RMA=orER Eethod=RBostR action=RD0age%htERK
DB#$$%#+ 8alue:UnbsB;JinBut naEe=RU3*T #+R tABe=RteMtR id=RU3*T#+R siXe=R&R EaMlength=R#$RKUnbsB;
JinBut naEe=RMAButtonR tABe=RsubEitR id=RMAButtonR @alue=RSa@eRNK
JN!orEK
n pratica un campo T>ormU con id &74orm contiene una casella di testo con id CI:T11 di dimensione 5 caratteri con
un massimo impostabile di 10 caratteri. Nel form trova posto anche un pulsante di tipo submit la cui pressione esegue
l'invio dell'intero modulo.
Definendo nel browser il valore della casella di testo ed agendo sul tasto Save, il dato inputato verr inviato al server
che visualizzer la pagina 8Page.*tm e contemporaneamente provveder a scrivere il valore definito nella variabile
UNT DB100.12.
La funzione javascript SetVal9es!#, che si trova in testa alla pagina Html ed eseguita automaticamente sul caricamento
della pagina, serve a inizializzare la casella di testo con il valore reale della variabile UNT allocata a DB100.12.
!unction Set8alues() [Set(RU3*T#+R, RJ<CRPdR, U3*T, #+DKR);\
JNscriBtK
JNheadK
JbodA onLoad=RSet8alues();RK
1%.1.1 AR0 name
l campo name dell'argomento molto importante in quanto definisce il tipo di variabile PLC da impostare (Sono gestiti
tutti i tipi definiti nella EC61131) ed il suo indirizzo, i due campi devono essere separati da uno spazio.
Un nome del tipo UNT 12 indicher una variabile UNT allocata ad indirizzo DB 100.12.
Un nome del tipo REAL 128 indicher una variabile REAL allocata ad indirizzo DB 100.128.
Quindi un nome del tipo STRNG 1000 indicher una variabile STRNG allocata ad indirizzo DB 100.1000.
1%.1.2 AR0 id
l campo id dell'argomento serve a referenziare l'oggetto all'interno del form in modo da poterlo valorizzare con la
funzione +et2alues"#. La scelta di definirlo come UNT12 utilizzata nell'esempio puramente indicativa, meglio sarebbe
utilizzare una definizione che ne riprenda il significato (Esempio "SetPoint, "Preset, ecc.).
Mnl151c060 Pag. 246/271
1%.4Alcuni esem!i
Naturalmente le pagine web vanno create in base alle proprie esigenze inserendo gli oggetti desiderati. Per facilitare lo
sviluppo delle proprie pagine viene fornito un programma dimostrativo PTP128*000 che contiene una serie di
programmi SlimLine e relative pagine web.
Per testare i vari programmi occorre trasferire sul modulo CPU il programma tramite LogicLab e tramite un client FTP
trasferire la pagina *tm nella directory Storage. Ora da un browser si digita l'indirizzo P del modulo CPU seguito dalla
directory e dal nome della pagina Esempio *tt+),,1/1.162.$.111,Storage,Page.*tm.
Mnl151c060 Pag. 247/271
1%.6LogicI-* gestione I5- logici
Ecco un esempio di gestione /O logici da pagina web, per visualizzare lo stato degli ingressi e delle uscite sono stati
utilizzati degli oggetti c*ecI;o=. Lo stato di attivo indicato dalla presenza del tick, per attivare le uscite si pone il tick
sulla uscita desiderata e si agisce sul tasto Set o9t+9ts.
Per visualizzare lo stato reale degli ingressi la pagina viene automaticamente rinfrescata ogni 10 secondi. Per ottenere
l'aggiornamento della pagina dopo la direttiva T*eadU viene posta la dichiarazione:
Tmeta *tt+-eB9iDFXre>res*X contentFX1$XU
Per la gestione della pagina sono utilizzate alcune funzioni javascript.
C*ecI!4ield, Val9e#, mposta o rimuove il simbolo di tick sull'oggetto di tipo checkbox indicato in 4ield in base a Val9e.
SetVal9es!#, Eseguita al caricamento della pagina esegue l'aggiornamento di tutti gli oggetti di tipo checkbox presenti.
S9;mit4orm!4orm#, Eseguita su pressione del tasto Set outputs controlla se i checkbox di attivazione uscite sono
settati ed aggiorna il valore dei campi hidden di scrittura variabili.
+orgente 'unzioni La3ascri!t di !agina
!unction 5hec?(=ield, 8alue) [docuEent%MA=orEC=ieldD%chec?ed=(8alue <= $);\
!unction Set8alues()
[
5hec?(R3nB$$R, 9J<CRPdR, B,,L, $DK9);
5hec?(R3nB$#R, 9J<CRPdR, B,,L, #DK9);
5hec?(R,ut$$R, 9J<CRPdR, B,,L, )DK9);
5hec?(R,ut$#R, 9J<CRPdR, B,,L, 6DK9);
\
!unction SubEit=orE(=orE)
[
i! (docuEent%get.leEentBA3d(9,ut$$9)%chec?ed) docuEent%get.leEentBA3d(9B,,L)9)%@alue=R#R;
i! (docuEent%get.leEentBA3d(9,ut$#9)%chec?ed) docuEent%get.leEentBA3d(9B,,L69)%@alue=R#R;
docuEent%!orEsC=orED%subEit();
\
JNscriBtK
Mnl151c060 Pag. 248/271
1%.7C-M)ort* !arametri comunicazione seriale
Ecco un esempio di come gestire la visualizzazione e l'impostazione dei parametri di comunicazione seriale da pagina
web. Per la selezione della porta, baud rate, numero bit dato, tipo di parit e modo di gestione del segnale DTR si sono
utilizzati oggetti select. L'oggetto select permette di selezionare il valore desiderato tramite una lista di valori.
Per le definizione dei tempi di ritardo sul segnale DTR si sono utilizzati degli oggetti te=t che permettono di visualizzare
ed impostare valori.
Richiamando la pagina vengono visualizzati i valori corrispondenti alle impostazioni definite nelle variabili dello
SlimLine. valori sono stati appoggiati su di un'area ritentiva per mantenerne il valore impostato anche allo
spegnimento del sistema.
Definendo nuovi valori ed agendo sul tasto Preset C'& +ort i valori saranno trasferiti nelle variabili dello SlimLine e la
pagina verr visualizzata con i nuovi valori definiti.
Ecco come si presenta la pagina web, stata visualizzata sulla finestra del programma LogicLab che visualizza in
debug i valori delle variabili.
Mnl151c060 Pag. 249/271
1%.7.1 (unzioni La3ascri!t
Per la gestione della pagina sono utilizzate alcune funzioni javascript.
Set!4ield, Val9e#, mposta il campo te=t di name 4ield con il valore Val9e.
C*oose!4ield, Val9e#, Seleziona l'oggetto select di name 4ield sull'opzione il cui valore corrisponde a Val9e.
SetVal9es!#, Eseguita al caricamento della pagina esegue l'aggiornamento di tutti gli oggetti presenti.
+orgente 'unzioni La3ascri!t di !agina
!unction 5hoose(=ield, 8alue)
[
!or (i=$; iJdocuEent%MA=orEC=ieldD%oBtions%length; iLL)
i! (docuEent%MA=orEC=ieldD%oBtionsCiD%@alue == 8alue) docuEent%MA=orEC=ieldD%selected3ndeM=i;
\
!unction Set8alues()
[
5hoose(R0ortR, 9J<CRPsR, STR3*-, +$62DK9);
5hoose(RBaudrateR, 9J<CRPdR, UD3*T, +$&7DK9);
5hoose(RDataBitsR, 9J<CRPdR, US3*T, +$7$DK9);
5hoose(R0aritAR, 9J<CRPdR, STR3*-, +$76DK9);
5hoose(RDTRMngR, 9J<CRPdR, US3*T, +$72DK9);
Set(RDTR,nR, 9J<CRPdR, U3*T, +$1$DK9);
Set(RDTR,!!R, 9J<CRPdR, U3*T, +$1+DK9);\
JNscriBtK
Mnl151c060 Pag. 250/271
11 .i!s and trics
11.1 +Ca! 3ariabile D&-RD
Ecco come utilizzare la funzione <'L per eseguire lo swap su variabile 8?'<8.
Nell'esempio l valore 16Y1130632 viene trasformato nel valore 16Y6321130 e trasferito nella variabile 2ar-ut.
Esem!io LD
Esem!io IL
LD #7T#+)6&712
R,L #7
ST 8ar,ut (* ,utBut @ariable *)
Esem!io +.
8ar,ut:=R,L(#7T#+)6&712, #7); (* ,utBut @ariable *)
11.2 +Ca! 3ariabile &-RD
Ecco come utilizzare la funzione <'L per eseguire lo swap su variabile ?'<8.
Esem!io LD
Esem!io IL
LD #7T#+)6
R,L 2
Esem!io +.
8ar,ut:=R,L(#7T#+)6, 2); (* ,utBut @ariable *)
Mnl151c060 Pag. 251/271
11.$ +Ca! 3ariabile B,.E
Ecco come utilizzare la funzione <'L per eseguire lo swap su variabile B(TE.
Esem!io LD
Esem!io IL
LD #7T#+
R,L 6
Esem!io +.
8ar,ut:=R,L(#7T#+, 6); (* ,utBut @ariable *)
Mnl151c060 Pag. 252/271
11.1 Es!andere D&-RD in $2 B--L
Ecco un come utilizzando i blocchi funzione 8o9;leTo?ord, ?ordToB7te, B7teToBit sia possibile espandere una
variabile 8?'<8 in 32 variabili B''L.
Esem!io (BD (P&011$a600, F%D_D(E=0an))
Mnl151c060 Pag. 253/271
11.4 Com!rimere $2 B--L in D&-RD
Ecco come utilizzando i blocchi funzione BitToB7te, B7teTo?ord, ?ordTo8o9;le sia possibile comprimere 32
variabili B''L in una variabile 8?'<8.
Esem!io (BD (P&011$a600, F%D_D(Com0re--)
Mnl151c060 Pag. 254/271
11.6 De'inire caratteri ascii non stam!abili
Nella gestione di protocolli di comunicazione e/o per impostare modalit di stampa su stampanti necessita eseguire
l'output di caratteri ascii non stampabili, cio caratteri con codici inferiori al 16#20 o superiori al 16#7F.
Per la definizione dei caratteri ascii stampabili basta includere tra apici singoli i caratteri (Esempio Oa;cdO).
Per i caratteri non stampabili, occorre anteporre al valore esadecimale del carattere il simbolo $, quindi per il carattere
di <STX> 16#02 avremo la definizione OV$1O, per <ETX> OV$3O e cos di seguito.
Ricordo che alcuni caratteri di controllo come il line feed, codice 16#0A, sia possibile definirli sia come OV$%O che come
OVlO. l carriage return, codice 16#0D, possibile definirlo sia come OV$8O che come OVrO. Riporto tabella esplicativa.
+e8uenza +igni'icato Esadecimale Esem!io
$$ Carattere $ 16#24 ' paid $$5 for this'
$' Apostrofo 16#27 'Enter $'Y$' for YES'
$l Line feed 16#0A 'next $l line'
$r Carriage return 16#0D 'Hello$r'
$n New line 16#0D0A 'This is a line$n'
$p New page 16#0C 'last line $p first line'
$t Tabulazione 16#09 'name$tsize$tdate'
$hh 16#hh 'ABCD = $41$42$43$44'
Ecco un esempio di utilizzo della funzione S7sVar>+rint> per definire oltre ai caratteri stampabili anche i caratteri non
stampabili ed inviarli verso lo stream di uscita. n questo esempio viene inviato verso la porta seriale C'&$ la stringa
QCiaoR seguita da carriage return e line feed.
Esem!io LD
Mnl151c060 Pag. 255/271
11.7 RE5.E dati su stream
Come si visto con la funzione S7s>o+en possibile definire un collegamento tra una risorsa di /O ed un flusso di dati
stream da cui possibile gestire la ricezione e/o la trasmissione di dati.
Per la ricezione dei dati in ingresso dallo stream si utilizza la funzione per controllo se dati presenti S7sGetIC*ars e la
funzione per la lettura degli stessi S7s>getc.
Esem!io +.
(* RM data !roE streaE% *)
0tr:="DR(RMString); (* String Bointer *)
;:3L. (T,GB,,L(SAs-et35hars(=ile))) D,
V0tr:=T,GUS3*T(SAs!getc(=ile)); (* RM string *)
0tr:=0trL#; (* String Bointer *)
(* 5hec? i! string Bointer o@er!loI% *)
3= (0tr K "DR(RMString)L)#) T:.* ./3T; .*DG3=;
.*DG;:3L.;
Per la trasmissione dei dati in uscita dallo stream si utilizza la funzione che controlla se spazio disponibile
S7sGet'S+ace, e se lo spazio sufficiente a contenere la stringa, o come nell'esempio, se il buffer di uscita vuoto
possibile trasferire la stringa sullo stream con la funzione S7sVar>+rint>.
Esem!io +.
(* TM data to streaE% *)
3= (T,GUD3*T(SAs-et,SBace(=ile)) = SAs-etTMBSiXe(=ile)) T:.*
i:=T,GU3*T(SAs8ar!Brint!(=ile, 9Ps9, STR3*-GTO0., "DR(TMString)));
.*DG3=;
Mnl151c060 Pag. 256/271
11.9 Con3ersione ti!o dati
La conversione dei dati (Detto anche casting) una pratica necessaria nella programmazione, naturalmente se il tipo
dati di destinazione ha un range inferiore del tipo dati di origine viene effettuato un troncamento del valore. Vediamo
caso per caso le varie conversioni:
.i!o B--L: Le conversioni da qualsiasi tipo verso un B--L, tornano FALSE se il valore del dato da convertire 0.
Tornano TRUE se il valore del dato da convertire diverso da 0 (anche < 0).
.i!o +IN.5<+IN.@ Le conversioni da qualsiasi tipo verso un <+IN., tornano il valore del byte meno significativo del
valore da convertire espresso in esadecimale. Esempio il valore 4660 (16#1234) torner 52 (16#34), lo stesso vale per i
REAL esempio 300.0 (16#012C) torner 44 (16#2C). Per il tipo +IN. se il valore esadecimale supera 127 il numero
sar negativo.
.i!o IN.5<IN.@ Le conversioni da qualsiasi tipo verso un <IN., tornano il valore dei due bytes meno significativi del
valore da convertire espresso in esadecimale. Esempio il valore 305419896 (16#12345678) torner 22136 (16#5678),
lo stesso vale per i REAL esempio 90000.0 (16#15F90) torner 24464 (16#5F90). Per il tipo IN. se il valore
esadecimale supera 32767 il numero sar negativo.
Nella programmazione EC con LogicLab sono previste apposite funzioni di conversione di tipo, vediamole.
Name In!ut t/!e -ut!ut t/!e (unction
DNT_TO_NT DNT NT Converts a long integer (32 bits, signed) into an integer (16 bits, signed)
NT_TO_DNT NT DNT Converts an integer (16 bits, signed) into a long integer (32 bits, signed)
TO_BOOL Any BOOL Converts any data type into a boolean
TO_SNT Any SNT Converts any data type into a short integer (8 bits, signed)
TO_USNT Any USNT Converts any data type into an unsigned short integer (8 bits, unsigned)
TO_NT Any NT Converts any data type into an integer (16 bits, signed)
TO_UNT Any UNT Converts any data type into an unsigned integer (16 bits, unsigned)
TO_DNT Any DNT Converts any data type into a long integer (32 bits, signed)
TO_UDNT Any UDNT Converts any data type into an unsigned long integer (32 bits, unsigned)
TO_REAL Any REAL Converts any data type into a floating point (32 bits, signed)
Mnl151c060 Pag. 257/271
Esem!i
Conversione di una variabile di tipo DNT in una variabile di tipo USNT nei diversi linguaggi di programmazione.
Naturalmente se il valore della variabile Var8I:T supera il valore 255 (Limite della variabile VarCSI:T), verr ritornato il
resto della divisione per il limite.
Esem!io IL
LD 8arD3*T (* D3*T @ariable *)
T,GUS3*T
ST 8arUS3*T (* US3*T @ariable *)
Esem!io (BD
Esem!io LD
Esem!io +.
8arUS3*T:=T,GUS3*T(8arD3*T); (* US3*T @ariable *)
Mnl151c060 Pag. 258/271
11.: <ser In'ormations and +ettings
E' previsto un interfacciamento tra il programma utente PLC ed il sistema operativo, questo permette di visualizzare ed
impostare da sistema operativo variabili il cui valore disponibile all'interno del programma utente.
S7sCIn>o%, S7sCIn>oB, S7sCIn>oC, S7sCIn>o8, 4 variabili stringa da 16 caratteri, che possono essere valorizzate da
programma utente e visualizzabili da sistema operativo.
S7sCSet%, S7sCSetB, S7sCSetC, S7sCSet8, 4 variabili stringa da 16 caratteri, che possono essere valorizzate da
sistema operativo e utilizzate da programma utente.
E' prevista una pagina web (Men Cser) in cui sono visualizzate le variabili S7sCIn>o!=# ed possibile impostare le
variabili S7sCSet!=#.
Nell'esempio riporto un semplice programma che acquisisce i valori delle variabili S7sCSet!=# e li trasferisce nella
rispettiva variabile di visualizzazione S7sCIn>o!=#. Nella pagina web il valore impostato nella variabile S7sCSet!=# su
accettazione con il tasto ?rite verr ritornato nella variabile S7sCIn>o!=# come visibile dallo screenshot riportato sopra.
Esem!io +.
(* Read user settings and Irite user in!os% *)
3= (SAsU8Set) T:.*
i:=SAs8arsscan!("DR(SAsUSet"), 9Pd9, UD3*TGTO0., "DR(8aluesC$D));
i:=SAs8arsnBrint!("DR(SAsU3n!o"), #7, 9Pd9, UD3*TGTO0., "DR(8aluesC$D));
i:=SAs8arsscan!("DR(SAsUSetB), 9Pd9, UD3*TGTO0., "DR(8aluesC#D));
i:=SAs8arsnBrint!("DR(SAsU3n!oB), #7, 9Pd9, UD3*TGTO0., "DR(8aluesC#D));
i:=SAs8arsscan!("DR(SAsUSet5), 9Pd9, UD3*TGTO0., "DR(8aluesC+D));
i:=SAs8arsnBrint!("DR(SAsU3n!o5), #7, 9Pd9, UD3*TGTO0., "DR(8aluesC+D));
i:=SAs8arsscan!("DR(SAsUSetD), 9Pd9, UD3*TGTO0., "DR(8aluesC)D));
i:=SAs8arsnBrint!("DR(SAsU3n!oD), #7, 9Pd9, UD3*TGTO0., "DR(8aluesC)D));
.*DG3=;
Mnl151c060 Pag. 259/271
12 Esem!i di !rogrammazione
12.1Biblioteca esem!i
Per permettere all'utente di disporre di esempi da utilizzare per lo
sviluppo dei proprii programmi quasi tutti gli esempi riportati sul
manuale sono forniti in programmi dimostrativi. programmi
dimostrativi sono codificati con il suffisso PTP, accanto ad ogni
esempio . Se si desidera includere nel proprio progetto un file di
esempio del manuale occorre dal men ProLect scegliere la voce
Im+ort o;Lect >rom li;rar7. Si aprir un dialog box che permette di
selezionare la libreria da cui estrarre il programma da importare.
Scegliere il file di libreria desiderato
(Esempio Pt+116G$$$.+ll) si aprir la
finestra con l'elenco degli oggetti
presenti all'interno da cui sar
possibile selezionare gli oggetti
desiderati.
Evidenziando gli oggetti e agendo sul
tasto Im+ort ';Lect, gli oggetti
selezionati saranno inclusi nel proprio
progetto.
Oltre ai programmi possibile
importare dalla libreria anche le
variabili. n questo modo si potranno
importare tutte le definizioni degli /O
logici come indicato nella tabella di
definizione.
Una volta inclusi nel progetto gli esempi, sar possibile utilizzarli direttamente, oppure con con semplici operazioni di cut
and paste incollare parti di codice sorgente dal progetto di esempio.
Mnl151c060 Pag. 260/271
12.2De'inizioni I5- logici negli esem!i
Tutti gli esempi riportati in questo manuale sono stati realizzati utilizzando un sistema configurato con un modulo CPU
SlimLine tipo MPS046A100 abbinato ad un modulo Mixed /O PCB122*100 (mpostato con address 0). Tutti gli /O del
modulo sono stati abbinati a variabili mnemoniche. Gli ingressi sono denominati 8i$=&$$ e le uscite 8o$=&$$ come
evidente nella tabella di definizione.
Mnl151c060 Pag. 261/271
12.$Esem!i 'orniti con LogicLab
Nella distribuzione del programma LogicLab sono inseriti alcuni programmi di esempio, i programmi sono forniti in
codice sorgente e possono essere trasferiti sul sistema target e provati. Nell finestra principale di LogicLab sotto la voce
E=am+le +roLects vi il link ai vari progetti. Per poter utilizzare un esempio sul proprio sistema target occorre definire il
sistema con il quale si st operando dal men )roLect Q +elect target.
E definire il modo di comunicazione utilizzato dal men -nGline Q +et u! communication.
Mnl151c060 Pag. 262/271
12.$.1 Elenco !rogrammi di esem!io
programmi forniti con LogicLab sono:
+tart+to! Logica di marcia/arresto
+M+b/&eb nvio messaggi SMS da pagina web
MdbAsciiMaster FB gestione protocollo Modbus Ascii (Modo Master)
Multi!le+.E Connessione in SNMP con alcuni dispositivi STE
Eas/)rotocol Sviluppo di un semplice protocollo di comunicazione
)oCer-neCm Comunicazione con inverter Aurora della Power One
.agReader Controllo accessi con TAG -button
0+MDoor-!en Apricancello su chiamata telefonica
.C)Ascii)rotocol Semplice comunicazione ascii su connessione TCP/P
C+2(ile.ime+Citch Programmatore orario con lettura tempi da file CSV
+ine&a3e Generatore onda sinusoidale
Mnl151c060 Pag. 263/271
1$ A!!endici
1$.1.abella istruzioni IL
Istruzione -!erandi Descrizione
LD Tutti Carica il valore operando nell'accumulatore
LDN Tutti Carica il valore negato operando nell'accumulatore
+. Tutti Trasferisce il valore dell'accumulatore nell'operando
+.N Tutti Trasferisce il valore negato dell'accumulatore nell'operando
+ BOOL Setta l'operando (Accetta solo BOOL) se l'accumulatore TRUE
R BOOL Resetta l'operando (Accetta solo BOOL) se l'accumulatore TRUE
AND Tutti meno REAL AND a bit tra accumulatore e valore operando, risultato in accumulatore
ANDN Tutti meno REAL AND a bit tra accumulatore e valore negato operando, risultato in accumulatore
-R Tutti meno REAL OR a bit tra accumulatore e valore operando, risultato in accumulatore
-RN Tutti meno REAL OR a bit tra accumulatore e valore negato operando, risultato in accumulatore
>-R Tutti meno REAL XOR a bit tra accumulatore e valore operando, risultato in accumulatore
>-RN Tutti meno REAL XOR a bit tra accumulatore e valore negato operando, risultato in accumulatore
N-. Esegue l'inversione a bit del valore in accumulatore
ADD Tutti meno BOOL Somma tra accumulatore e valore operando, risultato in accumulatore
+<B Tutti meno BOOL Sottrazione tra accumulatore e valore operando, risultato in accumulatore
M<L Tutti meno BOOL Moltiplicazione tra accumulatore e valore operando, risultato in accumulatore
DI2 Tutti meno BOOL Divisione tra accumulatore e valore operando, risultato in accumulatore
M-D Tutti meno BOOL Ritorna il modulo della divisione nell'accumulatore
0. Tutti meno BOOL Controlla se accumulatore > operando, risultato (BOOL) in accumulatore
0E Tutti meno BOOL Controlla se accumulatore >= operando, risultato (BOOL) in accumulatore
E= Tutti meno BOOL Controlla se accumulatore = operando, risultato (BOOL) in accumulatore
NE Tutti meno BOOL Controlla se accumulatore <> operando, risultato (BOOL) in accumulatore
LE Tutti meno BOOL Controlla se accumulatore <= operando, risultato (BOOL) in accumulatore
L. Tutti meno BOOL Controlla se accumulatore < operando, risultato (BOOL) in accumulatore
RM) Etichetta Salta incondizionatamente su etichetta
RM)C Etichetta Salta su etichetta se accumulatore diverso da zero
RM)CN Etichetta Salta su etichetta se accumulatore uguale a zero
CAL FB Esegue incondizionatamente il blocco funzione
CALC FB Esegue blocco funzione se accumulatore diverso da zero
CALCN FB Esegue blocco funzione se accumulatore uguale a zero
RE. Ritorna incondizionatamente al programma che ha eseguito CALL
RE.C Ritorna al programma che ha eseguito CALL se accumulatore diverso da zero
Mnl151c060 Pag. 264/271
1$.2-!eratori linguaggio +.
Nella tabella seguente sono riportati gli operatori utilizzabili nel linguaggio ST. Gli operatori sono riportati in tabella in
base alla loro priorit, dall'alto verso il basso, quindi le parentesi hanno priorit maggiore su tutti gli altri operatori.
-!eratore +imbolo Esem!io
Parenthesization (Espressione)
Function evaluation Funzione(Argomenti)
L*("), M"/(/,O), etc%
Negation -
Complement NOT
Exponentiation **
Multiply *
Divide /
Modulo MOD
Add +
Subtract -
Comparison < , > , <= , >=
Equality =
nequality <>
Boolean AND &
Boolean AND AND
Boolean Exclusive OR XOR
Boolean OR OR
Mnl151c060 Pag. 265/271
1$.$+tatements linguaggio +.
Nella tabella seguente sono riportati gli operatori utilizzabili nel linguaggio ST. Gli operatori sono riportati in tabella in
base alla loro priorit, dall'alto verso il basso, quindi le parentesi hanno priorit maggiore su tutti gli altri operatori.
+tatement Esem!io
Assignment
":=B; 58:=58L#; 5:=S3*(/);
FB nvocation and output usage
5MDGTMR(3*:=P3/&, 0T:=TT)$$Es);
":=5MDGTMR%';
RETURN
R.TUR*;
F
D:=B*B6*"*5;
3= D J $%$ T:.* *R,,TS:=$;
.LS3= D=$%$ T:.*
*R,,TS:=#;
/#:=BN(+%$*");
.LS.
*R,,TS:=+;
/#:=(BLS'RT(D))N(+%$*");
/+:=(BS'RT(D))N(+%$*");
.*DG3=;
CASE
T;:=B5DGT,G3*T(T:UMB;:..L);
T;G.RR,R:=$;
5"S. T; ,=
#,&: D3S0L"O:=,8.*GT.M0;
+: D3S0L"O:=M,T,RGS0..D;
): D3S0L"O:=-R,SST"R.;
6,7%%#$: D3S0L"O:=ST"TUS(T;6);
.LS.
D3S0L"O:=$;
T;G.RR,R:=#;
.*DG5"S.;
';#$$:=3*TGT,GB5D(D3S0L"O);
FOR
]:=#$#;
=,R 3:=# T, #$$ BO + D,
3= ;,RDSC3D=9H.O9 T:.*
]:=3;
./3T;
.*DG3=;
.*DG=,R;
WHLE
]:=#;
;:3L. ] J= #$$ U ;,RDSC]DJK9H.O9 D,
]:=]L+;
.*DG;:3L.;
REPEAT
]:=#;
R.0."T
]:=]L+;
U*T3L ]=#$# ,R ;,RDSC]D=9H.O9
.*DGR.0."T ;
EXT
./3T;
Empty Statement
;
Mnl151c060 Pag. 266/271
1$.1Errori di esecuzione
Alcune funzioni e/o blocchi funzione possono avere errori di esecuzione, tipicamente ritornata una flag di fault che
indica l'errore. Per acquisire il codice di errore utilizzare la funzione S7sGetLastError, ritorna il codice dell'ultimo errore,
v eseguita immediatamente dopo la funzione di cui si vuole controllare l'errore. Da debug possibile controllare il
valore della variabile S7sLastError che sar $ se nessun errore oppure ritorner il valore dell'ultimo errore riscontrato
nella esecuzione.
ID Range errore (unzione o (B
9952 9952000 9952999 SysDirListing, directory listing
9953 9953000 9953999 Sys2CWrRd, writes/reads on 2C extension bus
9954 9954000 9954999 SysCANTxMsg, transmit a CAN message
9955 9955000 9955999 SysCANRxMsg, receives a CAN message
9956 9956000 9956999 SyssCANRxTxAv, checks if CAN Rx or Tx is available
9957 9957000 9957999 SysCANSetMode, set the CAN controller mode
9958 9958000 9958999 Sysfseek, file seek
9959 9959000 9959999 Sysfilelength, file lengh
9960 9960000 9960999 Sysrename, file rename
9961 9961000 9961999 Sysremove, file remove
9962 9962000 9962999 SysFOBfFlush, file output buffer flush
9963 9963000 9963999 SysFOBfClear, file output buffer clear
9964 9964000 9964999 SysFBfClear, file input buffer clear
9965 9965000 9965999 SysGetTxBSize, get file Tx output buffer size
9966 9966000 9966999 SysGetRxBSize, get file Rx input buffer size
9967 9967000 9967999 SysGetOSpace, get output available space on file
9968 9968000 9968999 SysGetChars, get input available characters from file
9969 9969000 9969999 Sysfwrite, write data to file
9970 9970000 9970999 Sysfread, read data from file
9971 9971000 9971999 Sysfputc, put character to file
9972 9972000 9972999 Sysfgetc, get character from file
9973 9973000 9973999 Sysfclose, file close
9974 9974000 9974999 SysPReach, P address is reachable
9975 9975000 9975999 SysUDPSktRcv, UDP socket receive
9976 9976000 9976999 SysUDPSktSend, UDP socket send
9977 9977000 9977999 SysSktListen, socket listen
9978 9978000 9978999 SysGetCrc, get CRC value
9979 9979000 9979999 SysDMXMng, DMX management
9980 9980000 9980999 SysGetEncoder, get encoder input
9981 9981000 9981999 SysGetCounter, get counter
9982 9982000 9982999 SysSetAnOut, set analog output
9983 9983000 9983999 SysGetAnnp, get analog input
9984 9984000 9984999 SysSetPhrDO, set peripheral digital output
9985 9985000 9985999 SysGetPhrD, get peripheral digital input
9986 9986000 9986999 SysETimeToDate, epoch time to date conversion
Mnl151c060 Pag. 267/271
9987 9987000 9987999 SysDateToETime, date to epoch time conversion
9988 9988000 9988999 SysPhrVWr, write variable to peripheral module
9989 9989000 9989999 SysPhrVRd, read variable from peripheral module
9990 9990000 9990999 SysPhrnfos, get infos from peripheral modules
9991 9991000 9991999 SysPCodeAccept, accepts the protection code
9992 9992000 9992999 SysSetSerialDTR, set DTR signal status
9993 9993000 9993999 SysGetSerialCTS, get serial CTS signal status
9994 9994000 9994999 SysSetSerialMode, set serial mode
9995 9995000 9995999 SysGetSerialMode, get serial mode
9996 9996000 9996999 Sysfopen, file open
9997 9997000 9997999 SysVarsnprintf, variable print to string
9998 9998000 9998999 SysVarfprintf, variable print to file
9999 9999000 9999999 SysVarsscanf, extracts values from string
10000 10000000 10000999 MDBRTUMASTER, modbus Rtu master
10001 10001000 10001999 CPUModuleO, CPU module /O management
10002 10002000 10002999 ModemCore_v1, modem core management
10003 10003000 10003999 ModemSMSReceive, receive a SMS message
10004 10004000 10004999 ModemSMSRxCmd_v1, receive a SMS command
10005 10005000 10005999 ModemSMSSend_v1, send a SMS message
10006 10006000 10006999 SetSMode, Set serial mode
10007 10007000 10007999 ModbusRTUMaster_v1, modbus RTU master
10008 10008000 10008999 OwireMng, One-Wire management
10009 10009000 10009999 OWRddentifier, One-Wire read ROM identifier
10010 10010000 10010999 OWRdTemperature, One-Wire read temperature
10011 10011000 10011999 ODataExchange, exchange data by using logic /O
10012 10012000 10012999 PDMng, PD management
10013 10013000 10013999 STESnmpAcq, STE termometer acquisition over SNMP
10014 10014000 10014999 UDPDataTxfer, UDP data transfer
10015 10015000 10015999 OWRdHumidity, One-Wire read humidity
10016 10016000 10016999 EC62056_21Rd, EC62056-21 protocol read
10017 10017000 10017999 NMEASnterface, NMEA system interface
10018 10018000 10018999 GLLSentence, Geographic Position sentence
10019 10019000 10019999 ModbusRTUSlave, modbus Rtu slave
10020 10020000 10020999 MWVSentence, Wind Speed and Angle sentence
10030 10030000 10030999 AuroraDSPMeasure, Aurora measure request to DSP
10031 10031000 10031999 AuroraCEnergy, Aurora cumulated energy reading
10032 10032000 10032999 sHWgSProtocol, HW group serial protocol
10033 10033000 10033999 ModbusAsciiSlave, modbus Ascii slave
10034 10034000 10034999 SysLogReport, send a report to Syslog server
10035 10035000 10035999 StringToLogFile, store string to a log file
10036 10036000 10036999 FileMemoryDump, dump memory on file
Mnl151c060 Pag. 268/271
10037 10037000 10037999 ModemPhoneCall, executes a phone call
10038 10038000 10038999 ModbusSlave, modbus slave
10039 10039000 10039999 HDClkDtaReader, HD RFD clock/data reader
10040 10040000 10040999 MMasterDataTxfer, multimaster data transfer
10041 10041000 10041999 DataTxferClient, Data transfer client
10042 10042000 10042999 ModemHTTPGet, executes a HTTP Get request
10043 10043000 10043999 SpyDataFile, spy data and stores them on a file
Mnl151c060 Pag. 269/271
1$.4.abella codici Ascii
1$.4.1 .abella codici A+CII standard
Mnl151c060 Pag. 270/271
1$.4.2 .abella codici A+CII estesi
Mnl151c060 Pag. 271/271

IEC61131 3 Programming

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

IEC61131 3 Programming

Caricato da

Copyright:

Formati disponibili

Programmazione IEC 61131-3

Potrebbero piacerti anche