# Modbus a MQTT

> PLCGateway sondea equipos Modbus TCP y RTU – medidores de energía, variadores, PLC, sensores – y publica sus registros y coils en un broker MQTT como valores con nombre y escalados.

Los equipos Modbus solo responden cuando se les pregunta, y lo que devuelven es el contenido bruto de los registros. Una plataforma IoT quiere lo contrario: valores con nombre que llegan por sí solos. PLCGateway sondea los registros, compone los valores de 32 y 64 bits con el orden de palabras correcto, aplica el escalado y publica cada tag cuando cambia.

Modbus TCP, RTU sobre TCP y RTU en una línea serie (RS-485 / RS-232) se admiten en la misma instalación, de modo que un medidor de energía serie y un PLC Ethernet acaban en el mismo broker. Los registros consecutivos se leen en una sola petición.

- **Origen:** [Modbus TCP / RTU](https://plcgateway.com/es/protocols/modbus.md) (`modbus_tcp`, `modbus_rtu_tcp`, `modbus_rtu`)
- **Conexión:** TCP 502 · RTU over TCP · RS-485 / RS-232
- **Destino:** [MQTT](https://plcgateway.com/es/integrations.md)
- **Escritura:** sí
- **Incluido en:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## Configuración en cinco pasos

1. Añada un dispositivo, elija Modbus TCP, RTU sobre TCP o RTU serie e introduzca la dirección IP o el puerto serie con la velocidad en baudios y la paridad.
2. Configure el unit id y, para los valores de 32 bits, el orden de palabras del equipo.
3. Cree los tags con sus direcciones y tipos de datos, o importe una lista de registros desde CSV; pruebe la conexión para ver los primeros valores.
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 meter1 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 |
|---|---|---|
| `ActivePower` | `HR100` | 42.75 kW |
| `Energy` | `HR200` | 128450.5 kWh |
| `PumpRunning` | `C12` | true |

**Topics y 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 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

- [Modbus TCP / RTU](https://plcgateway.com/es/protocols/modbus.md)
- [Schneider Electric Modicon](https://plcgateway.com/es/controllers/schneider-electric.md)
- [Controladores basados en CODESYS](https://plcgateway.com/es/controllers/codesys-plcs.md)
- [Automatización de edificios y medidores de energía](https://plcgateway.com/es/controllers/building-automation.md)

## Preguntas y respuestas

### ¿Funciona con Modbus RTU por RS-485?

Sí. Utilice un puerto serie o un adaptador USB del ordenador, o un convertidor Ethernet-serie con RTU sobre TCP. La velocidad en baudios, la paridad y el unit id se configuran por dispositivo.

### ¿Cómo se tratan los float de 32 bits?

El tipo de datos del tag define el ancho, y el orden de palabras (ABCD, CDAB, BADC, DCBA) se elige por dispositivo o por tag, de modo que el valor publicado es el número real y no dos registros en bruto.

### ¿Puedo escribir un registro por MQTT?

Sí, cuando la escritura está habilitada: un valor enviado al topic /set del tag se escribe en el holding register o la coil.

## Soluciones relacionadas

- [Modbus a OPC UA](https://plcgateway.com/es/solutions/modbus-to-opc-ua.md)
- [Siemens S7 a MQTT](https://plcgateway.com/es/solutions/siemens-s7-to-mqtt.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)
- [MTConnect a MQTT](https://plcgateway.com/es/solutions/mtconnect-to-mqtt.md)
- [Allen-Bradley EtherNet/IP a MQTT](https://plcgateway.com/es/solutions/ethernet-ip-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/modbus-to-mqtt
