Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Modbus plugins

Modbus is a serial communication protocol originally developed for industrial programmable logic controllers (PLCs). It has become the de-facto standard for industrial automation and is widely deployed in PLCs, HMIs, energy meters, building management systems and other OT/ICS equipment.

The protocol has no built-in authentication or encryption. Any device that can reach TCP port 502 or the correct serial bus, can read sensor values, setpoints, and configuration data and write directly to outputs or actuators.

Transport modes

All plugins support two transport modes selected by exclusive flags:

ModeFlagDefault port/baud
TCP--host <IP>502
RTU serial--serial <DEVICE>9600 baud

Exactly one of --host or --serial must be supplied. TCP is tried when --host is set. RTU is used when --serial is set.

Plugins

PluginCommandFunction code(s)
device-infomodbus device-infoFC03 (probe) & FC43 MEI
enumeratemodbus enumerateFC01, FC02, FC03, FC04
read-registersmodbus read-registersFC03/FC04
write-registermodbus write-registerFC06/FC16
read-coilsmodbus read-coilsFC01/FC02
write-coilmodbus write-coilFC05

Severity model

Successful unauthenticated reads are reported as High. The absence of any access control is the finding, regardless of the data values returned.

Successful unauthenticated writes are reported as Critical — they demonstrate the ability to modify process state, setpoints or actuator outputs without any authentication.

Connection failures and unsupported function codes are reported as Info.