小米MIoT设备自动识别接入HA插件 2024-04-30新版发布

anlong · 发表于 2021-1-22 16:40:30

本帖最后由 anlong 于 2024-4-30 18:02 编辑

插件地址：https://github.com/al-one/hass-xiaomi-miot
中文说明：https://github.com/al-one/hass-xiaomi-miot/blob/master/README_zh.md
使用教程：https://mp.weixin.qq.com/s/1y_EV6xcg17r743aV-2eRw

MIoT-Spec 是小米IoT平台根据硬件产品的联网方式、产品功能的特点、用户使用场景的特征和用户对硬件产品使用体验的要求，设计的描述硬件产品功能定义的标准规范。
本插件利用了miot协议的规范，可将小米设备自动接入HomeAssistant，目前已支持大部分小米米家智能设备。且该插件支持HA后台界面集成，无需配置yaml即可轻松将小米设备接入HA。

Xiaomi Miot Auto 通过独有的miio2miot机制，可以实现绝大部分的WiFi设备本地接入，随着版本的更新，支持本地接入的WiFi设备也将越来越多。

登录/注册后可看大图

安装/更新插件：

方法1：HACS
首次安装：HACS > 集成 > +浏览并下载存储库 > 搜索`Xiaomi Miot Auto` > 下载此存储库
升级插件：HACS > 集成 > `Xiaomi Miot Auto` > 更新 / 重新下载

方法2：手动安装
下载后解压并复制`custom_components/xiaomi_miot`文件夹到HA根目录下的`custom_components`文件夹中，也可以执行下面的shell命令可以自动安装/更新：

wget -O - https://hacs.vip/get | DOMAIN=xiaomi_miot REPO_PATH=al-one/hass-xiaomi-miot ARCHIVE_TAG=latest bash -

方法3：`shell_command`服务

# configuration.yaml
shell_command:
  update_xiaomi_miot: |-
    wget -O - https://hacs.vip/get | DOMAIN=xiaomi_miot REPO_PATH=al-one/hass-xiaomi-miot ARCHIVE_TAG=latest bash -

复制上面的代码到HA配置文件`configuration.yaml`
重启HA使配置生效
在HA开发者工具中调用此服务 service: shell_command.update_xiaomi_miot
再次重启HA使新版插件生效

安装后重启HA，依次进入：配置 > 集成 > ＋添加集成，搜索“Xiaomi Miot Auto”，配置你的账号或设备信息即可。
hass-xiaomi-miot-guide-01.min.jpg

如果安装成功后搜索不到插件，请确认的插件目录结构如下，并清理浏览器缓存或更换浏览器后再尝试。

.../custom_components/xiaomi_miot/
├── __init__.py
├── air_quality.py
├── binary_sensor.py
├── camera.py
├── climate.py
├── config_flow.py
├── core/
├── ......
├── vacuum.py
└── water_heater.py

目前支持的HA实体类型有：sonsor、binary_sensor、switch、light、fan、climate、cover、humidifier、media_player、camera、vacuum、number、select、water_heater、device_tracker
支持的米家设备类型有：空调、开关、插座、灯、风扇、电视、投影、洗衣机、冰箱、净水器、电饭煲/电磁炉、烤箱/微波炉、空气炸锅、饮水机、热水器、油烟机、窗帘电机、晾衣机、扫地机、加湿器、除湿器、空气检测仪、空气净化器、新风机、取暖器、浴霸、马桶(盖)、电热毯/水暖垫、电动床、按摩椅、开窗器、宠物饮水机、鱼缸、后视镜、手表、小爱音箱等

不支持的设备：
本插件使用轮询的方式获取设备状态，因此无法实时监听部分设备的事件

无线场景开关类 (如: lumi.sensor_switch.v1 / lumi.remote.b686opcn01)
人体传感器类 (如: lumi.sensor_motion.v1)
门窗传感器类 (如: lumi.sensor_magnet.v1)
摄像头/可视门铃: 不支持获取实时直播视频流，部分型号支持获取看家助手中的最后一张静态照片

集成设备：

通过小米账号集成： (Add devices using Mi Account)
该方式比较简单，也是推荐的方式，填入小米账号密码后读取设备列表，并在后续步骤中配置筛选设备的条件，保存后插件会把符合条件的设备自动添加到HA。如果不知道如何配置筛选条件或者账号下的设备不多，可以将筛选方式全部改成`Exclude (排除)`，并去掉所有的勾选。
自v0.4.4版本开始，插件新增支持账号集成时选择连接设备的模式：