modbus tools

Índice

• Sobre
• Ferramentas
  • escravo-rnd
  • troca de escravos
• Detalhes de implementação
• Compilação cruzada
• Exemplos on-line

Sobre

Ferramentas para trabalhar com protocolo Modbus desenvolvido por Rust/Tokio. Os aplicativos estão disponíveis online. Veja aqui para detalhes.

Ferramentas

escravo-rnd

Emulador escravo que gera respostas aleatórias para solicitações de leitura e reconhece positivamente comandos de gravação. Útil para verificação rápida de mestres Modbus, como sistemas SCADA, implementações de clientes personalizados, etc.

A maneira mais fácil é construir e operar via Cargo. Por padrão, o Modbus TCP usa a porta 502 que, na maioria dos casos, requer privilégios de root. Portanto todos os exemplos são apresentados na porta 1502.

 cargo run --bin slave-rnd tcp:0.0.0.0:1502
..
[2022-07-08T14:49:25Z INFO  slave_rnd] start server 0.0.0.0:1502
[2022-07-08T14:49:25Z INFO  slave_rnd] start message processor
[2022-07-08T14:49:25Z INFO  slave_rnd] press Ctrl+C to exit
[2022-07-08T14:49:27Z INFO  transport::tcp::server] 127.0.0.1:44544 connected
[2022-07-08T14:49:30Z INFO  transport::tcp::server] 127.0.0.1:44548 connected

Execute com saída detalhada.

 RUST_LOG=trace cargo run --bin slave-rnd tcp:0.0.0.0:1502
...
[2022-07-08T14:50:16Z INFO  slave_rnd] start server 0.0.0.0:1502
[2022-07-08T14:50:16Z INFO  slave_rnd] start message processor
[2022-07-08T14:50:16Z INFO  slave_rnd] press Ctrl+C to exit
[2022-07-08T14:50:16Z INFO  transport::tcp::server] 127.0.0.1:56896 connected
[2022-07-08T14:50:17Z DEBUG codec::net::default] 127.0.0.1:56896 unpack [0, 197, 0, 0, 0, 6, 1, 3, 0, 0, 0, 10]
[2022-07-08T14:50:17Z DEBUG transport::tcp::server] 127.0.0.1:56896 RequestFrame { id: Some(197), slave: 1, pdu: ReadHoldingRegisters { address: 0, nobjs: 10 } }
[2022-07-08T14:50:17Z DEBUG transport::tcp::server] 127.0.0.1:56896 ResponseFrame { id: Some(197), slave: 1, pdu: ReadHoldingRegisters { nobjs: 10, data: Data { buffer: [145, 4, 173, 2, 122, 70, 61, 128, 56, 198, 89, 37, 62, 72, 5, 186, 233, 123, 79, 21] } } }
[2022-07-08T14:50:17Z DEBUG codec::net::default] 127.0.0.1:56896 pack [0, 197, 0, 0, 0, 23, 1, 3, 20, 4, 145, 2, 173, 70, 122, 128, 61, 198, 56, 37, 89, 72, 62, 186, 5, 123, 233, 21, 79]
[2022-07-08T14:50:17Z DEBUG codec::net::default] 127.0.0.1:56896 unpack [0, 198, 0, 0, 0, 6, 1, 3, 0, 0, 0, 10]
..

Execute em modo serial.

 cargo run --bin slave-rnd serial:/dev/ttyUSB0:38400-8-N-1

troca de escravos

Um emulador de escravo permite conectar N mestres. Alguns mestres podem escrever em registradores e outros podem ler. O uso típico é o armazenamento temporário para conectar diferentes componentes de um sistema.

Correndo:

 cargo run --bin slave-exchange tcp:0.0.0.0:1502 udp:0.0.0.0:1502 serial:/dev/ttyUSB0:9600-8-N-1
..
[2022-12-07T19:43:18Z INFO  transport::builder] start tcp server 0.0.0.0:1502
[2022-12-07T19:43:18Z INFO  transport::builder] start udp server 0.0.0.0:1502
[2022-12-07T19:43:18Z INFO  transport::builder] start rtu slave /dev/ttyUSB0:9600-8-N-1
[2022-12-07T19:43:18Z INFO  slave_exchange] press Ctrl+C to exit

Detalhes de implementação

Modos suportados:

• Escravo
• Mestre

Transporte suportado:

• TCP
• UDP
• Serial

Funções suportadas:

• 0x01 Ler bobinas
• 0x02 Leitura de entradas discretas
• 0x03 Ler registros de retenção
• 0x04 Ler registros de entrada
• 0x05 Gravação de bobina única
• 0x06 Gravar registro único
• 0x07 Status de exceção de leitura
• 0x08 Diagnóstico
• 0x0B Obter contador de eventos de comunicação
• 0x0C Obter log de eventos de comunicação
• 0x0F Grava múltiplas bobinas
• 0x10 Grava vários registros
• 0x11 Reportar ID do Escravo
• 0x14 Ler registro de arquivo
• 0x15 Gravar registro de arquivo
• Registro de gravação de máscara 0x16
• 0x17 Leitura/gravação de vários registros
• 0x18 Leitura da fila FIFO
• Transporte de interface encapsulada 0x2B/0x0D
• Transporte de interface encapsulada 0x2B/0x0E. Leia a identificação do dispositivo

Compilação cruzada

ARMv7

Os binários ARMv7 podem ser executados, por exemplo, em Raspperry PI (32 bits) ou iMX6UL.

 cargo build --target=armv7-unknown-linux-gnueabihf 

Janelas 10

 cargo build --release --target=x86_64-pc-windows-gnu

Exemplos on-line

escravo-rnd - 194.60.201.127:502. O transporte TCP e UDP está ativado.

troca de escravos - 194.60.201.127:1502. O transporte TCP e UDP está ativado.