This is a collection of types that implement the embedded-hal traits.
The implementations never access real hardware. Instead, the hardware is mocked or no-op implementations are used.
The goal of the crate is to be able to test drivers in CI without having access to hardware.
See module-level docs for more information.
This crate supports both version 0.x and version 1.x of embedded-hal. By default only support
for version 0.x is enabled. To enable support for version 1.x, use the eh1 feature.
There are currently the following cargo features:
eh0: Provide moduleeh0that mocks embedded-hal version 0.x (enabled by default)eh1: Provide moduleeh1that mocks embedded-hal version 1.x (enabled by default)embedded-time: Enable theeh0::timermodule (enabled by default)embedded-hal-async: Provide mocks for embedded-hal-async ineh1
Currently this crate is not no_std. If you think this is important, let
me know.
| Feature | embedded-hal | embeded-hal-async |
|---|---|---|
| I²C | ✅ | ✅ |
| SPI | ✅ | ✅ |
| No-op delay | ✅ | ✅ |
| Actual delay | ✅ | ✅ |
| Serial | ✅ | - |
| RNG | - | - |
| I/O pins (including PWM) | ✅ | ✅ |
| ADC | ✅ | - |
Timers (with embedded-time Cargo feature) |
✅ | - |
Pull requests for more mock implementations are welcome! :)
This crate is guaranteed to compile on the latest stable Rust release. It might compile with older versions but that may change in any new patch release.
If you would like to use the current development version of embedded-hal (or any other version),
so long as they are API compatible you can use a patch field in your Cargo.toml file to override
the dependency version.
[patch.crates-io]
eh1 = { git = "https://github.com/rust-embedded/embedded-hal" }Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.