FreeMDU

O projeto FreeMDU fornece ferramentas de hardware e software abertas para comunicação com eletrodomésticos Miele através de sua interface de diagnóstico óptico. Ele serve como uma alternativa gratuita e aberta ao software proprietário Miele Diagnostic Utility (MDU), que está disponível apenas para técnicos de serviço registrados.

A maioria dos dispositivos Miele fabricados após 1996 inclui uma interface de diagnóstico baseada em infravermelho óptico, oculta atrás de uma das luzes indicadoras no painel frontal. Em eletrodomésticos mais antigos, esta interface é marcada por uma etiqueta Program Correction (PC).

Até agora, a comunicação com esta interface exigia um adaptador infravermelho caro vendido exclusivamente pela Miele, juntamente com seu software fechado. O objetivo do FreeMDU é tornar esta interface acessível a todos para fins de diagnóstico e automação residencial.

O projeto está dividido em três componentes principais:

• Protocolo: biblioteca principal do protocolo e implementações de dispositivos
• TUI: ferramenta de diagnóstico e teste de dispositivos baseada em terminal
• Home: firmware do adaptador de comunicação com integração MQTT para Home Assistant

Mais detalhes sobre a interface de diagnóstico proprietária e o processo de engenharia reversa por trás deste projeto podem ser encontrados neste post do blog.

[!CAUTION] Este projeto é altamente experimental e pode causar danos permanentes aos seus dispositivos Miele se não for usado com responsabilidade. Prossiga por sua conta e risco.

Dispositivos suportados

Quando uma conexão é estabelecida através da interface de diagnóstico, o eletrodoméstico responde com seu software ID, um número de 16 bits que identifica exclusivamente a versão do firmware em execução no microcontrolador do dispositivo. No entanto, este ID não corresponde diretamente a um modelo ou tipo de placa específico, portanto é impossível fornecer uma lista abrangente de modelos suportados.

A tabela a seguir lista os IDs de software e combinações de dispositivo/placa que foram confirmados como funcionando com o FreeMDU:

Se o seu eletrodoméstico não estiver listado aqui, mas tiver um número de modelo semelhante a um dos acima, já pode ser compatível. Em todos os outros casos, determinar o software ID é o primeiro passo para adicionar suporte a novos dispositivos.

Detalhes para adicionar suporte a novos dispositivos serão fornecidos em breve.

Primeiros passos

Antes de usar qualquer componente do FreeMDU, certifique-se de ter o Rust toolchain instalado no seu sistema.

Em seguida, você precisará construir um adaptador de comunicação para interfacear com seu dispositivo Miele. Quando o adaptador estiver pronto, escolha o caso de uso apropriado entre as opções abaixo:

Diagnóstico e teste de dispositivos

Se você deseja reparar ou testar seu eletrodoméstico:

1. Grave o firmware home no modo bridge no seu adaptador de comunicação e conecte-o ao seu dispositivo.

2. Execute o aplicativo TUI no seu computador.

Integração em sistemas de automação residencial

Se você deseja integrar seu eletrodoméstico no Home Assistant ou em outro sistema de automação residencial:

1. Grave o firmware home no modo autônomo no seu adaptador de comunicação e conecte-o ao seu dispositivo.

Construindo ferramentas personalizadas

Se você deseja desenvolver seu próprio software para comunicar com dispositivos Miele:

1. Grave o firmware home no modo bridge no seu adaptador de comunicação e conecte-o ao seu dispositivo.

2. Use a crate protocol para implementar seu software personalizado.

Aviso legal

Este é um projeto independente e de código aberto e não é afiliado, endossado ou patrocinado pela Miele & Cie. KG ou suas afiliadas. Todos os nomes de produtos e marcas registradas são propriedade de seus respectivos proprietários. As referências a eletrodomésticos Miele são apenas para fins descritivos e não implicam qualquer associação com a Miele.

Licença

Licenciado sob uma das seguintes licenças

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

à sua escolha.

Contribuição

A menos que você declare explicitamente o contrário, qualquer contribuição intencionalmente submetida para inclusão no trabalho por você, conforme definido na licença Apache-2.0, será licenciada duplamente como acima, sem quaisquer termos ou condições adicionais.