Bluefruit-LE-Shield-ATCommands
En cours de traduction/élaboration. |
A propos des commandes AT
Le module Bluefruit LE utilise un ensemble de commandes type "AT" (Hayes) pour configurer le périphérique.
L'avantage des commandes de type "AT" c'est qu'elles sont faciles à utiliser dans une communication machine-à-machine, tout en restant assez facile à lire/interpréter pour les humains.
Le mode: commande de test '=?'
Le mode de 'Test' est utiliser pour vérifier si une commande donnée existe (ou pas) dans le système.
Certaines versions de firmware ou certaines configurations pourraient (ou ne pourraient pas) inclure une commande spécifique. Vous pouvez tester la présence de la commande en saisissant le nom de la commande et en y ajoutant "=?" (comme dans l'exemple suivant:
AT+BLESTARTADV=?
Le périphérique réponde "OK" si la commande est présente. Si la commande n'existe pas alors le périphérique répondra "ERROR".
AT+BLESTARTADV=? OK\r\n AT+MISSINGCMD=? ERROR\r\n
Les mentions de \r et \n représentent respectivement le retour à la ligne et passage à la ligne suivante. Ces caractère sont rarement affichés tels quels... mais il est important de savoir qu'il sont présents si vous faite dialoguer des machines ensembles. |
le mode: commandes en écriture '=xxx'
Le mode en écriture (Write en anglais) est utilisé pour pour assigner des valeurs spécifiques à la commande. Par exemple: changer le niveau de puissance du transmetteur radio. Cela permet de réduire la puissance pour économiser facilement de l'énergie. Voyez l'exemple ci-dessous:
Pour écrire une valeur pour la commande, ajoutez simplement un signe '=' à la commande suivit du paramètre/valeur que vous voulez fixer/écrire. La valeur doit être différente de '?' sinon la commande sera interprétée comme un mode de test:
AT+BLEPOWERLEVEL=-8
Si l'opération d'écriture est exécuté avec succès alors vous obtiendrez (en général) une réponse "OK" sur une nouvelle ligne. Voyez l'exemple ci-dessous:
AT+BLEPOWERLEVEL=-8 OK\r\n
S'il y a un problème avec la commande (comme un paramètre/valeur invalid), le module renverra la réponse 'ERROR' sur une nouvelle ligne. Voyez l'exemple ci-dessous:
AT+BLEPOWERLEVEL=3 ERROR\r\n
Note: Une erreur est générée dans ce cas particulier car la valeur '3' n'est pas valide pour la commande AT+BLEPOWERLEVEL . Saisir les valeurs '-4', '0' ou '4' seront acceptées car elles font parties des valeurs acceptées pas cette commande.
Le mode d'exécution
Le mode d'exécution provoque l'exécution d'une commande spécifique, si cela est possible, et sera utilisé lorsque le nom de la commande est saisit dans paramètres additionnel.
AT+FACTORYRESET
Vous devriez
En cours de traduction/élaboration. |
You might use execute mode to perform a factory reset, for example, by executing the AT+FACTORYRESET command as follows:
AT+FACTORYRESET OK\r\n
NOTE: Many commands that are means to be read will perform the same action whether they are sent to the command parser in 'execute' or 'read' mode. For example, the following commands will produce identical results:
AT+BLEGETPOWERLEVEL -4\r\n OK\r\n AT+BLEGETPOWERLEVEL? -4\r\n OK\r\n
If the command doesn't support execute mode, the response will normally be "ERROR" on a new line.
Mode commande de lecture '?'
'Read' mode is used to read the current value of a command.
Not every command supports read mode, but you generally use this to retrieve information like the current transmit power level for the radio by appending a '?' to the command, as shown below:
AT+BLEPOWERLEVEL?
If the command doesn't support read mode or if there was a problem with the request, you will normally get an "ERROR" response.
If the command read was successful, you will normally get the read results followed by "OK" on a new line, as shown below:
AT+BLEPOWERLEVEL? -4\r\n OK\r\n
Note: For simple commands, 'Read' mode and "Execute" mode behave identically.
Basé sur "Bluefruit LE Shield" d'Adafruit Industries, écrit par
Kevin Townsend - Traduit en Français par shop.mchobby.be CC-BY-SA pour la traduction
Toute copie doit contenir ce crédit, lien vers cette page et la section "crédit de traduction".
Based on "Bluefruit LE Shield" from Adafruit Industries, written by
Kevin Townsend - Translated to French by shop.mchobby.be CC-BY-SA for the translation
Copies must includes this credit, link to this page and the section "crédit de traduction" (translation credit).
Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com