Flasher le Capteur XIAOMI Mijia Bluetooth lywsd03 pour Jeedom

NB : Pour agrandir les images : clic droit / ouvrir l’image dans un nouvel onglet

/!\ ATTENTION /!\ en dessous de 30% de batterie affiché sur Jeedom il y a une diminution de la fiabilité des infos, vers 20% un affichage LOW BATTERIE est visible sur le LCD avec perte du Bluetooth

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 et 5000ms.

Choisir “Atc1441” au lieu de “ALL” permet d’Ă©viter d’avoir des tempĂ©ratures incohĂ©rente (ex : 3000°C), de plus garder le “ALL” va gâcher de la batterie pour des info inutile et diviser par 4 la publication du format qui vous intĂ©resse.

En utilisant ces réglages on constate que nous avons 2x plus de données exploitables (5s Vs 10s) avec presque 2x moins de batterie (cf schéma suivant)
  • 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  et modifiĂ© par skillix pour prendre en compte les valeurs nĂ©gatives:
# 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])
                
                
                if temp > 60000 :
                	temp = 0 - ( 65530 - temp ) 
                
                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 !

NB : Si vous avez des tempĂ©ratures farfelues, vĂ©rifiez que vous avez bien changer l’adversering type, si c’est bien le cas vous pouvez utiliser une deuxièmes sĂ©curitĂ© en appliquant une valeur maximale :

Bonus – plugin Alexa (ASH)

Pour ceux qui souhaiteraient envoyer leurs thermomètres dans Alexa pour y accéder vocalement voici comment les configurer :

  • Trouver sont Ă©quipement dans Alexa plugin, cocher transmettre, choisir le type capteur de tempĂ©rature
MĂŞme si ce n’est pas obligĂ© je vous conseil de choisir un non, car sinon il le nommera “[Object]+[Ă©quipement]
  • Si vous rencontrĂ© un NOK (ce fonctionne aussi avec le OK) cliquez dessus, il vous explique ce dont il a besoin
notez les types générique attendu
  • Reportez les sur la commande adĂ©quate :
Engrenage de l’Ă©quipement

Puis, engrenage de la commande de température

Enfin on choisi le type générique de notre commande, soit, environnement/température
  • Sauvegarder, revenez sur le plugin Alexa, sauvegardez encore.
  • Lancez un scan sur l’application ALEXA

Normalement votre thermomètre est découvert et OK dans le plugin.

Bonus du Bonus

Sur la dernière image, j’ai configurĂ© ma commande de tempĂ©rature pour ĂŞtre averti (vocal et sms) si mon frigo passe au dessus de 11 degrĂ©s pendant plus de 10 minutes. Cela Ă©vite de crĂ©er des scĂ©nario.

Laisser un commentaire