# Modbus vers MQTT

> PLCGateway interroge les équipements Modbus TCP et RTU – compteurs d'énergie, variateurs, automates, capteurs – et publie leurs registres et coils vers un broker MQTT sous forme de valeurs nommées et mises à l'échelle.

Les équipements Modbus ne répondent que lorsqu'on les interroge, et ils renvoient le contenu brut des registres. Une plateforme IoT attend l'inverse : des valeurs nommées qui arrivent d'elles-mêmes. PLCGateway scrute les registres, assemble les valeurs 32 et 64 bits dans le bon ordre des mots, applique la mise à l'échelle et publie chaque tag lorsqu'il change.

Modbus TCP, RTU sur TCP et RTU sur liaison série (RS-485 / RS-232) sont pris en charge dans la même installation : un compteur d'énergie série et un automate Ethernet aboutissent sur le même broker. Les registres consécutifs sont lus en une seule requête.

- **Source:** [Modbus TCP / RTU](https://plcgateway.com/fr/protocols/modbus.md) (`modbus_tcp`, `modbus_rtu_tcp`, `modbus_rtu`)
- **Connexion:** TCP 502 · RTU over TCP · RS-485 / RS-232
- **Cible:** [MQTT](https://plcgateway.com/fr/integrations.md)
- **Écriture:** oui
- **Inclus dans:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Mise en place en cinq étapes

1. Ajoutez un appareil, choisissez Modbus TCP, RTU sur TCP ou RTU série, puis saisissez l'adresse IP ou le port série avec la vitesse et la parité.
2. Réglez l'unit id et, pour les valeurs 32 bits, l'ordre des mots de l'équipement.
3. Créez les tags avec leurs adresses et types de données, ou importez une liste de registres depuis un fichier CSV ; testez la connexion pour voir les premières valeurs.
4. Ouvrez Gateway → MQTT, saisissez l'adresse, le port et les identifiants du broker, activez TLS si le broker l'exige et choisissez le topic de base.
5. Choisissez la publication sur changement ou à intervalle et le format JSON ou valeur brute, puis vérifiez les topics avec mosquitto_sub ou dans votre plateforme.

## Exemple : topics et payloads

Un appareil d'id meter1 avec ces tags est publié comme ci-dessous ; les lignes correspondent à ce qu'affiche mosquitto_sub -v. Noms et valeurs donnés à titre d'exemple.

| Tag | Adresse | Valeur d'exemple |
|---|---|---|
| `ActivePower` | `HR100` | 42.75 kW |
| `Energy` | `HR200` | 128450.5 kWh |
| `PumpRunning` | `C12` | true |

**Topics et payloads 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 de base / id de l'appareil / nom du tag. Le payload JSON contient la valeur (v), la qualité (q), l'horodatage en millisecondes (t) et l'unité (u).

## La publication MQTT de PLCGateway

PLCGateway publie chaque tag vers votre broker MQTT (Mosquitto, EMQX, HiveMQ, AWS IoT Core ou une plateforme cloud via un pont) : les systèmes informatiques s'abonnent à des topics au lieu de scruter l'automate. Il parle MQTT 3.1.1 sur TCP ou TLS, avec nom d'utilisateur et mot de passe.

Les valeurs sont envoyées sur changement ou à intervalle fixe, en JSON avec qualité et horodatage ou sous forme de valeur brute. Un topic d'état retenu avec un message last will indique aux abonnés si la passerelle est en ligne.

- Un topic par tag : topic de base / appareil / tag, avec le topic de base de votre choix
- QoS 0 ou 1, messages retenus, message birth et last will
- Écriture optionnelle : une valeur publiée sur le topic /set du tag est écrite dans l'automate
- Les messages sont mis en file d'attente tant que le broker est injoignable, puis envoyés après la reconnexion

![Paramètres de la publication MQTT : broker, TLS, topic de base, mode de publication et format du payload](https://plcgateway.com/assets/img/shots/mqtt-1400.webp)

## Automates et équipements

- [Modbus TCP / RTU](https://plcgateway.com/fr/protocols/modbus.md)
- [Schneider Electric Modicon](https://plcgateway.com/fr/controllers/schneider-electric.md)
- [Automates basés sur CODESYS](https://plcgateway.com/fr/controllers/codesys-plcs.md)
- [Gestion technique du bâtiment et compteurs d'énergie](https://plcgateway.com/fr/controllers/building-automation.md)

## Questions et réponses

### Cela fonctionne-t-il avec Modbus RTU sur RS-485 ?

Oui. Utilisez un port série ou un adaptateur USB de l'ordinateur, ou un convertisseur Ethernet-série avec RTU sur TCP. Vitesse, parité et unit id se règlent par appareil.

### Comment les flottants 32 bits sont-ils traités ?

Le type de données du tag définit la largeur, et l'ordre des mots (ABCD, CDAB, BADC, DCBA) se choisit par appareil ou par tag : la valeur publiée est le nombre réel, pas deux registres bruts.

### Puis-je écrire un registre via MQTT ?

Oui, si l'écriture est activée : une valeur envoyée sur le topic /set du tag est écrite dans le holding register ou le coil.

## Solutions associées

- [Modbus vers OPC UA](https://plcgateway.com/fr/solutions/modbus-to-opc-ua.md)
- [Siemens S7 vers MQTT](https://plcgateway.com/fr/solutions/siemens-s7-to-mqtt.md)
- [FANUC FOCAS vers MQTT](https://plcgateway.com/fr/solutions/fanuc-focas-to-mqtt.md)
- [CNC Haas vers MQTT](https://plcgateway.com/fr/solutions/haas-to-mqtt.md)
- [MTConnect vers MQTT](https://plcgateway.com/fr/solutions/mtconnect-to-mqtt.md)
- [Allen-Bradley EtherNet/IP vers MQTT](https://plcgateway.com/fr/solutions/ethernet-ip-to-mqtt.md)
- [Tous les protocoles](https://plcgateway.com/fr/protocols.md)

_Les noms de produits et de modèles sont des marques de leurs propriétaires respectifs. Ils sont cités uniquement pour indiquer avec quels équipements les pilotes communiquent ; PLCGateway n'est pas affilié à ces sociétés._

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