Expand description
§drew-connect
Couche d’I/O et de décodage de télémétrie, agnostique et modulaire.
La bibliothèque repose sur deux traits totalement indépendants l’un de l’autre :
Transport: une source d’octets bruts (port série, socket UDP, fichier, mock de test, etc.)Decoder: la traduction de ces octets en un type de paquet quelconque (le trait est générique surOutput, il ne connaît donc rien de spécifique à la télémétrie)
ConnectionWorker assemble les deux dans un thread de fond et expose
un canal non bloquant. Grâce à cette séparation :
- un transport peut être remplacé par un autre sans toucher au décodeur (ni réciproquement)
- un format propriétaire peut être décodé sans dépendre de JSON ni de
serde - les tests peuvent utiliser un
Transport/Decoderfactice, sans matériel réel
§Features
| Feature | Ajoute | Débloque |
|---|---|---|
json | serde, serde_json | JsonDecoder, dérive Serialize/Deserialize sur TelemetryPacket |
serial | serialport | SerialTransport (UART/USB) |
udp | (rien, std uniquement) | UdpTransport (Wi-Fi/Ethernet) |
BinaryDecoder est toujours disponible : il ne dépend que de
core/std, aucune feature requise.
Aucune feature n’est activée par défaut : ajoutez uniquement celles dont votre binaire a besoin.
§Exemple minimal
use drew_connect::{ConnectionWorker, UdpTransport, BinaryDecoder};
let transport = UdpTransport::bind("0.0.0.0:9000")?;
let worker = ConnectionWorker::spawn(transport, BinaryDecoder);
if let Some(packet) = worker.try_recv() {
println!("{packet:?}");
}§Étendre la bibliothèque
Un décodeur ou un transport maison n’a pas besoin de vivre dans ce
crate : il suffit d’implémenter Decoder ou Transport dans votre
propre code, puis de le passer à ConnectionWorker::spawn comme
n’importe quelle implémentation fournie ici.
Re-exports§
pub use decoder::BinaryDecoder;pub use decoder::Decoder;pub use decoder::TelemetryPacket;pub use transport::Transport;pub use worker::ConnectionWorker;