	An dieser Seite wird momentan noch gearbeitet.

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

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)

Zunächst fangen wir mal auf unserem FHEM Rechner an. Mit Putty verbinden wir uns per SSH mit dem FHEM Computer.

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 cpan Crypt::Rijndael_PP
sudo apt-get install libcrypt-ecb-perl (nur nötig, wenn ihr einen verschlüsselten Token mit 96 Zeichen habt)
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]

Installation des inoffiziellen Moduls

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. 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?

Ich nutze dafür einen kleinen HTTP Server auf meinem Windows Rechner: MiniWeb

Dieses Tool runterladen und irgendwohin entpacken. Zum starten habe ich eine kleine Batchdatei geschrieben:

D:\Software\MiniWebServer\miniweb\miniweb.exe -p 80

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).

wget http://IP-Adresse_EUres_Windows_Rechners/72_XiaomiDevice.pm

bringt die Datei in euer FHEM Verzeichnis.

Jetzt noch die Rechte anpassen:

sudo chown fhem:dialout /opt/fhem/FHEM/72_XiaomiDevice.pm

Fertig.

Jetzt können wir auf die FHEM Oberfläche wechseln.

reload 72_XiaomiDevice.pm

und unser runtergeladenes Modul steht in FHEM zur Verfügung.

Einrichten des Moduls

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

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)
PayPal-Link, um Markus M. Dankeschön zu sagen