# Rust Modbus
[](https://github.com/hirschenberger/modbus-rs/actions/workflows/rust.yml)
[](https://crates.io/crates/modbus)
[](https://docs.rs/modbus/latest/modbus)
[](https://crates.io/crates/modbus)
[](http://doge.mit-license.org)
Modbus implementation in pure Rust.
## Usage
Add `modbus` to your `Cargo.toml` dependencies:
```toml
[dependencies]
modbus = "1.1"
```
Import the `modbus` crate and use it's functions:
```rust
use modbus::{Client, Coil};
use modbus::tcp;
let mut client = tcp::Transport::new("192.168.0.10");
client.write_single_coil(1, Coil::On).unwrap();
client.write_single_coil(3, Coil::On).unwrap();
let res = client.read_coils(0, 5).unwrap();
// res == vec![Coil::Off, Coil::On, Coil::Off, Coil::On, Coil::Off];
```
See the [documentation](https://docs.rs/modbus/latest/modbus) for usage examples and further reference and
the [examples](https://github.com/hirschenberger/modbus-rs/tree/master/examples) directory for a commandline client application.
## License
Copyright © 2015-2026 Falco Hirschenberger
Distributed under the [MIT License](LICENSE).