三步搞定美的家电本地化控制Midea AC LAN 局域网直连方案完全指南【免费下载链接】midea_ac_lanAuto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.项目地址: https://gitcode.com/gh_mirrors/mi/midea_ac_lan美的家电本地化控制正在成为越来越多家庭的刚需。Midea AC LAN 就是这样一套开源的局域网直连方案——它让你绕过云端中转直接在本地 Home Assistant 里掌控家里的美的系空调、风扇、热水器、洗衣机等设备。最吸引人的一点是哪怕外网彻底中断这些设备依然听你指挥秒级响应、数据不出家门。如果你厌倦了按下开关等三秒的迟钝或者担心自己的使用习惯被悄悄上传到厂商服务器那么这篇文章就是为你准备的。我们不讲晦涩的协议细节只把把遥控器拿回自己手里这件事讲清楚、做明白。第一章 你的智能家电其实一直在绕远路想象一个深夜场景你躺在床上准备入睡随口说了一句把空调关了系统却慢吞吞地转圈三秒后才传来一声嘀。你可能会归咎于网络不好但真相是——你的指令根本没有直奔空调而是先出了家门。一次指令的千里旅行当你用厂商 App 控制设备时指令的实际路径是这样的你家手机 → 路由器 → 运营商骨干网 → 厂商云服务器 → 骨干网 → 路由器 → 空调而 Midea AC LAN 的路径只有短短一截Home Assistant → 路由器 → 空调前者像极了让邻居帮忙传话明明隔壁就是你家偏要写封信寄到千里之外再寄回来。后者则是当面沟通一句关空调对方立刻照做。云端依赖的三笔隐形账单账单类型具体表现响应延迟指令绕行云端动辄几百毫秒起步自动化联动越多越明显隐私成本开关机时间、温湿度读数、作息规律全部经由厂商服务器单点故障厂商服务器维护、外网波动、运营商故障都可能让你的家电集体失聪这三笔账很多人平时感觉不到直到某一天外网断了、厂商服务器抽风了才发现满屋子智能设备一夜之间变成了半智能。而局域网直连方案正是为了把这三笔账一次性勾销。第二章 Midea AC LAN 是什么把遥控器还给你简单说Midea AC LAN 是一个运行在 Home Assistant 上的集成组件它用逆向工程还原了美的 M-Smart 协议的通信规则让你的 HA 能够以设备本尊的身份在局域网内直接与家电对话。它为你做了什么自动发现与配置通过 HA 界面完成设备搜索与添加全程可视化不需要手写配置文件。实时状态同步与设备维持 TCP 长连接设备状态一变HA 立刻知道无需反复轮询。丰富的实体扩展除了核心控制实体还能按需生成温湿度、能耗等传感器以及电辅热、ECO、无风感等开关实体。一屋子家电它几乎都认识项目为三十多种设备类型提供了专门的协议实现常见品类基本全覆盖空调、风扇、除湿器、空气净化器、加湿器、新风设备、电热水器、燃气热水器、壁挂炉、洗衣机、干衣机、洗碗机、油烟机、冰箱、电饭煲、微波炉、电烤箱、智能马桶、浴霸、灯……品牌方面也相当宽容美的、小天鹅、COLMO、东芝、Carrier、Ariston 等均在其列。你可以把它理解为一座翻译官团队——每种家电都配了一位听得懂它方言的本地翻译。第三章 一次握手、一个保险箱、一条不断线的通道局域网直连听起来高大上拆开看其实就三步每一步都像极了日常生活中的小动作。第一步对暗号握手与 Token 认证设备要确认你是自己人才肯跟你说话。这个过程叫握手客户端先发一个身份请求设备回应一串随机数双方再交换密钥材料最后各自推导出会话密钥。整个过程由midea/core/security.py中的 LocalSecurity 类负责属于典型的先对暗号、再谈正事。第二步用保险箱传话AES 加密通信暗号对上之后所有指令都装进保险箱再传输——采用 AES 加密密钥和初始向量由握手阶段动态协商。哪怕有人在你家网络里偷听看到的也只是一堆无意义的乱码完全无法还原你在调温度还是开新风。第三步留一扇常开的门TCP 长连接HTTP 那种问一句答一句、说完就关门的模式在这里被换成了门一直开着TCP 长连接建立后设备状态一旦变化就会主动推送HA 侧甚至可以在主动刷新间隔设为 0 的情况下依然保持状态最新。这正是它响应快、开销小的底层原因。如果你想亲手验证这套机制可以从custom_components/midea_ac_lan/midea/core/目录读起先看device.py设备通信基类再看message.py消息编解码最后对照security.py加密认证和discover.py发现机制。想了解某类设备的具体实现midea/devices/ac/device.py是个不错的入口。第四章 半小时上手把第一台设备接进来理论说再多不如动手一次。这一章我们走完整条路全程大概半小时。动手前的三分钟自检检查项要求Home Assistant 版本2022.5 或更高网络位置设备与 HA 处于同一网段路由器设置关闭 AP 隔离避免设备互相看不见IP 地址强烈建议为设备绑定静态 IP防止重启后地址漂移其中静态 IP 这一步最容易被人忽略但恰恰最值钱——地址一变所有配置都要跟着改绑定好一劳永逸。安装两条路任选路线一HACS 一键安装推荐新手在 HACS 中搜索 Midea AC LAN点击安装重启 Home Assistant 即可。路线二手动安装想完全掌控git clone https://gitcode.com/gh_mirrors/mi/midea_ac_lan把克隆下来的目录中的custom_components/midea_ac_lan整个复制到你的 Home Assistant 的custom_components/目录下然后重启。三步接入从零到控制第一步添加集成。在 HA 的设备与服务中搜索并添加 Midea AC LAN 集成。第二步登录一次美的账号。配置过程中会要求你输入美的账号和密码——别担心这只是为了去美的云服务器取回每台设备的 Token 与 Key相当于设备的身份证 钥匙。全部设备配置完成后这个账号配置可以删掉设备照常使用此后不再有任何云端往来。第三步选择添加方式。项目提供了三种按你的情况挑自动搜索组件扫描局域网并列出可发现的设备你选一台确认即可也可以指定网段搜索比如192.168.1.255。手动配置如果你从其他途径已知设备 ID、类型、IP、端口默认 6444、协议版本、Token 和 Key可以直接填表添加。仅列出所有设备只想看看网络里有哪些美的设备以及它们的 ID、类型、SN 等信息选这个就好。多台设备重复上述流程多次添加即可集成并不限制数量。安装后的三个加分项接入成功后你还可以在集成选项里做三件小事体验会立刻不一样调整刷新间隔默认每 30 秒主动刷新一次状态设为 0 表示关闭主动刷新。多数设备状态变化时会主动推送因此即使设为 0 也基本无感还能省电。生成额外实体勾选你想要的传感器与开关比如室内外温度、实时功率、累计能耗、电辅热、无风感、水平/垂直摆风等让面板信息更丰富。自定义设备参数部分设备支持 JSON 自定义比如把空调温度步长从默认的 0.5 改成 1{temperature_step: 1}第五章 进阶玩法让家电学会察言观色接入只是开始真正的乐趣在于让设备们互相配合。下面三个场景你可以在 HA 的自动化里直接照着写。场景一下班回家房间刚好是舒适温度出门前关掉空调省电回家前半小时自动开启预冷——用时间触发就能实现automation: - alias: 下班回家预冷 trigger: platform: time at: 17:30:00 action: - service: climate.set_hvac_mode target: entity_id: climate.midea_ac_01 data: hvac_mode: cool - service: climate.set_temperature target: entity_id: climate.midea_ac_01 data: temperature: 26场景二深夜入睡空调自动退居二线设置一个睡眠自动化到点把温度调高 1 度、关闭电辅热、开启无风感让风不再直吹床头automation: - alias: 夜间睡眠模式 trigger: platform: time at: 23:00:00 action: - service: climate.set_temperature target: entity_id: climate.midea_ac_01 data: temperature: 27 - service: switch.turn_on target: entity_id: switch.midea_ac_01_breezeless - service: switch.turn_off target: entity_id: switch.midea_ac_01_aux_heating场景三出门前一键关闭全屋把空调、风扇、灯光和安防系统串进同一个脚本出门只点一下script: good_bye: sequence: - service: climate.turn_off target: entity_id: climate.midea_ac_01 - service: fan.turn_off target: entity_id: fan.midea_fa_01 - service: switch.turn_off target: entity_id: switch.midea_light_01 - service: alarm_control_panel.alarm_arm_away target: entity_id: alarm_control_panel.home_alarm如果你生成过能耗类传感器实时功率、累计能耗还可以顺手接一个能耗看板配合峰谷电价时段让空调在电价高的时候自动收敛一点——省钱这件事交给自动化去算就好。第六章 故障自救一份能照着做的排查清单设备接不上、状态不更新先别急着卸载重装按下面的顺序过一遍九成问题都能自己解决。症状 1设备搜索不到确认设备与 HA 在同一网段确认路由器没有开启 AP 隔离确认设备确实支持局域网控制部分老款可能不支持。症状 2连接报认证失败重新核对 Token 与 Key重新走一遍登录账号 → 获取设备信息的流程拿到最新的凭据。症状 3状态更新很慢多数设备本身会主动推送状态若你的设备没有此机制可以尝试把刷新间隔调小比如从 30 秒改成 15 秒。症状 4想深挖原因日志不够看在configuration.yaml中开启调试日志然后盯住运行日志logger: default: warn logs: custom_components.midea_ac_lan: debug常见日志关键词的含义也帮你准备好了connect failed→ 网络不通先 ping 设备 IPinvalid token→ 认证凭据有误timeout→ 设备无响应或网络延迟高decrypt error→ 密钥不匹配重新获取 Token/Key。第七章 常见问题速答问这个项目收费吗完全免费开源。项目仓库地址仅用于手动安装时git clone使用https://gitcode.com/gh_mirrors/mi/midea_ac_lanHACS 安装则无需手动下载。问接入之后原来的美的 App 还能用吗能。局域网直连与原厂 App 是两条路互不干扰你完全可以两者并存。问断网真的能用吗只要设备与 HA 在同一局域网内外网断开后控制、自动化照常运行。唯一例外是首次配置时需要用一次云账号获取 Token 与 Key之后云就不再参与了。问需要很强的技术背景吗不需要。全程通过 HA 界面点选完成唯一稍显技术含量的就是给设备设静态 IP在路由器后台花两分钟就能搞定。问多台设备怎么管理重复添加集成 → 添加设备的流程即可不同设备类型的协议实现在项目里是模块化隔离的互不影响。写在最后真正的智能是当家作主Midea AC LAN 的价值远不止快了一点、省了一点。它代表了一种更健康的智能家居理念设备是你的数据是你的控制权也是你的。响应速度从绕远路变成面对面隐私从交给别人保管变成锁在自己家里可用性从看厂商脸色变成我说了算。你不需要成为协议专家也不需要看懂每一行代码。你只需要一个周末的下午跟着这篇文章的步骤把第一台空调接入本地网络然后站在开关前感受一次零延迟的回应。那一刻你会发现原来智能家居本该如此。从今晚开始动手吧——把遥控器重新握回自己手里。【免费下载链接】midea_ac_lanAuto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.项目地址: https://gitcode.com/gh_mirrors/mi/midea_ac_lan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考