Skip to main content

Crate rusty_esp_signal_core

Crate rusty_esp_signal_core 

Source
Expand description

rusty_esp_signal-core — the pure heart of rusty_esp_signal: the radio application layer with no radio in it.

  • radar — presence and motion from Wi-Fi CSI (radar::csi) and the HLK-LD2410 mmWave UART protocol (radar::ld2410).
  • link — the mID-authenticated session and the MAC’d frame envelope every ESP-NOW and LoRa frame travels in.
  • wifi — credentials that never print, and the station policy (reconnect back-off, fallback to provisioning).
  • ble — the GATT table (provisioning, manifest, telemetry) as data.
  • lora — modem parameters, exact time-on-air, region duty cycle, the discovery beacon.

Rules this crate lives by (from the Janus mission plan):

  1. no_std by default; alloc is a feature, never an assumption.
  2. No drivers, no HAL types, no esp-* crate, no allocator. Backends live in rusty_esp_signal-esp.
  3. Every type that crosses to another Janus package comes from rusty_esp_core; identity comes from rusty_esp_mid-core.
  4. Frames and buffers are borrowed over caller-owned memory; nothing here allocates per frame on a hot path.
  5. forbid(unsafe). Detectors are fixed-point and developed on the host from recorded captures against an external oracle before any radio.
  6. Sign the session, MAC the frames: P-256 ECDH under the device DID for the session key, HMAC-SHA256 truncated to 16 bytes per frame.

Re-exports§

pub use rusty_esp_core as esp_core;
pub use rusty_esp_mid_core as mid;

Modules§

ble
The Janus GATT table as data: three services (provisioning, manifest, telemetry), their characteristics, and the 128-bit UUIDs they live under.
link
The authenticated link every ESP-NOW and LoRa frame travels in.
lora
LoRa modem parameters, exact time-on-air, the regional duty-cycle budget and the unauthenticated discovery beacon.
prelude
The names a sketch or firmware wants in scope.
provision
BLE provisioning: the provisioning service carries the setup session.
radar
Radar: presence, motion and breathing without a camera.
setup
The setup session’s cryptographic core (enc-ble M1): the protocol of docs/setup-protocol.md in the Janus umbrella, v1, suite 1.
wifi
Wi-Fi station credentials that never print, the TLV they travel in over BLE provisioning, the station reconnect policy and RSSI statistics.

Constants§

VERSION
Crate version, for capability manifests and logs.