# MTConnect vers MQTT

> PLCGateway lit les data items de tout agent MTConnect et publie état d'exécution, compteurs de pièces, positions et conditions en topics MQTT – un topic par data item, envoyé à chaque changement de valeur.

MTConnect fournit les données machine sous forme de documents XML qu'un client doit demander puis analyser. Les brokers et les plateformes IoT fonctionnent à l'inverse : ils attendent de petits messages poussés vers des topics. PLCGateway demande cycliquement le document current de l'agent, en extrait les data items sélectionnés et publie chacun d'eux lorsqu'il change.

Les data items sont parcourus dans le document probe de l'agent et ajoutés comme tags : aucun traitement XML ni fichier de correspondance n'est nécessaire. Les samples arrivent sous forme de nombres, les events sous forme de texte ou de BOOL, et les conditions sous la forme Normal, Warning ou Fault.

- **Source:** [MTConnect](https://plcgateway.com/fr/protocols/mtconnect.md) (`mtconnect`)
- **Connexion:** HTTP · MTConnect agent (e.g. port 5000)
- **Cible:** [MQTT](https://plcgateway.com/fr/integrations.md)
- **Écriture:** lecture seule
- **Inclus dans:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Mise en place en cinq étapes

1. Vérifiez que l'agent MTConnect de la machine est joignable (par exemple http://machine:5000).
2. Ajoutez un appareil MTConnect avec l'URL de l'agent et, si nécessaire, le nom de l'appareil.
3. Parcourez les data items et ajoutez comme tags ceux dont vous avez besoin.
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 mazak1 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 |
|---|---|---|
| `Availability` | `avail` | AVAILABLE |
| `Execution` | `execution` | ACTIVE |
| `PartCount` | `PartCountAct` | 128 |
| `XPosition` | `Xact` | 124.375 mm |

**Topics et payloads MQTT**

```
plcgateway/status online
plcgateway/mazak1/Availability {"q":"GOOD","t":1794465246839,"v":"AVAILABLE"}
plcgateway/mazak1/Execution {"q":"GOOD","t":1794465246839,"v":"ACTIVE"}
plcgateway/mazak1/PartCount {"q":"GOOD","t":1794465246839,"v":128}
plcgateway/mazak1/XPosition {"q":"GOOD","t":1794465246839,"u":"mm","v":124.375}
```

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

- [MTConnect](https://plcgateway.com/fr/protocols/mtconnect.md)
- [Machines CNC avec MTConnect](https://plcgateway.com/fr/controllers/mtconnect-machines.md)
- [Haas Automation](https://plcgateway.com/fr/controllers/haas.md)

## Questions et réponses

### Quelles machines sont concernées ?

Toute machine dotée d'un agent MTConnect, par exemple Mazak, Okuma, DMG MORI, Hurco et Haas NGC, ainsi que les commandes raccordées via un adaptateur MTConnect.

### Que se passe-t-il quand une valeur est UNAVAILABLE ?

Le tag conserve son topic et la qualité dans le payload passe à UNCERTAIN, de sorte que les abonnés distinguent une valeur manquante d'une valeur réelle.

### Les messages MQTT peuvent-ils piloter la machine ?

Non. MTConnect est un standard en lecture seule : il n'y a rien à écrire. Pour écrire, utilisez l'interface propre à la commande, comme les variables macro FOCAS ou les commandes Q Haas.

## Solutions associées

- [MTConnect vers OPC UA](https://plcgateway.com/fr/solutions/mtconnect-to-opc-ua.md)
- [OEE CNC avec MTConnect](https://plcgateway.com/fr/solutions/mtconnect-oee.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)
- [Siemens S7 vers MQTT](https://plcgateway.com/fr/solutions/siemens-s7-to-mqtt.md)
- [Modbus vers MQTT](https://plcgateway.com/fr/solutions/modbus-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/mtconnect-to-mqtt
