# Da MTConnect a MQTT

> PLCGateway legge i data item di qualsiasi agent MTConnect e pubblica stato di esecuzione, conteggio pezzi, posizioni e condition come topic MQTT – un topic per data item, inviato quando il valore cambia.

MTConnect fornisce i dati macchina come documenti XML che un client deve richiedere ed elaborare. Broker e piattaforme IoT funzionano al contrario: si aspettano piccoli messaggi inviati attivamente sui topic. PLCGateway richiede ciclicamente all'agent il documento current, estrae i data item selezionati e pubblica ciascuno quando cambia.

I data item si sfogliano dal documento probe dell'agent e si aggiungono come tag, quindi non servono elaborazioni XML né file di mappatura. I sample arrivano come numeri, gli event come testo o BOOL e le condition come Normal, Warning o Fault.

- **Sorgente:** [MTConnect](https://plcgateway.com/it/protocols/mtconnect.md) (`mtconnect`)
- **Collegamento:** HTTP · MTConnect agent (e.g. port 5000)
- **Destinazione:** [MQTT](https://plcgateway.com/it/integrations.md)
- **Scrittura:** solo lettura
- **Incluso in:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Configurazione in cinque passi

1. Verifica che l'agent MTConnect della macchina sia raggiungibile (ad esempio http://machine:5000).
2. Aggiungi un dispositivo MTConnect con l'URL dell'agent e, se necessario, il nome del dispositivo.
3. Sfoglia i data item e aggiungi come tag quelli che ti servono.
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 mazak1 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 |
|---|---|---|
| `Availability` | `avail` | AVAILABLE |
| `Execution` | `execution` | ACTIVE |
| `PartCount` | `PartCountAct` | 128 |
| `XPosition` | `Xact` | 124.375 mm |

**Topic e payload 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 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

- [MTConnect](https://plcgateway.com/it/protocols/mtconnect.md)
- [Macchine CNC con MTConnect](https://plcgateway.com/it/controllers/mtconnect-machines.md)
- [Haas Automation](https://plcgateway.com/it/controllers/haas.md)

## Domande e risposte

### Quali macchine copre?

Qualsiasi macchina con un agent MTConnect, ad esempio Mazak, Okuma, DMG MORI, Hurco e Haas NGC, e i controlli collegati tramite un adapter MTConnect.

### Cosa succede quando un valore è UNAVAILABLE?

Il tag mantiene il proprio topic e la qualità nel payload passa a UNCERTAIN, così i sottoscrittori distinguono un valore mancante da uno reale.

### I messaggi MQTT possono comandare la macchina?

No. MTConnect è uno standard in sola lettura, quindi non c'è nulla da scrivere. Per scrivere usa l'interfaccia propria del controllo, come le variabili macro FOCAS o i comandi Q Haas.

## Soluzioni correlate

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