Midea AC LAN

English | 简体中文 | Discord 聊天 | QQ 群

通过局域网控制你的 Midea M-Smart 家电。

• 通过 Home Assistant 界面发现并配置家电。
• 创建额外的传感器和开关，用于家电控制。
• 保持一条持久的 TCP 连接，以实时同步家电状态。

⭐如果此组件对你有帮助，请为它点 Star，这会给我很大的鼓励。

❗注意：此集成需要 Home Assistant 2024.4.1 或更高版本

1. ❗❗❗❗❗❗重要提示❗❗❗❗❗❗

注意：目前，仅个人 Meiju 和 SmartHome 账号可用于登录，并且家电必须已绑定到该账号。否则，无法获取家电 Token。NetHome Plus 目前暂无法获取 Token，但相关选项和功能仍予以保留。 ❗ SmartHome：请勿从其他应用迁移账号。你必须注册一个新账号并添加家电；迁移过来的账号无法获取家电 Token。

1. 目前 Midea Meiju 和 SmartHome 的 Token API 服务要求使用个人 App 账号登录，并且家电必须先绑定到该账号，才能获取 Token。Midea 未来可能会逐步关闭这些 Token API 服务，这可能导致无法新增家电。
2. 对于已成功添加的家电，请务必将家电的 .json 配置文件复制或备份到 HAOS 以外的设备，以便日后使用。旧版 v2 协议家电没有 .json 配置文件，因此只需要备份 v3 协议家电。
3. 如何获取设备的 .json 配置文件：请参阅 调试和测试
4. 原因：在 Midea v1 LAN API 的初始设计中，假设客户端通信已经加密。因此，云服务生成并用于该加密通信的 Token 未设置过期时间。然而，GitHub 上许多 Home Assistant 插件使用了破解的客户端加密方式。由于这些 Token 不会过期，这会带来安全风险。因此，Midea 可能会逐步关闭上述云端 Token API 服务，并转向新的 v2 云端控制 API，最终可能导致 v1 局域网控制 API 不可用。

2. 从 georgezhao2010/midea_ac_lan 升级

1. 移除旧的 georgezhao2010/midea_ac_lan 集成
2. 安装当前集成，然后重启 HA
3. 您的设备不会被删除。它们应该仍然存在，因此您无需再次发现或添加它们。
4. 如果家电的开关或传感器实体消失，请从 设置 -> 设备与服务 -> Midea AC LAN -> 设备 -> 配置 中重新启用它们。
5. 完成。您的家电应该能像以前一样正常工作。

3. 支持的品牌

还有更多。

4. 支持的家电

❗注意：对于每种家电类型，请根据以下文档配置其支持的功能和参数。只有在确认家电在 Midea App 中支持该功能后，再启用相应功能。

请查看下方文档链接，了解每种家电类型支持的功能和使用方法。

类型	名称	文档
13	灯具	13.md
26	浴室主控制器	26.md
34	水槽洗碗机	34.md
40	集成式吊扇	40.md
A1	除湿机	A1.md
AC	空调	AC.md
AD	空气盒	AD.md
B0	微波炉	B0.md
B1	电烤箱	B1.md
B3	餐具消毒柜	B3.md
B4	烤面包机	B4.md
B6	吸油烟机	B6.md
BF	微波蒸汽烤箱	BF.md
C2	智能马桶	C2.md
C3	热泵 Wi-Fi 控制器	C3.md
CA	冰箱	CA.md
CC	MDV Wi-Fi 控制器	CC.md
CD	热泵热水器	CD.md
CE	新风机	CE.md
CF	热泵	CF.md
DA	波轮洗衣机	DA.md
DB	滚筒洗衣机	DB.md
DC	干衣机	DC.md
E1	洗碗机	E1.md
E2	电热水器	E2.md
E3	燃气热水器	E3.md
E6	燃气灶	E6.md
E8	电炖锅	E8.md
EA	电饭煲	EA.md
EC	电压力锅	EC.md
ED	饮水机	ED.md
FA	电风扇	FA.md
FB	电暖器	FB.md
FC	空气净化器	FC.md
FD	加湿器	FD.md

5. 安装 midea_ac_lan

选项 1：通过 HACS 安装

重启 Home Assistant。

选项 2：通过脚本安装

请在 HA Terminal 或 SSH 附加组件中运行此脚本。

wget -O - https://github.com/wuwentao/midea_ac_lan/raw/main/scripts/install.sh | ARCHIVE_TAG=latest bash -

选项 3：手动安装

1. 从最新发行版下载 midea_ac_lan.zip
2. 解压 midea_ac_lan.zip。
3. 将解压后的文件复制到 Home Assistant 中的 /config/custom_components/midea_ac_lan，确保 manifest.json 直接位于 /config/custom_components/midea_ac_lan/ 下。
4. 重启 Home Assistant。

重启后，打开 [设置]、[设备与服务]、[集成]、[Midea AC Lan]，完成初始设置并添加您的家电。

6. 添加设备

❗注意：首先，请在路由器中为家电设置静态 IP 地址，以免设置完成后家电的 IP 地址发生变化。

安装完成后，在 Home Assistant 的集成页面中搜索并添加 Midea AC LAN 集成。如需添加多台家电，请多次添加该集成，并每次执行自动配置。

或点击

❗注意：配置过程中，需要输入您的 Meiju 或 SmartHome 账号和密码，因为家电信息（Token 和 Key）必须从 Midea 云服务器获取。所有家电配置完成后，请备份每台 v3 家电的 .json 配置文件，以备日后使用。参见获取设备 JSON 配置。

Midea 账号登录完成后，点击 'ADD DEVICE' 添加一台家电。您可以重复此过程以添加多台家电。

注意：目前，仅个人 Meiju 和 SmartHome 账号可用于登录，且家电必须绑定到该账号。否则无法获取家电 Token。NetHome Plus 目前尚无法获取 Token，但相关选项和功能仍予以保留。 ❗ SmartHome：请勿从其他应用迁移账号。您需要注册新账号并添加家电；已迁移账号无法获取家电 Token。

6.1 自动发现

使用该选项，集成可以自动发现并列出网络中的美的 M-Smart 设备，或位于指定 IP 地址的设备。从列表中选择一项以添加它。

你也可以使用 IP 地址在指定网络中进行搜索，例如 192.168.1.255。

❗注意：自动发现要求你的设备与 Home Assistant 处于同一子网。否则，设备将无法被发现。你也可以直接输入 IP 地址。

6.2 手动配置

如果你之前已经通过其他集成手动配置过设备，或者已有 Token/Key 备份，则可以手动添加该设备。

• 设备编码
• 设备类型（支持的设备 之一）
• IP 地址
• 端口（默认 6444）
• 协议版本
• Token
• Key

除非你清楚自己正在修改的内容，否则请勿修改设备配置。添加错误的设备配置可能导致设备状态异常或无法控制。

6.3 仅列出所有设备

使用该选项，你可以列出网络中所有可发现的美的 M-Smart 设备，以及它们的 ID、类型、SN 和其他信息。

❗注意：并非所有受支持的设备都会在此列出。如果某个设备无法被扫描，则当前可能暂不支持该设备。

7. 配置

你可在 Settings -> Devices & Services -> Midea AC LAN -> Devices -> CONFIGURE 中找到配置。 当设备 IP 地址发生变化时，你可以重置该 IP 地址。 你还可以添加额外的传感器和开关实体，或者自定义你的设备。

❗❗❗ 设备成功添加后，并非所有功能都会默认启用。你仍需要调整配置，主要根据设备所支持的功能，手动启用或禁用相应功能。

7.1 IP 地址

设置设备 IP 地址。当设备 IP 地址发生变化时，可以重置该地址。

7.2 刷新间隔

设置主动刷新单个设备状态的间隔时间，单位为秒。默认值为 30，设置为 0 将禁用主动刷新。 大多数美的设备会主动通知状态变化，
因此即使刷新间隔设置为“0”，HA 状态更新仍可正常工作。
该组件还会定期主动查询设备状态，默认时间为 30 秒。
部分设备在状态变化时不会主动发送通知，因此 HA 中的状态同步速度会较慢。
如果你非常关注状态同步速度，可以尝试设置更短的状态刷新间隔。

❗注意：较短的刷新间隔可能会消耗更多资源

7.3 附加传感器与开关实体

配置完成后，默认可能会生成一个或几个主要实体（例如气候实体）。如果您希望将其他属性作为附加传感器实体或开关实体暴露出来，请单击 Midea AC LAN 集成卡片上的 CONFIGURE，并选择要生成的传感器和开关。您的设备必须支持所选功能。 启用前，请查阅对应设备类型的文档。

7.4 自定义

部分设备类型具有专属的自定义配置项。您可以使用它们来定制设备功能。如果您的设备无法正常工作，或显示值异常，可能需要通过自定义设置来修复。具体配置信息请查阅设备文档。

Customize 的格式必须为 JSON。

如需配置多个自定义配置项，设置必须符合 JSON 格式。

示例

{ "refresh_interval": 15, "fan_speed": 100 }

是否支持 Customize 取决于设备类型，请参阅相应设备文档。

8. 调试与测试

如需获取调试日志或修改源代码，请参阅调试与测试。

9. 贡献指南

开发使用 uv（无需 Docker）。安装 uv 后：

git clone https://github.com/wuwentao/midea_ac_lan.git
cd midea_ac_lan
./scripts/setup.sh

请参阅 CONTRIBUTING 了解完整设置、本地运行 Home Assistant 以及代码风格 / 提交规则。