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

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
(Page créée avec « {{Bluefruit-LE-Shield-NAV}} == Beacon == Adafruit's Bluefruit LE modules currently support the following 'Beacon' technologies: * Beacon (Apple) via AT+BLEBEACON * UriBea... »)
 
 
(13 versions intermédiaires par le même utilisateur non affichées)
Ligne 2 : Ligne 2 :
  
 
== Beacon ==
 
== Beacon ==
Adafruit's Bluefruit LE modules currently support the following 'Beacon' technologies:
+
Le module Bluefruit LE d'Adafruit supporte les technologies 'Beacon' suivantes:
 
* Beacon (Apple) via AT+BLEBEACON
 
* Beacon (Apple) via AT+BLEBEACON
* UriBeacon (Google) via AT+BLEURIBEACON (deprecated)
+
* UriBeacon (Google) via AT+BLEURIBEACON (obsoltète)
 
* Eddystone (Google) via AT+EDDYSTONE*
 
* Eddystone (Google) via AT+EDDYSTONE*
  
Modules can be configured to act as 'Beacons' using the following commands:
+
Les modules peuvent être configurés pour agir comme 'Beacons' en utilisant les commandes décrites dans cette partie du document.
  
 
== AT+BLEBEACON ==
 
== AT+BLEBEACON ==
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: The following comma-separated parameters are required to enable beacon mode:
+
* 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)
 
** Bluetooth Manufacturer ID (uint16_t)
** 128-bit UUID
+
** UUID sur 128-bits
** Major Value (uint16_t)
+
** Valeur majeure (uint16_t)
** Minor Value (uint16_t)
+
** Valeur mineure(uint16_t)
** RSSI @ 1m (int8_t)
+
** RSSI à 1m (int8_t)<br />''RSSI représente la mesure de la qualité du signal''
* Output: None
+
* Sortie: None
  
  <nowiki># Enable Apple iBeacon emulation
+
  <nowiki># Activer l'émulation Apple iBeacon
 
# Manufacturer ID = 0x004C
 
# 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
 
AT+BLEBEACON=0x004C,01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0,0x0000,0x0000,-59
 
OK
 
OK
# Reset to change the advertising data
+
# Réinitialiser pour changer les données de publication
 
ATZ
 
ATZ
 
OK
 
OK
 
    
 
    
# Enable Nordic Beacon emulation
+
# Activer l'émulation Beacon de Nordic
 
# Manufacturer ID = 0x0059
 
# 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
 
AT+BLEBEACON=0x0059,01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0,0x0000,0x0000,-59
 
OK
 
OK
# Reset to change the advertising data
+
# Réinitialiser pour changer les données de publication
 
ATZ
 
ATZ
 
OK</nowiki>
 
OK</nowiki>
  
{{ambox-stop|text=AT+BLEBEACON will cause the beacon data to be stored in non-volatile config memory on the Bluefruit LE module, and these values will be persisted across system resets and power cycles. To remove or clear the beacon data you need to enter the 'AT+FACTORYRESET' command in command mode. }}
+
{{ambox-stop|text=AT+BLEBEACON stocke les données beacon dans ma mémoire de configuration du module Bluefruit LE (non volatile). Ces données sont persistance et donc disponible après une réinitialisation système ou cycle d'alimentation. Pour effacer ou enlever ces données beacon il sera nécessaire d'utiliser la commande de réinitialisation à la configuration d'usine 'AT+FACTORYRESET'. }}
  
Entering Nordic Beacon emulation using the sample code above, you can see the simulated beacon in Nordic's 'Beacon Config' tool below:
+
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):
  
{{ADF-Image|Bluefruit-LE-Shield-Beacon-00.png|480px}}
+
{{ADFImage|Bluefruit-LE-Shield-Beacon-00.png|480px}}
  
 
== 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
* Parameters: The URI to encode (ex. http://www.adafruit.com/blog)
+
* Paramètres: l'URI à annoncer (ex. http://www.adafruit.com/blog)
* Output: 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 output:
+
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 66 : 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) ==
 +
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é
 +
 
 +
{{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># Activer le support Eddystone
 +
AT+EDDYSTONEENABLE=1
 +
OK
 +
 
 +
# Vérifier le statut du support Eddystone sur le module
 +
AT+EDDYSTONEENABLE
 +
1
 +
OK</nowiki>
 +
 
 +
== 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.
 +
 
 +
<nowiki># 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</nowiki>
 +
 
 +
== 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
 +
 
 +
<nowiki># Active l'annonce du service de configuration Eddystone pendant 5 minutes (300s)
 +
AT+EDDYSTONECONFIGEN=300
 +
OK</nowiki>
 +
 
 +
== 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é).
 +
 
 +
{{ambox|text=Il est nécessaire de réinitialiser le système pour que la commande soit prise en compte.}}
 +
 
 +
<nowiki># 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</nowiki>
 +
 
 +
== 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.
 +
 
 +
<nowiki># 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</nowiki>
  
 
{{Bluefruit-LE-Shield-TRAILER}}
 
{{Bluefruit-LE-Shield-TRAILER}}

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