FreeMDU

FreeMDU 项目提供开放的硬件和软件工具，用于通过光学诊断接口与 Miele 设备进行通信。它是专有的 Miele 诊断工具 (MDU) 软件（仅提供给注册服务技术人员）的免费开源替代方案。

1996 年之后生产的大多数 Miele 设备都包含一个基于红外线的光学诊断接口，隐藏在前面板某个指示灯后面。在较旧的设备上，该接口标有 程序校正 (PC) 标签。

到目前为止，与该接口通信需要购买 Miele 独家销售的昂贵红外适配器及其闭源软件。FreeMDU 的目标是让每个人都能出于诊断和家庭自动化目的使用此接口。

该项目分为三个主要组件：

• 协议：核心协议库和设备实现
• TUI：基于终端的设备诊断和测试工具
• Home：带有 MQTT 集成的通信适配器固件，用于 Home Assistant

有关专有诊断接口以及该项目背后逆向工程的更多详细信息，请参阅这篇博文。

[!CAUTION] 该项目高度实验性，如果使用不当，可能会对您的 Miele 设备造成永久性损坏。请自行承担风险。

支持的设备

当通过诊断接口建立连接时，设备会响应其软件 ID，这是一个 16 位数字，唯一标识设备微控制器上运行的固件版本。但是，此 ID 并不直接对应特定型号或主板类型，因此无法提供支持的型号的完整列表。

下表列出了已确认可与 FreeMDU 配合使用的软件 ID 和设备/主板组合：

如果您的设备未在此列出，但型号与上述之一相似，则可能已兼容。在所有其他情况下，确定软件 ID 是添加对新设备支持的第一步。

有关添加对新设备支持的详细信息将很快提供。

入门

在使用任何 FreeMDU 组件之前，请确保系统上已安装 Rust 工具链。

接下来，您需要构建一个通信适配器，以便与您的 Miele 设备交互。适配器准备好后，从以下选项中选择合适的用例：

设备诊断和测试

如果您想维修或测试您的设备：

1. 将 home 固件以桥接模式刷写到通信适配器上，然后将其连接到您的设备。

2. 在台式计算机上运行 TUI 应用程序。

集成到家庭自动化系统

如果您想将设备集成到 Home Assistant 或其他家庭自动化系统中：

1. 将 home 固件以独立模式刷写到通信适配器上，然后将其连接到您的设备。

构建自定义工具

如果您想开发自己的软件与 Miele 设备通信：

1. 将 home 固件以桥接模式刷写到通信适配器上，然后将其连接到您的设备。

2. 使用 protocol crate 来实现自定义软件。

免责声明

这是一个独立的开源项目，与 Miele & Cie. KG 或其附属公司无任何关联、认可或赞助关系。所有产品名称和商标均为其各自所有者的财产。提及 Miele 设备仅用于描述目的，并不意味着与 Miele 有任何关联。

许可证

根据以下任一许可证许可：

• Apache 许可证 2.0 版（LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0）
• MIT 许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

由您选择。

贡献

除非您明确声明，否则按照 Apache-2.0 许可证的定义，您有意提交以包含在作品中的任何贡献，均应按上述方式双重许可，无需附加任何条款或条件。