drew-connect
Couche d'I/O et de décodage de télémétrie, agnostique et modulaire, pensée pour relier du matériel embarqué à drew-sim ou à n'importe quelle application qui a besoin de lire un flux d'octets en arrière-plan et d'en récupérer des paquets décodés sans bloquer sa boucle principale.
Les trois briques
La bibliothèque tient en trois pièces, chacune remplaçable indépendamment :
| Brique | Rôle | Implémentations fournies |
|---|---|---|
Transport |
Fournit des octets bruts | SerialTransport (UART/USB), UdpTransport (Wi-Fi/Ethernet) |
Decoder |
Traduit ces octets en un paquet typé | BinaryDecoder, JsonDecoder (produisent tous deux TelemetryPacket) |
ConnectionWorker |
Fait tourner Transport + Decoder dans un thread et expose un canal non bloquant |
— |
Transport et Decoder ne se connaissent pas : ConnectionWorker est le seul point qui les assemble. Vous pouvez donc changer de transport sans toucher au décodage, et inversement.
Installation
Aucune feature n'est activée par défaut n'ajoutez que ce dont vous avez besoin :
[]
= { = "0.1", = ["udp"] }
| 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 et TelemetryPacket sont toujours disponibles, sans feature.
Démarrage rapide
Trois étapes, toujours les mêmes quel que soit le transport ou le format choisi :
1. Ouvrir un transport
use UdpTransport;
let transport = bind?;
# Ok::
2. Choisir un décodeur ici le format binaire compact, adapté à un microcontrôleur :
use BinaryDecoder;
let decoder = BinaryDecoder;
3. Démarrer le worker et lire les paquets
# use ;
# let transport = bind?;
let worker = spawn;
// Dans votre boucle de rendu ou de mise à jour :
if let Some = worker.try_recv
# Ok::
worker lit en continu dans un thread séparé ; try_recv / drain_latest ne bloquent jamais, ce qui les rend sûrs à appeler depuis une boucle de rendu à 60 FPS.
Exemple complet
Une boucle qui écoute des trames binaires sur UDP et n'affiche que le dernier paquet reçu à chaque tick (utile quand la fréquence d'émission dépasse la fréquence d'affichage) :
use ;
use Duration;
Ce même code se lance directement depuis le crate :
Pour prototyper en JSON plutôt qu'en binaire, seule l'étape 2 change :
# use ;
use JsonDecoder;
# let transport = bind?;
let worker = spawn;
# Ok::
(nécessite la feature json, et que le microcontrôleur envoie des lignes du type {"position":[0.0,1.2,0.5],"rotation":[0.1,0.0,0.3],"timestamp_ms":1024}).
Utiliser un port série
Identique, avec SerialTransport (feature serial) à la place d'UdpTransport :
use ;
let transport = new?;
let worker = spawn;
# Ok::
Créer son propre transport ou décodeur
Un format ou un canal maison n'a pas besoin de vivre dans ce crate, il suffit d'implémenter le trait correspondant dans votre propre code :
use Decoder;
;
ConnectionWorker::spawn(mon_transport, MonDecodeur) fonctionne alors exactement comme avec les types fournis par le crate.
License
GPL-2.0-or-later