Modifications

== GATT BLE ==

== GATT BLE ==

[https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gatt GATT] est l'acronyme de "Generic ATTribute Profile" (profile d'attribut générique). GATT gouverne l'organisation et l'échange de données entre les périphériques connectés. Un périphérique (nommé "''the peripheral''" dans la nomenclature) agit comme un serveur GATT qui enregistre les données dans des enregistrements Attributs. Un second périphérique (nommé la "central") agit comme un client GATT, demandant les données au serveur lorsque cela est nécessaire.

[https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gatt GATT] est l'acronyme de "Generic ATTribute Profile" (profile d'attribut générique). GATT gouverne l'organisation et l'échange de données entre les périphériques connectés. Un périphérique (nommé "''the peripheral''" dans la nomenclature) agit comme un serveur GATT qui enregistre les données dans des enregistrements Attributs. Un second périphérique (nommé la "central") agit comme un client GATT, demandant les données au serveur lorsque cela est nécessaire.

Le champs '''DESCRIPTION''' est une chaîne de caractère qui contient une courte description textuelle de la caractéristique. Certaines Apps pourraient ignorer cette information, elle devrait néanmoins être visible en utilisant l'application "Master Control Panel" de Nordic sous iOS et Android.

Le champs '''DESCRIPTION''' est une chaîne de caractère qui contient une courte description textuelle de la caractéristique. Certaines Apps pourraient ignorer cette information, elle devrait néanmoins être visible en utilisant l'application "Master Control Panel" de Nordic sous iOS et Android.

The '''PRESENTATION''' field contains a 7-byte payload that encapsulates the characteristic presentation format data.  It requires a specific set of bytes and values to work properly. See the following link for details on how to format the payload: https://developer.bluetooth.org/gatt/descriptors/Pages/DescriptorViewer.aspx?u=org.bluetooth.descriptor.gatt.characteristic_presentation_format.xml

L'exemple suivant montre comment vous pouvez utiliser ces deux nouveaux champs:

 

The following example shows how you might use both of these new fields:

  <nowiki>AT+GATTADDCHAR=UUID=0x2A37, PROPERTIES=0x10, MIN_LEN=2, MAX_LEN=3, VALUE=00-40,  

  <nowiki>AT+GATTADDCHAR=UUID=0x2A37, PROPERTIES=0x10, MIN_LEN=2, MAX_LEN=3, VALUE=00-40,  

               DESCRIPTION=HRM Measurement, PRESENTATION=17-00-AC-27-01-00-00</nowiki>

               DESCRIPTION=HRM Measurement, PRESENTATION=17-00-AC-27-01-00-00</nowiki>

For the Characteristic Presentation Format we have:

Pour le format de présentation de la caractéristique nous avons:

* Format = IEEE-11073 32-bit FLOAT (Decimal 23, Hex 0x17)

* Format = IEEE-11073 32-bit FLOAT (Decimal 23, Hex 0x17)

* Exponent = 0/None

* Exposant = 0/aucun

* Unit = Thermodynamic temperature: Degrees Fahrenheit (0x27AC) - Bluetooth LE Unit List

* Unité = témpérature thermodynamique (Thermodynamic temperature): Degrés Fahrenheit (0x27AC) - Bluetooth LE Unit List

* Namespace = Bluetooth SIG Assigned Number (0x01)

* Espace de nom/Namespace = Bluetooth SIG Assigned Number (0x01)

* Description = None (0x0000)

* Description = Aucune (0x0000)

The results from Nordic's Master Control Panel app can be seen below:

L'application "Master Control Panel" de Nordic affiche l'information suivante:

{{ADFImage|Bluefruit-LE-Shield-BLE-GATT-00.png}}

{{ADFImage|Bluefruit-LE-Shield-BLE-GATT-00.png}}

== AT+GATTCHAR ==

== AT+GATTCHAR ==

 

Fixer ou retrouver la valeur d'une caractéristique GATT personnalisée personnalisée (basé sur le numéro d'index ''index ID'' retourné par AT+GATTADDCHAR lorsque la caractéristique à été ajouté sur le périphérique).

Gets or sets the value of the specified custom GATT characteristic (based on the index ID returned when the characteristic was added to the system via AT+GATTADDCHAR).

* Codebase Revision: 0.3.0

* Codebase Revision: 0.3.0

* Parameters: This function takes one or two comma-separated functions (one parameter = read, two parameters = write).

* Paramètre: cette fonction prend un ou deux paramètres (séparé par une virgule, un paramètre = lecture, deux paramètres = écriture).

** The first parameter is the characteristic index value, as returned from the AT+GATTADDCHAR function. This parameter is always required, and if no second parameter is entered the current value of this characteristic will be returned.

** Le premier paramètre est l'index de la caractéristique, tel que retourné par la fonction AT+GATTADDCHAR. Ce paramètre est toujours nécessaire et s'il n'y a pas de second paramètres alors la valeur courante de la caractéristique est retournée.

** The second (optional) parameter is the new value to assign to this characteristic (within the MIN_SIZE and MAX_SIZE limits defined when creating it).

** Le second paramètre (optionnel) est la nouvelle valeur à assigner à la caractéristique (dans les limites définies par MIN_SIZE et MAX_SIZE lorsque la caractéristique à été créée).

* Response: If the command is used in read mode (only the characteristic index is provided as a value), the response will display the current value of the characteristics. If the command is used in write mode (two comma-separated values are provided), the characteristics will be updated to use the provided value.

* Réponse:  

** Si la commande est utilisée en mode lecture (avec l'index de la caractéristique comme seul paramètre) alors la réponse affichera la valeur actuelle de la caractéristique.

** Si la commande est utilisée en mode écriture (avec index de la caractéristique + une virgule + la nouvelle valeur) alors la caractéristique sera mise-à-jour pour utiliser la nouvelle valeur.

  <nowiki># Clear any previous custom services/characteristics

  <nowiki># Efface toutes les définitions antérieurs

# de services/caractéristiques personnalisées

AT+GATTCLEAR

AT+GATTCLEAR

OK

OK

# Add a battery service (UUID = 0x180F) to the peripheral

# Ajoute le service "battery" (UUID = 0x180F, état de la

# batterie) sur le périphérique

AT+GATTADDSERVICE=UUID=0x180F

AT+GATTADDSERVICE=UUID=0x180F

1

1

OK

OK

    

    

# Add a battery measurement characteristic (UUID = 0x2A19), notify enabled

# Ajoute la caractéristique "battery measurement"

# (UUID = 0x2A19, mesure de la batterie), notification activée

AT+GATTADDCHAR=UUID=0x2A19,PROPERTIES=0x10,MIN_LEN=1,VALUE=100

AT+GATTADDCHAR=UUID=0x2A19,PROPERTIES=0x10,MIN_LEN=1,VALUE=100

1

1

OK

OK

# Read the battery measurement characteristic (index ID = 1)

# Lire la caractéristique "battery measurement" (index ID = 1)

AT+GATTCHAR=1

AT+GATTCHAR=1

0x64

0x64

OK

OK

# Update the battery measurement characteristic to 32 (hex 0x20)

# Modifier la caractéristique "battery measurement" vers 32 (hex 0x20)

AT+GATTCHAR=1,32

AT+GATTCHAR=1,32

OK

OK

# Verify the previous write attempt

# Vérifier la valeur écrite

AT+GATTCHAR=1

AT+GATTCHAR=1

0x20

0x20

== AT+GATTLIST ==

== AT+GATTLIST ==

Lists all custom GATT services and characteristics that have been defined on the device.

Liste tous les services et caractéristiques GATT personnalisés qui ont été définis sur le périphérique.

* Codebase Revision: 0.3.0

* Codebase Revision: 0.3.0

* Parameters: None

* Paramètre: Aucun

* Response: A list of all custom services and characteristics defined on the device.

* Réponse: Une liste de tous les services personnalisé et toutes les caractéristiques définie sur le périphérique.

  <nowiki># Clear any previous custom services/characteristics

  <nowiki># Efface tous les services/caractéristiques personnalisés

AT+GATTCLEAR

AT+GATTCLEAR

OK

OK

# Add a battery service (UUID = 0x180F) to the peripheral

# Ajouter le service "battery" (UUID = 0x180F) sur le périphérique

AT+GATTADDSERVICE=UUID=0x180F

AT+GATTADDSERVICE=UUID=0x180F

1

1

OK

OK

    

    

# Add a battery measurement characteristic (UUID = 0x2A19), notify enabled

# Ajouter la caractéristique "battery measurement" (UUID = 0x2A19), notification activée

AT+GATTADDCHAR=UUID=0x2A19,PROPERTIES=0x10,MIN_LEN=1,VALUE=100

AT+GATTADDCHAR=UUID=0x2A19,PROPERTIES=0x10,MIN_LEN=1,VALUE=100

1

1

OK

OK

    

    

# Add a custom service to the peripheral

# Ajouter un service personalisé sur le périphérique

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

2

2

OK

OK

# Add a custom characteristic to the above service (making sure that there

# Ajouter une caractéristique personnalisé sur le service ci-dessus

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID)

# (S'assurer qu'il n'y a pas de conflit entre l'UUID 16 bits et

# les octets 3+4 sur UUID service 128-bit)

AT+GATTADDCHAR=UUID=0x0002,PROPERTIES=0x02,MIN_LEN=1,VALUE=100

AT+GATTADDCHAR=UUID=0x0002,PROPERTIES=0x02,MIN_LEN=1,VALUE=100

2

2

OK

OK

# Get a list of all custom GATT services and characteristics on the device

# Obtenir une liste de tous les services GATT personnalisés et

AT+GATTLIST

AT+GATTLIST

ID=01,UUID=0x180F

ID=01,UUID=0x180F

== AT+GATTCHARRAW ==

== AT+GATTCHARRAW ==

This read only command reads binary (instead of ASCII) data from a characteristic. It is non-printable but has less overhead and is easier when writing libraries in Arduino.

Cette commande en lecture seule lit les données binaires d'une caractéristique (au lieu de ASCII. L'information n'est pas affichable mais représente moins de surcharge et facilite l'écriture de bibliothèques pour Arduino (ou autre microcontroleur).

* Codebase Revision: 0.7.0

* Codebase Revision: 0.7.0

* Parameters: The numeric ID of the characteristic to display the data for

* Paramètre: Le numéro d'index de la caractéristique (''index ID'') dont on désire les données

* Output: Binary data corresponding to the specified characteristic.

* Sortie: les données binaire correspondant à la caractéristique.

{{ambox|text=Note: This is a specialized command and no NEWLINE is present at the end of the command!}}

{{ambox|text=Note : Il s'agit d'une commande spécialisée et il n'y a pas de caractère NEWLINE en fin de commande!}}

{{Bluefruit-LE-Shield-TRAILER}}

{{Bluefruit-LE-Shield-TRAILER}}