Mi vacuum: Unterschied zwischen den Versionen

Aus FHEMWiki
K (Änderung 30069 von Arne (Diskussion) rückgängig gemacht. ->72_XiaomiDevice.pm ist seit 28.2.18 offizielles Modul / Installation aus (inoffziellen) Quellen unnötig)
Markierung: Rückgängigmachung
(Link zu fhempy zum Auslesen des Tokens hinzugefügt)
 
(6 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Baustelle}}
{{Todo|Aktualiserung / Text weniger flapsig formulieren / Einbindung Info-Box. Information, die generell für das Modul [[XiaomiDevice]] gilt, sollte auf die Modulseite "verschoben" werden.}}
=Mi Vacuum=
=Mi Vacuum=
Wie der preiswerte Staubsaugerroboter auch auf FHEM hört...
Wie der preiswerte Staubsaugerroboter auch auf FHEM hört...
Zeile 13: Zeile 13:


==Die Einrichtung des Moduls==
==Die Einrichtung des Moduls==
Das ist insofern spannend, als das Modul nicht offiziell in FHEM eingecheckt ist. Man muss also das Modul runterladen, auf den FHEM Rechner bringen etc...
===Vorarbeiten (Linux)===
===Vorarbeiten (Linux)===
Zunächst fangen wir mal auf unserem FHEM Rechner an. Mit Putty verbinden wir uns per SSH mit dem FHEM Computer.
Zunächst fangen wir mal auf unserem FHEM Rechner an. Mit Putty verbinden wir uns per SSH mit dem FHEM Computer (Todo: Das ist hier ist für Windows-Nutzer...)


Folgende Befehle können benötigt werden (Debian):
Folgende Befehle können benötigt werden (Debian):
Zeile 22: Zeile 20:
* <code>sudo apt-get install libdigest-md5-perl</code>
* <code>sudo apt-get install libdigest-md5-perl</code>
* <code>sudo apt-get install libcrypt-cbc-perl</code>
* <code>sudo apt-get install libcrypt-cbc-perl</code>
* <code>sudo cpan Crypt::Rijndael_PP</code>
* <code>sudo apt install libcryptx-perl</code>
 
 
* <code>sudo apt-get install libcrypt-ecb-perl</code> (nur nötig, wenn ihr einen verschlüsselten Token mit 96 Zeichen habt)
* <code>sudo apt-get install libcrypt-ecb-perl</code> (nur nötig, wenn ihr einen verschlüsselten Token mit 96 Zeichen habt)
* <code>sudo cpan Crypt::Rijndael_PP</code> (nur nötig, wenn libcryptx-perl aus irgendwelchen Gründen nicht funktioniert)
* <code>sudo cpan Crypt::Cipher::AES</code> (nur nötig, wenn Crypt::Rijndael_PP aus irgendwelchen Gründen nicht funktioniert)
* <code>sudo cpan Crypt::Cipher::AES</code> (nur nötig, wenn Crypt::Rijndael_PP aus irgendwelchen Gründen nicht funktioniert)
Wenn bei dem ein oder anderen Modul die Meldung kommt, dass es schon installiert ist, einfach mit dem nächsten Befehl weiter machen. Das CPAN Teil würde ich am Schluss machen, das braucht ziemlich lang zum installieren.
Wenn bei dem ein oder anderen Modul die Meldung kommt, dass es schon installiert ist, einfach mit dem nächsten Befehl weiter machen. Das CPAN Teil würde ich am Schluss machen, das braucht ziemlich lang zum installieren.


Zeile 51: Zeile 53:
Zum Auslesen des Tokens mit iOS Endgeräten kann die Anleitung unter folgendem Link befolgt werden: [https://forum.smartapfel.de/forum/thread/370-xiaomi-token-auslesen/]
Zum Auslesen des Tokens mit iOS Endgeräten kann die Anleitung unter folgendem Link befolgt werden: [https://forum.smartapfel.de/forum/thread/370-xiaomi-token-auslesen/]


===Installation des inoffiziellen Moduls===
'''Auslesen mit fhem / fhempy'''
Der folgende Teil ist für völlige Noobs. Wenn ihr einen eleganteren Weg kennt, her damit.


Zunächst bitte das Modul aus dem Forum herunterladen.
In fhem gibt es auch noch das [https://github.com/fhempy/fhempy/blob/master/README.md fhempy-System], dafür gibt es auch ein Modul zum Auslesen von Xiaomi-Token aus deren Cloud, u.a. auch das Token für unseren Mi-Vacuum.
[https://forum.fhem.de/index.php/topic,73052.0.htmlm Hier] befindet sich der Thread. Markus M. hat sich die Mühe gemacht, ein Modul zu schreiben. Solange es nicht offiziell eingecheckt ist, muss man es händisch installieren. Das kann man wie folgt machen:
* das Modul zunächst auf seinem Windows PC speichern


Wie kommt das Modul nun auf den eigenen RasPi?
===Installation des inoffiziellen Moduls===
Das Modul ist seit 28.02.2018 ein offizielles Modul. Eine separates Installation ist nicht (mehr) notwendig.


Ich nutze dafür einen kleinen HTTP Server auf meinem Windows Rechner: [http://miniweb.sourceforge.net/ MiniWeb]
==Einrichten des Moduls [[XiaomiDevice]] ==


Dieses Tool runterladen und irgendwohin entpacken. Zum starten habe ich eine kleine Batchdatei geschrieben:
<pre>D:\Software\MiniWebServer\miniweb\miniweb.exe -p 80</pre>
Die sorgt nur dafür, dass der Server auf Port 80 läuft.
Im entpackten Verzeichnis ist ein Unterverzeichnis mit dem Namen "htdocs". Dahin kopieren wir das soeben runtergeladene Modul aus dem Forum-Thread.
Langsam sollte das cpan Tool auf unserer SSH Verbindung durchgelaufen sein.
Nun wechseln wir (auf dem Linux Rechner) in das FHEM Verzeichnis (cd /opt/fhem/FHEM).
<pre>wget http://IP-Adresse_EUres_Windows_Rechners/72_XiaomiDevice.pm</pre>
bringt die Datei in euer FHEM Verzeichnis.
Jetzt noch die Rechte anpassen:
<pre>sudo chown fhem:dialout /opt/fhem/FHEM/72_XiaomiDevice.pm</pre>
Fertig.
Jetzt können wir auf die FHEM Oberfläche wechseln.
<pre>reload 72_XiaomiDevice.pm</pre>
und unser runtergeladenes Modul steht in FHEM zur Verfügung.
==Einrichten des Moduls==
<pre>
<pre>
define Mi_Vacuum XiaomiDevice 192.168.222.77 55387753545937326a33396943557999
define Mi_Vacuum XiaomiDevice 192.168.222.77 55387753545937326a33396943557999
Zeile 159: Zeile 131:
</pre>
</pre>


==Probleme und Lösungen==
===Crypt::Cipher::AES or Crypt::Rijndael_PP is required!===
Die Meldung im STATE des Devices bedeutet, dass noch einige Debian/Perl-Module installiert werden müssen. Siehe [[#Vorarbeiten (Linux)]].
Danach ist darauf zu achten, dass das Device wieder aktiviert wird.
attr <devicename> disable 0
==Quellen==
==Quellen==
* {{Link2Forum|Topic=73052|LinkText=Forums-Thread}}
* {{Link2Forum|Topic=73052|LinkText=Forums-Thread}}
Zeile 165: Zeile 143:
* [https://xiaomi.flole.de/ Flole], alternative App für Android, die das Token nach GoogleDrive exportiert
* [https://xiaomi.flole.de/ Flole], alternative App für Android, die das Token nach GoogleDrive exportiert
* [http://www.roboter-forum.com/forumdisplay.php?130-Xiaomi Roboter-Forum] deutschsprachiges Forum, welches sich mit dem Mi Vacuum beschäftigt (auch vor dem Kauf des Roboters lohnt sich ein Besuch dort)
* [http://www.roboter-forum.com/forumdisplay.php?130-Xiaomi Roboter-Forum] deutschsprachiges Forum, welches sich mit dem Mi Vacuum beschäftigt (auch vor dem Kauf des Roboters lohnt sich ein Besuch dort)
* [https://paypal.me/mm0 PayPal]-Link, um Markus M. Dankeschön zu sagen
[[Kategorie:Other Components]]

Aktuelle Version vom 16. Juni 2024, 16:25 Uhr

Todo: Aktualiserung / Text weniger flapsig formulieren / Einbindung Info-Box. Information, die generell für das Modul XiaomiDevice gilt, sollte auf die Modulseite "verschoben" werden.

Mi Vacuum

Wie der preiswerte Staubsaugerroboter auch auf FHEM hört...

Für wen ist die Anleitung gedacht?

Ich gehe davon aus, dass ihr ein funktionierendes FHEM auf einem Linux Rechner (Debian) betreibt.

Weiterhin denke ich, dass euer Hauptarbeitsrechner unter Windows läuft.

Als Smartphone OS Android (wer Apple hat, kann gerne die Token-Auslese-Geschichte hier beschreiben).

Um das Teil auch von Alexa aus ein und aus zu schalten, sollte auch die Installation von Alexa in FHEM fertig sein.

Die Einrichtung des Moduls

Vorarbeiten (Linux)

Zunächst fangen wir mal auf unserem FHEM Rechner an. Mit Putty verbinden wir uns per SSH mit dem FHEM Computer (Todo: Das ist hier ist für Windows-Nutzer...)

Folgende Befehle können benötigt werden (Debian):

  • sudo apt-get install libjson-perl
  • sudo apt-get install libdigest-md5-perl
  • sudo apt-get install libcrypt-cbc-perl
  • sudo apt install libcryptx-perl


  • sudo apt-get install libcrypt-ecb-perl (nur nötig, wenn ihr einen verschlüsselten Token mit 96 Zeichen habt)
  • sudo cpan Crypt::Rijndael_PP (nur nötig, wenn libcryptx-perl aus irgendwelchen Gründen nicht funktioniert)
  • sudo cpan Crypt::Cipher::AES (nur nötig, wenn Crypt::Rijndael_PP aus irgendwelchen Gründen nicht funktioniert)

Wenn bei dem ein oder anderen Modul die Meldung kommt, dass es schon installiert ist, einfach mit dem nächsten Befehl weiter machen. Das CPAN Teil würde ich am Schluss machen, das braucht ziemlich lang zum installieren.

Vorarbeiten am Smartphone (Token)

Das Problem ist folgendes:

Wenn der Roboter mit dem WLAN verbunden wird, generiert er einen Token. Das ist ein Schlüssel, ohne den er sich nicht steuern lässt. Damit FHEM drauf zugreifen kann, benötigt man diesen Token.

Mit den neueren Versionen der MiHome App klappt das Auslesen der Tokens leider nicht mehr.

Auslesen bei Android Endgeräten

Ich gehe davon aus, dass der Staubsauger mit der original MiHome App eingebunden ist und funktioniert. (Ich habe bei der Einrichtung des Servers => "other" gewählt. Offenbar wollen neuere Staubsauger sich mit "China Mainland" nicht mehr verbinden. Tut hier an dieser Stelle zwar nichts zur Sache, aber vielleicht hilft es dem ein oder anderen. Wenn man die Region gewechselt hat, muss man auch den Staubsauger neu einbinden)

  • MiHome löschen
  • alte MiHome suchen (APKMirror z.B., Version 5.0.19 hat bei mir funktioniert, unsichere Quellen müssen erlaubt sein)
  • runtergeladene MiHome App öffnen und anmelden (sollte ganz normal den Sauger finden)
  • USB-Debugging am Handy einschalten (Entwickleroptionen...)
  • Handy mit USB Kabel und PC verbinden
  • MiToolkit 1.6 runterladen und öffnen
  • MiToolkit erzeugt nun am Handy ein Backup
  • anschließend zeigt es den Token direkt am PC an

Auslesen bei iOS Endgeräten

Zum Auslesen des Tokens mit iOS Endgeräten kann die Anleitung unter folgendem Link befolgt werden: [1]

Auslesen mit fhem / fhempy

In fhem gibt es auch noch das fhempy-System, dafür gibt es auch ein Modul zum Auslesen von Xiaomi-Token aus deren Cloud, u.a. auch das Token für unseren Mi-Vacuum.

Installation des inoffiziellen Moduls

Das Modul ist seit 28.02.2018 ein offizielles Modul. Eine separates Installation ist nicht (mehr) notwendig.

Einrichten des Moduls XiaomiDevice

define Mi_Vacuum XiaomiDevice 192.168.222.77 55387753545937326a33396943557999

attr Mi_Vacuum subType VacuumCleaner

Und schon (=etwa nach 10 Sekunden) sollte euer Roboter in FHEM mit ganz vielen Readings auftauchen.

Anwendung: Sprachsteuerung mit Alexa (einfach, ein und aus)

Wie bindet man das jetzt schnell in Alexa ein?

Wir legen uns in FHEM einen Dummy an. Dieser wird ein Switch (on off). Dazu noch ein DOIF oder ein notify, welches diesen Switch überwacht. Je nach Status des Dummys schalten wir den Roboter.

Ein List meines Dummys:

 Internals: 
   CFGFN 
   NAME       Mi_Vacuum_Staubsauger 
   NR         719473 
   STATE      on 
   TYPE       dummy 
   Readings: 
     2017-09-18 21:10:12   state           on 
 Attributes: 
   alexaName  Mi_Vacuum_Staubsauger 
   genericDeviceType switch 
   room       alexa 
   setList    on off 


Mein DOIF:

define di_Mi_Vacuum DOIF ([Mi_Vacuum_Staubsauger:"on"]) (set Mi_Vacuum start) DOELSE (set Mi_Vacuum charge)

Das Attribut do always nicht vergessen!


Den Dummy setzen wir in den Raum, der unsere Alexa Geräte beinhaltet. Nun den Alexa FHEM Service neu starten. Anschließend sollte eine Suche nach neuen Geräten in Alexa unseren Dummy finden. Für diesen legen wir in Alexa einen neuen Raum an, z.B. Staubsauger.

Fertig.

Ein "Alexa schaltet den Staubsauger ein" lässt unseren Mi-Vacuum loslegen. "Alexa schalte den Staubsauger aus" schickt ihn wieder zurück zu seiner Station.

Zonenreinigung

Um nur Teilbereiche einer Wohnung zu reinigen, ist es möglich über das Modul Zonen zu definieren. Hierzu ist es notwendig, die Koordinaten der gewünschten Zone zu ermitteln. Hierzu eignet sich die FloleVac App die entweder auf einem Android Device oder auf einem Android Emulator (z.B. BlueStacks) verwendet werden kann. In der App kann man in der Karte eine Zone für die Reinigung markieren und durch langes Gedrückthalten des "Reinigen-Buttons" in der FloleVac App die Koordinaten dieser Zone in die Zwischenablage kopieren.

Mit diesen Koordindaten im Format [16200,27250,31650,27650,1] kann man dann loslegen die Zonen in FHEM zu definieren:

Entweder direkt über die Werte:

set vacuum zone 16200,27250,31650,27650,1 23700,23050,25200,24200,2

Oder über die passenden Attribute erst ein Alias anlegen:

attr vacuum zone_names home:[16200,27250,31650,27650,1],[23700,23050,25200,24200,2] livingroom:[16200,26250,23000,30150,1]

Ein Alias kann dann wie folgt genutzt werden:

set vacuum zone home

Probleme und Lösungen

Crypt::Cipher::AES or Crypt::Rijndael_PP is required!

Die Meldung im STATE des Devices bedeutet, dass noch einige Debian/Perl-Module installiert werden müssen. Siehe #Vorarbeiten (Linux).

Danach ist darauf zu achten, dass das Device wieder aktiviert wird.

attr <devicename> disable 0

Quellen

  • Forums-Thread
  • Diskussionsthread
  • MiniWeb, kleiner WebServer für Windows
  • Flole, alternative App für Android, die das Token nach GoogleDrive exportiert
  • Roboter-Forum deutschsprachiges Forum, welches sich mit dem Mi Vacuum beschäftigt (auch vor dem Kauf des Roboters lohnt sich ein Besuch dort)