小米MIoT设备自动识别接入HA插件 2024-04-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设备也将越来越多。
https://user-images.githubusercontent.com/4549099/142151697-5188ea2d-0aad-4778-8b60-b949bcc410bb.png
安装/更新插件：
方法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”，配置你的账号或设备信息即可。
如果安装成功后搜索不到插件，请确认的插件目录结构如下，并清理浏览器缓存或更换浏览器后再尝试。
.../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版本开始，插件新增支持账号集成时选择连接设备的模式：
[*]自动模式：插件定期更新支持本地miot协议的设备，并自动将用户筛选的设备中符合条件的型号使用本地连接（推荐）
[*]本地模式：集成配置所筛选的所有设备都将使用本地连接，如勾选了不支持本地的设备将不可用，建议只勾选支持本地miot的设备
[*]云端模式：集成配置所筛选的所有设备都将使用云端连接，建议旧版miio、蓝牙、ZigBee设备使用，同个小米账号可以添加多个集成配置
通过IP/token集成： (Add device using host/token)
该方式适合在局域网环境下支持miot协议的米家设备，并可通过集成选项改变更新状态的频率。
常见问题：
[*]登录失败/没有实体等常见问题解决办法
[*]账号集成还是token集成？
[*]为什么XX型号的设备需要开启云端模式？如何开启？
[*]怎样为一个实体添加自定义属性？
[*]为什么设备状态会有延迟？如何减小延迟？
[*]如何翻译实体的选项文本？
[*]红外风扇或者其他平台绑定到米家的风扇如何通过本插件接入HA？
[*]红外窗帘电机如何通过本插件接入HA？
[*]如何让小爱同学播放文本(TTS)和执行语音命令？
[*]小爱对话记录实体使用场景及主动询问示例
[*]如何在HA查看摄像头实体回放(看家助手)视频？
[*]如何删除本插件生成的HA设备？
[*]如何查询米家设备型号？
你们的支持是我持续更新的动力！如果这个插件对你有用，请为项目点击一个★Star。
QQ交流群：198841186 ，插件使用过程中遇到任何问题都可加群咨询，入群口令回帖可见
**** Hidden Message *****
本帖最后由 anlong 于 2024-4-30 18:01 编辑
v0.7.18 新版发布：
[*]完善米家空气净化器 4 Pro H实体 (#1601)
[*]完善小顽智能宠物饮水机海外版实体 (#1615)
[*]完善米家零冷水燃气热水器S1 18L实体 (#1457)
[*]完善米家智能零冷水燃气热水器18L S2实体 (#1457)
[*]完善米家智能净烟机P1实体 (#1630)
[*]新增Yeelight RGB彩光吸顶灯 卧室款氛围灯实体 (#1611)
[*]新增支持米家智能电蒸锅 12L (#1617)
[*]修复灯实体的颜色模式
[*]修复米家LED灯泡 蓝牙MESH版 (#1594)
[*]修复净水器TDS传感器 (#1582)
[*]优化米家智能浴霸Pro (#1593)
[*]优化小爱音箱播放进度 (#1585)
[*]优化云米互联网蒸烤一体机King（嵌入式） (#1598)
[*]优化米家高速搅拌机（破壁料理机） (#1597)
[*]优化米家风冷十字四门冰箱 486L (#1596)
[*]优化冰箱相关实体 (#1426)
[*]优化qmi插座/插线板 (#1590)
[*]优化空调实体 (#1620)
[*]优化智米净化器的pm10传感器单位 (#1542)
[*]移除执行服务的结果通知
[*]移除执行服务的结果事件
[*]支持更多设备本地接入
看看，感谢分享 非常感谢！！可以用了 :hug::hug: 感谢分享.祝身体健康.
非常详细的资料了~~~谢谢谢谢 非常详细的资料了~~~ 膜拜大神！
感谢分享 支持一下