FreeMDU

Le projet FreeMDU fournit des outils matériels et logiciels ouverts pour communiquer avec les appareils Miele via leur interface de diagnostic optique. Il constitue une alternative libre et ouverte au logiciel propriétaire Miele Diagnostic Utility (MDU), réservé aux techniciens de maintenance agréés.

La plupart des appareils Miele fabriqués après 1996 intègrent une interface de diagnostic optique infrarouge, cachée derrière l’un des voyants du panneau avant. Sur les appareils plus anciens, cette interface est signalée par une étiquette Program Correction (PC).

Jusqu’à présent, la communication avec cette interface nécessitait un adaptateur infrarouge coûteux, vendu exclusivement par Miele, ainsi que son logiciel propriétaire. L’objectif de FreeMDU est de rendre cette interface accessible à tous, à des fins de diagnostic et d’automatisation domestique.

Le projet est divisé en trois composants principaux :

• Protocol : bibliothèque de protocole principale et implémentations de périphériques
• TUI : outil de diagnostic et de test de périphérique en terminal
• Home : firmware d’adaptateur de communication avec intégration MQTT pour Home Assistant

Plus de détails sur l’interface de diagnostic propriétaire et le processus de rétro-ingénierie derrière ce projet sont disponibles dans cet article de blog.

[!CAUTION] Ce projet est hautement expérimental et peut causer des dommages permanents à vos appareils Miele s’il n’est pas utilisé de manière responsable. Vous l’utilisez à vos propres risques.

Appareils pris en charge

Lorsqu’une connexion est établie via l’interface de diagnostic, l’appareil répond avec son identifiant logiciel, un nombre de 16 bits qui identifie de manière unique la version du firmware du microcontrôleur. Cependant, cet identifiant ne correspond pas directement à un modèle ou type de carte spécifique, il est donc impossible de fournir une liste exhaustive des modèles pris en charge.

Le tableau suivant liste les identifiants logiciels et les combinaisons appareil/carte qui ont été confirmés comme fonctionnant avec FreeMDU :

Si votre appareil ne figure pas dans cette liste mais possède un numéro de modèle similaire à l’un de ceux ci-dessus, il pourrait déjà être compatible. Dans tous les autres cas, la détermination de l’identifiant logiciel est la première étape pour ajouter la prise en charge de nouveaux appareils.

Les détails pour ajouter la prise en charge de nouveaux appareils seront fournis prochainement.

Pour commencer

Avant d’utiliser un composant de FreeMDU, assurez-vous que la chaîne d’outils Rust est installée sur votre système.

Ensuite, vous devrez construire un adaptateur de communication pour interfacer votre appareil Miele. Une fois l’adaptateur prêt, choisissez le cas d’utilisation approprié parmi les options ci-dessous :

Diagnostic et test de l’appareil

Si vous souhaitez réparer ou tester votre appareil :

1. Flashez le firmware home en mode pont sur votre adaptateur de communication et fixez-le à votre appareil.

2. Lancez l’application TUI sur votre ordinateur de bureau.

Intégration dans les systèmes d’automatisation domestique

Si vous souhaitez intégrer votre appareil dans Home Assistant ou un autre système d’automatisation domestique :

1. Flashez le firmware home en mode autonome sur votre adaptateur de communication et fixez-le à votre appareil.

Construction d’outils personnalisés

Si vous souhaitez développer votre propre logiciel pour communiquer avec des appareils Miele :

1. Flashez le firmware home en mode pont sur votre adaptateur de communication et fixez-le à votre appareil.

2. Utilisez la crate protocol pour implémenter votre logiciel personnalisé.

Avertissement

Ceci est un projet indépendant et open source, non affilié, approuvé ou sponsorisé par Miele & Cie. KG ou ses filiales. Tous les noms de produits et marques sont la propriété de leurs détenteurs respectifs. Les références aux appareils Miele sont fournies à titre descriptif uniquement et n’impliquent aucune association avec Miele.

Licence

Sous licence double selon votre choix :

• Licence Apache, version 2.0 (LICENSE-APACHE ou http://www.apache.org/licenses/LICENSE-2.0)
• Licence MIT (LICENSE-MIT ou http://opensource.org/licenses/MIT)

Contribution

Sauf indication contraire explicite de votre part, toute contribution intentionnellement soumise pour inclusion dans le travail par vos soins, telle que définie dans la licence Apache-2.0, sera sous double licence comme ci-dessus, sans conditions supplémentaires.