# Da Modbus a MQTT

> PLCGateway interroga dispositivi Modbus TCP e RTU – contatori di energia, azionamenti, PLC, sensori – e pubblica i loro registri e coil su un broker MQTT come valori scalati e con un nome.

I dispositivi Modbus rispondono solo quando vengono interrogati, e ciò che restituiscono è il contenuto grezzo dei registri. Una piattaforma IoT vuole l'opposto: valori con un nome che arrivano da soli. PLCGateway interroga i registri, compone i valori a 32 e 64 bit con il giusto ordine delle word, applica la scalatura e pubblica ogni tag quando cambia.

Modbus TCP, RTU over TCP e RTU su linea seriale (RS-485 / RS-232) sono supportati nella stessa installazione, così un contatore di energia seriale e un PLC Ethernet finiscono sullo stesso broker. I registri consecutivi vengono letti con un'unica richiesta.

- **Sorgente:** [Modbus TCP / RTU](https://plcgateway.com/it/protocols/modbus.md) (`modbus_tcp`, `modbus_rtu_tcp`, `modbus_rtu`)
- **Collegamento:** TCP 502 · RTU over TCP · RS-485 / RS-232
- **Destinazione:** [MQTT](https://plcgateway.com/it/integrations.md)
- **Scrittura:** sì
- **Incluso in:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Configurazione in cinque passi

1. Aggiungi un dispositivo, scegli Modbus TCP, RTU over TCP o RTU seriale e inserisci l'indirizzo IP oppure la porta seriale con baud rate e parità.
2. Imposta lo unit id e, per i valori a 32 bit, l'ordine delle word del dispositivo.
3. Crea i tag con indirizzi e tipi di dato, oppure importa un elenco di registri da CSV; testa il collegamento per vedere i primi valori.
4. Apri Gateway → MQTT, inserisci indirizzo, porta e credenziali del broker, attiva TLS se il broker lo richiede e scegli il topic di base.
5. Scegli la pubblicazione su variazione o a intervalli e il formato JSON o a valore semplice, poi verifica i topic con mosquitto_sub o nella tua piattaforma.

## Esempio: topic e payload

Un dispositivo con id meter1 e questi tag viene pubblicato come mostrato qui sotto; le righe sono ciò che stampa mosquitto_sub -v. Nomi e valori sono esempi.

| Tag | Indirizzo | Valore di esempio |
|---|---|---|
| `ActivePower` | `HR100` | 42.75 kW |
| `Energy` | `HR200` | 128450.5 kWh |
| `PumpRunning` | `C12` | true |

**Topic e payload MQTT**

```
plcgateway/status online
plcgateway/meter1/ActivePower {"q":"GOOD","t":1794465246839,"u":"kW","v":42.75}
plcgateway/meter1/Energy {"q":"GOOD","t":1794465246839,"u":"kWh","v":128450.5}
plcgateway/meter1/PumpRunning {"q":"GOOD","t":1794465246839,"v":true}
```

Topic: topic di base / id del dispositivo / nome del tag. Il payload JSON contiene il valore (v), la qualità (q), il timestamp in millisecondi (t) e l'unità (u).

## Il publisher MQTT di PLCGateway

PLCGateway pubblica ogni tag sul tuo broker MQTT – Mosquitto, EMQX, HiveMQ, AWS IoT Core o una piattaforma cloud dietro un bridge – così i sistemi IT sottoscrivono i topic invece di interrogare il controllore. Supporta MQTT 3.1.1 su TCP o TLS, con nome utente e password.

I valori vengono inviati quando cambiano oppure a intervalli fissi, in JSON con qualità e timestamp oppure come valore semplice. Un topic di stato retained con last will indica ai sottoscrittori se il gateway è online.

- Un topic per tag: topic di base / dispositivo / tag, con un topic di base a tua scelta
- QoS 0 o 1, messaggi retained, messaggio birth e last will
- Scrittura opzionale: un valore pubblicato sul topic /set del tag viene scritto nel controllore
- Se il broker non è raggiungibile, i messaggi vengono accodati e inviati dopo la riconnessione

![Impostazioni del publisher MQTT: broker, TLS, topic di base, modalità di pubblicazione e formato del payload](https://plcgateway.com/assets/img/shots/mqtt-1400.webp)

## Controllori e dispositivi

- [Modbus TCP / RTU](https://plcgateway.com/it/protocols/modbus.md)
- [Schneider Electric Modicon](https://plcgateway.com/it/controllers/schneider-electric.md)
- [Controllori basati su CODESYS](https://plcgateway.com/it/controllers/codesys-plcs.md)
- [Automazione degli edifici e contatori di energia](https://plcgateway.com/it/controllers/building-automation.md)

## Domande e risposte

### Funziona con Modbus RTU su RS-485?

Sì. Usa una porta seriale o un adattatore USB del computer, oppure un convertitore Ethernet-seriale con RTU over TCP. Baud rate, parità e unit id si impostano per dispositivo.

### Come vengono gestiti i float a 32 bit?

Il tipo di dato del tag definisce la larghezza, e l'ordine delle word (ABCD, CDAB, BADC, DCBA) si sceglie per dispositivo o per tag, così il valore pubblicato è il numero reale e non due registri grezzi.

### Posso scrivere un registro tramite MQTT?

Sì, se la scrittura è abilitata: un valore inviato sul topic /set del tag viene scritto nell'holding register o nel coil.

## Soluzioni correlate

- [Da Modbus a OPC UA](https://plcgateway.com/it/solutions/modbus-to-opc-ua.md)
- [Da Siemens S7 a MQTT](https://plcgateway.com/it/solutions/siemens-s7-to-mqtt.md)
- [Da FANUC FOCAS a MQTT](https://plcgateway.com/it/solutions/fanuc-focas-to-mqtt.md)
- [Da CNC Haas a MQTT](https://plcgateway.com/it/solutions/haas-to-mqtt.md)
- [Da MTConnect a MQTT](https://plcgateway.com/it/solutions/mtconnect-to-mqtt.md)
- [Da Allen-Bradley EtherNet/IP a MQTT](https://plcgateway.com/it/solutions/ethernet-ip-to-mqtt.md)
- [Tutti i protocolli](https://plcgateway.com/it/protocols.md)

_I nomi di prodotti e modelli sono marchi dei rispettivi proprietari. Sono citati solo per indicare con quali apparecchiature comunicano i driver; PLCGateway non è affiliata a queste aziende._

---
Source: https://plcgateway.com/it/solutions/modbus-to-mqtt
