| If the library is helpful for your projects you can support it by a glass of beer |  |
|---|
The library is under active development. Visit Releases page for stable one.
This library allows your Arduino board to communicate via Modbus protocol. The Modbus is a protocol used in industrial automation and also can be used in other areas, such as home automation.
The Modbus generally uses serial RS-485 as physical layer (then called Modbus Serial) and TCP/IP via Ethernet or WiFi (Modbus TCP).
- Supports all Arduino platforms
- Operates in any combination of multiple instances of
- Modbus RTU slave
- Modbus RTU master
- 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)
- Reply exception messages for all supported functions
- 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
- Callbacks for
- Client connect (Modbus TCP)
- Server/Client disconnect (Modbus TCP)
- Read specific Register
- Write specific Register
- Slave transaction finish
- 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.
- For API refer API.md
- 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
// 4.0.0-DEV
+ ModbusTLS: Modbus TCP Security Client/Server
+ ModbusTLS: ESP8266 Client/Server
+ Test: TLS ESP8266 Client/Server
+ Examples: TLS added
- Examples: TLS Certificate test Role extension and Alt-Name
- Examples: TLS Add example explanation
+ ModbusTLS: ESP32 Client
- Test: TLS ESP32 Client
+ Build with no STL dependency
- Test: No-STL mode
+ ModbusTCP: ModbusEthernet - W5x00 Ethernet library support
+ Test: W5x00 support
- Test: W5x00 with Ethernet library v1
+ API: Implementation code merge
+ API: Access ModbusTCP server by name
+ API: Set local multiple registers from an array
+ ModbusIP => ModbusTCP
+ 0x14 - Read File Records function
+ Test: 0x14
+ 0x15 - Write File Records function
+ Test: 0x15
- Examples: Basic file operations
- Examples: FW update
+ 0x16 - Write Mask Register function
- Test: 0x16
- 0x17 - Read/Write Registers function
- Test: 0x17
+ API: Access control callback for individual Modbus function
- 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
- Test: push/pull functions
- Test: Frame accuracy to specefication
- Documentation: Update
- Examples: Revising
+ ModbusRTU: ESP32 SoftwareSerial support
+ ModbusRTU: Fix transaction callback remains assigned after request end
+ ModbusTCP: Free server connection in destructor
+ Declare global registers and callbacks as static members
- Free global registers and callbacks on remove last Modbus instance
+ ModbusRTU: Refactor .task() for more relaibe processing of incoming data
+ API: Declare all callbacks as std::function (for STL)
- API: Msater/Slave => Client/Server according to [PRESS RELEASE](https://modbus.org/docs/Client-ServerPR-07-2020-final.docx.pdf)
// 4.1.0
- ModbusTLS: ESP32 Server
- Test: TLS ESP32 Serverhttps://github.com/emelianov/modbus-esp8266
Original version:
https://github.com/andresarmento/modbus-esp8266
https://github.com/andresarmento/modbus-arduino
prof (at) andresarmento (dot) com
The code in this repo is licensed under the BSD New License. See LICENSE.txt for more info.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent