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

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(7 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Bluefruit-LE-Shield-NAV}}
 
{{Bluefruit-LE-Shield-NAV}}
  
{{traduction}}
 
 
== Beacon ==
 
== Beacon ==
 
Le module Bluefruit LE d'Adafruit supporte les technologies 'Beacon' suivantes:
 
Le module Bluefruit LE d'Adafruit supporte les technologies 'Beacon' suivantes:
Ligne 43 : Ligne 42 :
  
 
== AT+BLEURIBEACON ==
 
== AT+BLEURIBEACON ==
Converts the specified URI into a UriBeacon advertising packet, and configures the module to advertise as a UriBeacon (part of Google's Physical Web project).
+
Converti l'URI spécifée en paquet d'annonce UriBeacon (''advertising packet'') et configure le module pour s'annoncer comme un UriBeacon (partie du projet "Physical Web" de Google).
 
 
To view the UriBeacon URIs you can use one of the following mobile applications:
 
* Android 4.3+: Physical Web on the Google Play Store
 
* iOS: Physical Web in Apple's App Store
 
  
 +
Vous pouvez utiliser l'une des aapplication suivantes pour voir l'URI annoncé dans par l'UriBeacon:
 +
* Android 4.3+: "Physical Web" sur Google Play Store
 +
* iOS: "Physical Web" sur l'App Store d'Apple
  
 
* Codebase Revision: 0.4.7
 
* Codebase Revision: 0.4.7
* Paramètres: The URI to encode (ex. http://www.adafruit.com/blog)
+
* Paramètres: l'URI à annoncer (ex. http://www.adafruit.com/blog)
* Sortie: None of a valid URI was entered (length is acceptable, etc.).
+
* Sortie: Aucune si une URI valide à été saisi (longueur acceptable, etc.).
  
 
  <nowiki>AT+BLEURIBEACON=http://www.adafruit.com/blog
 
  <nowiki>AT+BLEURIBEACON=http://www.adafruit.com/blog
 
OK
 
OK
  
# Reset to change the advertising data
+
# Reinitialise le module pour utiliser les données d'annonce
 
ATZ
 
ATZ
 
OK</nowiki>
 
OK</nowiki>
  
If the supplied URI is too long you will get the following Sortie:
+
Si l'URI fournie est trop longue alors vous obtiendrez le message suivant en sortie:
  
 
  <nowiki>AT+BLEURIBEACON=http://www.adafruit.com/this/uri/is/too/long
 
  <nowiki>AT+BLEURIBEACON=http://www.adafruit.com/this/uri/is/too/long
Ligne 67 : Ligne 65 :
 
ERROR</nowiki>
 
ERROR</nowiki>
  
{{ambox-stop|text=If the URI that you are trying to encode is too long, try using a shortening service like bit.ly, and encode the shortened URI. }}
+
{{ambox-stop|text=Si vous essayez d'encoder une URI trop longue alors essayez d'utiliser un service en ligne permettant de créer des liens court (comme bit.ly) et encodez ce lien court dans l'UriBeacon. }}
{{ambox|text=UriBeacon should be considered deprecated as a standard, and EddyStone should be used for any future development. No further development will happen in the Bluefruit LE firmware around UriBeacon.}}
+
{{ambox|text=UriBeacon devrait être considéré comme un standard obsolète. EddyStone devrait être utilisé pour chaque nouveau développement. Adafruit ne fera pas de développement complémentaire pour la technologie UriBeacon.}}
  
 
== AT+EDDYSTONEENABLE (commande dépréciée) ==
 
== AT+EDDYSTONEENABLE (commande dépréciée) ==
This command will enable Eddystone support on the Bluefruit LE module. Eddystone support must be enabled before the other related commands can be used.
+
Cette commande activera le support  Eddystone sur le module Bluefruit LE. Le support Eddystone doit être activé avant d'utiliser les autres commandes.
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
* Paramètres: 1 or 0 (1 = enable, 0 = disable)
+
* Paramètres: 1 ou 0 (1 = activé, 0 = désactiver)
* Sortie: The current state of Eddystone support if no Paramètres are provided (1 = enabled, 0 = disabled)
+
* Sortie: l'état actuel du support Eddystone si aucun paramètre est fournit à la commande. 1 = activé, 0 = désactivé
  
{{ambox-stop|text=This command was removed in firmware 0.7.0 to avoid confusion. Use AT+EDDYSTONESERVICEEN in 0.7.0 and higher.}}
+
{{ambox-stop|text=Cette commande est remplacée par AT+EDDYSTONESERVICEEN depuis le firmware 0.7.0 . La commande AT+EDDYSTONEENABLE n'est plus disponible depuis la version 0.7.0 afin d'éviter les confusions.}}
  
  <nowiki># Enable Eddystone support
+
  <nowiki># Activer le support Eddystone
 
AT+EDDYSTONEENABLE=1
 
AT+EDDYSTONEENABLE=1
 
OK
 
OK
  
# Check the current Eddystone status on the module
+
# Vérifier le statut du support Eddystone sur le module
 
AT+EDDYSTONEENABLE
 
AT+EDDYSTONEENABLE
 
1
 
1
Ligne 88 : Ligne 86 :
  
 
== AT+EDDYSTONEURL ==
 
== AT+EDDYSTONEURL ==
This command will set the URL for the Eddystone-URL protocol.
+
Cette commande fixe l'URL pour le le protocol Eddystone.
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
 
* Paramètres:  
 
* Paramètres:  
** The URL to encode (mandatory)
+
** L'URL a encoder (obligatoire)
** An optional second parameter indicates whether to continue advertising the Eddystone URL even when the peripheral is connected to a central device
+
** Le second paramètre (optionel) indique s'il faut continuer à envoyer l'URL Eddystone même si le périphérique est connecté sur un périphérique central
** Firmware '''0.6.7''' added an optional third parameter for the RSSI at 0 meters value. This should be measured by the end user by checking the RSSI value on the receiving device at 1m and then adding 41 to that value (to compensate for the signal strength loss over 1m), so an RSSI of -62 at 1m would mean that you should enter -21 as the RSSI at 0m. Default value is -18dBm.
+
** Firmware '''0.6.7''' ajout un 3ieme paramètre optionnel pour la valeur RSSI à 0 mètre. Devrait être mesurer par l'utilisateur final en vérifiant la valeur RSSI sur le périphérique de réception à 1 mètre de distance puis en ajoutant 41 à cette valeur (pour compenser la perte de signal sur un mètre). Un RSSI de -62 à 1m signifie qu'il faudrait encoder la valeur -21 comme valeur RSSI à 0m. La valeur par défaut est -18dBm.
* Sortie: Firmware <= 0.6.6: none. With firmware >= '''0.6.7''' running this command with no Paramètres will return the current URL.
+
* Sortie:
 +
** Firmware <= 0.6.6: rien.
 +
** Firmware >= '''0.6.7''' exécuter cette commande sans paramètre retournera l'URL actuellement configurée.
  
  <nowiki># Set the Eddystone URL to adafruit
+
  <nowiki># Fixe l'URL Eddystone sur Adafruit
 
AT+EDDYSTONEURL=http://www.adafruit.com
 
AT+EDDYSTONEURL=http://www.adafruit.com
 
OK
 
OK
 
    
 
    
# Set the Eddystone URL to adafruit and advertise it even when connected
+
# Fixe l'URL Eddystone sur Adafruit et effectue la publication même lorsqu'il y a une connexion
 
AT+EDDYSTONEURL=http://www.adafruit.com,1
 
AT+EDDYSTONEURL=http://www.adafruit.com,1
 
OK</nowiki>
 
OK</nowiki>
  
 
== AT+EDDYSTONECONFIGEN ==
 
== AT+EDDYSTONECONFIGEN ==
This command causes the Bluefruit LE module to enable the Eddystone URL config service for the specified number of seconds.
+
Cette commande active le service de configuration de l'URL Eddystone sur le module Bluefruit LE pendant le nombre de secondes spécifiées.
  
This command should be used in combination with the Physical Web application from Google, available for Android or iOS. Run this command then select the 'Edit URL' option from the app to change the destination URL over the air.
+
Cette commande devrait être utilisée en combinaison avec l'application "Physical Web" de Google (disponible sus Android et iOS).  
 +
 
 +
Utilisez cette commande pour sélectionner l'option 'Edit URL' (édition URL) depuis l'Application. Cela permet de changer l'URL de destination via les airs.
  
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
* Paramètres: The number of seconds to advertised the config service UUID
+
* Paramètres: le nombre de secondes pour l'annonce du service de configuration UUID
* Sortie: None
+
* Sortie: Aucun
  
  <nowiki># Start advertising the Eddystone config service for 5 minutes (300s)
+
  <nowiki># Active l'annonce du service de configuration Eddystone pendant 5 minutes (300s)
 
AT+EDDYSTONECONFIGEN=300
 
AT+EDDYSTONECONFIGEN=300
 
OK</nowiki>
 
OK</nowiki>
  
 
== AT+EDDYSTONESERVICEEN ==
 
== AT+EDDYSTONESERVICEEN ==
Adds or removes the Eddystone service from the GATT table (requires a reset to take effect).
+
Ajoute ou retire un service Eddystone dans la table GATT (gouverne l'organisation et l'échange de données entre les périphériques). Nécessite une réinitialisation pour être activé.
  
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
* Paramètres: Whether or not the Eddystone service should be enabled or not, using on of the following values:
+
* Paramètres: Utiliser les valeurs suivantes pour activer ou désactiver le service Eddystone:
** on
+
** on , 1 - activer le service
** off
+
** off 0 - désactiver le service
** 1
+
* Sortie: Si la commande est utilisée sans paramètre, le commande retournera une valeur indiquant si le service est actif ou non (1 = activé, 0 = désactivé).
** 0
 
* Sortie: If the command is executed with no Paramètres it will disable a numeric value indicating whether the service is enabled (1) or disabled (0).
 
  
{{ambox|text=You must perform a system reset for this command to take effect.}}
+
{{ambox|text=Il est nécessaire de réinitialiser le système pour que la commande soit prise en compte.}}
  
  <nowiki># Enable Eddystone service
+
  <nowiki># Active le service Eddystone
 
AT+EddyStonServiceEn=on
 
AT+EddyStonServiceEn=on
 
OK
 
OK
Ligne 137 : Ligne 137 :
 
OK
 
OK
  
# Disable Eddystone service
+
# Désactive le service Eddystone
 
AT+EddyStonServiceEn=off
 
AT+EddyStonServiceEn=off
 
OK
 
OK
Ligne 145 : Ligne 145 :
  
 
== AT+EDDYSTONEBROADCAST ==
 
== AT+EDDYSTONEBROADCAST ==
This command can be used to start of stop advertising the Eddystone payload using the URL stored in non-volatile memory (NVM).
+
Cette commande peut être utilisé pour démarrer / arrêter l'annonce (le ''broadcast'') du ''payload'' Eddystone. Eddystone utilise l'URL stockée dans la mémoire non-volatile du module.
  
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
* Paramètres: Whether or not the payload should be broadcast, using one of the following values:
+
* Paramètres: Indique s'il faut (ou non) faire l'annonce / broadcast du ''payload'' contenant l'URL.
** on
+
** on , 1 : Activer la broadcast
** off
+
** off , 0 : Désactiver le broadcast
** 1
 
** 0
 
 
* Sortie: If executed with no Paramètres, the current broadcast state will be displayed as a numeric value.
 
* Sortie: If executed with no Paramètres, the current broadcast state will be displayed as a numeric value.
  
  <nowiki># Enable broadcasting current setting of EddyStone (stored previously on nvm)
+
  <nowiki># Active le broadcast de la configuration EddyStone (l'URL, telle que stocké dans la mémoire non volatile)
 
AT+EddyStoneBroadcast=on
 
AT+EddyStoneBroadcast=on
 
OK
 
OK
Ligne 162 : Ligne 160 :
 
OK
 
OK
 
      
 
      
# Disable broadcasting current setting of EddyStone (still stored on nvm)
+
# Désactive le broadcast de la configuration EddyStone
 
AT+EddyStoneBroadcast=off
 
AT+EddyStoneBroadcast=off
 
OK
 
OK

Version actuelle datée du 5 juin 2017 à 17:15


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.

Beacon

Le module Bluefruit LE d'Adafruit supporte les technologies 'Beacon' suivantes:

  • Beacon (Apple) via AT+BLEBEACON
  • UriBeacon (Google) via AT+BLEURIBEACON (obsoltète)
  • Eddystone (Google) via AT+EDDYSTONE*

Les modules peuvent être configurés pour agir comme 'Beacons' en utilisant les commandes décrites dans cette partie du document.

AT+BLEBEACON

  • Codebase Revision: 0.3.0
  • Paramètres: les paramètres suivants (séparés par des virgules) sont nécessaires pour activer le mode Beacon:
    • Bluetooth Manufacturer ID (uint16_t)
    • UUID sur 128-bits
    • Valeur majeure (uint16_t)
    • Valeur mineure(uint16_t)
    • RSSI à 1m (int8_t)
      RSSI représente la mesure de la qualité du signal
  • Sortie: None
# Activer l'émulation Apple iBeacon
# Manufacturer ID = 0x004C
AT+BLEBEACON=0x004C,01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0,0x0000,0x0000,-59
OK
# Réinitialiser pour changer les données de publication
ATZ
OK
  
# Activer l'émulation Beacon de Nordic
# Manufacturer ID = 0x0059
AT+BLEBEACON=0x0059,01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0,0x0000,0x0000,-59
OK
# Réinitialiser pour changer les données de publication
ATZ
OK

En utilisant l'émulation Beacon de Nordic avec l'exemple ci-dessus, vous pourrez voir le résultat de la simulation beacon dans l'outil 'Beacon Config' de Nordic (comme ci-dessous):

Bluefruit-LE-Shield-Beacon-00.png
Crédit: AdaFruit Industries www.adafruit.com

AT+BLEURIBEACON

Converti l'URI spécifée en paquet d'annonce UriBeacon (advertising packet) et configure le module pour s'annoncer comme un UriBeacon (partie du projet "Physical Web" de Google).

Vous pouvez utiliser l'une des aapplication suivantes pour voir l'URI annoncé dans par l'UriBeacon:

  • Android 4.3+: "Physical Web" sur Google Play Store
  • iOS: "Physical Web" sur l'App Store d'Apple
  • Codebase Revision: 0.4.7
  • Paramètres: l'URI à annoncer (ex. http://www.adafruit.com/blog)
  • Sortie: Aucune si une URI valide à été saisi (longueur acceptable, etc.).
AT+BLEURIBEACON=http://www.adafruit.com/blog
OK

# Reinitialise le module pour utiliser les données d'annonce
ATZ
OK

Si l'URI fournie est trop longue alors vous obtiendrez le message suivant en sortie:

AT+BLEURIBEACON=http://www.adafruit.com/this/uri/is/too/long
URL is too long
ERROR

AT+EDDYSTONEENABLE (commande dépréciée)

Cette commande activera le support Eddystone sur le module Bluefruit LE. Le support Eddystone doit être activé avant d'utiliser les autres commandes.

  • Codebase Revision: 0.6.6
  • Paramètres: 1 ou 0 (1 = activé, 0 = désactiver)
  • Sortie: l'état actuel du support Eddystone si aucun paramètre est fournit à la commande. 1 = activé, 0 = désactivé
# Activer le support Eddystone
AT+EDDYSTONEENABLE=1
OK

# Vérifier le statut du support Eddystone sur le module
AT+EDDYSTONEENABLE
1
OK

AT+EDDYSTONEURL

Cette commande fixe l'URL pour le le protocol Eddystone.

  • Codebase Revision: 0.6.6
  • Paramètres:
    • L'URL a encoder (obligatoire)
    • Le second paramètre (optionel) indique s'il faut continuer à envoyer l'URL Eddystone même si le périphérique est connecté sur un périphérique central
    • Firmware 0.6.7 ajout un 3ieme paramètre optionnel pour la valeur RSSI à 0 mètre. Devrait être mesurer par l'utilisateur final en vérifiant la valeur RSSI sur le périphérique de réception à 1 mètre de distance puis en ajoutant 41 à cette valeur (pour compenser la perte de signal sur un mètre). Un RSSI de -62 à 1m signifie qu'il faudrait encoder la valeur -21 comme valeur RSSI à 0m. La valeur par défaut est -18dBm.
  • Sortie:
    • Firmware <= 0.6.6: rien.
    • Firmware >= 0.6.7 exécuter cette commande sans paramètre retournera l'URL actuellement configurée.
# Fixe l'URL Eddystone sur Adafruit
AT+EDDYSTONEURL=http://www.adafruit.com
OK
  
# Fixe l'URL Eddystone sur Adafruit et effectue la publication même lorsqu'il y a une connexion
AT+EDDYSTONEURL=http://www.adafruit.com,1
OK

AT+EDDYSTONECONFIGEN

Cette commande active le service de configuration de l'URL Eddystone sur le module Bluefruit LE pendant le nombre de secondes spécifiées.

Cette commande devrait être utilisée en combinaison avec l'application "Physical Web" de Google (disponible sus Android et iOS).

Utilisez cette commande pour sélectionner l'option 'Edit URL' (édition URL) depuis l'Application. Cela permet de changer l'URL de destination via les airs.

  • Codebase Revision: 0.6.6
  • Paramètres: le nombre de secondes pour l'annonce du service de configuration UUID
  • Sortie: Aucun
# Active l'annonce du service de configuration Eddystone pendant 5 minutes (300s)
AT+EDDYSTONECONFIGEN=300
OK

AT+EDDYSTONESERVICEEN

Ajoute ou retire un service Eddystone dans la table GATT (gouverne l'organisation et l'échange de données entre les périphériques). Nécessite une réinitialisation pour être activé.

  • Codebase Revision: 0.7.0
  • Paramètres: Utiliser les valeurs suivantes pour activer ou désactiver le service Eddystone:
    • on , 1 - activer le service
    • off , 0 - désactiver le service
  • Sortie: Si la commande est utilisée sans paramètre, le commande retournera une valeur indiquant si le service est actif ou non (1 = activé, 0 = désactivé).
# Active le service Eddystone
AT+EddyStonServiceEn=on
OK

AT+EddyStonServiceEn=1
OK

# Désactive le service Eddystone
AT+EddyStonServiceEn=off
OK

AT+EddyStonServiceEn=0
OK

AT+EDDYSTONEBROADCAST

Cette commande peut être utilisé pour démarrer / arrêter l'annonce (le broadcast) du payload Eddystone. Eddystone utilise l'URL stockée dans la mémoire non-volatile du module.

  • Codebase Revision: 0.7.0
  • Paramètres: Indique s'il faut (ou non) faire l'annonce / broadcast du payload contenant l'URL.
    • on , 1 : Activer la broadcast
    • off , 0 : Désactiver le broadcast
  • Sortie: If executed with no Paramètres, the current broadcast state will be displayed as a numeric value.
# Active le broadcast de la configuration EddyStone (l'URL, telle que stocké dans la mémoire non volatile)
AT+EddyStoneBroadcast=on
OK

AT+EddyStoneBroadcast=1
OK
    
# Désactive le broadcast de la configuration EddyStone
AT+EddyStoneBroadcast=off
OK

AT+EddyStoneBroadcast=0
OK

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