Crates.io | embedded-hal-bus |
lib.rs | embedded-hal-bus |
version | 0.2.0 |
source | src |
created_at | 2022-08-17 16:46:59.130826 |
updated_at | 2024-04-23 21:44:54.989304 |
description | Bus/Device connection mechanisms for embedded-hal, a Hardware Abstraction Layer (HAL) for embedded systems |
homepage | |
repository | https://github.com/rust-embedded/embedded-hal |
max_upload_size | |
id | 647607 |
size | 60,989 |
embedded-hal-bus
Bus sharing utilities for embedded-hal
, a Hardware Abstraction Layer (HAL) for embedded systems.
embedded-hal
provides traits for SPI and I2C buses and devices. This crate provides hardware-independent adapters for sharing a single bus between multiple devices, compatible with the traits.
This project is developed and maintained by the HAL team.
To support bus sharing, embedded-hal
provides the SpiBus
and SpiDevice
traits. SpiBus
represents an entire bus,
while SpiDevice
represents a device on that bus. For further details on these traits, please consult the
embedded-hal
documentation.
embedded-hal
trait implementations for microcontrollers should implement the SpiBus
trait.
However, device drivers should use the SpiDevice
traits, not the SpiBus
traits if at all possible
in order to allow for sharing of the bus they are connected to.
This crate provides mechanisms to connect a SpiBus
and a SpiDevice
.
In the case of I2C, the same I2c
embedded-hal
trait represents either an entire bus, or a device on a bus. This crate
provides mechanisms to obtain multiple I2c
instances out of a single I2c
instance, sharing the bus.
std
: enable shared bus implementations using std::sync::Mutex
, and implement
std::error::Error
for DeviceError
.async
: enable embedded-hal-async
support.defmt-03
: Derive defmt::Format
from defmt
0.3 for enums and structs.This crate is guaranteed to compile on stable Rust 1.60 and up. It might compile with older versions but that may change in any new patch release.
See here for details on how the MSRV may be upgraded.
Enabling the async
Cargo features requires Rust 1.75 or higher.
Licensed under either of
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.