Différences entre versions de « Bluefruit-LE-Shield-Beacon »
Ligne 70 : | Ligne 70 : | ||
== AT+EDDYSTONEENABLE (commande dépréciée) == | == 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 | * Codebase Revision: 0.6.6 | ||
− | * Paramètres: 1 | + | * Paramètres: 1 ou 0 (1 = activé, 0 = désactiver) |
− | * Sortie: | + | * Sortie: l'état actuel du support Eddystone si aucun paramètre est fournit à la commande. 1 = activé, 0 = désactivé |
− | {{ambox-stop|text= | + | {{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># | + | <nowiki># Activer le support Eddystone |
AT+EDDYSTONEENABLE=1 | AT+EDDYSTONEENABLE=1 | ||
OK | OK | ||
− | # | + | # Vérifier le statut du support Eddystone sur le module |
AT+EDDYSTONEENABLE | AT+EDDYSTONEENABLE | ||
1 | 1 |
Version du 5 juin 2017 à 16:22
En cours de traduction/élaboration. |
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
This command will set the URL for the Eddystone-URL protocol.
- Codebase Revision: 0.6.6
- Paramètres:
- The URL to encode (mandatory)
- An optional second parameter indicates whether to continue advertising the Eddystone URL even when the peripheral is connected to a central device
- 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.
- Sortie: Firmware <= 0.6.6: none. With firmware >= 0.6.7 running this command with no Paramètres will return the current URL.
# Set the Eddystone URL to adafruit AT+EDDYSTONEURL=http://www.adafruit.com OK # Set the Eddystone URL to adafruit and advertise it even when connected AT+EDDYSTONEURL=http://www.adafruit.com,1 OK
AT+EDDYSTONECONFIGEN
This command causes the Bluefruit LE module to enable the Eddystone URL config service for the specified number of seconds.
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.
- Codebase Revision: 0.6.6
- Paramètres: The number of seconds to advertised the config service UUID
- Sortie: None
# Start advertising the Eddystone config service for 5 minutes (300s) AT+EDDYSTONECONFIGEN=300 OK
AT+EDDYSTONESERVICEEN
Adds or removes the Eddystone service from the GATT table (requires a reset to take effect).
- Codebase Revision: 0.7.0
- Paramètres: Whether or not the Eddystone service should be enabled or not, using on of the following values:
- on
- off
- 1
- 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).
You must perform a system reset for this command to take effect. |
# Enable Eddystone service AT+EddyStonServiceEn=on OK AT+EddyStonServiceEn=1 OK # Disable Eddystone service AT+EddyStonServiceEn=off OK AT+EddyStonServiceEn=0 OK
AT+EDDYSTONEBROADCAST
This command can be used to start of stop advertising the Eddystone payload using the URL stored in non-volatile memory (NVM).
- Codebase Revision: 0.7.0
- Paramètres: Whether or not the payload should be broadcast, using one of the following values:
- on
- off
- 1
- 0
- Sortie: If executed with no Paramètres, the current broadcast state will be displayed as a numeric value.
# Enable broadcasting current setting of EddyStone (stored previously on nvm) AT+EddyStoneBroadcast=on OK AT+EddyStoneBroadcast=1 OK # Disable broadcasting current setting of EddyStone (still stored on nvm) 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