Différences entre versions de « Bluefruit-LE-Shield-ATCommands »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
(Page créée avec « {{Bluefruit-LE-Shield-NAV}} {{traduction}} == A propos des commandes AT == The Bluefruit LE modules use a [http://en.wikipedia.org/wiki/Hayes_command_set Hayes AT-style c... »)
 
 
(14 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Bluefruit-LE-Shield-NAV}}
 
{{Bluefruit-LE-Shield-NAV}}
  
−
{{traduction}}
 
 
== A propos des commandes AT ==
 
== A propos des commandes AT ==
−
The Bluefruit LE modules use a [http://en.wikipedia.org/wiki/Hayes_command_set Hayes AT-style command] set to configure the device.
+
Le module Bluefruit LE utilise un ensemble de [http://en.wikipedia.org/wiki/Hayes_command_set commandes type "AT" (Hayes)] pour configurer le périphérique.
  
−
The advantage of an AT style command set is that it's easy to use in machine to machine communication, while still being somewhat user friendly for humans.
+
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.
  
−
== Mode commande de test '=?' ==
+
== Commande de test '=?' ==
−
'Test' mode is used to check whether or not the specified command exists on the system or not.   
+
Le mode de 'Test' est utiliser pour vérifier si une commande donnée existe (ou pas) dans le système.   
  
−
Certain firmware versions or configurations may or may not include a specific command, and you can determine if the command is present by taking the command name and appending "'''=?'''" to it, as shown below
+
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:
  
 
  <nowiki>AT+BLESTARTADV=?</nowiki>
 
  <nowiki>AT+BLESTARTADV=?</nowiki>
  
−
If the command is present, the device will reply with "'''OK'''".  If the command is not present, the device will reply with "'''ERROR'''".
+
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'''".
  
 
  <nowiki>AT+BLESTARTADV=?
 
  <nowiki>AT+BLESTARTADV=?
Ligne 21 : Ligne 20 :
 
ERROR\r\n</nowiki>
 
ERROR\r\n</nowiki>
  
−
== Mode commande d'écriture '=xxx' ==
+
{{ambox|text=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. }}
−
'Write' mode is used to assign specific value(s) to the command, such as changing the radio's transmit power level using the command we used above.
 
  
−
To write a value to the command, simple append an ''''='''' sign to the command followed by any paramater(s) you wish to write (other than a lone ''''?'''' character which will be interpretted as tet 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:
  
 
  <nowiki>AT+BLEPOWERLEVEL=-8</nowiki>
 
  <nowiki>AT+BLEPOWERLEVEL=-8</nowiki>
  
−
If the write was successful, you will generally get an "'''OK'''" response on a new line, as shown below:
+
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:
  
 
  <nowiki>AT+BLEPOWERLEVEL=-8
 
  <nowiki>AT+BLEPOWERLEVEL=-8
 
OK\r\n</nowiki>
 
OK\r\n</nowiki>
  
−
If there was a problem with the command (such as an invalid parameter) you will get an 'ERROR' response on a new line, as shown below:
+
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:
  
 
  <nowiki>AT+BLEPOWERLEVEL=3
 
  <nowiki>AT+BLEPOWERLEVEL=3
 
ERROR\r\n</nowiki>
 
ERROR\r\n</nowiki>
  
−
'''Note:''' This particular error was generated because '3' is not a valid value for the AT+BLEPOWERLEVEL command. Entering '-4', '0' or '4' would succeed since these are all valid values for this command.
+
'''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.
  
−
== Mode d'exécution ==
+
== Commandes en mode exécution ==
−
'Execute' mode will cause the specific command to 'run', if possible, and will be used when the command name is entered with no additional parameters.
+
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.
  
 
  <nowiki>AT+FACTORYRESET</nowiki>
 
  <nowiki>AT+FACTORYRESET</nowiki>
  
−
You might use execute mode to perform a factory reset, for example, by executing the AT+FACTORYRESET command as follows:
+
Vous devriez utiliser le mode d'exécution pour effectuer une réinitialisation d'usine (''factory reset'') en exécutant la commande  AT+FACTORYRESET comme ci-dessous:
  
 
  <nowiki>AT+FACTORYRESET
 
  <nowiki>AT+FACTORYRESET
 
OK\r\n</nowiki>
 
OK\r\n</nowiki>
  
−
'''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:
+
'''NOTE:''' De nombreuses commandes destinées à être utilisées en mode lecture produirons un résultat identique (donc une 'lecture') lorsqu'elles sont utilisées en mode exécution.  
 +
 
 +
Par exemple, les deux commandes suivantes produisent le même résultat (mode exécution d'abord, mode lecture ensuite):
  
 
  <nowiki>AT+BLEGETPOWERLEVEL
 
  <nowiki>AT+BLEGETPOWERLEVEL
Ligne 59 : Ligne 62 :
 
OK\r\n</nowiki>
 
OK\r\n</nowiki>
  
−
If the command doesn't support execute mode, the response will normally be "'''ERROR'''" on a new line.
+
Si le commande ne supporte pas le mode d'exécution, la réponse renvoyée est habituellement "'''ERROR'''" sur une ligne seule.
  
−
== Mode commande de lecture '?' ==
+
== Mode de lecture '?' ==
−
'Read' mode is used to read the current value of a command.  
+
Le mode lecture ('''Read''' en anglais) est utilisé pour lire la valeur actuelle d'une commande.  
  
−
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:
+
Le mode lecture n'est pas supporté par toutes les commandes. Vous pouvez cependant les utiliser pour retrouver des informations tel que le niveau de puissance de transmission actuellement en cours d'utilisation (tranmis power level for the radio). Il suffit d'ajouter un '?' à la commande, comme ci-dessous:
  
 
  <nowiki>AT+BLEPOWERLEVEL?</nowiki>
 
  <nowiki>AT+BLEPOWERLEVEL?</nowiki>
  
−
If the command doesn't support read mode or if there was a problem with the request, you will normally get an "'''ERROR'''" response.
+
Si la commande ne supporte pas le mode de lecture (ou s'il y a un problème avec la requêtre) alors le module retourne la réponse "'''ERROR'''".
  
−
If the command read was successful, you will normally get the read results followed by "'''OK'''" on a new line, as shown below:
+
Si la commande est lue avec succès, vous recevrez un "'''OK'''" sur une nouvelle ligne (et la valeur souhaitée). Voir l'exemple ci-dessous:
  
 
  <nowiki>AT+BLEPOWERLEVEL?
 
  <nowiki>AT+BLEPOWERLEVEL?
Ligne 76 : Ligne 79 :
 
OK\r\n</nowiki>
 
OK\r\n</nowiki>
  
−
'''Note:''' For simple commands, 'Read' mode and "'''Execute'''" mode behave identically.
+
'''Note:''' pour les commandes simples, le mode 'lecture' et mode d'exécution agissent de façon identique.
  
 
{{Bluefruit-LE-Shield-TRAILER}}
 
{{Bluefruit-LE-Shield-TRAILER}}

Version actuelle datée du 3 juin 2017 à 10:04


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

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.

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.

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.

Commandes en mode 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 utiliser le mode d'exécution pour effectuer une réinitialisation d'usine (factory reset) en exécutant la commande AT+FACTORYRESET comme ci-dessous: 

AT+FACTORYRESET
OK\r\n

NOTE: De nombreuses commandes destinées à être utilisées en mode lecture produirons un résultat identique (donc une 'lecture') lorsqu'elles sont utilisées en mode exécution.

Par exemple, les deux commandes suivantes produisent le même résultat (mode exécution d'abord, mode lecture ensuite): 

AT+BLEGETPOWERLEVEL
-4\r\n
OK\r\n
AT+BLEGETPOWERLEVEL?
-4\r\n
OK\r\n

Si le commande ne supporte pas le mode d'exécution, la réponse renvoyée est habituellement "ERROR" sur une ligne seule.

Mode de lecture '?'

Le mode lecture (Read en anglais) est utilisé pour lire la valeur actuelle d'une commande.

Le mode lecture n'est pas supporté par toutes les commandes. Vous pouvez cependant les utiliser pour retrouver des informations tel que le niveau de puissance de transmission actuellement en cours d'utilisation (tranmis power level for the radio). Il suffit d'ajouter un '?' à la commande, comme ci-dessous: 

AT+BLEPOWERLEVEL?

Si la commande ne supporte pas le mode de lecture (ou s'il y a un problème avec la requêtre) alors le module retourne la réponse "ERROR".

Si la commande est lue avec succès, vous recevrez un "OK" sur une nouvelle ligne (et la valeur souhaitée). Voir l'exemple ci-dessous: 

AT+BLEPOWERLEVEL?
-4\r\n
OK\r\n

Note: pour les commandes simples, le mode 'lecture' et mode d'exécution agissent de façon identique.

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

Récupérée de « https://wiki.mchobby.be/index.php?title=Bluefruit-LE-Shield-ATCommands&oldid=23512 »