Free Modbus scanner and diagnostics tool for Windows and macOS

Connect a device through a USB-RS485 cable or the network. The app finds the serial settings and recognises the device.

Version 2.1.6 for Windows 10 and 11 and macOS 10.15 or later (Apple Silicon and Intel).

Adding an energy meter over the network. The app recognises it as Eastron SDM630-Modbus and says why.

What happens when you connect a device

  1. The app finds the settings

    On RS485 it tries the common baud rates, parities and Modbus addresses until the device answers. On the network it scans for Modbus TCP devices.

  2. It recognises the device

    It reads the registers where device types differ and picks the matching type from the 1236 in the library. You see why. When it is not sure, it lists the best candidates.

  3. You see the values with names and units

    Grouped, for example temperatures, states or power. They refresh from every half second to every thirty seconds.

When no type fits, the app guesses what each register is, such as a voltage, a temperature or a counter. You compare it with the display and save the result.

Tracking down a fault on site

The Diagnostics tab sums up the connection in one sentence: how many requests get an answer, and how fast.

Each error is shown as a cause, with what to check. Copy the report as text or print it.

If a device on RS485 suddenly stops answering, the app works out what has changed, such as the baud rate, the address or the COM port, and reconnects. If it finds nothing, you get a short list to work through.

How the app explains three common faults.

No answer
No answer arrived in time. Usually the Modbus address, the speed or the wiring (A and B) is wrong.
Garbled answers
Data arrives but is corrupted. Check the speed and parity, whether there is a second master on the bus, and the termination resistor.
Address does not exist
This register address does not exist on the device. Often the address is off by one (40001 is address 0) or the block runs over a gap. Read fewer registers at once.
MessageBytes on the wireReply timeMeaning
Request09 04 00 00 00 08 F0 84The app asks for the voltages (8 registers from address 0)
Reply09 04 10 43 6D BB D0 00 00 00 00 00 00 00 00 00 00 00 00 EF 4B48 msL1 is 237.7 V, L2 and L3 are not connected
Request09 04 00 46 00 02 91 56The app asks for the grid frequency
Reply09 04 04 42 47 FA 60 94 A138 ms49.99 Hz
Request09 03 FC 02 00 01 14 D2The app asks for the type code
Reply09 03 02 00 83 18 2447 ms131, which is an SDM72CT-M
Three requests to an Eastron SDM72CT-M on RS485 (address 9) and the replies, as the console shows them. The Meaning column was added for this page.

Devices the library does not know yet

The Eltako DSZ15DZMOD is not in the library. The registers from the manual go in by copy and paste. The app checks them on the meter and saves them as a device type.

  • The app reads the register table from a PDF, Excel (.xlsx), CSV or pasted text. Not scanned pages yet.
  • With the device connected, it checks the list against it and corrects address notation, word order and scale.
  • Save the list as your own device type, so the app recognises the device straight away next time.

More tools in the app

Reading and writing registers

Read coils, discrete inputs, input and holding registers in thirteen data types, with all four word orders side by side. Writes ask for confirmation first.

Logging

Record values from every 250 ms to every minute, or only when they change. You see a chart and save the recording as CSV or JSON.

Exporting

Turn a device type into Home Assistant or ESPHome YAML, a file for the ModbusCloud Gateway, CSV or JSON.

Scanning and practising

Search a bus for addresses 1 to 247, or your network for Modbus TCP devices. Without a device, practise with the built-in simulator.

Specifications of the Modbus scanner

Specifications of ModbusCloud Diagnostics
Connection
ConnectionsModbus RTU and ASCII over RS485 with a USB adapter, Modbus TCP, RTU over TCP
Function codesRead 01 to 04, write 05, 06, 15 and 16, identification 17 and 43/14
Data typesbool, int8, uint8, int16, uint16, int32, uint32, int64, uint64, float32, float64, text and 16-bit bit field, in the word orders ABCD, CDAB, BADC and DCBA
Serial settings1200 to 115200 baud, parity none, even or odd, 1 or 2 stop bits, 8 or 7 data bits
Library and manual
Library1236 device types, available offline and updated at most once a day
Reading a manualPDF, Excel (.xlsx), CSV, text file or pasted text, checked on the device
Use
Refresh and loggingLive every 500 ms to 30 s, logging every 250 ms to 60 s or on change
ExportRecordings as CSV or JSON; device types as Home Assistant YAML, ESPHome YAML, CSV, JSON or a file for the ModbusCloud Gateway; the diagnostics report as text or print
StorageDevices, device types and recordings stay on your own computer
InternetNot required. At start-up the app checks for an update and a newer library
LanguagesEnglish, Dutch and German
SystemsWindows 10 and 11 (64-bit, installs without administrator rights), macOS 10.15 or later on Apple Silicon and Intel
PriceFree, no account needed
ModbusCloud Diagnostics: a recognised Eastron SDM630 with voltage, current, power and energy per group

Questions about ModbusCloud Diagnostics

Comparing tools? ModbusCloud Diagnostics is set out next to Modbus Poll, ModScan, QModMaster and CAS Modbus Scanner, with the facts from their own websites.

Modbus Poll compared with ModbusCloud Diagnostics

How scanning an RS485 bus or a network works

Is ModbusCloud Diagnostics free?

Yes. The app is free, without a time limit and without an account. On Windows it installs without administrator rights.

Which systems does it run on?

Windows 10 and 11 (64-bit) and macOS 10.15 or later, on Apple Silicon and Intel. There is no version for Linux or for Windows on ARM.

Which adapter do I need for RS485?

A USB-RS485 adapter that your computer sees as a serial port (a COM port on Windows). Connect A and B of the adapter to A and B of the device. For Modbus TCP you need no adapter, only the network.

Does it find the baud rate and address by itself?

On RS485 it does, within the common range. It tries the 13 most common combinations of baud rate, parity and stop bits and the 14 most common addresses. A device with other settings you enter by hand. On Modbus TCP it tries a few common unit IDs.

Which devices does it recognise?

The 1236 device types in the ModbusCloud library, such as energy meters, inverters and heat pumps. For a device that is not in it, the app guesses per register what it holds, or reads the register table from the manual.

Can it write registers?

Yes, with function codes 05, 06, 15 and 16. By default the app asks for confirmation before each write. You can switch that off in Settings.

Do I need internet?

No. The library is built in and works offline. When the computer is online, the app looks for a new version and a newer library at start-up.

Download

Windows

Windows 10 and 11, 64-bit

macOS

macOS 10.15 or later, Apple Silicon and Intel in one app

Version 2.1.6. The app tells you when a new version is out, and updating takes one click.

Windows does not recognise this installer yet, so on first start it may show ‘Windows protected your PC’. Click ‘More info’ and then ‘Run anyway’.

On a Mac, open the app and click ‘Done’ when macOS stops it. Then allow it in System Settings under ‘Privacy & Security’ with ‘Open Anyway’. On macOS 14 or older, right-click the app and choose ‘Open’.

The ModbusCloud Gateway reads the same devices with the same library, and keeps sending the values to the portal after handover.

More about the ModbusCloud Gateway
Terminal strip with wiring in a control cabinet