Modbus Library for Arduino

ModbusRTU, ModbusTCP and ModbusTCP Security

If the library is helpful for your projects you can support it by a glass of beer

For detailes on the library usage visit documentation section.

Features

• Supports all Arduino platforms
• Operates in any combination of multiple instances of
  • Modbus RTU server
  • Modbus RTU client
  • Modbus TCP server for ESP8266/ESP32 and Ethernet library
  • Modbus TCP client for ESP8266/ESP32 and Ethernet library
  • MODBUS/TCP Security server (ESP8266)
  • MODBUS/TCP Security client (ESP8266/ESP32)
• Modbus functions supported:
  • 0x01 - Read Coils
  • 0x02 - Read Input Status (Read Discrete Inputs)
  • 0x03 - Read Holding Registers
  • 0x04 - Read Input Registers
  • 0x05 - Write Single Coil
  • 0x06 - Write Single Register
  • 0x0F - Write Multiple Coils
  • 0x10 - Write Multiple Registers
  • 0x14 - Read File Record
  • 0x15 - Write File Record
  • 0x16 - Mask Write Register
  • 0x17 - Read/Write multiple registers
• Callbacks driven design

Notes

1. The offsets for registers are 0-based. So be careful when setting your supervisory system or your testing software. For example, in ScadaBR offsets are 0-based, then, a register configured as 100 in the library is set to 100 in ScadaBR. On the other hand, in the CAS Modbus Scanner offsets are 1-based, so a register configured as 100 in library should be 101 in this software.
2. RS-485 transivers based on MAX-485 is working on at least up to 115200. XY-017/XY-485 working only up to 9600 for some reason.

For more information about Modbus see:

• Modbus (From Wikipedia, the free encyclopedia)
• MODBUS APPLICATION PROTOCOL SPECIFICATION V1.1b3
• MODBUS MESSAGING ON TCP/IP IMPLEMENTATION GUIDE V1.0b
• MODBUS over Serial Line Specification and Implementation Guide V1.02
• MODBUS/TCP Security Protocol Specification

Last Changes

// 4.0.0
+ Support of all Arduino boards
+ ModbusTLS: ESP8266 Client/Server and ESP32 Client
+ ModbusTCP: ModbusEthernet - WizNet W5x00, ENC28J60 Ethernet library support
+ 0x14 - Read File Records function
+ 0x15 - Write File Records function
+ Examples: FW update over Modbus fullfunctional example
+ 0x16 - Write Mask Register function+ Test: 0x16
+ 0x17 - Read/Write Registers function
+ ModbusRTU: ESP32 SoftwareSerial support
+ Build with no STL dependency (switchable)
+ API: ModbusIP => ModbusTCP
+ API: Access control callback for individual Modbus function
+ API: Master/Slave => Client/Server according to [PRESS RELEASE](https://modbus.org/docs/Client-ServerPR-07-2020-final.docx.pdf)
+ Lot of code refacting and small fixes
// 4.1.0-DEV
- ModbusTLS: ESP32 Server
- Test: TLS ESP32 Server
- Test: TLS ESP32 Client
- Examples: TLS Certificate test Role extension and Alt-Name
- Examples: TLS Add example explanation
- ModbusRTU: Add direction control pin for Stream
- ModbusRTU: Static buffer allocation.
- Buffer/packet size limitation support
- Slave/Server: slavePDU use early exit by return where possible
- Master/Client: Check frame size against header data where possible
- Master/Client: Additional responce data validation
- Free global registers and callbacks on remove last Modbus instance
- Test: Frame accuracy to specefication
- Test: push/pull functions
- Test: W5x00 with Ethernet library v1
- Examples: Basic file operations
- Examples: Revising

Contributions

https://github.com/emelianov/modbus-esp8266

a.m.emelianov@gmail.com

Original version:

https://github.com/andresarmento/modbus-esp8266

https://github.com/andresarmento/modbus-arduino

prof (at) andresarmento (dot) com

License

The code in this repo is licensed under the BSD New License. See LICENSE.txt for more info.