{"id":2741,"date":"2017-12-21T03:15:44","date_gmt":"2017-12-21T02:15:44","guid":{"rendered":"https:\/\/www.fanjoe.be\/?p=2741"},"modified":"2018-05-30T15:58:57","modified_gmt":"2018-05-30T13:58:57","slug":"flower-care-miflora-de-xiaomi-recuperer-les-donnees-avec-gatttool-sur-un-rpi-3","status":"publish","type":"post","link":"https:\/\/www.fanjoe.be\/?p=2741","title":{"rendered":"Flower Care \/ MiFlora de Xiaomi : R\u00e9cup\u00e9rer les donn\u00e9es avec Gatttool sur un RPi 3"},"content":{"rendered":"

Introduction<\/h1>\n

Dans un article pr\u00e9c\u00e9dent<\/a>, j’avais \u00e9voqu\u00e9 une mani\u00e8re de r\u00e9cup\u00e9rer des donn\u00e9es depuis un capteur Flower Care \/ MiFlora de Xiaomi vendu pour un peu plus de 20\u20ac sur Amazon<\/a>.<\/p>\n

Pour ce faire, on utilisait l\u2019outil \u00ab\u00a0miflora<\/em>\u00a0\u00bb publi\u00e9 par BarnyBug<\/em> sur GitHub<\/a>.<\/em><\/p>\n

Mais nous allons voir ici comment importer ces donn\u00e9es avec l’outil gatttool sur Linux.<\/p>\n

Importer les donn\u00e9es<\/h1>\n

Installation du bluetooth<\/h2>\n

En principe, si vous utilisez un RPi 3, avec Jessie ou Stretch, les outils gatttool<\/em> et hcitool<\/em> que nous allons utiliser plus loin devraient d\u00e9j\u00e0 \u00eatre install\u00e9s.
\nSi ce n’est pas le cas, je vous renvoie vers cet article : https:\/\/thepihut.com\/<\/a><\/p>\n

$ sudo apt-get update\r\n$ sudo apt-get upgrade\r\n$ sudo apt-get install bluetooth bluez-utils blueman\u00a0bluez<\/pre>\n
D\u00e9terminer l’adresse MAC du Miflora<\/h2>\n
Pour d\u00e9terminer cette adresse, nous allons utiliser l’outil hcitool<\/em>.<\/p>\n
$ sudo hcitool lescan<\/pre>\n
Ce qui devrait nous retourner la liste des p\u00e9riph\u00e9rique Bluetooth LE (Low Energy) qui se trouvent \u00e0 proximit\u00e9 :<\/p>\n
LE Scan ...\r\n00:A0:50:44:0B:F3 (unknown)\r\n00:A0:50:44:0B:F3 SensePeanut\r\nC4:7C:8D:63:85:B1 (unknown)\r\nC4:7C:8D:63:85:B1 Flower care\r\nC4:7C:8D:63:85:B1 (unknown)<\/pre>\n
Nous avons donc un Flower care avec l’adresse MAC : C4:7C:8D:63:85:B1<\/code><\/p>\n
Importer les donn\u00e9es avec gatttool<\/h2>\n
Premiers pas avec gatttool<\/h3>\n
Pour nous connecter, nous allons taper cette commande :<\/p>\n
$ sudo gatttool --device=C4:7C:8D:63:85:B1 -I<\/pre>\n
Une fois d\u00e9marr\u00e9, l’outil est pr\u00eat \u00e0 recevoir des commandes et ceci devrait apparaitre \u00e0 l’\u00e9cran :<\/p>\n
[C4:7C:8D:63:85:B1][LE]><\/pre>\n
On va se connecter avec cette commande :<\/p>\n
connect<\/pre>\n
L’outil devrait r\u00e9pondre quelque chose comme ceci et l’adresse MAC devrait passer en bleu lorsque la connexion est \u00e9tablie :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> connect\r\nAttempting to connect to C4:7C:8D:63:85:B1\r\nConnection successful\r\nNotification handle = 0x0021 value: 00 \r\nNotification handle = 0x0021 value: 00 \r\n[C4:7C:8D:63:85:B1]<\/span>[LE]<\/pre>\n
Un petit help<\/code> va nous retourner toutes les commandes disponibles :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> help\r\nhelp                                          Show this help\r\nexit                                          Exit interactive mode\r\nquit                                          Exit interactive mode\r\nconnect [address [address type]]              Connect to a remote device\r\ndisconnect                                    Disconnect from a remote device\r\nprimary [UUID]                                Primary Service Discovery\r\nincluded [start hnd [end hnd]]                Find Included Services\r\ncharacteristics [start hnd [end hnd [UUID]]]  Characteristics Discovery\r\nchar-desc [start hnd] [end hnd]               Characteristics Descriptor Discovery\r\nchar-read-hnd <handle>                        Characteristics Value\/Descriptor Read by handle\r\nchar-read-uuid <UUID> [start hnd] [end hnd]   Characteristics Value\/Descriptor Read by UUID\r\nchar-write-req <handle> <new value>           Characteristic Value Write (Write Request)\r\nchar-write-cmd <handle> <new value>           Characteristic Value Write (No response)\r\nsec-level [low | medium | high]               Set security level. Default: low\r\nmtu <value>                                   Exchange MTU for GATT\/ATT<\/pre>\n
La commande primary<\/code> va explorer les handles <\/em>des services primaires :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> primary\r\nattr handle: 0x0001, end grp handle: 0x0009 uuid: 00001800-0000-1000-8000-00805f9b34fb\r\nattr handle: 0x000c, end grp handle: 0x000f uuid: 00001801-0000-1000-8000-00805f9b34fb\r\nattr handle: 0x0010, end grp handle: 0x0022 uuid: 0000fe95-0000-1000-8000-00805f9b34fb\r\nattr handle: 0x0023, end grp handle: 0x0030 uuid: 0000fef5-0000-1000-8000-00805f9b34fb\r\nattr handle: 0x0031, end grp handle: 0x0039 uuid: 00001204-0000-1000-8000-00805f9b34fb\r\nattr handle: 0x003a, end grp handle: 0x0042 uuid: 00001206-0000-1000-8000-00805f9b34fb<\/pre>\n
La commande char-desc<\/code> va explorer les descripteurs de caract\u00e9ristiques :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> char-desc 0x0001\r\nNotification handle = 0x0021 value: 00 \r\nhandle: 0x0001, uuid: 00002800-0000-1000-8000-00805f9b34fb\r\nhandle: 0x0002, uuid: 00002803-0000-1000-8000-00805f9b34fb\r\nhandle: 0x0003, uuid: 00002a00-0000-1000-8000-00805f9b34fb\r\n\r\nhandle: 0x0033, uuid: 00001a00-0000-1000-8000-00805f9b34fb\r\n\r\nhandle: 0x0035, uuid: 00001a01-0000-1000-8000-00805f9b34fb\r\n\r\nhandle: 0x0038, uuid: 00001a02-0000-1000-8000-00805f9b34fb\r\n\r\nhandle: 0x0041, uuid: 00001a12-0000-1000-8000-00805f9b34fb\r\nhandle: 0x0042, uuid: 00001a12-0000-1000-8000-00805f9b34fb<\/pre>\n
Lire un handle<\/h3>\n
Pour lire le contenu d’un handle<\/em>, on utilise la commande char-read-hnd<\/code> suivie du n\u00b0 du handle<\/em> qui nous int\u00e9resse :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> char-read-hnd 0x0035\r\nCharacteristic value\/descriptor: aa bb cc dd ee ff 99 88 77 66 00 00 00 00 00 00<\/pre>\n
Les handles<\/em> qui nous int\u00e9ressent<\/h3>\n
Dans un post sur la plateforme de Jeedom<\/em><\/a>, j’ai trouv\u00e9 une petite liste reprenant les handles<\/em> qui vont nous int\u00e9resser. Il s’agit du 0x0003, du 0x0033, du 0x0035 et du 0x0038.<\/p>\n
Un autre post de la communaut\u00e9 Home Assistant<\/a>, nous apprend que jusqu’\u00e0 la version 2.6.2 du firmware du MiFlora, les donn\u00e9es \u00e9taient directement lisibles dans le handle<\/em> 0x0035.<\/p>\n
Mais depuis la version 2.6.6, il faut d’abord inscrire la valeur A01F<\/code> dans le handle<\/em> 0x0033<\/code> pour d\u00e9clencher le live data<\/em> et pouvoir lire les donn\u00e9es en 0x0035<\/code>.<\/p>\n
Sans \u00e7a, les donn\u00e9es retourn\u00e9es seraient celles par d\u00e9faut :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> char-read-hnd 0x0035\r\nCharacteristic value\/descriptor: aa bb cc dd ee ff 99 88 77 66 00 00 00 00 00 00<\/pre>\n
Pour ce faire, on utilise la commande :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> char-write-req 0x0033 A01F<\/pre>\n
Une nouvelle lecture de 0x0035 devrait nous retourner quelque chose comme ceci :<\/p>\n
[C4:7C:8D:63:85:B1][LE]> char-read-hnd 0x0035\r\nCharacteristic value\/descriptor: 8f 00 00 10 00 00 00 23 dc 01 02 3c 00 fb 34 9b<\/pre>\n
NB:<\/strong> Les commandes write<\/em> et read<\/em> doivent \u00eatre pass\u00e9es rapidement sans quoi les valeurs retourn\u00e9es seront celles de base.<\/p>\n
[C4:7C:8D:63:85:B1][LE]> connect\r\n[C4:7C:8D:63:85:B1][LE]> char-write-req 0x33 A01F\r\nCharacteristic value was written successfully\r\n[C4:7C:8D:63:85:B1][LE]> char-read-hnd 0x35\r\nCharacteristic value\/descriptor: 8f 00 00 10 00 00 00 23 dc 01 02 3c 00 fb 34 9b \r\n[C4:7C:8D:63:85:B1][LE]> quit<\/pre>\n
En ligne de commande<\/h3>\n
Nous allons voir comment utiliser gatttool en ligne de commande :<\/p>\n
$ sudo gatttool --device=C4:7C:8D:63:85:B1 --char-write-req -a 0x33 -n A01F\r\n\r\n$ sudo gatttool --device=C4:7C:8D:63:85:B1 --char-read -a 0x35<\/pre>\n
Structure des donn\u00e9es<\/h2>\n
Nombres entiers sur plusieurs octets<\/h3>\n
Les donn\u00e9es sont cod\u00e9es sur des octets en Little endian<\/em>. C.-\u00e0-d. avec l’octet de poids le plus faible en premier.<\/p>\n
Pour comprendre la repr\u00e9sentation des nombres entiers sur plusieurs octets, vous pouvez consulter cette page Wikipedia : https:\/\/fr.wikipedia.org\/wiki\/Endianness<\/a><\/p>\n
Handle 0x0035<\/h3>\n
Correction<\/strong> le 06\/01\/2018 selon le commentaire de Rene Jullien :
\nTemp\u00e9rature cod\u00e9e sur 2 bytes et non 3.<\/p>\n
Exemple<\/strong> : 8f 00<\/span> 00 10 00 00 00<\/span> 23<\/span> dc 01<\/span> 02 3c 00 fb 34 9b<\/p>\n\n\n\n\n\t\n\t\n\t
8f<\/td>00<\/td>00<\/td>10<\/td>00<\/td>00<\/td>00<\/td>23<\/td>dc<\/td>01<\/td>02<\/td>3c<\/td>00<\/td>fb<\/td>34<\/td>9b<\/td>\n<\/tr>\n
143<\/td><\/td>16<\/td>35<\/td>476<\/td><\/td><\/td><\/td><\/td><\/td><\/td>\n<\/tr>\n
Temp\u00e9rature<\/td>??<\/td>Ensoleillement<\/td>Humidit\u00e9<\/td>Engrais<\/td>??<\/td>??<\/td>??<\/td>??<\/td>??<\/td>??<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
Le handle 0x0035 retourne ces donn\u00e9es :<\/p>\n