Revision as of 22:51, 5 May 2016

Protocole série / UDP

• SSID WIFI : LEDTUBE
• WIFI protection : OPEN
• DHCP activé
• DHCP Range : 192.168.1.1 - 192.168.1.???
• Adresse IP du module WIFI sur le réseau WIFI : 192.168.1.0
• Masque sous réseau 255.255.255.0
• Numéro de port UDP : 5125 (decimal)

Une interface UDP/IP est offerte pour y injecter des images et envoyer des commandes.
Le système n'envoie jamais rien vers le device connecté.

La limitation de débit est liée à la liaison série entre le MCU et le module WIFI. Elle est à 115200 bauds. Soit un débit utile proche de 92kbits/s.

Le système ne peut recevoir que les choses suivantes

• une commande ON/OFF sortie de veille, mise en veille
• des images en RAW en trois trame UDP pour les images fixes
• une commande d'initialisation de la translation (nombre flottant dans [-1,1]).
• un vecteur vitesse de translation horizontale (nombre flottant dans [-1,1]). En tours par seconde.
• une demande de changement de mode de génération d'image.
• une commande d'intensité lumineuse exploitée par certains modes (8,9,10,?)

Il n'est pas nécessaire de limiter le nombre de commande par trame UDP à 1. Le parser gère les données reçues comme un stream continu.

Les commandes ne sont jamais acknoledgées. Le système n'envoie jamais rien en réponse, quoi qu'il arrive. Aucun message spontané non plus.

Il est à noter que le passage en TCP ne demanderait que très peu de changement dans la mesure où en réalité, le parser gère un stream.

Pas de notion de sprites. Pas de notions de couches superposées transparentes. On va pas refaire le chipset de l'amiga.

Les commandes sont aussi exprimées en syntaxe sprintf.

Par exemple, la commande POS qui a un paramètre variable en nombre flottant à nombre de décimales fixe est documentée en utilisant le formatage de la commande en langage C sprintf.

float pos;
sprintf(s,"LEDTUBE:POS:%+01.4f$$",pos);

Les Commandes

Commande On/Off

• "LEDTUBE:OFF:$$" (exemple)

Commande init translation, exprimée en unité de tour. Paramètre = Nombre flottant à virgule fixe dans [-1,1]

• "LEDTUBE:POS:???????$$" (masque parser de commande)
• "LEDTUBE:POS:%+01.4f$$" (syntaxe sprintf pour le formatage en C)
• "LEDTUBE:POS:+0.2445$$" (exemple)
• "LEDTUBE:POS:-0.1200$$" (exemple)

Commande vecteur vitesse de translation horizontale, exprimé en tours par seconde. Paramètre = Nombre flottant à virgule fixe dans [-1,1]

• "LEDTUBE:SPD:???????$$" (masque parser de commande)
• "LEDTUBE:SPD:%+01.4f$$" (syntaxe sprintf pour le formatage en C)
• "LEDTUBE:SPD:-0.1112$$" (exemple)

Commande Image Raw

• "LEDTUBE:RAW:" (masque parser de commande)
• "LEDTUBE:RAW:[RGB](1200x)" (pseudo syntaxe)
• "LEDTUBE:RAW:RGBRGBRGBRGB..." (exemple.Nota : il n'y a pas de $$ à la fin)
• En raison des limitations du module WIFI, les images peuvent être envoyées en un minimum de 3 trames UDP de taille 1212,1200,1200. Ou bien 4 trames UDP de taille 12,1200,1200,1200
• Respecter un délai entre chaque envoi de trame d'au moins 94ms.
• La durée totale d'envoi ne doit pas dépasser 5 secondes (time out).
• Le code source fourni dans le package complet : sendrawbyudp.cpp , ltraw.exe permet de faire ça sur PC.

Changement de mode. Paramètre entier en hexadecimal dans [0000..]

• "LEDTUBE:MOD:????$$" (masque parser de commande)
• "LEDTUBE:MOD:%04X$$" (syntaxe sprintf pour le formatage en C)
• "LEDTUBE:MOD:000A$$" (exemple)

Changement de l'intensité lumineuse (dans certains modes). Paramètre entier hexadecimal dans [0000..00FF]

• "LEDTUBE:INT:????$$" (masque parser de commande)
• "LEDTUBE:INT:%04X$$" (syntaxe sprintf pour le formatage en C)
• "LEDTUBE:INT:008A$$" (exemple)

Les Modes (MOD)

Modes (decimal)

• 0 : le système passe dans ce mode à chaque réception d'une image RAW.
• 1..5 : plasma dynamique
• 6 : 6 space invaders RGB
• 7 : image noire
• 8 : image blanche
• 9 : image jaune
• 10 : 3 logos Electrolab Verts
• 11 : jeu de la vie (le feature creep commence)
• etc...