FreeMDU

Проект FreeMDU предоставляет открытые аппаратные и программные средства для связи с приборами Miele через их оптический диагностический интерфейс. Он служит бесплатной и открытой альтернативой проприетарному программному обеспечению Miele Diagnostic Utility (MDU), которое доступно только зарегистрированным сервисным техникам.

Большинство устройств Miele, произведенных после 1996 года, имеют оптический инфракрасный диагностический интерфейс, скрытый за одним из индикаторов на передней панели. На старых приборах этот интерфейс обозначен надписью Program Correction (PC).

До сих пор для связи с этим интерфейсом требовался дорогой инфракрасный адаптер, продаваемый исключительно Miele, вместе с их закрытым программным обеспечением. Цель FreeMDU — сделать этот интерфейс доступным для всех в целях диагностики и домашней автоматизации.

Проект разделен на три основных компонента:

• Protocol: основная библиотека протокола и реализации устройств
• TUI: терминальный инструмент диагностики и тестирования устройств
• Home: прошивка коммуникационного адаптера с интеграцией MQTT для Home Assistant

Более подробную информацию о проприетарном диагностическом интерфейсе и процессе обратной разработки, лежащем в основе этого проекта, можно найти в этой статье блога.

[!CAUTION] Этот проект является крайне экспериментальным и может привести к необратимому повреждению ваших устройств Miele при безответственном использовании. Действуйте на свой страх и риск.

Поддерживаемые устройства

При установлении соединения через диагностический интерфейс устройство отвечает своим идентификатором программного обеспечения (software ID) — 16-битным числом, которое однозначно идентифицирует версию прошивки, работающую на микроконтроллере устройства. Однако этот ID не соответствует напрямую конкретной модели или типу платы, поэтому невозможно предоставить исчерпывающий список поддерживаемых моделей.

В следующей таблице перечислены идентификаторы программного обеспечения и комбинации устройств/плат, которые были подтверждены как работающие с FreeMDU:

Если ваше устройство не указано в списке, но имеет номер модели, похожий на один из вышеперечисленных, оно может быть совместимым. Во всех остальных случаях определение идентификатора ПО (software ID) является первым шагом к добавлению поддержки новых устройств.

Подробности добавления поддержки новых устройств будут предоставлены в ближайшее время.

Начало работы

Перед использованием любых компонентов FreeMDU убедитесь, что на вашей системе установлен набор инструментов Rust.

Далее вам нужно собрать коммуникационный адаптер для взаимодействия с вашим устройством Miele. После того как адаптер будет готов, выберите подходящий вариант использования из приведенных ниже:

Диагностика и тестирование устройств

Если вы хотите отремонтировать или протестировать ваше устройство:

1. Прошейте прошивку home в режиме моста на ваш коммуникационный адаптер и подключите его к устройству.

2. Запустите приложение TUI на вашем настольном компьютере.

Интеграция в системы домашней автоматизации

Если вы хотите интегрировать ваше устройство в Home Assistant или другую систему домашней автоматизации:

1. Прошейте прошивку home в автономном режиме на ваш коммуникационный адаптер и подключите его к устройству.

Создание пользовательских инструментов

Если вы хотите разработать собственное программное обеспечение для связи с устройствами Miele:

1. Прошейте прошивку home в режиме моста на ваш коммуникационный адаптер и подключите его к устройству.

2. Используйте крейт protocol для реализации вашего собственного программного обеспечения.

Отказ от ответственности

Это независимый проект с открытым исходным кодом, который не связан, не одобрен и не спонсируется компанией Miele & Cie. KG или ее филиалами. Все названия продуктов и товарные знаки являются собственностью их владельцев. Ссылки на устройства Miele приводятся только в описательных целях и не подразумевают какой-либо связи с Miele.

Лицензия

Лицензировано на условиях одной из следующих лицензий:

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

на ваш выбор.

Вклад

Если вы явно не укажете иное, любой вклад, намеренно предоставленный вами для включения в работу, как определено в лицензии Apache-2.0, будет подлежать двойному лицензированию, как указано выше, без каких-либо дополнительных условий.