nand-nor / radio-hal

Embedded rust radio abstraction crate

Rust IoT Radio Abstraction(s)

An embedded-hal like abstraction for digital radio devices, this is intended to provide a common basis for implementing packet radio drivers, and for extension to support 802.15.4 / BLE etc. in the hope that we can construct embedded network stacks using this common abstraction.

Radio devices should implement the core traits, and then gain automatic blocking helper functions. Experimental async/await helpers are available behind the nonblocking feature flag, this uses dtolnay/async-trait, imports std and async-std, and requires a nightly compiler, and a MockRadio implementation for testing is available behind the mock feature flag (also requiring nightly).

Status

Work In Progress, expect major API changes

Open Issues

Features:

• Generic Traits
  • Transmit
  • Receive
  • Set Channel
  • Fetch RSSI
  • Register Access
  • Configuration (?)
• Mode Specific Traits (and definitions)
  • 802.15.4
  • BLE
  • LoRa
• Helpers
  • Blocking
  • Async

Examples

• ryankurte/rust-radio-sx127x
• ryankurte/rust-radio-sx128x
• ryankurte/rust-radio-at86rf212
• ryankurte/rust-radio-s2lp

For similar interfaces, check out:

• Riot-OS
  • netdev.h
  • ieee802154.h netdev_ieee802154.c
• Contiki-OS
  • core/dev/radio.h
• Tock-PS
  • ieee802154/device.rs