rust-embedded/embedded-hal
Embedded Hal
Embedded-hal is a hardware abstraction layer for embedded microcontrollers that defines common traits allowing peripheral drivers to remain entirely independent of specific hardware platforms. The library provides platform-agnostic interfaces that decouple driver logic from microcontroller architectures, utilizing zero-cost trait abstractions that compile down to direct hardware register manipulations without runtime overhead or memory allocation.
The project features asynchronous execution support and synchronous-to-asynchronous adaptation, enabling non-blocking peripheral operations and cooperative multitasking in resource-constrained environments. It includes shared bus coordination utilities that let multiple device drivers safely share a single communication bus without signal conflicts, alongside specialized communication protocol traits, polling methods, and stream mode management.
Additional capabilities cover byte-oriented stream processing for hardware and virtual connections, custom error handling via associated types, and automated diagnostic message formatting for inspecting system states across custom types.
Features
- Hardware Abstraction Layers - Serves as a foundational hardware abstraction layer defining common traits for embedded microcontrollers.
- Bus-Sharing Arbitration - Supplies safe coordination utilities letting multiple device drivers share a communication bus safely.
- 硬件驱动 - Defines platform-agnostic traits allowing peripheral drivers to remain independent of hardware platforms.
- Decoupled Driver Architectures - Deploys trait-based generic boundaries that decouple peripheral drivers from specific microcontrollers.
- Embedded Async Multitasking - Enables non-blocking peripheral operations and cooperative multitasking on resource-constrained microcontrollers.
- Asynchronous Hardware Interfaces - Runs peripheral operations using modern asynchronous execution models with non-blocking await syntax.
- Embedded Peripheral Interfacing - Provides a set of platform-agnostic driver interface traits for embedded microcontrollers.
- Hardware Abstraction Layers - Provides portable driver abstractions that work across different microcontroller platforms without modification.
- Input-Output Interfaces - Provides custom input and output traits tailored for bare-metal and resource-constrained environments.
- Synchronous-to-Asynchronous Wrappers - Converts blocking hardware operations into non-blocking asynchronous interfaces for cooperative multitasking.
- Associated Types - Uses associated types on interface traits to allow custom error definitions without memory allocation.
- Asynchronous Operation Execution - Executes peripheral and I/O operations asynchronously without blocking the main execution flow.
- Generalized Error Handling for Custom Types - Implements associated error types on traits enabling custom error handling without dynamic dispatch or allocation.
- Bare-Metal Runtimes - Handles byte-oriented I/O operations in constrained bare-metal environments without standard libraries.
- Zero-Allocation Runtime Models - Provides stream and I/O traits that operate entirely without standard libraries or heap allocators.
- Zero-Cost Abstraction Patterns - Defines zero-overhead interface contracts compiling directly down to hardware register manipulations.
- Polling Operations - Executes polling-based operations through supplementary modules to check hardware status.
- Byte Stream Capture - Models byte-oriented communication streams for hardware and virtual connections using reader and writer traits.
- Synchronous Adaptation Wrappers - Bridges synchronous and asynchronous stream traits to support flexible driver execution modes.
- Stream Mode Management - Separates blocking read and write operations from availability check traits to handle asynchronous data flow safely.
