English | 简体中文
由于原作者长期没有更新,所以自己fork了一个(捐款信息全是原作者)
通过本地局域网控制你的美的M-Smart设备
- 通过Home Assistant UI完成设备的自动搜索和配置.
- 生成额外的传感器和开关方便进行设备控制.
- 与设备保持TCP长连接以便实时同步设备状态.
本集成部分技术来源来自 @mac-zhou, 他的美的midea-msmart提供了类似的功能。 该组件包括来自他的项目中经过改写的部分代码。
同时感谢@NeoAcheron
⭐如果本集成对你有所帮助, 请不吝为它点个星, 这将是对我的极大激励。
❗注意: 本集成需要Home Assistant 2022.5或更高版本
以及更多。
类型 | 名称 | 文档 |
---|---|---|
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 |
在HACS中搜索'Midea AC LAN'并安装, 或者从Latest release下载最新的Release版本, 将其中的custom_components/midea_ac_lan
放到你的Home Assistant的custom_components/midea_ac_lan
中。
重启Home Assistant
❗注意: 首先, 在路由器上为你的设备设置一个静态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
如果喜欢这个集成, 可以使用支付宝或者微信支付赞助我来支持我的工作。