https://github.com/CarlKCarlK/device-envoy
Build Pico and ESP32 applications with LED panels, easy WiFi, and composable device abstractions.
https://github.com/CarlKCarlK/device-envoy
Last synced: 4 months ago
JSON representation
Build Pico and ESP32 applications with LED panels, easy WiFi, and composable device abstractions.
- Host: GitHub
- URL: https://github.com/CarlKCarlK/device-envoy
- Owner: CarlKCarlK
- License: apache-2.0
- Created: 2025-10-14T17:17:19.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T20:43:55.000Z (4 months ago)
- Last Synced: 2026-04-16T22:29:05.752Z (4 months ago)
- Language: Rust
- Homepage:
- Size: 15.9 MB
- Stars: 32
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-esp-rust - device-envoy - Embassy-based device abstractions for ESP32-C6 and ESP32-S3, including Wi-Fi provisioning, LED-panel graphics, and audio playback. (Libraries built on top of `esp-hal`)
README
# device-envoy
[](https://github.com/CarlKCarlK/device-envoy)
Rust workspace for composable embedded device abstractions built on Embassy.
## Intro
`device-envoy` is a workspace for building embedded applications in Rust with Embassy, organized around device abstractions.
A device abstraction is a software encapsulation of hardware that manages timing, tasks, control flow, interrupts, channels, and state within the abstraction.
Rather than replacing HALs or drivers, `device-envoy` builds on them and exposes a small set of simple operations to the rest of your program.
Current platform focus is Raspberry Pi Pico 1 and Pico 2 via `device-envoy-rp`, and ESP via `device-envoy-esp` (actively tested on ESP32-C6 and ESP32-S3).
## Workspace Crates
- `crates/device-envoy`: top-level landing crate [](https://crates.io/crates/device-envoy) [](https://docs.rs/device-envoy)
- `crates/device-envoy-rp`: Raspberry Pi Pico focused crate [](https://crates.io/crates/device-envoy-rp) [](https://docs.rs/device-envoy-rp)
- `crates/device-envoy-esp`: ESP32-C6 and ESP32-S3 focused crate [](https://crates.io/crates/device-envoy-esp) [](https://docs.rs/device-envoy-esp)
- `crates/device-envoy-core`: shared core APIs used across platform crates [](https://crates.io/crates/device-envoy-core) [](https://docs.rs/device-envoy-core)
## Status
⚠️ **Alpha / Experimental**
The API is actively evolving. Not recommended for production use, but good for experimentation, learning, and exploratory projects.
This workspace is also in active migration as shared functionality moves into `device-envoy-core` while platform crates remain usable.
## Features
- LED strips and panels for NeoPixel-style (WS2812) hardware
- WiFi auto-connect and credential management
- Audio player over I2S
- Button input and debouncing
- Servo control and animation
- Flash storage for persistent configuration
- LCD text display support
- IR remote decoding
- RFID card reading
- Clock synchronization helpers
- 4-digit seven-segment display control
- Single LED control and animation
## Forum
- **[Using Embassy to build applications](https://github.com/CarlKCarlK/device-envoy/discussions)**
A place to talk about writing embedded applications with Embassy: sharing code, asking practical questions, and learning what works in practice.
## Videos and Articles
- [device-envoy: Making Embedded Fun with Rust, Embassy, and Composable Device Abstractions](https://medium.com/@carlmkadie/device-envoy-making-embedded-fun-31534917414b) -- versions: [article](https://medium.com/@carlmkadie/device-envoy-making-embedded-fun-31534917414b) or [video](https://www.youtube.com/watch?v=iUu6hvJLVOU)
- [How Rust & Embassy Shine on Embedded Devices](https://medium.com/@carlmkadie/how-rust-embassy-shine-on-embedded-devices-part-1-9f4911c92007) by Carl M. Kadie and Brad Gibson
- [More Rust articles](https://medium.com/@carlmkadie)
## Thanks
Special thanks to [Brad Gibson](https://github.com/U007D/), organizer of the [Seattle Rust User Group](https://www.meetup.com/seattle-rust-meetup/). He introduced me to Rust programming on microcontrollers, suggested the term *device abstraction*, and encouraged thinking in terms of shared traits across controller families. Those conversations helped set the goals for device-envoy.
## Example: Animated LED Strip (from RP crate)
This example is from `device-envoy-rp` and cycles a 96-LED strip through red, green, and blue frames.
```rust,no_run
# #![no_std]
# #![no_main]
# use panic_probe as _;
# use core::convert::Infallible;
use device_envoy_rp::{Result, led_strip::{LedStrip as _, Frame1d, colors}};
use device_envoy_rp::led_strip;
led_strip! {
LedStripAnimated {
pin: PIN_4,
len: 96,
}
}
async fn example(spawner: embassy_executor::Spawner) -> Result {
let p = embassy_rp::init(Default::default());
let led_strip_animated = LedStripAnimated::new(p.PIN_4, p.PIO0, p.DMA_CH0, spawner)?;
let frame_duration = embassy_time::Duration::from_millis(300);
led_strip_animated.animate([
(Frame1d::filled(colors::RED), frame_duration),
(Frame1d::filled(colors::GREEN), frame_duration),
(Frame1d::filled(colors::BLUE), frame_duration),
]);
core::future::pending().await
}
```
## Policy on AI-assisted development and contributions
The use of AI tools is permitted for development and contributions to this repository. AI may be used as a productivity aid for drafting, exploration, and refactoring.
All code and documentation contributed to this repository must be reviewed, edited, and validated by a human contributor. AI tools are not a substitute for design judgment, testing, or responsibility for correctness.
[AGENTS.md](AGENTS.md) contains the general instructions and constraints given to AI tools used during development of this repository.
## Development Guide
If you want to edit this workspace, start here: [development.md](development.md).
## License
Licensed under either:
- MIT license (see LICENSE-MIT)
- Apache License, Version 2.0 (see LICENSE-APACHE)
at your option.