Skip to content

Auto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.

License

Notifications You must be signed in to change notification settings

HappyQuQu/midea_ac_lan

 
 

Repository files navigation

Midea AC LAN

hacs_badge Donate Stable

English | 简体中文

由于原作者长期没有更新,所以自己fork了一个(捐款信息全是原作者)

通过本地局域网控制你的美的M-Smart设备

  • 通过Home Assistant UI完成设备的自动搜索和配置.
  • 生成额外的传感器和开关方便进行设备控制.
  • 与设备保持TCP长连接以便实时同步设备状态.

本集成部分技术来源来自 @mac-zhou, 他的美的midea-msmart提供了类似的功能。 该组件包括来自他的项目中经过改写的部分代码。

同时感谢@NeoAcheron

⭐如果本集成对你有所帮助, 请不吝为它点个星, 这将是对我的极大激励。

❗注意: 本集成需要Home Assistant 2022.5或更高版本

已支持的品牌

beverly bugu carrier colmo comfee electrolux invertor littleswan midea netsu ProBreeze rotenso toshiba vandelo wahin

以及更多。

已支持的设备

类型 名称 文档
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, 如果需要添加多台设备, 多次添加本集成并执行自动配置即可。

或者直接点击 Configuration

❗注意: 配置过程中, 可能会要求输入你的美的账号及密码, 这是因为需要去美的云服务器获取设备的信息 (Token and Key)。在完成所有设备配置后, 可以删除美的账户配置, 不影响设备的使用

完成美的账户配置之后, 点击'添加设备'进行设备添加。你可以多次重复操作以添加多台设备。

Discover automatically / 自动搜索

使用此选项, 组件会列出网络上或者指定IP地址上的设备, 选择一个并进行添加。

你也可以使用IP地址在指定网络中搜索, 比如192.168.1.255

❗注意: 自动配置要求设备必须与HA在同一网段, 否则可能搜索不到设备, 请自行确认这点

Configure manually / 手动配置

如果之前你已经通过其它集成手工配置过设备, 并知道以下信息, 也可以进行手动配置

  • 设备ID
  • 设备类型 (已支持的设备之一)
  • IP地址
  • 端口(默认为6444)
  • 协议版本
  • Token
  • Key

List all appliances only / 仅列出所有设备

使用此选择, 可以列出网络中所有可以被搜索到的美的M-Smart设备, 以及他们的ID, 类型, SN等信息

❗注意: 出于某些原因, 可能不是所有受支持的设备都能于此列出

配置

集成配置位于配置 -> 设备与服务 -> Midea AC LAN -> 设备 -> 选项。 在配置中, 你可以在设备IP改变后重新指定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

支持我的工作

如果喜欢这个集成, 可以使用支付宝或者微信支付赞助我来支持我的工作。

alipay wechatpay

About

Auto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%