FreeMDU

Il progetto FreeMDU fornisce strumenti hardware e software open per comunicare con gli elettrodomestici Miele tramite la loro interfaccia diagnostica ottica. Funge da alternativa gratuita e open al software proprietario Miele Diagnostic Utility (MDU), disponibile solo per tecnici di assistenza registrati.

La maggior parte dei dispositivi Miele fabbricati dopo il 1996 include un'interfaccia diagnostica ottica a infrarossi, nascosta dietro uno degli indicatori luminosi sul pannello frontale. Negli elettrodomestici più vecchi, questa interfaccia è contrassegnata da un'etichetta Program Correction (PC).

Fino ad ora, la comunicazione con questa interfaccia richiedeva un costoso adattatore a infrarossi venduto esclusivamente da Miele, insieme al loro software closed-source. L'obiettivo di FreeMDU è rendere questa interfaccia accessibile a tutti per scopi diagnostici e di automazione domestica.

Il progetto è suddiviso in tre componenti principali:

• Protocol: libreria del protocollo principale e implementazioni dei dispositivi
• TUI: strumento diagnostico e di test basato su terminale
• Home: firmware dell'adattatore di comunicazione con integrazione MQTT per Home Assistant

Maggiori dettagli sull'interfaccia diagnostica proprietaria e il processo di reverse engineering alla base di questo progetto sono disponibili in questo post del blog.

[!CAUTION] Questo progetto è altamente sperimentale e può causare danni permanenti ai tuoi dispositivi Miele se non utilizzato in modo responsabile. Procedi a tuo rischio.

Dispositivi supportati

Quando viene stabilita una connessione tramite l'interfaccia diagnostica, l'elettrodomestico risponde con il suo ID software, un numero a 16 bit che identifica univocamente la versione del firmware in esecuzione sul microcontrollore del dispositivo. Tuttavia, questo ID non corrisponde direttamente a un modello o tipo di scheda specifico, quindi è impossibile fornire un elenco completo dei modelli supportati.

La tabella seguente elenca le combinazioni di ID software e dispositivo/scheda che sono state confermate funzionanti con FreeMDU:

Se il tuo elettrodomestico non è elencato qui ma ha un numero di modello simile a uno dei precedenti, potrebbe già essere compatibile. In tutti gli altri casi, determinare l'ID software è il primo passo per aggiungere il supporto per nuovi dispositivi.

I dettagli per aggiungere il supporto per nuovi dispositivi saranno forniti presto.

Per iniziare

Prima di utilizzare qualsiasi componente di FreeMDU, assicurati di avere il toolchain Rust installato sul tuo sistema.

Successivamente, dovrai costruire un adattatore di comunicazione per interfacciarti con il tuo dispositivo Miele. Una volta pronto l'adattatore, scegli il caso d'uso appropriato tra le opzioni seguenti:

Diagnostica e test del dispositivo

Se desideri riparare o testare il tuo elettrodomestico:

1. Flasha il firmware home in modalità bridge sul tuo adattatore di comunicazione e collegalo al tuo dispositivo.

2. Esegui l'applicazione TUI sul tuo computer desktop.

Integrazione in sistemi di automazione domestica

Se desideri integrare il tuo elettrodomestico in Home Assistant o in un altro sistema di automazione domestica:

1. Flasha il firmware home in modalità standalone sul tuo adattatore di comunicazione e collegalo al tuo dispositivo.

Creazione di strumenti personalizzati

Se desideri sviluppare il tuo software per comunicare con i dispositivi Miele:

1. Flasha il firmware home in modalità bridge sul tuo adattatore di comunicazione e collegalo al tuo dispositivo.

2. Utilizza la libreria protocol per implementare il tuo software personalizzato.

Disclaimer

Questo è un progetto open-source indipendente e non è affiliato, approvato o sponsorizzato da Miele & Cie. KG o dalle sue affiliate. Tutti i nomi di prodotto e marchi registrati sono di proprietà dei rispettivi proprietari. I riferimenti agli elettrodomestici Miele sono solo a scopo descrittivo e non implicano alcuna associazione con Miele.

Licenza

Concesso in licenza secondo una delle seguenti opzioni:

• Licenza Apache, Versione 2.0 (LICENSE-APACHE o http://www.apache.org/licenses/LICENSE-2.0)
• Licenza MIT (LICENSE-MIT o http://opensource.org/licenses/MIT)

a tua scelta.

Contributi

Salvo diversa indicazione esplicita, qualsiasi contributo intenzionalmente inviato per l'inclusione nel lavoro da parte tua, come definito nella licenza Apache-2.0, sarà concesso in doppia licenza come sopra, senza ulteriori termini o condizioni.