Home Assistant Midea Air Appliances (LAN)：摆脱云端依赖，实现美的智能家电本地网络控制

Home Assistant Midea Air Appliances (LAN)：摆脱云端依赖，实现美的智能家电本地网络控制

【免费下载链接】homeassistant-midea-air-appliances-lanThis Home Assistant custom component adding support for controlling Midea air conditioners and dehumidifiers on local network.项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant-midea-air-appliances-lan

你是否曾经遇到过这样的场景：炎炎夏日，空调突然无法通过手机APP控制，因为云端服务器宕机了；或者梅雨季节，除湿器因为网络不稳定而失去响应？当智能家电必须依赖云端服务器才能工作时，你实际上失去了对设备的真正控制权。Home Assistant Midea Air Appliances (LAN)集成正是为了解决这一问题而生——它让你能够通过本地网络直接控制美的空调和除湿器，彻底摆脱云端依赖，实现真正自主的智能家居体验。

为什么你需要本地控制？云端依赖的三大痛点

在深入技术细节之前，让我们先理解为什么本地控制如此重要：

1. 网络延迟问题：云端控制需要将指令发送到远程服务器，再转发到你的设备，这个过程通常需要几百毫秒到几秒的时间。而本地控制几乎瞬间响应。

2. 隐私安全风险：你的设备使用数据、家庭环境信息都需要经过第三方服务器，存在数据泄露风险。

3. 服务可用性依赖：一旦云端服务不可用（服务器维护、网络中断、服务商倒闭），你的智能设备就变成了"智障设备"。

通过本地网络控制，你重新获得了对设备的完全控制权。数据仅在家庭网络内传输，响应速度极快，即使互联网中断，设备依然可以正常工作。

项目核心价值：不只是替代，更是增强

Home Assistant Midea Air Appliances (LAN)不是简单地替代官方APP，而是在保留原有功能的基础上，提供了更多高级功能：

• 多设备统一管理：在Home Assistant中集中控制所有美的设备
• 自动化集成：与其他智能设备联动，创建复杂场景
• 历史数据记录：长期跟踪设备运行状态和环境变化
• 自定义界面：根据个人需求定制控制面板

更重要的是，这个集成支持美的V2和V3协议设备，这些协议允许本地网络访问。对于V3协议设备，只需要首次连接时访问一次云端获取token和key，之后所有通信都在本地进行。

快速开始：三步完成设备接入

第一步：安装集成

通过HACS安装（推荐）这是最简单快捷的方式：

1. 打开Home Assistant侧边栏，点击"HACS"
2. 选择"集成"选项卡
3. 点击右下角的"浏览和下载存储库"
4. 搜索"Midea Air Appliances (LAN)"
5. 点击"下载"按钮完成安装
6. 重要提示：安装完成后必须重启Home Assistant

手动安装方式如果你更喜欢手动操作，可以按照以下步骤：

1. 克隆项目仓库到本地：

   git clone https://gitcode.com/gh_mirrors/ho/homeassistant-midea-air-appliances-lan

2. 将custom_components/midea_dehumidifier_lan文件夹复制到Home Assistant的custom_components目录中

第二步：配置集成

完成安装后，进入"配置" → "设备与服务"，点击"+添加集成"，搜索"Midea Air Appliances (LAN)"并选择。系统会引导你完成配置流程：

在配置过程中，你需要提供以下信息：

• Midea云账户用户名：你在美的美居APP中使用的手机号或邮箱
• 密码：对应的账户密码
• 移动应用选择：选择你使用的官方APP版本

集成会自动扫描局域网内的Midea设备。如果自动发现失败，你可以手动输入设备的IPv4地址。在配置页面选择"高级设置"，输入设备的IPv4地址，保存配置并重启Home Assistant即可。

第三步：开始使用

配置完成后，你的美的设备就会出现在Home Assistant的设备列表中。对于除湿器，你将看到完整的控制界面：

对于空调设备，你将获得温度控制、模式切换等完整功能。所有操作都在本地网络中进行，无需经过云端服务器，响应速度极快。

功能详解：从基础控制到高级监控

除湿器的完整控制能力

每个发现的除湿器将创建以下控制实体，让你全面掌控设备状态：

空调设备的全面控制

对于空调设备，集成提供以下功能：

传感器数据实时监控

集成提供了丰富的传感器数据，让你随时了解设备状态：

注意：部分除湿器的温度传感器可能读数偏低，这是正常现象。通常是由于传感器位置靠近冷却管道造成的，不影响设备的正常工作。

实际应用场景：智能家居的无限可能

场景一：智能湿度控制

假设你住在潮湿地区，可以设置以下自动化规则：

# 当湿度超过70%时自动开启除湿器 automation: - alias: "Auto Dehumidify When Too Humid" trigger: platform: numeric_state entity_id: sensor.dehumidifier_humidity above: 70 action: service: humidifier.turn_on entity_id: humidifier.dehumidifier

场景二：节能模式联动

结合其他传感器，创建更智能的节能策略：

# 当室内无人且湿度正常时关闭除湿器 automation: - alias: "Turn Off Dehumidifier When No One Home" trigger: platform: state entity_id: binary_sensor.presence_sensor to: "off" condition: condition: numeric_state entity_id: sensor.dehumidifier_humidity below: 60 action: service: humidifier.turn_off entity_id: humidifier.dehumidifier

场景三：空调温度优化

根据室外温度自动调节室内温度：

# 当室外温度超过30度时，将空调设为26度 automation: - alias: "Adjust AC Based on Outdoor Temperature" trigger: platform: numeric_state entity_id: sensor.outdoor_temperature above: 30 action: service: climate.set_temperature target: entity_id: climate.air_conditioner data: temperature: 26

高级功能：深度定制你的设备

启用调试日志排查问题

当遇到设备连接或控制问题时，你可以启用详细日志记录功能：

1. 进入集成的高级设置页面
2. 激活调试日志记录功能
3. 查看完整日志进行分析

你也可以通过Home Assistant的服务功能直接启用调试日志。在开发者工具的服务页面，调用logger.set_level服务，设置以下参数：

service: logger.set_level data: custom_components.midea_dehumidifier_lan: DEBUG midea_beautiful: DEBUG

设备管理的最佳实践

1. 避免冲突：不要同时使用多个集成访问同一台设备，这可能导致不可预知的行为
2. IP地址管理：如果设备IP地址变更，需要重启Home Assistant才能重新连接
3. 网络访问：确保Home Assistant能够访问物理网络，否则可能无法发现所有设备
4. 定期检查：定期查看设备状态和错误代码，及时发现并解决问题

支持的设备型号

本集成支持以下品牌和型号的美的智能家电：

重要提示：2021年及之后生产的某些Midea设备使用Tuya平台，本集成将无法支持这些设备。在购买新设备时，请确认设备使用的是V2或V3协议，而不是Tuya协议。

常见问题与解决方案

Q1：设备无法被发现怎么办？

如果集成无法自动发现你的设备，可以尝试以下步骤：

1. 检查网络连接：确保设备与Home Assistant在同一子网内
2. 验证设备状态：确认设备已连接到WiFi网络并正常工作
3. 手动添加设备：在集成配置页面选择"高级设置"，输入设备的IPv4地址
4. 重启设备：有时简单的重启可以解决连接问题

Q2：传感器数据显示异常如何处理？

如果传感器数据显示异常，特别是温度传感器读数偏低：

1. 了解原因：这通常是由于传感器位置靠近冷却管道造成的物理现象
2. 校准调整：可以在Home Assistant中创建模板传感器进行校准
3. 使用外部传感器：考虑使用独立的温湿度传感器获取更准确的数据

Q3：升级后出现问题怎么办？

如果你在升级集成后遇到问题：

1. 卸载重装：卸载集成，重启Home Assistant，然后重新安装
2. 检查配置：确保配置信息正确无误
3. 查看日志：启用调试日志，查看详细的错误信息

技术原理：本地控制如何工作

协议解析

美的设备使用两种主要协议进行通信：

1. V3协议：较新的协议，需要首次连接时访问云端获取token和key
2. V2协议：较旧的协议，部分设备支持

这个集成的核心是midea-beautiful-air库，它负责：

• 设备发现和识别
• 协议解析和通信
• 数据加密和解密
• 错误处理和重试

数据流分析

本地控制的数据流非常简单：

Home Assistant → 本地网络 → 美的设备

对比云端控制的数据流：

Home Assistant → 互联网 → 美的云服务器 → 互联网 → 美的设备

本地控制不仅减少了延迟，还提高了可靠性和隐私性。

社区生态与未来展望

相关资源

• 官方文档：README.md
• 配置示例：info.md中的详细说明
• 问题排查：README.md中的故障排除部分
• 社区讨论：GitHub Issues中的技术讨论

自定义界面

如果你想要更美观的控制界面，可以尝试以下Lovelace卡片：

• Dehumidifier_Comfee_Card：专门为Comfee除湿器设计的卡片
• midea-inventor-card：为Inventor设备优化的卡片

技术发展趋势

随着物联网技术的发展，本地控制将成为智能家居的主流方向。未来我们可能会看到：

1. 更多设备支持：支持更多品牌和型号的本地控制
2. 协议标准化：统一的本地控制协议标准
3. 边缘计算：设备端智能处理，减少对中心服务器的依赖
4. 隐私保护：更强的数据加密和隐私保护机制

开始你的本地智能家居之旅

现在，你已经了解了Home Assistant Midea Air Appliances (LAN)集成的全部功能。这个集成不仅让你摆脱云端依赖，更重要的是让你重新获得了对智能设备的控制权。

通过本地控制，你可以：

• 享受极速响应：控制指令瞬间到达设备
• 保护隐私安全：数据不再经过第三方服务器
• 确保服务可用：即使互联网中断，设备依然可用
• 实现深度集成：与其他智能设备无缝联动

不要再让云端服务器成为你智能家居的瓶颈。现在就开始行动，将你的美的空调和除湿器接入Home Assistant的本地网络控制系统，体验真正的智能家居自主权。

记住，智能家居的核心应该是为你服务，而不是让你为它操心。通过本地控制，你重新掌握了主动权。开始你的本地智能家居之旅吧！

【免费下载链接】homeassistant-midea-air-appliances-lanThis Home Assistant custom component adding support for controlling Midea air conditioners and dehumidifiers on local network.项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant-midea-air-appliances-lan