| Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
| en:software:devices:modbus [2016/12/23 17:23] – [6.3.2. Parametri] qem103 | en:software:devices:modbus [2016/12/27 14:47] – [6.3.5. Comandi] qem103 |
|---|
| |
| === - Parameters === | === - Parameters === |
| FIXME | |
| ^ Nome ^ D ^ R ^ A ^ Condizioni ^ Descrizione ^ | ^ Name ^ D ^ R ^ A ^ Conditions ^ Description ^ |
| | mode | B | R | R/W | - | **Mode**\\ (0 ÷ 2)\\ Definisce se la scheda deve funzionare come master o come slave.\\ **1** = slave con area di scambio dati fissa;\\ **2** = slave senza area di scambio dati fissa: ad ogni scrittura o lettura eseguita dal master viene messi a 1 il flag st_msgrx.\\ Contemporaneamente i parametri //type//, //addr// e //num// indicano le caratteristiche del messaggio ricevuto.\\ - **Type** indica il tipo di funzione che vuole fare ill master (lettura o scrittura),\\ - **addr** indica l'indirizzo dell'inizio del blocco di dati scritti o letti,\\ - **num** indica il numero di dati letti o scritti (a bit o a byte a seconda del valore di type).\\ Il device controllerà, in ricezione, solamente num (size di messaggio) che non sia superiore a 32word ma non più l'indirizzo che può essere ora qualsiasi.\\ Se è una scrittura (lo si capisce dal valore di type se è 5,6,15,16) vengono riportati i dati nelle variabili di scambio input (sempre a partire dalla prima word) ed il device attende il comando RECEIVED.\\ Se è una lettura il device attende che il QCL depositi i dati nelle word variabili di scambio output ed attende il comando VALIDATE. | | | mode | B | R | R/W | - | **Mode**\\ (0 ÷ 2)\\ Defines if the board should function as a master or slave.\\ **1** = slave with fixed data exchange area;\\ **2** = slave without fixed data exchange area: any writing or reading done by the master is put to 1 the st_msgrx flag.\\ At the same time the //type//, //addr// and //num// parameters indicate the features of the received message.\\ - **Type** indicates the type of function that wants to be the master (read or write),\\ - **addr** indicates the address of the beginning of the written or read data block,\\ - **num** indicates the read or written number of data (to bit or to byte depending on the value of type).\\ The device will check, in reception, only num (size of message) that does not exceed 32wordbut not the address that can now be any.\\ If it is a write (You can tell by the value of the type if it is 5,6,15,16) are shows the lists the data in variables of exchange input (always starting from the first word) and the device waits for the RECEIVED command.\\ If you read the device waits for the QCL stores data in word output exchange variables and waits for the VALIDATE command. | |
| | prot | B | R | R/W | - | **Protocol**\\ Definisce il tipo di protocollo Modbus da utilizzare.\\ **0** = ASCII,\\ **1** = RTU,\\ **2** = TCPIP. | | | prot | B | R | R/W | - | **Protocol**\\ Defines the type of Modbus Protocol to use.\\ **0** = ASCII,\\ **1** = RTU,\\ **2** = TCPIP. | |
| | wider | B | R | R/W | - | **Wide Registers**\\ Indica se utilizzare l’estensione del protocollo per i registri a 32bit. Vedere capitolo “Estensione del protocollo”.\\ **0** = normale,\\ **1** = protocollo esteso. | | | wider | B | R | R/W | - | **Wide Registers**\\ Indicates if to use the 32-bit registers protocol extension. See “Extension of the Protocol” section.\\ **0** = normal,\\ **1** = extended protocol. | |
| | idcard | W | R | R/W | - | **Identification Card**\\ ( 1 ÷ 255 per slave)\\ Nel funzionamento come slave è il numero che identifica l’apparecchio nella rete. | | | idcard | W | R | R/W | - | **Identification Card**\\ ( 1 ÷ 255 for slave)\\ In slave mode is the number that identifies the device on the network. | |
| | brate | L | R | R/W | - | **Baud rate**\\ Baud rate della seriale.\\ Valori validi: 4800, 9600, 19200, 38400, 57600, 115200. | | | brate | L | R | R/W | - | **Baud rate**\\ Baud rate of the serial.\\ Valid values: 4800, 9600, 19200, 38400, 57600, 115200. | |
| | stopb | B | R | R/W | - | **Stop bit**\\ Valori validi: 1, 2. | | | stopb | B | R | R/W | - | **Stop bit**\\ Valid values: 1, 2. | |
| | par | B | R | R/W | - | **Parity**\\ (0 ÷ 2)\\ **0** = none,\\ **1** = even,\\ **2** = odd. | | | par | B | R | R/W | - | **Parity**\\ (0 ÷ 2)\\ **0** = none,\\ **1** = even,\\ **2** = odd. | |
| | rdelay | W | R | R/W | - | **Reply delay**\\ (0 ÷ 9999 msec)\\ E' il tempo di attesa prima di trasmettere la risposta. | | | rdelay | W | R | R/W | - | **Reply delay**\\ (0 ÷ 9999 msec)\\ It is the time to wait before transmitting the reply. | |
| | iword1÷32 | W | 0 | R | - | **Input Word nr.** (1Input Long nr. (1÷16)32) | | | iword1÷32 | W | 0 | R | - | **Input Word nr.** (1Input Long nr. (1÷16)32) | |
| | st_ibit0÷15 | F | 0 | R | - | **Input bit nel parametro iword1** | | | st_ibit0÷15 | F | 0 | R | - | **Input bit in the iword1 parameter** | |
| | ilong1÷16 | L | 0 | R | - | **Input Long nr.** (1÷16) | | | ilong1÷16 | L | 0 | R | - | **Input Long nr.** (1÷16) | |
| | oword1÷32 | W | 0 | R/W | - | **Output Word nr.** (1÷32) | | | oword1÷32 | W | 0 | R/W | - | **Output Word nr.** (1÷32) | |
| | st_obit0÷15 | F | 0 | R/W | - | **Output bit nel parametro oword1** | | | st_obit0÷15 | F | 0 | R/W | - | **Output bit in the oword1 parameter** | |
| | olong1÷16 | L | 0 | R/W | - | **Output Long nr.** (1÷16) | | | olong1÷16 | L | 0 | R/W | - | **Output Long nr.** (1÷16) | |
| |
| |
| |
| === - Variabili === | === - Variables === |
| ^Nome^D^R^A^Condizioni^ Descrizione^ | |
| |serr|B|0|R/W|-|**Serial Errors**\\ Indica se sono stati riscontrati errori nella comunicazione seriale.\\ Il parametro viene aggiornato ad ogni errore rilevato. Il valore permane fino ad un successivo errore o ad una scrittura sullo stesso con il QCL.\\ **0** = nessun errore,\\ **1** = parity error,\\ **2** = framing error,\\ **3** = overrun error.| | ^Name^D^R^A^Conditions^Description^ |
| | |serr|B|0|R/W|-|**Serial Errors**\\ Indicates if errors occurred in serial communication.\\ The parameter is updated for each error encountered. The value persists until a subsequent error or to a writing on the same with the QCL.\\ **0** = no errors,\\ **1** = parity error,\\ **2** = framing error,\\ **3** = overrun error.| |
| | |
| | === - States === |
| | |
| | ^Name^D^R^A^Conditions^Description^ |
| | |st_msgrx|F|0|R|-|**Message received**\\ State used only in slave mode. Indicates that a message from the master has executed a write in the QCL data exchange area. The state is reset with the RECEIVED command.| |
| | |st_opencom|F|0|R|-|**Open communication port**\\ Activation indicates that the device is working with the serial communications port. To set this state use the OPENCOM command, for reset use CLOSECOM.| |
| | |wdata|F|0|R|-|**Warning Data**\\ This bit indicates that an attempt was made to insert an invalid value in a parameter.| |
| | |wcmd|F|0|R|-|**Warning Command**\\ This bit indicates that it did not execute a command because they lack the necessary conditions.| |
| | |
| | === - Commands === |
| |
| === - Stati === | The available commands to manage the device are listed below in descending order of priority.\\ |
| ^Nome^D^R^A^Condizioni^ Descrizione^ | The device executes all commands received within the same sampling time starting from the one with the highest priority.\\ |
| |st_msgrx|F|0|R||-|**Message received**\\ Stato utilizzato solo in modalitá slave. Indica che un messagio del master ha eseguito una scrittura nell’area scambio dati QCL. Lo stato viene resettato con il comando RECEIVED.| | For example if the device receives the same sampling time CLOSECOM and OPENCOM commands, first run the OPENCOM command and than to CLOSECOM leaving therefore the communication port closed. |
| |st_opencom|F|0|R|-|**Open communication port**\\ L'attivazione indica che il device sta impegnando la porta di comunicazione seriale. Per settare questo stato usare il comando OPENCOM, per resettarlo CLOSECOM.| | |
| |wdata|F|0|R|-|**Warning Data**\\ Questo bit segnala che è stato tentato un inserimento di un valore non valido in un parametro.| | |
| |wcmd|F|0|R|-|**Warning Command**\\ Questo bit segnala che è non è stato eseguito un comando perchè mancano le condizioni necessarie.| | |
| |
| === - Comandi === | ^ Name ^ D ^ R ^ A ^ Conditions ^ Description ^ |
| I comandi a disposizione per gestire il device sono elencati sotto in ordine di priorità decrescente.\\ | | RECEIVED | - | - | - | st_msgrx = 1\\ mode = 1, 2\\ st_opencom = 1 | **Received**\\ Used only in slave mode. Indicates that the QCL application has processed the information that the master has sent | |
| Il device esegue tutti i comandi ricevuti entro lo stesso tempo di campionamento iniziando da quello con la priorità maggiore.\\ | | VALIDATE | - | - | - | mode = 1, 2\\ st_opencom = 1 | **Validate**\\ Indicates that the parameters of the QCL data exchange becomes available to the master. | |
| Per esempio se il device riceve nello stesso tempo di campionamento i comandi CLOSECOM e OPENCOM, per primo esegue il comando OPENCOM e poi quello di CLOSECOM lasciando perciò la porta di comunicazione chiusa. | | CLRWDATA | - | - | - | - | **Clear Warning Data**\\ Reset the wdata parameter reporting | |
| ^ Nome ^ D ^ R ^ A ^ Condizioni ^ Descrizione ^ | | CLRWCMD | - | - | - | - | **Clear Warning Command**\\ Reset the wcmd parameter reporting | |
| | RECEIVED | - | - | - | st_msgrx = 1\\ mode = 1, 2\\ st_opencom = 1 | **Received**\\ Utilizzato solamente in modalitá slave. Indica che l’applicativo QCL ha processato le informazioni che il master ha inviato | | | OPENCOM | - | - | - | st_opencom = 0 | **Open Serial communication**\\ Open the serial communication (the device then committed the communications port). The //st_opencom// state changes to 1. | |
| | VALIDATE | - | - | - | mode = 1, 2\\ st_opencom = 1 | **Validate**\\ Indica che i parametri di scambio dati QCL diventano disponibili al master. | | | CLOSECOM | - | - | - | - | **Close Serial communication**\\ Closes the serial communication (the device then does not commit more the communications port). The //st_opencom// state changes to 0. | |
| | CLRWDATA | - | - | - | - | **Clear Warning Data**\\ Azzera la segnalazione del parametro wdata | | |
| | CLRWCMD | - | - | - | - | **Clear Warning Command**\\ Azzera la segnalazione del parametro wcmd | | |
| | OPENCOM | - | - | - | st_opencom = 0 | **Open Serial communication**\\ Apre la comunicazione seriale (il device quindi impegna la porta di comunicazione). Lo stato //st_opencom// diventa 1. | | |
| | CLOSECOM | - | - | - | - | **Close Serial communication**\\ Chiude la comunicazione seriale (il device quindi non impegna piú la porta di comunicazione). Lo stato //st_opencom// diventa 0. | | |
| |
| |