Spécifications du protocole

Protocole de communication Asycube

Le protocole de communication du contrôleur hôte utilise uniquement des caractères ASCII et est conçu pour les réseaux de communication. L’ordinateur hôte est toujours le client. Les serveurs ne transmettent qu’après avoir reçu un message du client.

Format de commande / réponse

Command: Begin, Command, End, CRLF
Response: Begin, Response, End, CRLF

Début

Le caractère ASCII { doit être le premier caractère du paquet, ce qui permet de détecter un nouveau paquet.

Commande

Ce champ contient les caractères ASCII qui précisent l’objet du message. Les Commandes disponibles sont listées plus loin dans la documentation.

Réponse

Ce champ contient un format défini qui spécifie la validation de l’instruction. L’Asycube fournit un message de réponse correspondant à chaque instruction.

Fin

Le caractère ASCII } doit être placé juste après la commande ou la réponse.

CRLF

Les caractères ASCII retour chariot 0x0D (également connu sous la forme \r) et saut de ligne 0x0A (également connu sous la forme \n) sont les deux derniers octets du paquet, tant pour l’envoi que pour la réception.

Tableau 16 Caractère ASCII

0 à 9	non sensible à la casse
a à z, A à Z
{	début du paquet
:	spécifie une opération de lecture
=	spécifie une opération d’écriture
}	fin du paquet
( ou ) ou ;	délimiteurs spéciaux
CR	0x0D Retour chariot
LF	0x0A Saut de ligne

Remarque

Pour plus d’informations sur les commandes disponibles, voir le chapitre Commandes.

Codes d’erreur

La réponse en série donne un code d’erreur sous la forme d’une valeur entière. Vous devez convertir la valeur en binaire pour obtenir le bit d’erreur concerné. Par exemple, une réponse {Er00004} signifie que le système ne reconnaît pas le premier caractère de la commande.

Tableau 17 Codes d’erreur de communication

Binaire	Bit d’erreur	Message
[00001]	0	Erreur de syntaxe dans la chaîne de caractères du message !
[00002]	1	Erreur de conversion d’une chaîne de caractères en nombres entiers ! , even/off selon la lecture/écriture
[00004]	2	Premier caractère de la commande inconnu !
[00008]	3	Deuxième caractère de la commande inconnu !
[00016]	4	Erreur de valeur de paramètre !
[00032]	5	Erreur de valeur 0 de la durée de vibration de la séquence !
[00064]	6	Erreur d’accès à l’ID du set de vibrations ou pour cause d’ID de séquence 26 !
[00128]	7	Non utilisé
[00256]	8	La mémoire tampon de réception est pleine !
[00512]	9	Réception de la fin du message } mais la mémoire tampon de réception est pleine !
[01024]	10	Réception de la fin du message } mais absence du début du message { !
[02048]	11
[04096]	12	Erreur de cadrage détectée !
[08192]	13	Erreur de parité détectée !
[16384]	14	Erreur de débordement détectée !
[32768]	15	Contrôle du délai pour la réception du message complet !