Modifications

== AT+GAPSETADVDATA ==

== 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). Suivant 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é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].

{{traduction}}

{{traduction}}

The Advertising Data payload consists of [https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile Generic Access Profile] data that is inserted into the advertising packet in the following 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-stop|text=WARNING: This command requires a degree of knowledge about the low level details of the Bluetooth 4.0 or 4.1 Core Specification, and should only be used by expert users. Misuse of this command can easily cause your device to be undetectable by central devices in radio range.}}

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

{{ambox-stop|text=WARNING: This command will override the normal advertising payload and may prevent some services from acting as expected.}}

{{ambox-stop|text=ATTENTION : Cette commande remplace le payload d'annonce et peut empêcher certains services de fonctionner comme attendu.}}

{{ambox-stop|text=To restore the advertising data to the normal default values use the AT+FACTORYRESET command.}}

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

For example, to insert the 'Flags' Data Type (Data Type Value 0x01), and set the value to 0x06/0b00000110 (BR/EDR Not Supported and LE General Discoverable Mode) we would use the following byte array:

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:

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

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

* 0x02 indicates the number of bytes in the entry

* 0x02 indique le nombre d'octets dans l'entrée

* 0x01 is the 'Data Type Value' and indicates that this is a 'Flag'

* 0x01 indique la valeur 'type de donnée' (''Data Type Value'') qui indique que c'est un drapeau (''Flag'').

* 0x06 (0b00000110) is the Flag value, and asserts the following fields (see Core Specification 4.0, Volume 3, Part C, 18.1):

* 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''' (i.e. anyone can discover this device)

** '''LE General Discoverable Mode''' (tout le monde peut découvrir ce périphérique)

** '''BR/EDR Not Supported''' (i.e. this is a Bluetooth Low Energy only device)

** '''BR/EDR Not Supported''' (C'est un périphérique Bluetooth Low Energy uniquement)

If we also want to include two 16-bit service UUIDs in the advertising data (so that listening devices know that we support these services) we could append the following data to the byte array:

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:

  <nowiki>05-02-0D-18-0A-18</nowiki>

  <nowiki>05-02-0D-18-0A-18</nowiki>

* 0x05 indicates that the number of bytes in the entry (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 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'''"

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