swaits
a0fbd150cf
Replace hardcoded USB serial "001" with the board's MAC address so multiple dongles are uniquely identifiable on one host. Thread MAC through usb_task as a parameter, removing the Board import. Add 31 unit tests for protocol serialization: RadioConfig roundtrips, all Command tags, all Response variants, validation boundaries, and edge cases. Gate firmware modules with #[cfg(not(test))] and add DONGLORA_HOST_TEST env var so `just test` runs on the host.
100 lines
2.5 KiB
Rust
100 lines
2.5 KiB
Rust
//! DongLoRa firmware — transparent LoRa radio over USB.
|
|
//!
|
|
//! Three async tasks communicate via static channels:
|
|
//!
|
|
//! ```text
|
|
//! usb_task ──Command──► radio_task ──► SX1262
|
|
//! ◄──Response── │
|
|
//! StatusWatch
|
|
//! ▼
|
|
//! display_task (optional)
|
|
//! ```
|
|
//!
|
|
//! The host drives everything. The radio idles until commanded.
|
|
|
|
#![cfg_attr(not(test), no_std)]
|
|
#![cfg_attr(not(test), no_main)]
|
|
|
|
#[cfg(not(test))]
|
|
mod board;
|
|
#[cfg(not(test))]
|
|
mod channel;
|
|
#[cfg(not(test))]
|
|
mod display;
|
|
mod protocol;
|
|
#[cfg(not(test))]
|
|
mod radio;
|
|
#[cfg(not(test))]
|
|
mod usb;
|
|
|
|
#[cfg(not(test))]
|
|
use embassy_executor::Spawner;
|
|
|
|
#[cfg(not(test))]
|
|
use crate::board::LoRaBoard;
|
|
#[cfg(not(test))]
|
|
use crate::channel::{CommandChannel, DisplayCommandChannel, ResponseChannel, StatusWatch};
|
|
|
|
#[cfg(not(test))]
|
|
cfg_if::cfg_if! {
|
|
if #[cfg(feature = "rak_wisblock_4631")] {
|
|
use panic_probe as _;
|
|
} else if #[cfg(any(feature = "heltec_v3", feature = "heltec_v4"))] {
|
|
use esp_backtrace as _;
|
|
use esp_println as _;
|
|
}
|
|
}
|
|
|
|
#[cfg(not(test))]
|
|
static COMMANDS: CommandChannel = CommandChannel::new();
|
|
#[cfg(not(test))]
|
|
static RESPONSES: ResponseChannel = ResponseChannel::new();
|
|
#[cfg(not(test))]
|
|
static STATUS: StatusWatch = StatusWatch::new();
|
|
#[cfg(not(test))]
|
|
static DISPLAY_COMMANDS: DisplayCommandChannel = DisplayCommandChannel::new();
|
|
|
|
#[cfg(not(test))]
|
|
cfg_if::cfg_if! {
|
|
if #[cfg(feature = "rak_wisblock_4631")] {
|
|
#[embassy_executor::main]
|
|
async fn main(spawner: Spawner) {
|
|
run(spawner).await;
|
|
}
|
|
} else if #[cfg(any(feature = "heltec_v3", feature = "heltec_v4"))] {
|
|
#[esp_rtos::main]
|
|
async fn main(spawner: Spawner) {
|
|
run(spawner).await;
|
|
}
|
|
}
|
|
}
|
|
|
|
#[cfg(not(test))]
|
|
async fn run(spawner: Spawner) {
|
|
let board = <board::Board as LoRaBoard>::init();
|
|
let mac = board::Board::mac_address();
|
|
let (radio, usb, display) = board.into_parts();
|
|
|
|
let has_display = display.is_some();
|
|
|
|
spawner
|
|
.spawn(radio::radio_task(radio, &COMMANDS, &RESPONSES, &STATUS))
|
|
.expect("spawn radio_task");
|
|
spawner
|
|
.spawn(usb::usb_task(
|
|
usb,
|
|
&COMMANDS,
|
|
&RESPONSES,
|
|
&DISPLAY_COMMANDS,
|
|
has_display,
|
|
mac,
|
|
))
|
|
.expect("spawn usb_task");
|
|
|
|
if let Some(dp) = display {
|
|
spawner
|
|
.spawn(display::display_task(dp, &STATUS, &DISPLAY_COMMANDS))
|
|
.expect("spawn display_task");
|
|
}
|
|
}
|