Flasher le Capteur XIAOMI Mijia Bluetooth lywsd03 pour Jeedom

Quand on commence la domotique, on y rentre à tâtons et nos choix s’orientent vite vers les produits les moins chers. Beaucoup d’entre nous commençons avec une marque pas (trop) chère et avec une bonne réputation, Xiaomi !

Au vu du prix, beaucoup d’entre nous choisissent ce produit :

Mais comme nous commençons à ce moment là dans la domotique, nous n’imaginons pas la galère dans laquelle ce petit thermomètre beau et pas cher va nous mettre !

Ce qui est nĂ©cessaire :

  • Un capteur
  • Un Jeedom avec une antenne Bluetooth (local ou dĂ©portĂ©)
  • BLEA (plugin)
  • JeeXplorer (plugin)
  • Un Pc / Mobile avec Bluetooth

Il existe plusieurs sujets qui expliquent comment bidouiller BLEA avec les BindKey, le flasher et bidouiller ou encore ne rien toucher et utiliser une passerelle Xiaomi combiné à un skill Alexa et le remonter dans Jeedom grâce au plugin AlexaAPI/smarthome.

Rendons un hommage à tous ceux qui ont travaillé en les citant à travers ces sources :

https://github.com/atc1441/ATC_MiThermometer

http://atcnetz.blogspot.com/2020/09/custom-firmware-fur-das-4-xiaomi.html

https://github.com/pvvx/ATC_MiThermometer#bluetooth-advertising-formats

https://community.jeedom.com/t/refresh-xiaomi-lywsd03mmc/17216

https://community.jeedom.com/t/valeurs-non-remontees/44590/10

https://community.jeedom.com/t/refresh-xiaomi-lywsd03mmc/17216/77

Chaque mĂ©thode possède ses avantages et ses inconvĂ©nients :

AlexaAPI/smarthome :

Avantages :

  • Aucune bidouille
  • Très simple
  • Pas de flashage

InconvĂ©nients :

  • NĂ©cessite une passerelle Bluetooth Xiaomi
  • Avoir Alexa
  • Trous dans les remontĂ©s (très rare mais embĂŞtant quand on pilote un chauffage)
  • Pas CloudFree (DĂ©pendant d’internet)

BLEA avec les BindKey :

Avantages :

  • CloudFree (DĂ©pendant d’internet)
  • Pas de flashage

InconvĂ©nients :

  • Complexe (rĂ©cupĂ©ration @MAC, BindKey)
  • Trous dans les remontĂ©s (très rare mais embĂŞtant quand on pilote un chauffage)
  • Modification des BindKey si connexion sur MihHome/Autre
  • Avoir une antenne Bluetooth
  • Installation d’une dĂ©pendance de dĂ©cryptage de clĂ©s

BLEA avec flashage :

Avantages :

  • Simple
  • Capteur paramĂ©trable
  • RemontĂ© sans trou (ou pas encore constatĂ© Ă  ce jour)

InconvĂ©nients :

  • Flashage
  • Avoir une antenne Bluetooth

Même tout ceci n’est pas si compliqué, voir très simple dans certains cas, ce n’est pas forcément la vision qu’on peut en avoir au début. J’ai longtemps galéré, tâtonné, fait des erreurs et souvent je ne comprenais pas des choses pourtant très simples.

C’est pourquoi je rédige ce tuto concernant la dernière solution, en vulgarisant au maximum pour le débutant de Jeedom.

Pourquoi choisir cette mĂ©thode ?

Je les ai toutes testées et je n’ai jamais été réellement satisfait, trop de trou dans la remontée, ou trop de contrainte de maintien. Finalement je suis resté sur la plus stable à mon gout AlexaAPI/smarthome. Je n’avais à l’époque pas retenu le flashage car il n’y avait pas de moyen de l’intégrer à BLEA.

Le nouveau firmware a fini de me convaincre, car cette solution me semble la plus stable au niveau des remontés, meilleure optimisation de la batterie et les inconvénients peuvent être considérés comme des avantages.

Pour comparatif sur 1H avec mes sondes encore sous Alexa :

Alexa

BLEA flashé

Constat sans appel !

Rappel important :

Pour ceux qui voudraient comparer les diffĂ©rentes mĂ©thodes Ă  plus longs termes, je vous rappelle que par dĂ©faut les historiques sont lissĂ©s/moyennĂ©s au-delĂ  de 2h tous les jours au CRON d’archivage (environ 4h00) avec 1 valeur moyenne par heure :

L’archivage a lieu une fois par jour dans la nuit les 2h sont appliquĂ© a partir de lĂ 

Que l’on constate sous la forme de :

Avant 3h, ce n’est pas qu’il y a eu qu’une remontĂ©e toutes les heures, mais toutes les remontĂ©es ont Ă©tĂ© regroupĂ©es en une moyenne par heures

Donc il faudra changer ces paramètres pour un comparatif objectif.

  1. Le flashage

Même si l’ancienne méthode de flashage proposée par Aaron Christophel était déjà pas mal

https://atc1441.github.io/TelinkFlasher.html

https://github.com/atc1441/ATC_MiThermometer

http://atcnetz.blogspot.com/2020/09/custom-firmware-fur-das-4-xiaomi.html

Victor pvvx, l’a reprise et l’a améliorée !

https://github.com/pvvx/ATC_MiThermometer

https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html

En rĂ©sumĂ©, cette nouvelle mouture propose un chargement automatique du dernier firmware, une optimisation de la batterie, ainsi qu’une multitude de paramĂ©trages supplĂ©mentaires (dont dĂ©clencheur d’action physique sur la broche de test, bon faudra souder pour ça :p )

Rendez-vous sur la page https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html

Nota : Si vous avez un capteur déjà flashé au format T1441, il est possible que vous deviez soit passer par le flasher T1441 pour remettre le firmware Xiaomi, ou bien utiliser la page https://pvvx.github.io/ATC_MiThermometer/TelinkOTA.html et pour effectuer une mise a jour OTA de T1441 vers PVVX. Retourner ensuite sur le flasher PVVX pour modifier les paramètres.

  • Activez le Bluetooth du Pc/Mobile avant de tenter de se connecter 
  • Saisissez « LYWSD03 » dans « BLE device name prefix filter »(cela permet de n’avoir que les thermomètres Xiaomi), « ATC » permettra mettre le filtre pour un thermomètre dĂ©jĂ  flashĂ©
  • Appuyez sur « Connecter » et sĂ©lectionnez votre thermomètre
  • Attendez que la connexion soit Ă©tablie
  • Appuyez sur « Do Activation »
  • Attendez la rĂ©cupĂ©ration des clĂ©s Xiaomi
  • Appuyez sur « Custom Firmware ver 2.x »
    • Nota le bouton Ă  cotĂ© est celui pour remettre la version Xiaomi de base
  • Appuyez sur « Start Flashing »
    • Le Flash prend plusieurs secondes voir plusieurs minutes
  • Si cela ne se fait pas tout seul appuyez sur « Reconnect »
  • Sauf besoin particulier je prĂ©conise de ne toucher que 2 valeurs :
  • Advertising type est le format des trames, par dĂ©faut est sur « ALL Â» et envoi donc aussi des trames au format Xiaomi, qui est je pense la source de valeurs farfelue que vous verrez dans la dernière vidĂ©o car j’ai oubliĂ© de changer ce paramètre au dĂ©but.

On choisit donc « Atc1441 Â» car c’est pour ce format qu’a Ă©tĂ© dĂ©veloppĂ© le code qu’on utilisera plus tard.

  • Advertising interval est la valeur de rafraichissement des trames, j’ai choisi cette valeur car elle permet d’optimiser la durĂ©e de vie de la batterie de 7 mois sans trop affecter la frĂ©quence de rafraĂ®chissement.
  • Une fois les paramètres choisis appuyez sur « Send Config »

VoilĂ  le flashage est terminĂ© !

  • Modification du fichier lywsd03.py

Nota : il semblerait que le .Py original arrive à lire cette version flashée sans modification (à confirmer), la différence de code (parse) permettrait de remonter les données (noté en entête) au moment de la vérification de la présence sans établir de connexion, un peu comme si vous recherchiez un réseau wifi et que derrière le nom il y avait des infos en claires. Donc le code suivant peut être utile pour forcer indirectement le refresh sans bloquer la sonde.

Quand on est habitué à Jeedom cela peu paraître bête, mais quand on débute on se demande comment modifier un fichier ; Winscp ne fonctionne pas sans droit root, PuTTY n’est pas pratique si vous n’êtes pas parfaitement familiarisé avec linux…

La rĂ©ponse est pourtant simple, JeeXplorer !

JeeXplorer est un plugin « explorateur Â» comme son nom l’indique, il permet, la modification, crĂ©ation, suppression de fichiers/dossiers

  • Ouvrez JeeXplorer
  • Naviguez dans l’arborescence jusqu’à html/plugins/blea/resources/blead/devices/
  • Sauvegardez le fichier lywsd03.py
    • Clic droit
  • Laissez le fichier dupliquĂ© il servira si jamais vous voulez le restaurer
  • Editez le fichier (clic droit Ă©diter ou double clic gauche) avec le code avec le code de dudusse optimisĂ© par DrKamp  :
# coding: utf-8
from bluepy import btle
import time
import logging
import globals
import struct
from multiconnect import Connector
from notification import Notification

class Lywsd03():
        def __init__(self):
                self.name = 'lywsd03'
                self.ignoreRepeat = False

        def isvalid(self,name,manuf='',data='',mac=''):
                logging.debug('LYWSD03------isvalid data=%s, mac=%s, name=%s, manuf=%s' % (data, mac, name, manuf))
                if name.lower() in [self.name]:
                        return True
                if data.lower().startswith("1a18") and (mac.lower().startswith("a4:c1:38")):
                        #broadcasted advertising data
                        return True

        def parse(self,data,mac,name,manuf):
                logging.info('LYWSD03------adv data=%s, mac=%s, name=%s, manuf=%s' % (data, mac, name, manuf))
                action={}
                action['present'] = 1

                bd = bytes.fromhex(data)

                (temp,) = struct.unpack('>H', bd[8:10])
                temp = temp / 10
                humi =  bd[10]
                batt = bd[11]

                action["temperature"] = temp
                action["moisture"] = humi
                action["battery"] = batt

                logging.info('LYWSD03------mac=%s, temp=%s, humi=%s, batt=%s' % (mac, temp,humi,batt))

                return action

        def read(self,mac):
                result={}
                try:
                        conn = Connector(mac)
                        conn.connect()
                        if not conn.isconnected:
                                conn.connect()
                                if not conn.isconnected:
                                        return
                        batt = bytearray(conn.readCharacteristic('0x3a'))
                        battery = batt[0]
                        notification = Notification(conn,Lywsd03)
                        notification.subscribe(10)
                        result['battery'] = battery
                        result['id'] = mac
                        logging.debug('LYWSD03------'+str(result))
                        return result
                except Exception as e:
                        logging.error(str(e))
                return result

        def handlenotification(self,conn,handle,data,action={}):
                result={}
                if hex(handle) == '0x36':
                        received = bytearray(data)
                        temperature = float(received[1] * 256 + received[0]) / 100
                        moisture = received[2]
                        result['moisture'] = moisture
                        result['temperature'] = temperature
                        result['id'] = conn.mac
                        result['source'] = globals.daemonname
                        globals.JEEDOM_COM.add_changes('devices::'+conn.mac,result)

globals.COMPATIBILITY.append(Lywsd03)
  • Enregistrez et quittez
  • Sauvegardez votre fichier en le dupliquant et en le renommant
  • BLEA :
  • Relancez le dĂ©mon
L’ancienne version du code obligeait Ă  rechercher les devises inconnues, pas le nouveau !

/ ! \ IMPORTANT : si vous utilisez une antenne déportée, penser à

Et

  • Lancez un scan
    • / ! \ Pensez a couper le Bluetooth du Pc/Mobile car il est toujours connectĂ© et c’est le cas le capteur et ne sera pas dĂ©tectable ou de vĂ©rifier que l’@ MAC n’est pas dĂ©jĂ  dans les pĂ©riphĂ©riques inconnus de BLEA
  • Choisissez « lywsd03 Â» et suivez l’inclusion classique
  • DĂ©cochez le refresh forcĂ©
  • Cochez historiser si vous souhaitez avoir des graphes ou vĂ©rifier vos remontĂ©es

Voila vous avez fini !

One thought on “Flasher le Capteur XIAOMI Mijia Bluetooth lywsd03 pour Jeedom

  1. Salut,

    Merci pour ce tuto.

    Lors d’une mise Ă  jour du plugin BLEA, le fichier est-il supprimĂ© ? Faut-il faire une copie avant la mise Ă  jour puis après le remettre ?

    Merci;

    Loutre38

    1. Oui une mise a jour de BLEA supprime le fichier pour replacer le fichier d’origine. C’est pourquoi dans le tuto je fais une sauvegarde du fichier avant.
      Sinon moi ce que j’ai fais j’ai ouvert le fichier avec JeeXplorer, fait la mise a jour sur un autre onglet puis enregistrĂ© apres la mise a jour.

      Apres d’après les retours de certaines personnes sur le forum Jeedom, avec ce firmware, il semblerait que le fichier .Py d’origine BLEA soit capable de lire sans problèmes les informations de tempĂ©ratures, humiditĂ©s et batteries sans problèmes.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *