swaits
d636259470
Switch from the third-party cobs crate to ucobs — the same COBS implementation used by the firmware. Keeps the entire stack on one COBS library.
38 lines
1.0 KiB
Markdown
38 lines
1.0 KiB
Markdown
# DongLoRa Rust Client
|
|
|
|
Rust client library for talking to a DongLoRa device — either directly
|
|
over USB or through the [mux daemon](../../mux/).
|
|
|
|
## What's in Here
|
|
|
|
- `src/protocol.rs` — wire protocol types (`RadioConfig`, `Command`, `Response`, `ErrorCode`)
|
|
- `src/codec.rs` — COBS framing, frame accumulator
|
|
- `src/discovery.rs` — USB VID:PID device discovery
|
|
- `src/transport.rs` — serial and mux socket transports
|
|
- `src/client.rs` — high-level `Client<T>` with send/recv
|
|
- `src/connect.rs` — auto-detection (mux socket, TCP, direct USB)
|
|
|
|
## Usage
|
|
|
|
```rust
|
|
use donglora_client::*;
|
|
|
|
let mut client = connect_default()?;
|
|
client.ping()?;
|
|
client.set_config(RadioConfig::default())?;
|
|
client.start_rx()?;
|
|
|
|
loop {
|
|
if let Some(Response::RxPacket { rssi, snr, payload }) = client.recv()? {
|
|
println!("RX rssi={rssi} snr={snr} len={}", payload.len());
|
|
}
|
|
}
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
- `ucobs` — COBS framing (same implementation as the firmware)
|
|
- `serialport` — USB serial communication
|
|
- `anyhow` — error handling
|
|
- `tracing` — logging
|