Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- it:iot:xiaomi-mi-robot-vacuum-mop-2-ultra [2023/01/17 21:47] – vytvořeno Petr Nosek
+++ it:iot:xiaomi-mi-robot-vacuum-mop-2-ultra [2023/01/17 22:47] (aktuální) – [raw_command, get_property_by, call_action_by] Petr Nosek
@@ Řádek 3: / Řádek 3: @@
 Na internet jsem se inspiroval některýma knihovnama, které ukazují, že lze můj robotický vysavač ovládat skrze příkazy v Pythonu. Tak jsem se pustil, co je na tom pravdu s vidinou, že bych nepotřeboval oficiální aplikaci, ale mohl využívat scénáře v Node Red.
+Nejprve k samotnému binárnímu protokolu Xiaomi. Dle příspěvku [[https://github.com/OpenMiHome/mihome-binary-protocol|Xiaomi's MiHome Binary protocol]] to vypadá, že komunikace probíhá skrz protokol **UDP** na portu **54321**. Tady je popsána struktura packetu: [[https://github.com/OpenMiHome/mihome-binary-protocol/blob/master/doc/PROTOCOL.md|Xiaomi Mi Home Binary Protocol]]
+===== získání šifrovacího tokenu =====
+Pro instalaci robotického vysavače jsem si musel vytvořit účet v aplikaci od Xiaomi. A přihlašovací údaje do aplikace jsou cestou, jak získat šiforvací token. Tady jsou popsány cesty, jak token získat: [[https://github.com/Maxmudjon/com.xiaomi-miio/blob/master/docs/obtain_token.md|Obtain Mi Home device token]]. Cesty jsou sice komplikované, nicméně článek jsem dal pro úplnost, protože může sloužit jako návod, jak protokol odposlouchávat a vyhledat konkrétní příkazy.
+Nicméně pak jsem našel jednodušší cestu pro získání tokenu. A byl to projekt [[https://github.com/rytilahti/python-miio|python-miio]].
+Zde je [[https://python-miio.readthedocs.io/en/latest/discovery.html#installation|popis instalace]]:
+<code bash>
+pip3 install python-miio
+</code>
+Později jsem potřeboval i aktuální verzi z repozitáře, kterou jsem rozběhal ve virtuálním stroji takto:
+<code bash>
+git clone https://github.com/rytilahti/python-miio.git
+cd python-miio/
+pip3 install poetry
+poetry install
+poetry run miiocli --help
+</code>
+K získání tokenu mi pak stačil tento příkaz:
+<code bash>
+miiocli cloud list
+</code>
+Zadal jsem přihlašovací jméno do účtu Mi Home a heslo a měl jsem jako výstup token a IP adresu, na které mi robot naslouchá.
+===== posílání příkazů na robota =====
+Je hodně typů robotů a potřeboval jsem vědět, jak volat svůj model. Chvíli jsem tápal a zkoušel, jestli je podporovaný, než jsem v kódu našel tohle: https://github.com/rytilahti/python-miio/blob/master/miio/integrations/vacuum/dreame/dreamevacuum_miot.py
+Pochopil jsem, že můj model patří do **dreamevacuum**.
+Pro vypsání možných příkazů k použití, které jsou implementovány v modulu dreamevacuum zavolám:
+<code bash>
+miiocli --output json_pretty  dreamevacuum  --ip 192.168.1.108 --token sifrovacitoken --help
+</code>
+Pro zjištění přesného modelu robota, který budu potřebovat pro další volání použiju příkaz:
+<code bash>
+miiocli --output json_pretty  dreamevacuum  --ip 192.168.1.108 --token sifrovacitoken info
+</code>
+Pro zjištění stavu mého robota poslouží příkaz:
+<code bash>
+miiocli --output json_pretty  dreamevacuum  --ip 192.168.1.108 --token sifrovacitoken --model dreame.vacuum.p2150a status
+</code>
+Pro můj model je omezená možnost příkazů, skrze miiocli. Našel jsem ovšem nějaké záhadný příkazy, o kterých jsem dlouho bádal, jak zavolat. V [[https://github.com/rytilahti/python-miio|dokumentaci miiocli]] jsem dohladal v části Controlling MIoT devices příkazy, který by mi mohly vysvětlit fungování.
+Podařilo se mi spustit pouze tento:
+<code bash>
+poetry run miiocli genericmiot --ip 192.168.1.108 --token sifrovacitoken actions
+</code>
+Ale z výstupu jsem nebyl moc moudrý. Očekával jsem, že kromě actions se mi podaří jesště zavolat status, set a call, ale to se mi nepodařilo.
+==== příkazy: raw_command, get_property_by, call_action_by ====
+U těchto funkcí jsem pořád nemohl přijít na funkčnost, až po několika hodinách jsem zkoušením a hledáním ve zdrojovém kódu přišel na odpověď.
+Ze [[https://github.com/rytilahti/python-miio/blob/master/miio/integrations/vacuum/dreame/dreamevacuum_miot.py|zdrojového kódu]] jsem vyčetl v úvodu že například parametr **locate** má hodnotu: **{"siid": 7, "aiid": 1}**.
+Později jsem vyčetl, že čísla siid a aiiid + vysvětlení jaké funkce volají jsou dokumentaci mého mopu: https://home.miot-spec.com/spec/dreame.vacuum.p2150a
+A jak tedy zavolat příkaz?:
+<code bash>
+miiocli dreamevacuum --ip 192.168.1.108 --token sifrovanytoken --model dreame.vacuum.p2150a raw_command action '{"siid": 7, "aiid": 1}'
+</code>
+To byla akce. Pro čtení zase tento příkaz - vrací mi hodnotu baterie:
+<code bash>
+miiocli dreamevacuum --ip 192.168.1.108 --token sifrovanytoken --model dreame.vacuum.p2150a raw_command get_properties '[{"siid": 3, "aiid": 1}]'
+</code>
+Ještě by mělo fungovat set_properties na konci a vrátit pole s objektem json, kde bude siid, aiid a typoval bych, že hodnota bude value. To jsem ale nezkoušel.
+A pak mě napadlo vyzkoušet i funkce call_action_by a get_property_by a fungovalo to:
+<code bash>
+miiocli dreamevacuum --ip 192.168.1.108 --token sifrovacitoken --model dreame.vacuum.p2150a call_action_by 7 1
+miiocli dreamevacuum --ip 192.168.1.108 --token sifrovacitoken --model dreame.vacuum.p2150a get_property_by 2 1
+</code>
+==== shrnutí ====
+K dokonalosti mi bohužel schází implementace výběru konkrétní místnosti, kterou chci vysávat. To se mi zatím nepodařilo.
+Při hledání jsem narazil na projekt, kdy už někdo vytvářel kobminaci Home Assistenta, Noderedu a Xiaomi vysavače: [[https://github.com/victorwads/mi-home-api|Home API to Control Home Appliance with Hassio, Motion]]. Pak jsem ale narazil ještě na zajímavější projekt [[https://github.com/Tasshack/dreame-vacuum|Dreame vacuum integration for Home Assistant]] u kterého to vypadá, že Home Assistant má kompletní implementaci i pro můj model. Ke zkoušení Home Assistant jsem se ale ještěš nedostal.