# Beckhoff TwinCAT ADS vers MQTT

> PLCGateway lit les automates TwinCAT 2 et TwinCAT 3 via ADS, parcourt leurs symboles et publie les variables sélectionnées vers votre broker MQTT – sans code MQTT dans le projet automate.

TwinCAT peut publier en MQTT depuis l'automate grâce à une fonction IoT et à des blocs fonctionnels dans le projet. PLCGateway est la solution sans code automate : il se connecte via ADS, liste les symboles du projet en cours d'exécution et publie les variables que vous sélectionnez.

La passerelle trouve les systèmes TwinCAT du réseau, ajoute pour vous la route ADS sur l'automate et reprend les types de données de l'automate. Elle fonctionne sous Windows ou Linux, sur un PC ou un petit appareil du même réseau.

- **Source:** [Beckhoff TwinCAT ADS](https://plcgateway.com/fr/protocols/beckhoff-ads.md) (`ads`)
- **Connexion:** ADS / AMS · TCP 48898 · UDP 48899
- **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 avec le protocole Beckhoff TwinCAT (ADS) et cliquez sur « Rechercher les systèmes TwinCAT » ; la sélection de l'automate renseigne son adresse IP et son AMS NetId.
2. Cliquez sur « Ajouter la route sur l'automate » et saisissez l'utilisateur de l'automate (anciennes images Beckhoff : Administrator / 1). Cette étape n'est nécessaire qu'une fois.
3. Ouvrez le navigateur de symboles, sélectionnez des variables de programme et globales et ajoutez-les en une seule étape – les types de données viennent de l'automate.
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 cx1 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 |
|---|---|---|
| `LineSpeed` | `MAIN.Speed` | 12.5 m/min |
| `PumpRunning` | `GVL.Line1.Pump.Running` | true |
| `Setpoint` | `MAIN.Recipe[3]` | 75.5 °C |

**Topics et payloads MQTT**

```
plcgateway/status online
plcgateway/cx1/LineSpeed {"q":"GOOD","t":1794465246839,"u":"m/min","v":12.5}
plcgateway/cx1/PumpRunning {"q":"GOOD","t":1794465246839,"v":true}
plcgateway/cx1/Setpoint {"q":"GOOD","t":1794465246839,"u":"°C","v":75.5}
```

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

- [Beckhoff TwinCAT ADS](https://plcgateway.com/fr/protocols/beckhoff-ads.md)
- [Beckhoff TwinCAT](https://plcgateway.com/fr/controllers/beckhoff.md)

## Questions et réponses

### Faut-il TwinCAT ou un routeur ADS sur l'ordinateur passerelle ?

Non. PLCGateway implémente lui-même ADS et ne nécessite ni installation TwinCAT ni routeur. Il ajoute sa propre route sur l'automate avec l'utilisateur que vous saisissez une fois.

### Cela fonctionne-t-il avec TwinCAT 2 ?

Oui. TwinCAT 2 et TwinCAT 3 sur PC embarqués CX, PC industriels et Bus Terminal Controllers sont pris en charge, par nom de symbole ou par adresse mémoire et image process.

### Que se passe-t-il après un chargement ou une modification en ligne ?

PLCGateway détecte que la table des symboles a changé, se reconnecte et résout de nouveau les variables : les topics gardent leur nom et continuent avec les nouvelles valeurs.

## Solutions associées

- [Beckhoff TwinCAT ADS vers OPC UA](https://plcgateway.com/fr/solutions/beckhoff-ads-to-opc-ua.md)
- [Modbus vers MQTT](https://plcgateway.com/fr/solutions/modbus-to-mqtt.md)
- [Allen-Bradley EtherNet/IP vers MQTT](https://plcgateway.com/fr/solutions/ethernet-ip-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)
- [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/beckhoff-ads-to-mqtt
