Skip to main content

Crate drew_connect

Crate drew_connect 

Source
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 sur Output, 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/Decoder factice, sans matériel réel

§Features

FeatureAjouteDébloque
jsonserde, serde_jsonJsonDecoder, dérive Serialize/Deserialize sur TelemetryPacket
serialserialportSerialTransport (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;

Modules§

decoder
Décodage d’octets bruts en paquets typés.
transport
Abstraction des canaux de communication (source d’octets bruts).
worker
Thread de fond reliant un Transport à un Decoder via un canal non bloquant.