# MTConnect a MQTT

> PLCGateway lee los data items de cualquier agente MTConnect y publica el estado de ejecución, los recuentos de piezas, las posiciones y las conditions como topics MQTT: un topic por data item, enviado cuando cambia el valor.

MTConnect entrega los datos de la máquina como documentos XML que un cliente tiene que solicitar e interpretar. Los brokers y las plataformas IoT funcionan al revés: esperan mensajes pequeños enviados a topics. PLCGateway solicita de forma cíclica el documento current del agente, extrae los data items seleccionados y publica cada uno cuando cambia.

Los data items se exploran desde el documento probe del agente y se añaden como tags, por lo que no hace falta tratar XML ni archivos de mapeo. Los samples llegan como números, los events como texto o BOOL, y las conditions como Normal, Warning o Fault.

- **Origen:** [MTConnect](https://plcgateway.com/es/protocols/mtconnect.md) (`mtconnect`)
- **Conexión:** HTTP · MTConnect agent (e.g. port 5000)
- **Destino:** [MQTT](https://plcgateway.com/es/integrations.md)
- **Escritura:** solo lectura
- **Incluido en:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Configuración en cinco pasos

1. Compruebe que el agente MTConnect de la máquina es accesible (por ejemplo http://machine:5000).
2. Añada un dispositivo MTConnect con la URL del agente y, si es necesario, el nombre del dispositivo.
3. Explore los data items y añada como tags los que necesite.
4. Abra Gateway → MQTT, introduzca la dirección, el puerto y las credenciales del broker, active TLS si el broker lo exige y elija el topic base.
5. Elija la publicación por cambio o por intervalo y el formato JSON o valor simple, y compruebe los topics con mosquitto_sub o en su plataforma.

## Ejemplo: topics y payloads

Un dispositivo con el id mazak1 y estos tags se publica como se muestra a continuación; las líneas son lo que imprime mosquitto_sub -v. Los nombres y valores son ejemplos.

| Tag | Dirección | Valor de ejemplo |
|---|---|---|
| `Availability` | `avail` | AVAILABLE |
| `Execution` | `execution` | ACTIVE |
| `PartCount` | `PartCountAct` | 128 |
| `XPosition` | `Xact` | 124.375 mm |

**Topics y 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 base / id del dispositivo / nombre del tag. El payload JSON contiene el valor (v), la calidad (q), la marca de tiempo en milisegundos (t) y la unidad (u).

## El publicador MQTT de PLCGateway

PLCGateway publica cada tag en su broker MQTT – Mosquitto, EMQX, HiveMQ, AWS IoT Core o una plataforma en la nube detrás de un puente –, de modo que los sistemas IT se suscriben a topics en lugar de sondear el controlador. Habla MQTT 3.1.1 por TCP o TLS, con nombre de usuario y contraseña.

Los valores se envían cuando cambian o a intervalos fijos, como JSON con calidad y marca de tiempo o como valor simple. Un topic de estado retenido con last will indica a los suscriptores si la pasarela está en línea.

- Un topic por tag: topic base / dispositivo / tag, con el topic base que usted elija
- QoS 0 o 1, mensajes retenidos, mensaje birth y last will
- Escritura opcional: un valor publicado en el topic /set del tag se escribe en el controlador
- Los mensajes se ponen en cola mientras el broker no está accesible y se envían al reconectar

![Configuración del publicador MQTT: broker, TLS, topic base, modo de publicación y formato del payload](https://plcgateway.com/assets/img/shots/mqtt-1400.webp)

## Controladores y equipos

- [MTConnect](https://plcgateway.com/es/protocols/mtconnect.md)
- [Máquinas CNC con MTConnect](https://plcgateway.com/es/controllers/mtconnect-machines.md)
- [Haas Automation](https://plcgateway.com/es/controllers/haas.md)

## Preguntas y respuestas

### ¿Qué máquinas abarca?

Cualquier máquina con un agente MTConnect, por ejemplo Mazak, Okuma, DMG MORI, Hurco y Haas NGC, así como controles detrás de un adaptador MTConnect.

### ¿Qué ocurre cuando un valor es UNAVAILABLE?

El tag conserva su topic y la calidad del payload pasa a UNCERTAIN, de modo que los suscriptores pueden distinguir un valor ausente de uno real.

### ¿Pueden los mensajes MQTT controlar la máquina?

No. MTConnect es un estándar de solo lectura, así que no hay nada que escribir. Para escribir, utilice la interfaz propia del control, como las variables de macro de FOCAS o los comandos Q de Haas.

## Soluciones relacionadas

- [MTConnect a OPC UA](https://plcgateway.com/es/solutions/mtconnect-to-opc-ua.md)
- [OEE de CNC con MTConnect](https://plcgateway.com/es/solutions/mtconnect-oee.md)
- [FANUC FOCAS a MQTT](https://plcgateway.com/es/solutions/fanuc-focas-to-mqtt.md)
- [CNC Haas a MQTT](https://plcgateway.com/es/solutions/haas-to-mqtt.md)
- [Siemens S7 a MQTT](https://plcgateway.com/es/solutions/siemens-s7-to-mqtt.md)
- [Modbus a MQTT](https://plcgateway.com/es/solutions/modbus-to-mqtt.md)
- [Todos los protocolos](https://plcgateway.com/es/protocols.md)

_Los nombres de productos y modelos son marcas de sus respectivos propietarios. Se mencionan únicamente para indicar con qué equipos se comunican los drivers; PLCGateway no está vinculada a estas empresas._

---
Source: https://plcgateway.com/es/solutions/mtconnect-to-mqtt
