Il protocollo Modbus permette lo scambio di dati tra dispositivi di automazione utilizzando una comunicazione seriale oppure Ethernet. Attraverso gli oggetti Gateway Modbus e Gateway Modbus Slave, il server Thinknx può leggere e scrivere valori Modbus, renderli disponibili alla supervisione e scambiarli con il sistema KNX.
Questa guida descrive:
In una comunicazione Modbus, il Master avvia le richieste, mentre lo Slave risponde alle operazioni di lettura o scrittura ricevute. Uno Slave non avvia autonomamente una comunicazione verso il Master o verso altri Slave.
Quando viene utilizzato l'oggetto Gateway Modbus, il server Thinknx opera come Master e interroga uno o più dispositivi Slave. Può quindi leggere ciclicamente i loro dati oppure inviare comandi di scrittura.
Quando viene utilizzato l'oggetto Gateway Modbus Slave, il server Thinknx espone i propri Datapoint a un Master esterno, che potrà leggerli o scriverli secondo la configurazione effettuata.
Nelle implementazioni Modbus TCP vengono utilizzati anche i termini Client e Server. Dal punto di vista della comunicazione, il Client invia la richiesta e il Server risponde. Nella terminologia utilizzata dal Configurator, il Gateway Modbus Master svolge normalmente il ruolo di Client, mentre il dispositivo Slave svolge il ruolo di Server.
I dati Modbus sono organizzati in quattro aree principali.
| Area dati | Dimensione | Accesso standard | Funzioni di lettura | Funzioni di scrittura |
|---|---|---|---|---|
| Coil | 1 bit | Lettura e scrittura | 1 | 5 oppure 15 |
| Discrete Input | 1 bit | Sola lettura | 2 | — |
| Input Register | 16 bit | Sola lettura | 4 | — |
| Holding Register | 16 bit | Lettura e scrittura | 3 | 6, 16 oppure 22 |
Il tipo di area non viene determinato solamente dal numero visualizzato nel manuale del dispositivo. È la Function Modbus utilizzata a indicare se il server deve accedere, ad esempio, a una Coil oppure a un Holding Register.
Le principali funzioni utilizzabili nella configurazione sono riepilogate nella tabella seguente.
| Function | Nome | Utilizzo |
|---|---|---|
| 1 | Read Coils | Legge lo stato di una o più Coil. |
| 2 | Read Discrete Inputs | Legge uno o più ingressi digitali. |
| 3 | Read Holding Registers | Legge uno o più Holding Register. |
| 4 | Read Input Registers | Legge uno o più Input Register. |
| 5 | Write Single Coil | Scrive lo stato di una singola Coil. |
| 6 | Write Single Holding Register | Scrive un singolo Holding Register. |
| 15 | Write Multiple Coils | Scrive più Coil consecutive. |
| 16 | Write Multiple Holding Registers | Scrive più Holding Register consecutivi. |
| 22 | Mask Write Register | Modifica bit selezionati all'interno di un Holding Register. |
La funzione deve essere supportata dal dispositivo e deve corrispondere all'area dati indicata nella relativa documentazione Modbus.
I manuali dei dispositivi non utilizzano sempre lo stesso sistema di indirizzamento. Alcuni mostrano i registri partendo da 1, mentre altri riportano direttamente l'indirizzo di protocollo partendo da 0.
Il server Thinknx applica automaticamente un offset di -1 all'indirizzo inserito nel Configurator.
Indirizzo trasmesso = Indirizzo inserito nel Configurator - 1
| Indirizzo inserito nel Configurator | Indirizzo trasmesso dal server |
|---|---|
| 1 | 0 |
| 10 | 9 |
| 100 | 99 |
Se il manuale utilizza una numerazione dei registri che parte da 1, normalmente il relativo numero deve essere inserito direttamente nel Configurator. Il server applicherà poi automaticamente l'offset.
Se il manuale riporta già l'indirizzo di protocollo partendo da 0, nel Configurator deve essere inserito il valore aumentato di 1. Ad esempio, per trasmettere l'indirizzo di protocollo 0 deve essere configurato l'indirizzo 1.
Le notazioni tradizionali 00001, 10001, 30001 e 40001 identificano anche l'area dati:
| Notazione tradizionale | Area dati | Primo indirizzo di protocollo |
|---|---|---|
| 00001 | Coil | 0 |
| 10001 | Discrete Input | 0 |
| 30001 | Input Register | 0 |
| 40001 | Holding Register | 0 |
Ad esempio, la notazione 40001 indica normalmente il primo Holding Register. Nel Datapoint Thinknx deve quindi essere selezionata la Function relativa agli Holding Register e deve essere configurato l'indirizzo numerico richiesto dal Configurator, senza utilizzare automaticamente l'intero valore 40001.
In questo caso, una configurazione tipica è:
| Indicazione nel manuale | Indirizzo del dato nel Configurator | Indirizzo trasmesso |
|---|---|---|
| Holding Register 40001 | 1 | 0 |
Attenzione: prima di configurare tutti i Datapoint, verificare sempre la convenzione utilizzata dal produttore provando a leggere un singolo valore noto. Applicare manualmente un ulteriore -1 quando il server lo applica già porta alla lettura del registro precedente.
Alcuni manuali Modbus riportano l'indirizzo dei Datapoint in formato esadecimale, normalmente identificato dal prefisso 0x. Prima di inserirlo nel Configurator, l'indirizzo deve essere convertito nel corrispondente valore decimale.
La conversione può essere eseguita, ad esempio, tramite la Calcolatrice di Windows in modalità Programmatore:
0x;Ad esempio:
0x0010 = 16
La conversione da esadecimale a decimale non modifica la regola dell'offset Thinknx. Se 0x0010 rappresenta già l'indirizzo di protocollo, il valore decimale è 16 e nel Configurator deve essere inserito 17, in modo che il server trasmetta l'indirizzo 16.
| Indicazione nel manuale | Valore decimale | Indirizzo del dato nel Configurator | Indirizzo trasmesso dal server |
|---|---|---|---|
| 0x0010 | 16 | 17 | 16 (0x0010) |
Attenzione: la notazione esadecimale indica solamente la base numerica. Non permette di stabilire se il produttore utilizza una numerazione da 0 oppure da 1. Questa informazione deve essere verificata nel manuale del dispositivo o tramite una lettura di prova.
Prima di configurare il Gateway Modbus, recuperare il manuale o la tabella Modbus del dispositivo e identificare:
Verificare inoltre che sul server siano disponibili la porta di comunicazione necessaria e, quando prevista per il modello utilizzato, la relativa licenza Modbus.
È consigliabile verificare questi dati con un programma Modbus esterno prima di configurare l'intera integrazione in Thinknx.
L'oggetto Gateway Modbus consente al server Thinknx di operare come Modbus Master. Il server interroga ciclicamente i dispositivi configurati e può scrivere i valori mediante i Datapoint, il gateway KNX oppure i comandi dell'oggetto.
Per aggiungere il gateway, accedere alla sezione Sistema del progetto, fare clic con il tasto destro sul nodo principale e aggiungere l'oggetto Gateway Modbus dalla categoria dedicata ai gateway.
La proprietà Tipo comunicazione definisce il metodo utilizzato dal server.
Questa modalità viene utilizzata per collegare direttamente il server a un bus seriale, normalmente tramite RS485.
Tutti i dispositivi presenti sullo stesso bus seriale devono utilizzare parametri di comunicazione compatibili e devono avere un indirizzo Slave univoco.
Questa modalità viene utilizzata quando il bus seriale viene raggiunto attraverso un convertitore Ethernet/seriale. Il convertitore trasporta sulla rete la comunicazione seriale senza trasformarla in comunicazione Modbus TCP nativa.
La porta utilizzata deve corrispondere a quella configurata nel convertitore. Non deve essere necessariamente la porta standard 502.
Questa modalità viene utilizzata per comunicare direttamente con un dispositivo Modbus TCP.
Modbus Seriale su TCP e Modbus TCP non sono equivalenti. La modalità deve essere scelta in base al protocollo realmente supportato dal dispositivo o dal convertitore.
Un Intervallo lettura molto breve aumenta il traffico e può provocare timeout o instabilità, soprattutto su bus seriali con molti dispositivi. Iniziare con pochi Datapoint e con un intervallo prudente, quindi ridurlo solamente dopo avere verificato la stabilità della comunicazione.
Assegnare nomi descrittivi, ad esempio Temperatura mandata, Allarme pompa oppure Setpoint zona 1, così da riconoscere facilmente i Datapoint quando vengono selezionati da altri oggetti.
Un Input Register, ad esempio, viene normalmente letto con Function 4 e non può essere scritto. Un Holding Register viene normalmente letto con Function 3 e può essere scritto con una funzione supportata dal dispositivo, come Function 6 o Function 16.
Ad esempio, se il dispositivo restituisce il valore 235 per rappresentare 23,5 °C, deve essere utilizzato un fattore di conversione pari a 0,1.
Prima di applicare il fattore di conversione, verificare che il valore grezzo e il segno siano interpretati correttamente. Un tipo di dato errato può produrre valori apparentemente casuali o molto lontani da quelli attesi.
La proprietà Riusa permette di riutilizzare una lettura già eseguita quando più Datapoint estraggono bit differenti dallo stesso indirizzo.
Ad esempio, se un Holding Register contiene sedici stati digitali, è possibile creare più Datapoint con gli stessi valori di Indirizzo periferica e Indirizzo del dato, modificando solamente Numero del bit:
Il driver legge il registro una sola volta e utilizza il valore ricevuto per estrarre i diversi bit. Questo riduce il numero di richieste inviate allo Slave e migliora la velocità del polling.
Quando Force rewrite è abilitato, il server riscrive ciclicamente l'ultimo valore inviato al Datapoint. La frequenza è definita dalla proprietà generale Intervallo di riscrittura del Gateway Modbus.
Questa funzione deve essere utilizzata solamente quando il dispositivo richiede un aggiornamento periodico del comando. Non abilitarla indiscriminatamente, perché aumenta il traffico e il numero di scritture inviate.
Abilitando Gateway KNX, il Datapoint può scambiare il valore con il bus KNX.
Il flusso standard è il seguente:
Dispositivo Modbus → Gateway Modbus → Gruppo KNX di feedback
Abilitando la comunicazione bidirezionale viene aggiunto il flusso opposto:
Gruppo KNX di comando → Gateway Modbus → Dispositivo Modbus
Verificare che il Tipo di dato KNX sia compatibile con il valore Modbus e con l'eventuale Fattore di conversione.
I comandi dell'oggetto consentono di eseguire scritture Modbus richiamabili da scene, logiche, pulsanti o altri oggetti Thinknx.
Scrive lo stato di una singola Coil.
Nel Configurator il comando è denominato Invia valore Modbus con la funzione 5 e utilizza i seguenti parametri:
Il dispositivo deve supportare la Function 5 sull'indirizzo selezionato.
Scrive un singolo Holding Register.
Nel Configurator il comando è denominato Invia valore Modbus con la funzione 6 e utilizza i seguenti parametri:
A livello Modbus, la Function 6 opera su un singolo registro da 16 bit. Nonostante il parametro sia denominato Indirizzo del coil nel Configurator, per questa funzione identifica l'indirizzo dell'Holding Register da scrivere. Verificare nel manuale del dispositivo il formato e l'intervallo del valore accettato.
La Function 15, conosciuta anche come Write Multiple Coils, permette di scrivere contemporaneamente lo stato di più Coil Modbus consecutive.
Attenzione: per richiamare la Function 15 dalla supervisione, utilizzare un comando generico associato al comando Invia Modbus Word con funzione 15. Non utilizzare un oggetto Lampadina, poiché la Function 15 deve ricevere tutti i parametri necessari per scrivere più Coil consecutive e non gestisce un semplice comando ON/OFF su una singola Coil.
Ogni Coil rappresenta un singolo bit:
Le Coil vengono scritte a partire dall'indirizzo specificato in Indirizzo del primo registro. Il software utilizza un unico valore decimale per definire lo stato delle Coil e lo converte internamente in binario. Il bit meno significativo corrisponde alla prima Coil, il bit successivo alla seconda e così via.
Per impostare su ON le prime 10 Coil:
1111111111 = 1023
Per impostare su ON le prime 20 Coil:
11111111111111111111 = 1048575
In generale, per impostare su ON le prime N Coil consecutive:
Valore = 2ᴺ - 1
| Numero di Coil | Valore decimale |
|---|---|
| 8 | 255 |
| 10 | 1023 |
| 16 | 65535 |
| 20 | 1048575 |
È possibile controllare anche Coil singole impostando solamente i bit corrispondenti. Ad esempio:
00000101 = 5
Il valore 5 imposta su ON la prima e la terza Coil, lasciando le altre su OFF.
Parametri del comando:
Scrive uno o più Holding Register consecutivi.
Nel Configurator il comando è denominato Invia valore Modbus con la funzione 16 e utilizza i seguenti parametri:
La dimensione configurata deve essere coerente con il numero di registri e con il tipo di valore richiesto dal dispositivo.
La Function 22 permette di modificare bit selezionati all'interno di un Holding Register senza gestire il registro come un semplice comando di scrittura completa.
Nel Configurator il comando è denominato Invia Modbus Word con funzione 22 e utilizza i seguenti parametri:
Il significato della maschera e il risultato atteso devono essere verificati inizialmente su un registro di prova o tramite un simulatore Modbus.
Gli esempi seguenti utilizzano valori dimostrativi. Prima di applicarli a un dispositivo reale, sostituire tutti i parametri con quelli indicati nel relativo manuale Modbus.
Si desidera leggere una temperatura da un dispositivo con le seguenti caratteristiche:
Configurazione del gateway:
| Proprietà | Valore |
|---|---|
| Tipo comunicazione | Modbus Seriale |
| Numero porta | Porta seriale utilizzata dal server |
| Baud Rate | 9600 |
| Data Bits | 8 |
| Parità | None |
| Stop Bits | 1 |
Configurazione del Datapoint:
| Proprietà | Valore |
|---|---|
| Nome | Temperatura dispositivo |
| Indirizzo periferica | 1 |
| Indirizzo del dato | 10 |
| Indirizzo trasmesso dal server | 0 |
| Tipo di dato | Tipo unsigned a 16 bit corrispondente |
| Funzione Lettura | Function 3 |
| Fattore di conversione | 0.1 |
Il valore atteso all'interno di Thinknx è 23,5.
Il manuale indica esplicitamente Protocol Address 25. Poiché si tratta già dell'indirizzo trasmesso sul protocollo, nel Configurator deve essere inserito 26.
| Valore | Indirizzo |
|---|---|
| Indirizzo indicato dal manuale | 25 |
| Indirizzo del dato nel Configurator | 26 |
| Indirizzo trasmesso dal server | 25 |
Un Holding Register contiene diversi stati di allarme, uno per ciascun bit.
Creare più Datapoint con gli stessi valori di Indirizzo periferica, Indirizzo del dato, Tipo di dato e Funzione Lettura. Configurare un Numero del bit differente per ogni allarme.
Nel primo Datapoint lasciare Riusa disabilitato. Nei successivi abilitare Riusa, in modo che il server esegua una sola lettura del registro e riutilizzi il valore ricevuto.
Per inviare una temperatura letta da Modbus sul bus KNX:
Per consentire anche la scrittura da KNX verso Modbus:
Si desidera leggere l'Holding Register 10 di un dispositivo Modbus TCP con indirizzo IP 192.168.1.50, porta 502 e Unit ID 1.
Configurazione del gateway:
| Proprietà | Valore |
|---|---|
| Tipo comunicazione | Modbus TCP |
| Indirizzo IP | 192.168.1.50 |
| Porta IP | 502 |
Configurazione del Datapoint:
| Proprietà | Valore |
|---|---|
| Indirizzo periferica | 1 |
| Indirizzo del dato | 10 |
| Indirizzo trasmesso dal server | 9 |
| Funzione Lettura | Function 3 |
Dopo il caricamento del progetto, verificare che il server apra la connessione TCP e riceva una risposta valida dal dispositivo prima di aggiungere altri Datapoint.
L'oggetto Gateway Modbus Slave permette al server Thinknx di esporre Datapoint a un Master esterno. Il Master può leggere o scrivere i valori disponibili secondo le funzioni e gli indirizzi configurati.
La proprietà Tipo comunicazione definisce il metodo di comunicazione.
Per Modbus Seriale sono disponibili:
Per Modbus Seriale su TCP oppure Modbus TCP, la proprietà Porta IP definisce la porta sulla quale il Gateway Modbus Slave rimane in ascolto. Non viene richiesto un indirizzo IP remoto, poiché il server Thinknx opera come Slave e attende la connessione del Master.
Ulteriori proprietà:
Per ciascun Datapoint sono disponibili:
Per rendere disponibile a un sistema esterno una temperatura presente sul bus KNX:
La verifica deve essere eseguita inizialmente con un solo dispositivo e un solo Datapoint. Dopo avere confermato la comunicazione, è possibile aggiungere gli altri valori.
Modbus Poll può essere utilizzato come Master esterno per verificare un dispositivo Slave indipendentemente da Thinknx.
Procedura consigliata:
Se Modbus Poll non comunica con il dispositivo, il problema deve essere risolto prima di procedere con la configurazione Thinknx.
Modbus Slave può essere utilizzato per simulare il dispositivo e osservare le richieste inviate dal server Thinknx quando opera come Master.
Questa prova permette di controllare:
Per una prova Modbus TCP, configurare nel Gateway Modbus l'indirizzo IP del PC sul quale è in esecuzione il simulatore. Verificare che firewall e porta TCP consentano la connessione.
Gli strumenti Modbus Poll e Modbus Slave sono disponibili sul sito Modbus Tools.
Wireshark permette di acquisire il traffico Modbus TCP e analizzare le richieste e le risposte scambiate sulla rete.
Filtri utili:
mbtcp modbus tcp.port == 502 ip.addr == 192.168.1.100
Sostituire l'indirizzo IP dell'esempio con quello del dispositivo. La cattura permette di controllare apertura della connessione TCP, Function Code, indirizzi, quantità richieste, dati ed eventuali risposte di errore.
Wireshark non consente di intercettare direttamente un bus Modbus RTU attraverso una normale scheda di rete. Per il traffico seriale sono necessari un'interfaccia e un metodo di acquisizione adatti al bus utilizzato.
Controllare:
Prima di modificare il progetto Thinknx, verificare il dispositivo con Modbus Poll o uno strumento equivalente.
Le risposte di eccezione più comuni sono:
| Codice | Significato | Verifica principale |
|---|---|---|
| 01 | Illegal Function | La funzione non è supportata dal dispositivo. |
| 02 | Illegal Data Address | L'indirizzo o l'intervallo richiesto non è disponibile. |
| 03 | Illegal Data Value | Il valore o la quantità richiesta non è valida. |
| 04 | Server Device Failure | Il dispositivo non è riuscito a completare l'operazione. |
Consultare sempre il manuale del dispositivo, perché il produttore può prevedere condizioni aggiuntive.