1. Manuals
  2. Tumbleweed
  3. mbpoll
  4. mbpoll(1)

Scroll to navigation

MBPOLL(1) User Commands MBPOLL(1)

NAME

mbpoll - ModBus(R) Master Simulator

SYNOPSIS

mbpoll [ options ] device|host [ writevalues... ] [ options ]

DESCRIPTION

mbpoll is a command line utility to communicate with ModBus slave devices (RTU or TCP). It allows to read and write in ModBus slave registers connected by serial (RTU only) or TCP.

mbpoll can:

  • read discrete inputs
  • read and write binary outputs (coil)
  • read input registers
  • read and write output registers (holding register)

The reading and writing of registers may be in decimal, hexadecimal or floating single precision.

mbpoll's output syntax and command line option syntax is similar to the original modpoll command line program published by proconX. However mbpoll is a completely independent project and based on different source code than the original modpoll program. mbpoll is distributed under the GPL license, but the original modpoll program is not covered by the GPL license.

ARGUMENTS

Serial port when using ModBus RTU protocol.
  • COM1, COM2, ... on Windows
  • /dev/ttyS0, /dev/ttyS1, ... on Linux
  • /dev/ser1, /dev/ser2, ... on QNX
Host name or dotted IP address when using ModBus/TCP protocol.
List of values to be written. If none specified (default), mbpoll reads data. If negative numbers are provided, precede the list of data to be written by two dashes (--). For example:

mbpoll -t4:int /dev/ttyUSB0 -- 123 -1568 8974 -12

GENERAL OPTIONS

Communication mode: rtu or tcp. Default is tcp.
Slave address. Range: 1-255 for RTU, 0-255 for TCP. Default is 1. For reading, it is possible to give an address list separated by commas or colons. For example:

-a 32,33,34,36:40 reads slaves [32,33,34,36,37,38,39,40].

Start reference. Default is 1. For reading, it is possible to give a reference list separated by commas or colons.
Number of values to read (1-125). Default is 1.
Read the description of the type, the current status, and other information specific to a remote device (Report Slave ID). RTU only.
Data type. The following types are supported:
0
Discrete output (coil) data type (binary 0 or 1).
1
Discrete input data type (binary 0 or 1).
3
16-bit input register data type.
3:int16
16-bit input register with signed integer display.
3:hex
16-bit input register with hexadecimal display.
3:string
16-bit input register with string (char) display.
3:int
32-bit integer data type in input register table.
3:float
32-bit float data type in input register table.
4
16-bit output (holding) register data type (default).
4:int16
16-bit output (holding) register with signed integer display.
4:hex
16-bit output (holding) register with hexadecimal display.
4:string
16-bit output (holding) register with string (char) display.
4:int
32-bit integer data type in output (holding) register table.
4:float
32-bit float data type in output (holding) register table.
-0
First reference is 0 (PDU addressing) instead of 1.
Use function code 0x10 (Write Multiple Registers) for writing a single register, instead of 0x06 (Write Single Register).
Big endian word order for 32-bit integer and float.
-1
Poll only once, otherwise poll at every poll rate interval.
Poll rate in milliseconds. Must be greater than 100. Default is 1000.
Response time-out in seconds (0.01 - 10.00). Default is 1.00 s.
Quiet mode. Minimum output only.
Print addresses (references) in hexadecimal format.
Enable MAX_SLAVE quirk (accept slave id 0-255).
Enable REPLY_TO_BROADCAST quirk (send reply to broadcast).

MODBUS/TCP OPTIONS

TCP port number. Default is 502.

MODBUS RTU OPTIONS

Baud rate (1200-921600). Default is 19200.
Data bits: 7 or 8. Default is 8 for RTU.
Stop bits: 1 or 2. Default is 1.
Parity: none, even, or odd. Default is even.
RS-485 mode. /RTS is on (active low) after sending. An optional parameter specifies the GPIO pin number for RTS (only available when compiled with GPIO RTS support).
RS-485 mode. /RTS is on (active low) when sending. An optional parameter specifies the GPIO pin number for RTS (only available when compiled with GPIO RTS support).

OTHER OPTIONS

Print help summary and exit.
Print version and exit.
Verbose mode. Causes mbpoll to print debugging messages about its progress. This is helpful in debugging connection problems.
Print warranty information and exit.

EXAMPLES

Read input registers 1 and 2 from slave 33 via RTU on /dev/ttyUSB2 at 38400 baud:

mbpoll -a 33 -b 38400 -t 3 -r 1 -c 2 /dev/ttyUSB2

Read holding registers 100 to 109 from slave 1 via TCP on host 192.168.1.10:

mbpoll -t 4 -r 100 -c 10 192.168.1.10

Write value 1234 to holding register 100 of slave 1 via TCP:

mbpoll -t 4 -r 100 192.168.1.10 1234

Write 32-bit integer values (including negative) to holding registers via RTU:

mbpoll -t 4:int /dev/ttyUSB0 -- 123 -1568 8974 -12

Read coils 1 to 8 from slave 5, poll only once:

mbpoll -a 5 -t 0 -r 1 -c 8 -1 /dev/ttyUSB0

Read multiple slaves at once:

mbpoll -a 1,2,3 -t 4 -r 1 -c 5 /dev/ttyUSB0

Read a range of non-contiguous registers:

mbpoll -r 1,5,10:15 -t 4 192.168.1.10

Report slave ID of device at address 1:

mbpoll -a 1 -u -m rtu /dev/ttyUSB0

EXIT STATUS

0
Success. All frames were received without errors.
1
Failure. One or more communication errors occurred.

DEPENDENCIES

mbpoll requires libmodbus(3) version 3.1.7 or later.

BUGS

Report bugs at https://github.com/epsilonrt/mbpoll/issues.

AUTHOR

Pascal JEAN https://github.com/epsilonrt/mbpoll

COPYRIGHT

Copyright © 2015-2026 Pascal JEAN.

License GPLv3+: GNU GPL version 3 or later https://www.gnu.org/licenses/gpl.html.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

modbus_new_rtu(3), modbus_new_tcp_pi(3), libmodbus(7)

February 2026 mbpoll