FreeMDU

Das FreeMDU-Projekt bietet offene Hardware- und Softwarewerkzeuge zur Kommunikation mit Miele-Geräten über deren optische Diagnoseschnittstelle. Es dient als freie und offene Alternative zur proprietären Miele Diagnostic Utility (MDU)-Software, die nur registrierten Servicetechnikern zur Verfügung steht.

Die meisten Miele-Geräte, die nach 1996 hergestellt wurden, verfügen über eine optische, infrarotbasierte Diagnoseschnittstelle, die hinter einer der Kontrollleuchten auf der Frontblende versteckt ist. Bei älteren Geräten ist diese Schnittstelle mit einem Program Correction (PC)-Aufkleber gekennzeichnet.

Bisher erforderte die Kommunikation mit dieser Schnittstelle einen teuren Infrarotadapter, der ausschließlich von Miele verkauft wurde, sowie deren Closed-Source-Software. Das Ziel von FreeMDU ist es, diese Schnittstelle für jeden zu Diagnose- und Hausautomatisierungszwecken zugänglich zu machen.

Das Projekt ist in drei Hauptkomponenten unterteilt:

• Protocol: Kernbibliothek des Protokolls und Geräteimplementierungen
• TUI: Terminalbasiertes Gerätediagnose- und Testwerkzeug
• Home: Kommunikationsadapter-Firmware mit MQTT-Integration für Home Assistant

Weitere Details zur proprietären Diagnoseschnittstelle und zum Reverse-Engineering-Prozess hinter diesem Projekt finden Sie in diesem Blogbeitrag.

[!CAUTION] Dieses Projekt ist hochgradig experimentell und kann bei unsachgemäßer Verwendung zu dauerhaften Schäden an Ihren Miele-Geräten führen. Sie handeln auf eigene Gefahr.

Unterstützte Geräte

Wenn eine Verbindung über die Diagnoseschnittstelle hergestellt wird, antwortet das Gerät mit seiner Software-ID, einer 16-Bit-Zahl, die die auf dem Mikrocontroller des Geräts laufende Firmware-Version eindeutig identifiziert. Diese ID entspricht jedoch nicht direkt einem bestimmten Modell oder Platinentyp, daher ist es unmöglich, eine vollständige Liste der unterstützten Modelle bereitzustellen.

Die folgende Tabelle listet die Software-IDs und Geräte-/Platinenkombinationen auf, die mit FreeMDU getestet wurden und funktionieren:

Falls Ihr Gerät hier nicht aufgeführt ist, aber eine Modellnummer ähnlich einer der oben genannten hat, könnte es bereits kompatibel sein. In allen anderen Fällen ist die Ermittlung der Software-ID der erste Schritt, um Unterstützung für neue Geräte hinzuzufügen.

Details zum Hinzufügen der Unterstützung für neue Geräte werden bald bereitgestellt.

Erste Schritte

Bevor Sie FreeMDU-Komponenten verwenden, stellen Sie sicher, dass die Rust-Toolchain auf Ihrem System installiert ist.

Als nächstes müssen Sie einen Kommunikationsadapter bauen, um mit Ihrem Miele-Gerät zu kommunizieren. Sobald der Adapter bereit ist, wählen Sie den passenden Anwendungsfall aus den folgenden Optionen:

Gerätediagnose und -test

1. Flashen Sie die home-Firmware im Bridge-Modus auf Ihren Kommunikationsadapter und schließen Sie ihn an Ihr Gerät an.

2. Führen Sie die TUI-Anwendung auf Ihrem Desktop-Computer aus.

Integration in Hausautomatisierungssysteme

1. Flashen Sie die home-Firmware im Standalone-Modus auf Ihren Kommunikationsadapter und schließen Sie ihn an Ihr Gerät an.

Erstellung eigener Werkzeuge

1. Flashen Sie die home-Firmware im Bridge-Modus auf Ihren Kommunikationsadapter und schließen Sie ihn an Ihr Gerät an.

2. Verwenden Sie die protocol-Crate, um Ihre eigene Software zu implementieren.

Haftungsausschluss

Dies ist ein unabhängiges Open-Source-Projekt und ist nicht mit der Miele & Cie. KG oder ihren Tochtergesellschaften verbunden, wird nicht von ihnen unterstützt oder gesponsert. Alle Produktnamen und Marken sind Eigentum ihrer jeweiligen Inhaber. Verweise auf Miele-Geräte dienen nur zu beschreibenden Zwecken und implizieren keine Verbindung zu Miele.

Lizenz

Lizenziert unter einer der folgenden Lizenzen:

• Apache License, Version 2.0 (LICENSE-APACHE oder http://www.apache.org/licenses/LICENSE-2.0)
• MIT-Lizenz (LICENSE-MIT oder http://opensource.org/licenses/MIT)

nach Ihrer Wahl.

Beitrag

Sofern Sie nicht ausdrücklich etwas anderes angeben, wird jeder von Ihnen gemäß der Apache-2.0-Lizenz absichtlich zur Aufnahme in das Werk eingereichte Beitrag wie oben beschrieben unter dualer Lizenz gestellt, ohne zusätzliche Bedingungen.