07HomeAssistant 中如何添加美的Midea的设备

admin

在 Home Assistant (HA) 2025.12.2 版本中，接入美的（Midea）设备最稳定、功能最全的方式仍然是通过社区集成的**局域网控制（Local LAN）**方案。虽然美的在 2024-2025 年推出了一些支持 Matter 的新设备（如 Midea U 空调），但官方 Matter 集成功能往往受限（通常只能开关和调温），无法控制风速、摆风或查看详细传感器数据。

以下是基于 Home Assistant 2025.12.2 环境验证的详细保姆级教程，采用目前最受推崇的 Midea AC LAN 集成方案。

---

🟢 核心方案选择

• 推荐方案：使用 HACS 安装 Midea AC LAN (作者: wuwentao)。

• 优点：

  
  

  • 纯本地控制：配置完成后断网也能用，响应速度极快。

  • 功能全：支持空调、除湿机、风扇、热水器等多种设备，且支持摆风、干燥、ECO 等高级模式。

  • 自动获取 Token：新版集成支持通过账号登录自动获取设备 Key/Token，无需繁琐抓包。

    
    
  
  

---

🔧 准备工作

• 美的设备已配网：确保你的美的设备已经连接到家里的 Wi-Fi。

  
  

  • 强烈建议：使用 “美的美居” (Meiju) 或 “NetHome Plus” App 进行配网。如果设备是新买的，建议优先尝试使用 NetHome Plus App（国际版），因为它对第三方抓取 Token 更友好，但国内设备通常只能用美的美居。

    
    

• Home Assistant 已安装 HACS：

  
  

  • 如果你还没有安装 HACS（Home Assistant Community Store），请先参考官方文档安装。这是接入非官方设备必不可少的商店。

    
    
  
  

---

📝 详细步骤教程第一步：在 HACS 中下载集成

• 打开 Home Assistant，点击左侧边栏的 HACS。

• 点击 Integrations (集成)。

• 点击右下角的 + Explore & Download Repositories (探索并下载仓库)。

• 在搜索框输入 Midea AC LAN。

• 找到由 wuwentao 开发的 Midea AC LAN，点击进入。

  
  

  • 注意：请认准作者 wuwentao，这是目前维护最积极的版本。

    
    

• 点击右下角的 Download，下载完成后，系统会提示你重启 Home Assistant。

• 前往 设置 -> 系统 -> 右上角电源按钮 -> 重启 Home Assistant。

  
  

第二步：添加集成并配置

重启完成后，我们开始添加设备。

• 点击左侧边栏的 Settings (配置) -> Devices & Services (设备与服务)。

• 点击右下角的 + Add Integration (添加集成)。

• 搜索 Midea AC LAN 并点击。

• 选择配置模式：

  
  

  • 此时你会看到几种选项，通常选择 "Auto" (自动扫描) 或 "Add device by account" (通过账号添加)。

  • 小白推荐方案：选择 "Add device by account"（通过账号添加）。这是 2025 年最简单的获取 Token 方式，不需要手动抓包。

    
    
  
  

第三步：自动获取 Token 与添加设备

美的设备需要 Token 和 Key 才能进行局域网控制，这一步是关键。

• 在弹出的账号登录界面中：

  
  

  • Account Type (账号类型)：如果你用的是“美的美居”，选择 Meiju；如果用的是“NetHome Plus”，选择 NetHome Plus。

  • Username/Password：输入你 App 的账号和密码。

    
    

• 点击 Submit (提交)。

• 集成会自动连接美的云端，获取你账号下绑定的所有设备的 IP 地址、ID、Token 和 Key。

• 获取成功后，列表会显示发现的设备。勾选你要添加的设备，点击提交。

• 重要提示：一旦添加成功，集成就会切换到局域网（LAN）模式控制。此时，哪怕你改了 App 密码或者家里断了外网，只要 HA 和空调在同一个路由器下，就能控制。

  
  

---

💡 进阶配置与常见问题 (FAQ)1. 实体命名与卡片

添加成功后，在“概览”页面，你会看到一个标准的空调卡片（Climate Entity）。

• 功能测试：尝试点击开关、调节温度。你应该会发现响应几乎是“秒级”的，比 App 还要快。

• 高级属性：点击卡片右上角的三个点（或点击实体图标），你可以看到更多控制选项，如 Swing (摆风)、Fan Mode (风速)、Preset (预设模式如 ECO/Boost)。

  
  

2. 如果自动搜索失败怎么办？(手动 IP 法)

如果通过账号也无法发现设备，可能是因为设备跨网段了（VLAN），或者 UDP 广播被路由器拦截。

• 在路由器后台找到美的设备的 IP 地址（建议在路由器中将美的设备设为固定 IP，防止 IP 变动导致失联）。

• 在添加集成时，选择 "Add device manually" (手动添加)。

• 输入 IP 地址。此时可能需要手动填入 Token 和 Key。

  
  

  • 获取 Token 备选方案：如果集成无法自动获取，你需要使用电脑端的 Python 工具 msmart-ng。

  • 在电脑终端运行：pip install msmart-ng 然后运行 msmart-ng discover，它会扫描局域网并尝试计算 Token。

    
    
  
  

3. 为什么有些传感器不显示？

默认情况下，为了性能，部分非核心传感器（如室外温度、功率统计）可能是禁用状态。

• 进入 设置 -> 设备与服务 -> 点击 Midea AC LAN -> 点击对应设备。

• 在“实体”列表中，点击那些灰色的实体，在设置中将它们 Enable (启用)，稍等片刻即可看到数据。

  
  

4. 关于 Matter (仅限新款设备)

如果你的设备是 2024 年后生产的高端款（如 Midea U 型窗机新款），包装上印有 Matter 标志。

• 你可以直接通过 HA 的 Matter (BETA) 集成扫描设备机身上的二维码接入。

• 缺点：目前 Matter 协议对空调的支持比较基础，可能无法控制“防直吹”、“自清洁”等特有功能。如果你需要这些功能，请坚持使用上面的 LAN 方案。

  
  

✅ 总结

对于 2025.12.2 版本的 HA 用户，HACS + Midea AC LAN (wuwentao版) 依然是最佳解。它避开了美的云端的不稳定性，实现了完全的本地化控制，是目前最“完美”的接入方式。

发帖者介绍-莱特智能成立于2010年，专注智能家居整体解决方案，Now ALL IN HA，欢迎淘宝搜索！