Capteurs Bluetooth (BLE) : ouvrir la voie à une intégration externe

Suite à un échange avec le créateur de Theengs / OpenMQTTGateway, un manque a été identifié : Gladys a bien une intégration Bluetooth, mais elle ne couvre qu’une poignée d’appareils — alors que l’écosystème des capteurs BLE (température, humidité, plantes, etc. : Xiaomi, SwitchBot, RuuviTag…) est énorme, et que des projets comme Theengs savent en décoder des centaines.

Pour moi, ça doit passer par une intégration externe, pas par du code dans le core. Mais aujourd’hui, le framework d’intégrations externes ne donne pas accès au Bluetooth de la machine, et pour de bonnes raisons : contrairement à une clé Zigbee (un simple périphérique USB qu’on peut monter dans le conteneur), donner l’accès Bluetooth à un conteneur implique de lui donner des privilèges réseau très larges sur la machine, incompatible avec le modèle de sécurité du store (des intégrations tierces non auditées, installables en un clic).

La piste envisagée : un accès Bluetooth médié, sur le même modèle que la découverte réseau déjà en place, le core écoute la radio et relaie les trames brutes, l’intégration les décode et publie capteurs et états via les API existantes. L’adaptateur reste sous le contrôle du core, ce qui sera de toute façon indispensable le jour où on fera du commissioning Matter/Thread en BLE.

À noter : pour ceux qui utilisent des passerelles ESP32 avec OpenMQTTGateway, une intégration externe est déjà possible dès aujourd’hui via MQTT, sans rien changer au framework.

Le sujet ici, c’est l’utilisation de l’adaptateur Bluetooth de la machine qui fait tourner Gladys.

Salut,

En effet si l’acces au Bluetooth est possible ca devrait nous permettre de decoder les trames et de rendre Gladys compatible en lecture avec tous ces appareils

Voici ce dont un décodeur comme Theengs a besoin, côté API :

1. C’est l’intégration qui pilote le scan — le core exécute et arbitre. Même philosophie que scanNetwork() : l’intégration demande une fenêtre de scan bornée, par exemple gladys.scanBluetooth({ mode, durationSeconds, filters }), et le core garde la main sur l’adaptateur. Deux nuances par rapport à scanNetwork :

  • les trames doivent être streamées pendant la fenêtre (callback au fil de l’eau), pas seulement rendues en bloc à la fin, la latence compte pour les états ;
  • la fenêtre doit être renouvelable (modèle de bail) : c’est l’intégration qui décide de sa cadence — soutenue pendant une découverte, duty cycle relâché en régime de croisière (ex. 10 s de scan toutes les 60 s), arrêt quand l’utilisateur désactive.

Le core reste seul arbitre : durée max par fenêtre, quotas, partage entre intégrations, et préemption immédiate quand Matter/Thread a besoin de la radio.

2. Le contenu de trame minimal. Pour décoder, Theengs a besoin de :

  • mac (+ type d’adresse public/random) — c’est l’identifiant stable de l’appareil
  • rssi
  • name (local name) si présent
  • manufacturerdata (bytes, hex ou base64)
  • servicedata + servicedatauuid
  • serviceUuids annoncés
  • un timestamp, et l’indication trame d’advertising vs scan response

Un champ brut (payload_base64 des AD structures, cohérent avec scanNetwork) en complément des champs parsés serait idéal : ça couvre les cas exotiques sans figer le parsing côté core.

3. Scan passif ET actif, au choix de la requête. Certains capteurs très répandus n’exposent leurs données que dans la scan response (donc scan actif requis). Le mode est un paramètre de la requête de scan ; le manifest, lui, déclare la capacité maximale autorisée (ex. "bluetooth": { "modes": ["passive", "active"] }) que l’utilisateur accorde à l’installation.

4. Filtrage côté core, paramétré par la requête. Optionnel mais précieux pour ne pas saturer le WebSocket : filtres par préfixe MAC, manufacturer_id ou service_uuid passés dans les options de scan, et un throttle par MAC (ex. max 1 trame/MAC/seconde, les capteurs répètent la même trame en rafale).

5. Gestion des adaptateurs : au niveau du core, propriétaire unique. C’est le point qui rend le modèle médié vraiment supérieur à un accès direct :

  • le core inventorie les adaptateurs (hci0, dongles USB…), les tient à jour (hotplug), surveille leur santé et les réinitialise en cas de blocage, les adaptateurs BLE bon marché gèlent régulièrement, un watchdog centralisé profite à tout le monde ;
  • le core est l’unique propriétaire de chaque adaptateur et multiplexe tous les consommateurs : service Bluetooth core (GATT/présence), commissioning Matter/Thread, et fenêtres de scan des intégrations, fini les conflits d’ownership entre processus ;
  • côté utilisateur : si plusieurs adaptateurs sont présents, c’est dans la config core qu’il assigne les rôles (ex. hci0 réservé à Matter, dongle USB pour le scan des intégrations) ;
  • côté intégration : jamais de chemin /dev ni de nom d’adaptateur physique, au plus un identifiant logique optionnel dans les options de scan quand l’utilisateur a assigné plusieurs adaptateurs. L’intégration demande « un scan », pas « l’adaptateur X ».

Bonus à terme : plusieurs adaptateurs assignés au scan = plusieurs antennes, meilleure couverture —et l’API n’a pas à changer, le core agrège les trames.

6. Consentement utilisateur. Comme pour les classes matérielles existantes : l’écoute BLE révèle la présence de personnes (téléphones, wearables) — un écran d’autorisation à l’installation, distinct des autres permissions, semble la bonne granularité.

7. Hors périmètre pour un v1 du relais (de notre point de vue) : pas de connexion GATT ni d’écriture depuis les intégrations, l’advertising en lecture seule couvre déjà l’immense majorité des capteurs, et ça garde le modèle de sécurité simple.

Quelques ressources:

https://www.npmjs.com/package/theengs-decoder

Salut tout le monde !

Ce sujet est désormais en cours de développement.

Une PR a été ouverte pour spécifier le streaming des advertisements BLE (capteurs Bluetooth) :

N’hésitez pas à suivre la PR, à tester (optionnel, surtout pour les petites demandes) et à faire vos retours ici si besoin.

@1technophile J’ai proposé une spec avec Fable 5, tu en penses quoi ? :slight_smile:

@pierre-gilles Cela va ouvrir la voie pour une intégration externe OTBR ?

Merci, qq commentaires mais rien de bloquant

Merci pour tes retours @1technophile !

Non je ne pense pas !

Bonjour,

Je développe un outil pour communiquer en BLE avec un vieil appareil de mesure de la radioactivité (FTLab BSG-001). Rien n’est standard dans son protocole Bluetooth : l’appareil n’envoie rien de lui-même et ne publie pas ses mesures dans ses annonces. Il faut se connecter en GATT, lui envoyer des requêtes et écouter ses notifications. De plus, il cesse d’émettre ses annonces dès qu’un client est connecté.

D’après le point 7 du message de @1technophile (pas de connexion ni d’écriture GATT depuis les intégrations dans une v1), je comprends qu’une intégration externe n’est pas envisageable pour ce type d’appareil pour l’instant. Est-ce bien ça ?

Deux questions :

  • L’accès GATT relayé par le cœur est-il envisagé dans une version ultérieure, ou est-il exclu ? J’ai aussi vu que la PR de spécification #2935 a été fermée automatiquement : le sujet est-il en pause ?
  • En attendant, quelle approche recommandez-vous ? Un petit service Bluetooth séparé, hors de Gladys, qui expose les mesures en MQTT (ou via une API qu’une intégration externe interrogerait) ?

Bonjour @ldesgrange,

Oui, tu as bien compris : une intégration externe ne peut pas gérer ce type d’appareil aujourd’hui, et ce ne sera pas possible dans un futur proche non plus.

Sur le GATT relayé par le cœur

Ce n’est pas exclu pour toujours, mais ce n’est pas prévu. Le relais BLE dont on parle dans ce sujet sert uniquement à écouter les annonces, en lecture seule. C’est un choix voulu. Laisser une intégration installée en un clic, sans relecture du code, se connecter en GATT et écrire sur n’importe quel appareil Bluetooth autour de la maison n’a rien à voir avec écouter des annonces, en termes de sécurité. Il y a aussi un problème de partage de la radio : une connexion GATT occupe l’adaptateur. Ton appareil le montre bien d’ailleurs, puisqu’il arrête ses annonces dès qu’un client est connecté. Il faudrait que le cœur gère la vie de chaque connexion, et ça dépend beaucoup de chaque appareil.

Pour la PR #2935 : elle a été fermée automatiquement par le bot parce qu’elle n’avait plus d’activité. Ce n’est pas une décision d’abandonner le sujet. Mais il faut être clair : la spec n’a pas été mergée et rien n’est développé pour l’instant, même la partie lecture des annonces.

En attendant : oui, un petit service séparé qui publie en MQTT, c’est la bonne approche

Je te conseille de faire comme ceci :

  • Un petit programme indépendant qui se connecte en GATT à ton BSG-001, envoie les requêtes et écoute les notifications. En Python, bleak marche très bien pour ça.
  • Il publie les mesures sur le broker MQTT avec le format de découverte MQTT Home Assistant (homeassistant/sensor/.../config + un topic d’état). L’intégration MQTT de Gladys gère ce format depuis cet été : l’appareil apparaît tout seul dans l’onglet de découverte MQTT, sans rien créer à la main.
  • Autre solution : créer l’appareil à la main dans l’intégration MQTT et publier sur gladys/master/device/<external_id>/feature/<feature_external_id>/state.

Pas besoin d’ajouter une intégration externe qui interroge une API : avec MQTT, tu as déjà tout ce qu’il faut.

Deux remarques :

  • Si ce programme tourne sur la même machine que Gladys et que l’intégration Bluetooth de Gladys est activée, les deux vont se disputer l’adaptateur. Il vaut mieux désactiver l’intégration Bluetooth de Gladys, utiliser un second dongle, ou faire tourner le programme sur un autre appareil plus près du compteur (un Raspberry Pi par exemple).
  • Gladys n’a pas encore de catégorie « radioactivité » (µSv/h). Avec la découverte Home Assistant, la mesure sera remontée comme un capteur générique. Si tu veux une vraie catégorie, on peut en discuter dans un sujet à part, en suivant nos critères pour les catégories d’appareils.