Modifications

== BLE GAP ==

== BLE GAP ==

[https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gap GAP] (''Adafruit, Anglais'') qui signifie ''Generic Access Profile'' gouverne l'annonce et les connexions avec les périphériques Bluetooth Low Energy.

[https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gap GAP] (''Adafruit, Anglais'') qui signifie ''Generic Access Profile'' gouverne l'annonce et les connexions avec les périphériques Bluetooth Low Energy.

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 [https://www.bluetooth.org/en-us/specification/adopted-specifications Spécifications Core Bluetooth 4.0 or 4.1].

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 [https://www.bluetooth.org/en-us/specification/adopted-specifications 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ée 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 [https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile Generic Access Profile].

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 [https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile Generic Access Profile].

 

Le payload d'annonce est constitué de données [https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile GAP (''Generic Access Profile'')] insérées dans un paquet d'annonce au format: [U8:LEN] [U8:Data Type Value] [n:Value]

Le payload d'annonce est constitué de données [https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile GAP (''Generic Access Profile'')] insérées dans un paquet d'annonce au format: [U8:LEN] [U8:Data Type Value] [n:Value]

{{ambox|text=Vous pouvez utiliser la commande AT+FACTORYRESET pour restaurer le payload normal (celui par défaut).}}

{{ambox|text=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ée suivant:

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:

  <nowiki>02-01-06</nowiki>

  <nowiki>02-01-06</nowiki>

* 0x05 indique le nombre d'octets en entrée (5)

* 0x05 indique le nombre d'octets en entrée (5)

* 0x02 is the '[https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile Data Type Value]' and indicates that this is an "'''Incomplete List of 16-bit Service Class UUIDs'''"

* 0x02 est la valeur indiquant le type de donnée ''[https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile 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 is the first 16-bit UUID (which translates to '''0x180D''', corresponding to the [https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.heart_rate.xml Heart Rate Service]).

* 0x0D 0x18 est le premier UUID 16 bits (que l'on converti en '''0x180D''') et correspond au service [https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.heart_rate.xml Heart Rate].

* 0x0A 0x18 is another 16-bit UUID (which translates to '''0x180A''', corresponding to the [https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.device_information.xml Device Information Service]).

* 0x0A 0x18 est un autre UUID 16 bits (que l'on converti en '''0x180A''') et correspondant au service [https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.device_information.xml Device Information].

{{ambox-stop|text= Including the service UUIDs is important since some mobile applications will only work with devices that advertise a specific service UUID in the advertising packet. This is true for most apps from Nordic Semiconductors, for example.}}

{{ambox-stop|text=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

*Codebase Revision: 0.3.0

* Parameters: The raw byte array that should be inserted into the advertising data section of the advertising packet, being careful to stay within the space limits defined by the Bluetooth Core Specification.

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

* Response: None

* Réponse: Aucune

  <nowiki># Advertise as Discoverable and BLE only with 16-bit UUIDs 0x180D and 0x180A

  <nowiki># 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

AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18

OK</nowiki>

OK</nowiki>

The results of this command can be seen in the screenshot below, taken from a sniffer analyzing the advertising packets in Wireshark. The advertising data payload is higlighted in blue in the raw byte array at the bottom of the image, and the packet analysis is in the upper section:

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

[[Fichier:Bluefruit-LE-Shield-BLE-GAP-00.png]]

[[Fichier:Bluefruit-LE-Shield-BLE-GAP-00.png]]

{{Bluefruit-LE-Shield-TRAILER}}

{{Bluefruit-LE-Shield-TRAILER}}