Bluefruit-LE-Shield-Beacon

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche


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
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'.

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):

 
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
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.
 
 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é
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. 
# 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é).
 
 Il est nécessaire de réinitialiser le système pour que la commande soit prise en compte. 
# 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

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