31 releases (13 breaking)
0.15.0 | Oct 10, 2024 |
---|---|
0.14.0 | Jul 21, 2024 |
0.12.0 |
|
0.9.0 | Jul 27, 2023 |
0.0.0 | Aug 21, 2017 |
#31 in Network programming
18,766 downloads per month
Used in 26 crates
(23 directly)
180KB
4K
SLoC
tokio-modbus
A pure Rust Modbus library based on tokio.
Modbus is based on a master/slave communication pattern. To avoid confusion with the Tokio terminology the master is called client and the slave is called server in this library.
Features
- Pure Rust library
- Modbus TCP or RTU at your choice
- Both
async
(non-blocking, default) andsync
(blocking, optional) - Client API
- Server implementations
- for out-of-the-box usage or
- as a starting point for a customized implementation
- Open source (MIT/Apache-2.0)
Installation
Add this to your Cargo.toml
:
[dependencies]
tokio-modbus = "*"
Cargo Features
"rtu"
: Asynchronous RTU client (default)"tcp"
: Asynchronous TCP client (default)"rtu-sync
: Synchronous RTU client"tcp-sync"
: Synchronous TCP client"rtu-server"
: (Asynchronous) RTU server"tcp-server"
: (Asynchronous) TCP server"rtu-over-tcp-server"
: (Asynchronous) RTU over TCP server
Examples
If you only need an asynchronous TCP client add the following line to your Cargo.toml file:
[dependencies]
tokio-modbus = { version = "*", default-features = false, features = ["tcp"] }
For an asynchronous RTU client:
[dependencies]
tokio-modbus = { version = "*", default-features = false, features = ["rtu"] }
For an RTU server:
[dependencies]
tokio-modbus = { version = "*", default-features = false, features = ["rtu-server"] }
For a TCP server:
[dependencies]
tokio-modbus = { version = "*", default-features = false, features = ["tcp-server"] }
Examples
Various examples for Modbus RTU and TCP using either the asynchronous or synchronous API can be found in the examples folder.
Testing
The workspace contains documentation, tests, and examples for all available features.
cargo test --workspace
cargo test --workspace --all-features
Protocol-Specification
- Modbus Application Protocol Specification v1.1b3 (PDF)
- Modbus over serial line specification and implementation guide v1.02 (PDF)
- Modbus Messaging on TCP/IP Implementation Guide v1.0b (PDF)
License
Copyright (c) 2017-2024 slowtec GmbH
Dependencies
~3–11MB
~121K SLoC