Expand description
rusty_esp_signal-esp — chip backends for rusty_esp_signal.
This is the wrap crate of the package: where the silicon must be
touched, it calls the esp-rs HAL (Track B, esp-hal + esp-radio) or
ESP-IDF (Track A, esp-idf) and feeds bytes into the pure core’s state
machines. Nothing product- or protocol-specific lives here; that is the
core’s job. This crate ingests the signal; the core interprets it.
§Track B is compiled by a firmware, never on its own
esp-hal refuses to build unless exactly one chip feature (esp32c6, …) is
set, and a library that selected one would fix the chip for every consumer.
So the chip is chosen by the firmware binary, which turns on this crate’s
esp-hal feature and its own esp-hal/esp-radio chip feature; cargo’s
feature unification then compiles the backends below for that chip. The
host build and the workspace tests use no feature here and see only the
Track marker, so they never need a chip.
§The radios
Each backend feeds one core module (rusty_esp_signal_core):
- [
hal::rng] — the hardware TRNG behind the core’sRngseam, for device keys and session ephemerals. - [
hal::link] — the ESP-NOW datagram transport under the mID-authenticatedlink::Session, plus the handshake driven over it. - [
hal::csi] — a Wi-Fi CSI frame borrowed intoradar::csi::CsiFrame;idf::csi(featureesp-idf-csi) is its Track A twin, a callback on ESP-IDF’s Wi-Fi task parked into a ring the sketch drains. The ring and the buffer’s ingest arecsi_queue, compiled on the host and tested there, because a callback cannot be tested on a board. - [
hal::ld2410] — a UART reader feedingradar::ld2410::Parser. - [
hal::station] — Wi-Fi station events drivingwifi::StationPolicy. - [
lora] (featurelora) —lora::Paramsmapped tolora-phymodulation and packet parameters, and the P2P link over them. - [
ble] (featureble) — atrouble-hostGATT server built from the core’sble::GATT_TABLE.
The last two touch no esp crate: they are generic over the modem and the HCI controller, so a firmware can take either without the radio stack.
Re-exports§
pub use rusty_esp_signal_core as core_crate;
Modules§
- csi_
queue - The seam between a CSI callback and the sketch that reads it: the frame a callback makes of the chip’s buffer, and the ring it parks it in.
Enums§
- Track
- Which track this build of the backend crate was compiled for.
Constants§
- TRACK
- The track this crate was built with.