English | 简体中文 | Discord交流群
❗ georgezhao2010/midea_ac_lan 已经很长时间没有更新了, 我们将接替并持续更新
通过本地局域网控制你的美的M-Smart设备
- 通过Home Assistant UI完成设备的自动搜索和配置.
- 生成额外的传感器和开关方便进行设备控制.
- 与设备保持TCP长连接以便实时同步设备状态.
本集成部分技术来源来自 @mac-zhou, 他的美的midea-msmart提供了类似的功能。 该组件包括来自他的项目中经过改写的部分代码。
同时感谢@NeoAcheron
⭐如果本集成对你有所帮助, 请不吝为它点个星, 这将是对我的极大激励。
❗注意: 本集成需要 Home Assistant 2023.8 或更高版本
以及更多。
| 类型 | 名称 | 文档 |
|---|---|---|
| 13 | 灯 | 13_hans.md |
| 26 | 浴霸 | 26_hans.md |
| 34 | 水槽式洗碗机 | 34_hans.md |
| 40 | 凉霸 | 40_hans.md |
| A1 | 除湿器 | A1_hans.md |
| AC | 空调器 | AC_hans.md |
| B0 | 微波炉 | B0_hans.md |
| B1 | 电烤箱 | B1_hans.md |
| B3 | 消毒碗柜 | B3_hans.md |
| B4 | 小烤箱 | B4_hans.md |
| B6 | 油烟机 | B6_hans.md |
| BF | 微蒸烤一体机 | BF_hans.md |
| C2 | 智能马桶 | C2_hans.md |
| C3 | 热泵空调Wi-Fi线控器 | C3_hans.md |
| CA | 冰箱 | CA_hans.md |
| CC | 中央空调(风管机)Wi-Fi线控器 | CC_hans.md |
| CD | 空气能热水器 | CD_hans.md |
| CE | 新风设备 | CE_hans.md |
| CF | 中央空调暖家(水机) | CF_hans.md |
| DA | 波轮洗衣机 | DA_hans.md |
| DB | 滚筒洗衣机 | DB_hans.md |
| DC | 干衣机 | DC_hans.md |
| E1 | 洗碗机 | E1_hans.md |
| E2 | 电热水器 | E2_hans.md |
| E3 | 燃气热水器 | E3_hans.md |
| E6 | 壁挂炉 | E6_hans.md |
| E8 | 慢炖锅 | E8_hans.md |
| EA | 电饭煲 | EA_hans.md |
| EC | 电压力锅 | EC_hans.md |
| ED | 饮用水设备 | ED_hans.md |
| FA | 电风扇 | FA_hans.md |
| FB | 电取暖器 | FB_hans.md |
| FC | 空气净化器 | FC_hans.md |
| FD | 加湿器 | FD_hans.md |
请使用以下方式安装:
- 确保
Home Assistant中已安装HACS HACS install docs- 打开
HACS, 点击[Custom repositories],Repository输入:https://github.com/wuwentao/midea_ac_lan,Category选择[Integration]- 重启Home Assistant.
在HomeAssistant的Terminal add-on或者SSH中执行以下脚本
wget -O - https://github.com/wuwentao/midea_ac_lan/raw/master/scripts/install.sh | ARCHIVE_TAG=latest bash -
- 从Latest Release 下载
midea_ac_lan.zip- 复制
midea_ac_lan.zip到/custom_components/midea_ac_lan.- 重启 Home Assistant.
重启完成后, 打开 [Settings], [Device & services], [Integrations], [Midea AC Lan], 进行初始化设置并添加所有设备.
❗注意: 首先, 在路由器上为你的设备设置一个静态IP地址, 以防设置后设备的IP地址发生改变。
安装之后, 在Home Assistant的集成界面搜索添加集成Midea AC LAN, 如果需要添加多台设备, 多次添加本集成并执行自动配置即可。
或者直接点击
❗注意: 配置过程中, 可能会要求输入你的美的账号及密码, 这是因为需要去美的云服务器获取设备的信息 (Token and Key)。在完成所有设备配置后, 可以删除美的账户配置, 不影响设备的使用
完成美的账户配置之后, 点击'添加设备'进行设备添加。你可以多次重复操作以添加多台设备。
使用此选项, 组件会列出网络上或者指定IP地址上的设备, 选择一个并进行添加。
你也可以使用IP地址在指定网络中搜索, 比如192.168.1.255
❗注意: 自动配置要求设备必须与HA在同一网段, 否则可能搜索不到设备, 请自行确认这点
如果之前你已经通过其它集成手工配置过设备, 并知道以下信息, 也可以进行手动配置
- 设备ID
- 设备类型 (已支持的设备之一)
- IP地址
- 端口(默认为6444)
- 协议版本
- Token
- Key
使用此选择, 可以列出网络中所有可以被搜索到的美的M-Smart设备, 以及他们的ID, 类型, SN等信息
❗注意: 出于某些原因, 可能不是所有受支持的设备都能于此列出
集成配置位于配置 -> 设备与服务 -> Midea AC LAN -> 设备 -> 选项。
在配置中, 你可以在设备IP改变后重新指定IP地址, 也可以增加扩展的传感器或开关等实体或者自定义你的设备
指定设备的IP地址。当你的设备IP地址变动后, 可以重新设定它
指定单台设备的主动状态刷新间隔 (单位为秒) (默认值为30, 设0代表不进行主动刷新)
大部分的美的设备在自身状态改变时会主动发送通知, 在这种情况下, 即使将改值设为0, 也不会影响HA中的设备状态更新。组件默认每间隔30秒会进行主动刷新。部分设备没有状态改变时主动通知的机制, 状态同步就会表现得很慢, 这种情况下可以尝试更短的主动状态更新间隔。
❗注意: 更小的更新间隔意味着更多的能源消耗
配置完成后, 可能会默认生成一个或几个主要实体(比如climate实体)。如果需要其它属性生成为扩展的传感器及开关实体, 在Midea AC LAN集成卡片上点击'选项', 并选择要生成的传感器及开关(如果你的设备支持该属性)。
某些类型的设备有它们自己的自定义项, 可以通过自定义项定制设备的特点。如果你的设备无法正常工作, 也许你需要自定义它。请参阅设备文档以获取具体信息。
自定义的格式必须是JSON。
如果要设置多个自定义项, 请注意遵循JSON的格式要求
示例
{ "refresh_interval": 15, "fan_speed": 100 }要打开调试日志输出, 在configuration.yaml中添加如下配置
logger:
default: warn
logs:
custom_components.midea_ac_lan: debug
midealocal: debug需同时开启
midea_ac_lan和midealocal, 重启后生效
或者使用如下方式，无需重启
Developer Tools->Services->GO TO YAML MODE粘贴以下内容到输入框中，执行CALL SERVICE
service: logger.set_level
data:
custom_components.midea_ac_lan: debug
midealocal: debug