Bluefruit-LE-Shield-BLE-GAP

De MCHobby - Wiki
Révision datée du 22 juin 2017 à 13:07 par Admin (discussion | contributions) (→‎BLE GAP)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)
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.

BLE GAP

GAP (Adafruit, Anglais) qui signifie Generic Access Profile gouverne l'annonce et les connexions avec les périphériques Bluetooth Low Energy.

Les commandes suivantes peuvent être utilisées pour configurer les paramètres GAP sur le module BLE.

Vous pouvez utiliser ces commandes pour modifier les données d'annonce (advertising data). Par exemple: le nom du périphérique tel qu'il doit apparaître sur votre smartphone durant le processus d'appairage. Les commandes permettent également de récupérer des informations concernant la connexion qui a été établie entre deux périphériques, ou la déconnexion si vous ne désirez pas maintenir une connexion.

AT+GAPCONNECTABLE

Cette commande est utilisé pour rendre le périphérique 'non connectable'.

  • Codebase Revision: 0.7.0
  • Paramètre: Indique si le périphérique doit (ou ne doit pas) s'annoncer comme "connectable". Utiliser une des valeurs suivantes:
    • 1 ou yes - s'annoncer comme connectable
    • 0 ou no - ne pas s'annoncer comme connectable
  • Sortie: Afficher l'état 'connectable' du périphérique si la commande est appelée sans paramètre
# Rendre le périphérique non-connectable (avertissement uniquement)
AT+GAPCONNECTABLE=0
OK

# Vérifier le statut "connectable" actuel du module. 
AT+GAPCONNECTABLE
1
OK

AT+GAPGETCONN

Affiche le statut actuel de la connexion (si nous sommes connecté sur un autre périphérique BLE ou non).

  • Codebase Revision: 0.3.0
  • Paramètres: Aucun
  • Sortie: 1 si connecté, sinon 0
# Connecté
AT+GAPGETCONN
1
OK
  
# Non connecté
AT+GAPGETCONN
0
OK

AT+GAPDISCONNECT

Déconnecter le module du périphérique centrale (smartphone).

  • Codebase Revision: 0.3.0
  • Paramètre: Aucun
  • Sortie: Aucun
AT+GAPDISCONNECT
OK

AT+GAPDEVNAME

Obtenir ou modifier le nom du module, celui qui est inclus dans le payload d'annonce du module Bluefruit LE

  • Codebase Revision: 0.3.0
  • Paramètre:
    • Aucun pour lire le nom actuel du périphérique
    • Le nouveau nom du périphérique si vous voulez changer son nom
  • Sortie: Le nom actuel du périphérique si la commande est exécutée en mode lecture.
Stop
 Le nom du module est stocké dans la mémoire non volatile. Ce nouveau nom est donc persistant. La modification est effective dès la réinitialisation du système (ATZ). Pour réinitialiser le périphérique aux valeurs d'usine et effacer les données de configuration, il faut utiliser la commande AT+FACTORYRESET 
# Lecture du nom actuel du périphérique
AT+GAPDEVNAME
UART
OK
  
# Changer le nom du module BLE à 'BLEFriend'
AT+GAPDEVNAME=BLEFriend
OK
# Réinitialisation système pour appliquer les modifications
ATZ
OK

AT+GAPDELBONDS

Efface les informations d'appairage stockés dans le module Bluefruit LE.

  • Codebase Revision: 0.3.0
  • Paramètres: Aucun
  • Sortie: Aucun
AT+GAPDELBONDS
OK

AT+GAPINTERVALS

Retrouver ou modifier les différentes intervalles d'annonce et de connexion pour le module Bluefruit LE.

Soyez extrêmement attentif en utilisant cette commande puisque vous pouvez facilement provoquer des problèmes en modifiant les intervalles. En effet, certains téléphones mobile pourrait ne plus reconnaître le module ou refuser de s'y connecter.

  • Codebase Revision: 0.3.0
  • Paramètres: Si vous désirez modifier les intervalles GAP, les données doivent être saisi dans l'ordre suivant (séparés avec des virgules):
    • Minimum connection interval (Intervalle de connexion minimal, en millisecondes)
    • Maximum connection interval (Intervalle de connexion maximal, en millisecondes)
    • Fast Advertising interval (Intervalle d'annonce rapide, en millisecondes)
    • Fast Advertising timeout (Timeout d'annonce rapide, en millisecondes)
    • >= 0.7.0: Low power advertising interval (Intervalle d'annonce en mode d'économie d'énergie, en millisecondes), 417.5 ms par défaut
 Afin d'économisé l'énergie, les modules Bluefruit passent en mode "lower advertising rate" (faible débit d'annonce) après avoir atteind le temps "fast advertising timeout" (en secondes). La valeur par défaut est de 30 secondes (Fast Advertising Timeout). L'intervalle "low power advertising interval" est hard-codé à environ 0.6s dans les firmwares avant < 0.7.0. La support du paramétrage "low power interval" à été ajouté dans le firmware 0.7.0 via un 5ieme paramètre optionnel.

Voici les différentes limitations min et max pour les paramètres GAP:

  • Absolute minimum connection interval (minimum absolu pour l'intervalle de connexion): 10ms
  • Absolute maximum connection interval (maximum absolu pour l'intervalle de connexion) : 4000ms
  • Absolute minimum fast advertising interval (minimum absolu pour l'intervalle d'annonce rapide): 20ms
  • Absolute maximum fast advertisting interval (maximum absolu pour l'intervalle d'annonce rapide): 10240ms
  • Absolute minimum low power advertising interval (minimum absolu pour l'intervalle annonce en économie d'énergie): 20ms
  • Absolute maximum low power advertising interval (maximum absolu pour l'intervalle annonce en économie d'énergie): 10240ms
Stop
 Si vous désirez uniquement modifier un intervalle alors laissez les autres valeurs -entre les virgules- vides (ex: ",,110," modifiera uniquement la 3ième valeur "advertising interval").
  • Sortie: en lisant les paramètres d'intervalle GAP, les informations suivantes seront affichées (séparés par des virgules):
    • Minimum connection interval (interval de connexion minimum, en milisecondes)
    • Maximum connection interval (interval de connexion maximum, en milisecondes)
    • Advertising interval (interval d'annonce, en milisecondes)
    • Advertising timeout (timeout d'annonce, en milisecondes)
Stop
 La modification des intervalles GAP est enregistré dans la mémoire non-volatile et les nouvelles valeurs seront utilisées après la réinitialisation du système. Pour réinitialiser le périphérique aux paramètres d'usine (et effacer vos paramètres de la mémoire), vous pouvez utiliser la commande AT+FACTORYRESET 
# Lecture des différents intervales GAP
AT+GAPINTERVALS
20,100,100,30
  
# Modification de tous les intervalles
AT+GAPINTERVALS=20,200,200,30
OK
  
# Modifier uniquement l'intervalle d'annonce (advertising interval)
AT+GAPINTERVALS=,,150,
OK

AT+GAPSTARTADV

Force le module Bluefruit LE commencer l'émission des paquets d'annonce si ce n'est pas déjà le cas (et en partant du principe qu'il n'est pas déjà connecté sur un pérhiphérique externe).

  • Codebase Revision: 0.3.0
  • Paramètre: Aucun
  • Sortie: Aucun
# Résultat de la commande lorsque le module n’émet pas de paquet d'annonce
AT+GAPSTARTADV
OK
  
# Résultat de la commande lorsque le Bluefruit émet déjà des paquets d'annonce
AT+GAPSTARTADV
ERROR
  
# Résulatat de la commande lorque le module est déjà connecté sur un autre périphérique
AT+GAPSTARTADV
ERROR

AT+GAPSTOPADV

Arrête l'émission des paquets d'annonce depuis le module Bluefruit LE.

  • Codebase Revision: 0.3.0
  • Paramètre: Aucun
  • Sortie: Aucun
 AT+GAPSTOPADV
OK

AT+GAPSETADVDATA

Surcharge les données du payload d'annonce avec le tableau d'octet spécifié en paramètre (remplace les données normalement utilisées dans le payload d'annonce normal). Le payload d'annonce du module suit les guidelines dans les Spécifications Core Bluetooth 4.0 or 4.1.

En particulier, les Core Specification Supplement (CSS) v4 contient des détails concernant les champs de données d'annonce habituels comme les 'Flags/drapeaux' (Partie A, Section 1.3) et une liste des UUID des différents services (Partie A, Section 1.1). Une liste de tous les types de donnée GAP possible est disponible sur la page Bluetooth SIG's Generic Access Profile.

Le payload d'annonce est constitué de données GAP (Generic Access Profile) insérées dans un paquet d'annonce au format: [U8:LEN] [U8:Data Type Value] [n:Value]

Stop
 ATTENTION : cette commande nécessite un certain degré de connaissances concernent les détails bas niveau des spécifications "Bluetooth 4.0 or 4.1 Core". Cette commande ne devrait être utilisée que par des utilisateurs expérimentés. Une mauvaise utilisation de cette commande rendra votre module indétectable par le périphérique central (votre SmartPhone).
Stop
 ATTENTION : Cette commande remplace le payload d'annonce et peut empêcher certains services de fonctionner comme attendu.
Vous pouvez utiliser la commande AT+FACTORYRESET pour restaurer le payload normal (celui par défaut).

Par exemple : pour insérer le type de donnée drapeau (flags, valeur "Data Type" 0x01) et utiliser la valeur 0x06/0b00000110 ("BR/EDR Not Supported" et "LE General Discoverable Mode"), il faut utiliser le tableau de données suivant: 

02-01-06
  • 0x02 indique le nombre d'octets dans l'entrée
  • 0x01 indique la valeur 'type de donnée' (Data Type Value) qui indique que c'est un drapeau (Flag).
  • 0x06 (0b00000110) est la valeur du drapeau (Flag). Il active les éléments suivants (voir les spécifications Bluetooth Core 4.0, Volume 3, Part C, 18.1):
    • LE General Discoverable Mode (tout le monde peut découvrir ce périphérique)
    • BR/EDR Not Supported (C'est un périphérique Bluetooth Low Energy uniquement)

Si nous désirons également inclure deux UUIDs de services dans les informations d'annonces (pour que les périphériques distants savent que le module supporte ces services) alors nous pouvons ajouter les données suivantes au tableau d'octets: 

05-02-0D-18-0A-18
  • 0x05 indique le nombre d'octets en entrée (5)
  • 0x02 est la valeur indiquant le type de donnée Data Type Value. Indique qu'il s'agit d'une liste incomplète de service UUIDs (Incomplete List of 16-bit Service Class UUIDs)
  • 0x0D 0x18 est le premier UUID 16 bits (que l'on converti en 0x180D) et correspond au service Heart Rate.
  • 0x0A 0x18 est un autre UUID 16 bits (que l'on converti en 0x180A) et correspondant au service Device Information.
Stop
 Inclure les UUIDs des services est important puisque certaines applications mobiles ne fonctionnerons qu'avec des périphériques annonçant un service UUID spécifique dans les paquets d'annonce. C'est par exemple le cas pour la plupart des applications de Nordic Semiconductors.
  • Codebase Revision: 0.3.0
  • Paramètres: le tableau d'octets brute qui devrait être inséré dans la section de donnée du bloc d'annonce. Veuillez à rester à l'intérieur de l'espace définit dans les spécifications Bluetooth Core.
  • Réponse: Aucune
# S'annoncer comme Découvrable et BLE uniquement avec 
# les UUIDs 16 bits 0x180D et 0x180A
AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18
OK

Le résultat de cette commande est visible sur la capture d'écran ci-dessous. Capture obtenue à l'aide d'un sniffer capturant et analysant les paquets d'annonce dans Wireshark. Les données d'annonce (dans le payload) sont visibles en surbrillance (en bleu, dans le tableau d'octets en bas de l'image et l'analyse du paquet dans la section supérieure):

Bluefruit-LE-Shield-BLE-GAP-00.png

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-BLE-GAP&oldid=23700 »