# Modbus TCP e Modbus RTU

> Conecte PLCs, inversores, medidores de energia e módulos de I/O que falam Modbus e disponibilize seus valores para clientes OPC UA, telas SCADA, histórico e assistentes de IA.

O Modbus é o protocolo de campo mais difundido na indústria: PLCs, inversores de frequência, medidores de energia, controladores de temperatura e I/O remoto quase sempre o oferecem. O PLCGateway inclui um mestre Modbus para Modbus TCP, Modbus RTU encapsulado em TCP (gateways seriais) e Modbus RTU em porta serial.

Registradores vizinhos são combinados em uma única requisição, de modo que um dispositivo inteiro é lido com poucos telegramas; valores de 32 e 64 bits são montados na ordem de palavras do dispositivo, e cada valor traz um código de qualidade. Os valores podem então ser publicados pelo servidor OPC UA integrado, enviados via MQTT, armazenados no histórico, monitorados por alarmes e exibidos em telas.

- **ID do driver:** `modbus_tcp`, `modbus_rtu_tcp`, `modbus_rtu`
- **Conexão:** TCP 502 · RTU over TCP · RS-485 / RS-232
- **Navegação de endereços:** endereços digitados ou importados
- **Escrita:** sim
- **Incluído em:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## O que o PLCGateway lê e escreve

- Holding registers (FC3) e input registers (FC4)
- Coils (FC1) e discrete inputs (FC2)
- Bits individuais de um registrador como BOOL
- INT16 a INT64, FLOAT32 / FLOAT64 e strings com ordem de palavras selecionável (ABCD, CDAB, BADC, DCBA)
- Escrita com FC5, FC6 e FC16; bits de registrador com read-modify-write
- Vários escravos atrás de um único gateway por meio do unit id

## Exemplos de endereços

| Endereço | Significado |
|---|---|
| `HR100 · %MW100` | Holding register 100 (base 0) |
| `40101` | Notação clássica em base 1 para o holding register 100 |
| `IR5 · 30006` | Input register |
| `C12 · 00013` | Coil |
| `DI7 · 10008` | Discrete input |
| `HR20.7` | Bit 7 do holding register 20 |

## Controladores e dispositivos

- [Schneider Electric Modicon](https://plcgateway.com/pt/controllers/schneider-electric.md)
- [Controladores baseados em CODESYS](https://plcgateway.com/pt/controllers/codesys-plcs.md)
- [Automação predial e medidores de energia](https://plcgateway.com/pt/controllers/building-automation.md)

## Conecte em poucos passos

1. Adicione um dispositivo, escolha Modbus TCP, RTU over TCP ou RTU serial e informe o endereço IP ou a porta serial com baud rate e paridade.
2. Defina o unit id e, para valores de 32 bits, a ordem de palavras do dispositivo.
3. Crie as tags com seus endereços e tipos de dados ou importe uma lista de registradores de um CSV; teste a conexão para ver os primeiros valores.
4. Use os valores em telas, histórico e alarmes ou compartilhe-os via OPC UA e MQTT.

## Perguntas e respostas

### O PLCGateway suporta Modbus RTU via RS-485?

Sim. O driver modbus_rtu usa diretamente uma porta serial (RS-485 ou RS-232), e o modbus_rtu_tcp envia frames RTU por meio de um gateway serial-Ethernet.

### Meus valores float parecem errados. O que devo mudar?

A maioria dos dispositivos armazena um valor de 32 bits em dois registradores, mas a ordem varia. Escolha a ordem de palavras ABCD, CDAB, BADC ou DCBA no dispositivo ou em uma tag específica até que o valor coincida com o exibido no dispositivo.

### O PLCGateway também pode atuar como servidor Modbus?

Sim. Além do driver Modbus, o PLCGateway tem um servidor Modbus TCP que oferece todas as tags como coils e registradores, para que outro PLC ou um sistema SCADA leia os dados coletados via Modbus.

## Protocolos relacionados

- [BACnet/IP](https://plcgateway.com/pt/protocols/bacnet.md)
- [Siemens S7](https://plcgateway.com/pt/protocols/siemens-s7.md)
- [Cliente OPC UA](https://plcgateway.com/pt/protocols/opc-ua.md)
- [DNP3 (IEEE 1815)](https://plcgateway.com/pt/protocols/dnp3.md)
- [Todos os protocolos](https://plcgateway.com/pt/protocols.md)

_Os nomes de produtos e modelos são marcas de seus respectivos proprietários. Eles são citados apenas para indicar com quais equipamentos os drivers se comunicam; o PLCGateway não é afiliado a essas empresas._

---
Source: https://plcgateway.com/pt/protocols/modbus
