Projet

Général

Profil

Protocole EthernetWifi V1 » Historique » Version 1

Anonyme, 11/12/2012 21:50

1 1 Anonyme
h1. Protocole EthernetWifi V1
2
3
h2. Généralités
4
5
Le protocole de communication privilégié est l'UDP.
6
7
Toutes les valeurs numériques (récupérées depuis un capteur ou transmises comme consigne) doivent être converties de sorte que leurs valeurs varient entre -16000 (valeur minimale théoriquement atteignable) et 16000 (valeur maximale théoriquement atteignable). 
8
Un champ de valeur aussi important garantissant une précision en principe suffisante pour les calculs à effectuer par la suite.
9
10
L'usage de int16_t définis dans stdint.h peut donc être pertinent dans le cadre des manipulations de ces valeurs.
11
12
Une formule permettant d'obtenir un formatage efficace est : *Val_formatée = (32000 . (Val_Réelle - Val_Min)/(Val_Max - Val_Min)) - 16000*
13
Attention : les calculs doivent être réalisés en float afin d'éviter des pertes importantes au cours de la division.
14
15
Si ce choix semble non pertinent merci de nous contacter.
16
17
_(Par ailleurs, de manière plus générale, l'usage des variables définies dans stdint.h pourrait être un gage de portabilité, il me semble donc pertinent d'envisager de les préférer aux variables par défaut.)_
18
19
*Attention : à l'issue de ce formatage, le 0 ne désigne pas nécessairement la position neutre ou le 0 conventionnel. Cela ne sera vrai que si l'intervalle des valeurs d'origine est centré en 0 (val_min = -val_max).*
20
21
---------------------------------------------------
22
23
Le format de trame sera le suivant :
24
*
25
<NUM_PAQUET><!><TYPE_TRAME><< ?>|<<:><VAL>[,VAL[,...]]>><CRLF>*
26
27
Avec :
28
29
<NUM_PAQUET> : numéro du paquet, auto-incrémental, sur 4 chiffres, non signé, en décimal. 
30
31
<!> : caractère "!" utilisé comme séparateur
32
33
<TYPE_TRAME> : suite de 2 caractères en ASCII indiquant les informations portées par la trame (voir plus bas)
34
35
<< ?>|<<:><VAL>[,VAL[,...]]>> valant soit :
36
       -- "?" dans le cadre de la demande d'une (série de) valeurs
37
       -- ":" suivi d'une série de valeurs séparés par des virgules
38
39
<CRLF> : caractères "\r\n"
40
41
h2. Liste des TYPE_TRAME
42
43
les TYPES_TRAME sont des suites de 2 caractères ASCII
44
45
h3. TYPE_TRAME commençant par un 0
46
47
Ces types sont réservés à des fins de test et ne doivent pas être utilisé dans le cadre d'une implémentation finale.
48
49
h3. TYPE_TRAME commençant par un 1
50
51
Ces types sont réservés à la transmission des erreurs.
52
53
h3. Capteurs
54
55
"Ca" suivi d'une série de 11 valeurs est utilisé pour envoyer l'ensemble des valeurs des capteurs dans l'ordre suivant :
56
accéléro_x, accéléro_y,accéléro_z,gyro_x,gyro_y,gyro_z,magnéto_x,magnéto_y,magnéto_z,baromètre,thermomètre
57
58
h4. Accéléromètres
59
60
"Ax" suivi d'une valeur correspond à l'accéléromètre x
61
"Ay" suivi d'une valeur correspond à l'accéléromètre y
62
"Az" suivi d'une valeur correspond à l'accéléromètre z
63
"Aa" suivi de trois valeurs correspond aux valeurs des trois accéléromètres dans l'ordre x,y,z
64
65
h4. Gyroscopes
66
67
"Gx" suivi d'une valeur correspond au gyroscope x
68
"Gy" suivi d'une valeur correspond au gyroscope y
69
"Gz" suivi d'une valeur correspond au gyroscope z
70
"Ga" suivi de trois valeurs correspond aux valeurs des trois gyroscopes dans l'ordre x,y,z
71
72
h4. Magnétomètre
73
74
"Ax" suivi d'une valeur correspond au magnétomètre x
75
"Ay" suivi d'une valeur correspond au magnétomètre y
76
"Az" suivi d'une valeur correspond au magnétomètre z
77
"Aa" suivi de trois valeurs correspond aux valeurs des trois magnétomètres dans l'ordre x,y,z
78
79
h4. Sonars
80
81
"Sf" suivi d'une valeur correspond au sonar avant (front)
82
"Sb" suivi d'une valeur correspond au sonar arrière (back)
83
"Sl" suivi d'une valeur correspond au sonar gauche (left)
84
"Sr" suivi d'une valeur correspond au sonar droit (right)
85
"Su" suivi d'une valeur correspond au sonar haut (up)
86
"Sd" suivi d'une valeur correspond au sonar bas (down)
87
"S6" suivi de 6 valeurs correspond à la valeur des 6 sonars (ordre : avant, arrière, gauche, droite, bas, haut)
88
89
h4. Autres capteurs
90
91
"B0" suivi d'une valeur correspond au baromètre
92
"TH" suivi d'une valeur correspond au thermomètre
93
"GP" suivi de 8 valeurs correspond aux valeurs du GPS (ordre à définir)
94
95
h3. Moteurs
96
97
98
h4. Du drone vers le contrôleur
99
100
"M1" suivi d'une valeur correspond à la valeur actuelle du moteur 1
101
"M2" suivi d'une valeur correspond à la valeur actuelle du moteur 2
102
"M3" suivi d'une valeur correspond à la valeur actuelle du moteur 3
103
"M4" suivi d'une valeur correspond à la valeur actuelle du moteur 4
104
"Me" suivi de 4 valeurs correspond à la valeur actuelle des 4 moteurs (1,2,3,4)
105
"Mc" suivi d'une valeur correspond à la valeur actuelle de la consigne moteur
106
"M+" suivi de 5 valeurs correspond à la valeur actuelle des 4 moteurs suivi de la consigne moteur
107
108
h4. Du contrôleur vers le drône
109
110
"M1" suivi d'une valeur correspond à la valeur à atteindre pour le moteur 1
111
"M2" suivi d'une valeur correspond à la valeur à atteindre pour le moteur 2
112
"M3" suivi d'une valeur correspond à la valeur à atteindre pour le moteur 3
113
"M4" suivi d'une valeur correspond à la valeur à atteindre pour le moteur 4
114
"Me" suivi de 4 valeurs correspond à la valeur à atteindre pour les 4 moteurs (1,2,3,4)
115
"Mc" suivi d'une valeur correspond à la valeur à atteindre pour la consigne moteur
116
"M+" suivi de 5 valeurs correspond à la valeur à atteindre pour les 4 moteurs suivi de la consigne moteur
117
118
h2. Exemples
119
120
On aura ainsi par exemple 
121
122
123
0010!Gx?
124
125
correspond au dixième message échangé, le contrôleur demande au drone la valeur de son gyroscope en x
126
127
0011!Gx:21
128
129
serait la réponse du drone
130
131
ou encore 
132
133
0101!0B:21,22,58
134
135
Qui serait le 101e message d'une série, utilisant un protocole de test (commençant par 0) et renvoyant 3 valeurs
136
137
138
-----------------------------------------------------------------------------
139
140
*_Notes :_*
141
_1) La présence de bits de bourrage en fin de trames peut être envisagée et pourrait être décidée dans le cadre d'une révision ultérieure de ce document_
142
_2) Ce protocole est encore une ébauche, il est susceptible d'être modifié par la suite_
143
_3) Ce protocole constitue un premier jet destiné à la phase de conception initiale du système, l'optimisation de la vitesse n'est pas privilégiée ici_
144
_4) Ce protocole sera probablement fortement étendu voire totalement abandonné lors de développement ultérieurs du projet, les implémentations de divers protocoles doivent donc pouvoir être interverties aisément au sein du code réalisé (au besoin à l'aide de pattern adéquats). Les révisions cités son suceptibles d'affecter profondément la forme des trames mais aussi de manière non négligeable les informations transmises_
145
146
147
-----------------------------------------------------------------------------
148
149
_+Dernière révision : 11/12/2012 21h30+_
150
_+Auteurs : Couma Joani -- Faure Axel+_