Pagina 1 di 6 ELSIST Srl, www.elsist.it Blocchi funzione MNL041Q000 FbModbusAsciiMs Questo blocco funzione permette lo scambio di dati tra due sistemi, uno master ed uno slave, utilizzando una connessione MODBUS ASCII in linea seriale. Per la comunicazione con i sistemi slave il blocco funzione utilizza le funzioni MODBUS 41: Read memory bytes (User function) e 42: Write memory bytes (User function), si rimanda alla documentazione del blocco funzione FbModbusAsciiSl per la documentazione completa delle funzioni utilizzate. Per un esempio di rete di comunicazione tra un sistema master e due o piu sistemi slave, fare riferimento a HT001. Code:PFB044 Prototype FbModbusAsciiMs.h History report Declaration void FbModbusAsciiMs(FBMODBUSASCIIMSDATA* S); Parameters FBMODBUSASCIIMSDATA* S Data ure address (Range from 0x0000 to 0xFFFF) Return value None Struttura dati Il blocco funzione utilizza una struttura dati di 64 bytes di cui forniamo prototipo. I membri riportati sotto l'indicazione di Internal use only members sono utilizzati internamente dal blocco funzione e non devono essere modificati dal programma utente. typedef // --------------------------[Members that can be managed by user program]-- BOOL Enable:1; //Enable BOOL ResetCtrs:1; //Resets all the counters BOOL b2:1; BOOL b3:1; BOOL DoWrite:1; //Write memory bytes BOOL DoRead:1; //Read memory bytes BOOL DoWrRd:1; //Write/read memory bytes BOOL b7:1; }Command; //Command BOOL Enabled:1; //Enabled BOOL JobDone:1; //Command executed BOOL b2:1; BOOL b3:1; BOOL Timeouts:1; //Timeout error BOOL Overruns:1; //Overrun error BOOL CommErrs:1; //Communication error BOOL Parameters:1; //Parameter error }Status; //Status unsigned char NodeAdd; //Node address unsigned char Dummy1; unsigned int WrLcStAd; //Master send data start address unsigned int WrRmStAd; //Slave receive data start address unsigned char WrBytes; //Number of bytes to send (from 0x00 to 0x20) unsigned char Dummy2; unsigned int RdLcStAd; //Master receive data start address
Pagina 2 di 6 unsigned int RdRmStAd; //Slave send data start address unsigned char RdBytes; //Number of bytes to receive (from 0x00 to 0x20) unsigned char Dummy3; unsigned int CommndWt; //Wait time before start (msec) unsigned int TimeOutCk; //Timeout Check (msec) unsigned char Dummy4; unsigned int Timeouts; //Timeout error counter unsigned int Overruns; //Overrun error counter unsigned int CommErrs; //Communication error counter unsigned int TxFrames; //Transmit string counter unsigned int RxFrames; //Received string counter unsigned int PLCMemStart; //Start PLC memory unsigned char Dummy5; unsigned char FrameLength; //Rx/Tx frame Length unsigned char* FrameBuf; //Rx/Tx frame buffer // --------------------------------------------[Internal use only members]--... }FBMODBUSASCIIMSDATA; 00 Command Bits di comando del blocco funzione, il programma utente può gestire questi bits in funzione delle proprie necessità. 0 Enable FALSE: Disabilita l'fb, la comunicazione si arresta. Disabilitando l'fb si azzerano anche tutti i bits di errore in Status e tutti gli altri bits di comando non sono piu attivi. TRUE: Abilita l'fb e si attiva la comunicazione. 1 ResetCtrs TRUE: Esegue il reset di tutti i counters, il bit viene automaticamente resettato. 4 DoWrite TRUE: Comanda il trasferimento dei dati verso il sistema slave. Con l'inizio della esecuzione comando il bit viene automaticamente resettato. 5 DoRead TRUE: Comanda la lettura dei dati dal sistema slave. Con l'inizio della esecuzione comando il bit viene automaticamente resettato. 6 DoWrRd TRUE: Comanda il trasferimento dei dati verso il sistema slave e la sucessiva lettura. Con l'inizio della esecuzione comando il bit viene automaticamente resettato. 01 Status Bits di stato del blocco funzione, il programma utente può testare questi bits. 0 Enabled TRUE: Indica che la FB è stata abilitata. 1 JobDone Attivato per un loop di programma al termine della esecuzione del comando richiesto. 4 Timeouts TRUE: Indica un errore di timeout esecuzione comando, il sistema slave non ha risposto alla richiesta inviata. Si resetta azzerando il bit Command.Enable. 5 Overruns TRUE: Indica un errore di overruns in ricezione risposta da linea seriale, è stato ricevuto un numero di caratteri maggiore della lunghezza buffer di ricezione. Si resetta azzerando il bit Command.Enable. 6 CommErrs TRUE: Indica un errore in ricezione risposta da linea seriale, è stato ricevuto un carattere errato od un numero di caratteri diverso da quello atteso. Si resetta azzerando il bit Command.Enable. 7 Parameters TRUE: Indica un errore nei parametri impostati nella struttura dati della FB. Si resetta azzerando il bit Command.Enable. 02 NodeAdd Caricato dal programma utente, definisce l'indirizzo di nodo slave con cui comunicare (Da 0x00 a 0xFF). 04 WrLcStAd Caricato dal programma utente, definisce l indirizzo di inizio dell area dati sistema master da trasferire verso il sistema slave (Da 0x0000 a 0xFFFF). 06 WrRmStAd Caricato dal programma utente, definisce l'indirizzo di inizio dell area del sistema slave in cui vengono trasferiti i dati letti dal sistema master (Da 0x0000 a 0xFFFF). L'indirizzo utilizzato dal comando MODBUS per la scrittura dei dati sul sistema slave sarà la somma tra questo valore ed il valore di PLCMemStart. 08 WrBytes Caricato dal programma utente, definisce il numero di bytes da trasferire verso il sistema slave (Da 1 a 32). 0A RdLcStAd Caricato dal programma utente, definisce l'indirizzo di inizio dell area del sistema master in cui vengono trasferiti i dati letti dal sistema slave (Da 0x0000 a 0xFFFF). 0C RdRmStAd Caricato dal programma utente, definisce l'indirizzo di inizio dell area del sistema slave da cui verranno letti i dati che saranno trasferiti nel sistema master (Da 0x0000 a 0xFFFF). L'indirizzo utilizzato dal comando MODBUS per la lettura
Pagina 3 di 6 dei dati dal sistema slave sarà la somma tra questo valore ed il valore di PLCMemStart. 0E RdBytes Caricato dal programma utente, definisce il numero di bytes da leggere dal sistema slave (Da 1 a 32). 10 CommndWt Caricato dal programma utente, definisce il tempo di attesa espresso in millisecondi che intercorre tra il termine della esecuzione di un comando (si ricorda che ogni comando è sempre composto da un invio di un frame comando ed una ricezione della relativa risposta) e l'avvio del comando successivo. In caso di comando DoWrRd rappresenta il tempo che intercorre tra il termine del comando di write e l invio del successivo comando di read (Da 0x0000 a 0xFFFF). 12 TimeOutCk Caricato dal programma utente, definisce il tempo disponibile per l'esecuzione un comando espresso in millisecondi (Da 0x0000 a 0xFFFF). 16 Timeouts Contiene il conteggio del numero di errori di timeouts occorsi sia in ricezione che in trasmissione (Da 0x0000 a 0xFFFF). Può essere azzerato da programma utente oppure attivando il bit Command.ResetCtrs. 18 Overruns Contiene il conteggio del numero di errori di overrun occorsi in ricezione (Da 0x0000 a 0xFFFF). Può essere azzerato da programma utente oppure attivando il bit Command.ResetCtrs. 1A CommErrs Contiene il conteggio del numero di errori di comunicazione occorsi in ricezione (Da 0x0000 a 0xFFFF). Può essere azzerato da programma utente oppure attivando il bit Command.ResetCtrs. 1C TxFrames Contiene il conteggio del numero stringhe di comando trasmesse (Da 0x0000 a 0xFFFF). Può essere azzerato da programma utente oppure attivando il bit Command.ResetCtrs. 1E RxFrames Contiene il conteggio del numero di stringhe di risposta ricevute (Da 0x0000 a 0xFFFF). Può essere azzerato da programma utente oppure attivando il bit Command.ResetCtrs. 20 PLCMemStart Caricato dal programma utente, definisce l'indirizzo di allocazione delle variabili PLC in memoria sul sistema slave (Da 0x0000 a 0xFFFF). L'indirizzo utilizzato dal comando MODBUS per la scrittura dei dati sul sistema slave sarà la somma tra questo valore ed il valore di WrRmStAd. L'indirizzo utilizzato dal comando MODBUS per la lettura dei dati sul sistema slave sarà la somma tra questo valore ed il valore di RdRmStAd. 23 FrameLength Caricato dal programma utente, definisce la dimensione in byte del buffer di ricezione/trasmissione frames (Da 12 a 255). Per mantenere la compatibilità con le precedenti versioni occorre definire una dimensione del buffer di 40 bytes. 24 FrameBuf Caricato da programma utente, definisce l'indirizzo di allocazione del buffer di ricezione/trasmissione frames (Da 0x0000 a 0xFFFF). Esempio RIL Nel seguente esempio viene eseguita la gestione della comunicazione Modbus con un sistema slave, il sistema master ed il sistema slave si scambiano automaticamente banchi di memoria. Per testarne il funzionamento basterà connettere il sistema master con un sistema slave su cui deve essere eseguito un programma che gestisce il blocco funzione FbModbusAsciiSl di gestione modbus slave. ; @Section("Communication buffer") ; Here define the data buffer to communicate with the slave system. DEFG Y ToSlave KD 4 DEFG Y ToY0000 Y ToSlave KH 0000 ; ToSlave, Y 0000 DEFG Y ToY0001 Y ToSlave KH 0001 ; ToSlave, Y 0001 DEFG W ToW0002 Y ToSlave KH 0002 ; ToSlave, W 0002 DEFG Y FromSlave KD 2 DEFG Y FromY0020 Y FromSlave KH 0000 ; FromSlave, Y 0020 DEFG Y FromY0021 Y FromSlave KH 0001 ; FromSlave, Y 0021
Pagina 4 di 6 ; @Section("Local definitions") ; MODBUS master communication, data ure. DEFL Y Mdb KD 64 DEFL Y MdbCommand Y Mdb KH 0000 ; Mdb.Command DEFL Y MdbStatus Y Mdb KH 0001 ; Mdb.Status DEFL Y MdbNodeAdd Y Mdb KH 0002 ; Mdb.NodeAdd DEFL W MdbWrLcStAd Y Mdb KH 0004 ; Mdb.WrLcStAd DEFL W MdbWrRmStAd Y Mdb KH 0006 ; Mdb.WrRmStAd DEFL Y MdbWrBytes Y Mdb KH 0008 ; Mdb.WrBytes DEFL W MdbRdLcStAd Y Mdb KH 000A ; Mdb.RdLcStAd DEFL W MdbRdRmStAd Y Mdb KH 000C ; Mdb.RdRmStAd DEFL Y MdbRdBytes Y Mdb KH 000E ; Mdb.RdBytes DEFL W MdbCommndWt Y Mdb KH 0010 ; Mdb.CommndWt DEFL W MdbTimeOutCk Y Mdb KH 0012 ; Mdb.TimeOutCk DEFL W MdbTimeouts Y Mdb KH 0016 ; Mdb.Timeouts DEFL W MdbOverruns Y Mdb KH 0018 ; Mdb.Overruns DEFL W MdbCommErrs Y Mdb KH 001A ; Mdb.CommErrs DEFL W MdbTxFrames Y Mdb KH 001C ; Mdb.TxFrames DEFL W MdbRxFrames Y Mdb KH 001E ; Mdb.RxFrames DEFL W MdbPLCMemStart Y Mdb KH 0020 ; Mdb.PLCMemStart DEFL Y MdbFrameLength Y Mdb KH 0023 ; Mdb.FrameLength DEFL W MdbFrameBuf Y Mdb KH 0024 ; Mdb.FrameBuf ; Rx/Tx frame buffer definition. DEFL Y FrameBuf KD 40 ; @Section("Program init") ; MODBUS master communication, variables settings. ORGR LODT F PLCFirstLoop MOVI Y MdbNodeAdd KD 0 ; Mdb.NodeAdd MOVA W MdbWrLcStAd Y ToSlave ; Mdb.WrLcStAd MOVI W MdbWrRmStAd KH 0000 ; Mdb.WrRmStAd MOVI Y MdbWrBytes KD 4 ; Mdb.WrBytes MOVA W MdbRdLcStAd Y FromSlave ; Mdb.RdLcStAd MOVI W MdbRdRmStAd KH 0020 ; Mdb.RdRmStAd MOVI Y MdbRdBytes KD 2 ; Mdb.RdBytes MOVI W MdbCommndWt KD 40 ; Mdb.CommndWt MOVI W MdbTimeOutCk KD 500 ; Mdb.TimeOutCk MOVI W MdbPLCMemStart KH 0000 ; Mdb.PLCMemStart MOVI Y MdbFrameLength KD 40 ;Mdb.FrameLength MOVA W MdbFrameBuf Y FrameBuf ;Mdb.FrameBuf LTCH Y MdbCommand BD 1 ;Mdb.Command.ResetCtrs ; @Section("MODBUS communication, master management") ; MODBUS master communication management. ; [End of file] ORGR SETR SETV KE IOSerialPortA TASK L FbModbusAsciiMs Y Mdb ; MODBUS master management LTCH Y MdbCommand BD 0 ;Mdb.Command.Enable LTCH Y MdbCommand BD 6 ;Mdb.Command.DoWrRd Esempio "C"
Pagina 5 di 6 Nel seguente esempio viene eseguita la gestione della comunicazione Modbus con un sistema slave, il sistema master ed il sistema slave si scambiano automaticamente banchi di memoria. Per testarne il funzionamento basterà connettere il sistema master con un sistema slave su cui deve essere eseguito un programma che gestisce il blocco funzione FbModbusAsciiSl di gestione modbus slave. // FILE INCLUSIONS #include <ElSystemLib.h> #include <ElPLCLib.h> #include <FbModbusAsciiMs.h> // GENERAL DEFINITIONS #define MDBFRAMELENGTH 40 //Modbus frame length // DATA BUFFER DEFINITIONS // Here define the data buffer to communicate with the slave system. unsigned char Byte0; //To slave system, byte 0 unsigned char Byte1; //To slave system, byte 1 unsigned int Word2; //To slave system, word 2 }ToSlave; //Data buffer to slave unsigned char Byte0; //From slave system, byte 0 unsigned char Byte1; //From slave system, byte 1 }FromSlave; //Data buffer from slave // EXAMPLE PROGRAM void Example(void) // Local variable definitions. static FBMODBUSASCIIMSDATA Mdb; //MODBUS master data ure static unsigned char FrameBuf[MDBFRAMELENGTH]; //Rx/Tx frame buffer // PROGRAM INIT // Execute the system init at first program execution loop. if (PLCFirstLoop) // Set variables to manage the MODBUS master communication. Mdb.NodeAdd=0; //Node address Mdb.WrLcStAd=(unsigned int)&toslave; //Master send data start address Mdb.WrRmStAd=0x0000; //Slave receive data start address Mdb.WrBytes=sizeof(ToSlave); //Number of bytes to send Mdb.RdLcStAd=(unsigned int)&fromslave; //Master receive data start address Mdb.RdRmStAd=0x0004; //Slave send data start address Mdb.RdBytes=sizeof(FromSlave); //Number of bytes to receive Mdb.TimeOutCk=500; //Timeout Check (msec)
Pagina 6 di 6 } Mdb.CommndWt=0; //Wait time before start (msec) Mdb.PLCMemStart=0x0000; //Start PLC memory Mdb.FrameLength=MDBFRAMELENGTH; //Rx/Tx frame length Mdb.FrameBuf=&FrameBuf; //Rx/Tx frame buffer Mdb.Command.Enable=FALSE; //Enable Mdb.Command.ResetCtrs=TRUE; //Resets all the counters // MODBUS MASTER COMMUNICATION // MODBUS master communication call. } SetTermIOVectors(IOSerialPortA); FbModbusAsciiMs(&Mdb); //MODBUS master management Mdb.Command.Enable=TRUE; //Enable Mdb.Command.DoWrite=TRUE; //Write memory bytes // [End of file]