【小米MIoT设备接入HomeAssistant通用插件教程】

• 欢迎大家阅读2345VOR的博客【小米MIoT设备接入HomeAssistant通用插件教程】🥳🥳🥳
• 2345VOR鹏鹏主页： 已获得CSDN《嵌入式领域优质创作者》称号🎉🎉、阿里云《arduino专家博主》👻👻👻，座右铭：脚踏实地，仰望星空🛹🛹🛹
• 《HomeAssistant》：介绍homeassistant中基本开发， 重点设计esphome和nodered开发，包含小爱同学打印机等诸多设备添加。🎉🎉🎉

1. Xiaomi Miot Auto介绍

小米IoT设备协议规范：MIoT Specification，简称：MIoT-Spec，是小米IoT平台根据硬件产品的联网方式、产品功能的特点、用户使用场景的特征和用户对硬件产品使用体验的要求，设计的描述硬件产品功能定义的标准规范。了解更多

而hass-xiaomi-miot插件利用了MIoT-Spec的规范，可将绝大部分小米设备轻松接入HomeAssistant，支持WiFi、蓝牙、ZigBee设备。且该插件支持HA后台界面集成，无需配置yaml即可轻松将小米设备接入HA。

2. 常见问题

• 👍 新手入门手把手教程1 (感谢@来鸭大佬)
• 👍 新手入门手把手教程2 (感谢@萝卜大佬)
• 登录失败/没有实体等常见问题解决办法
• 支持哪些设备？是否支持XX型号？
• 账号集成还是token集成？
• 为什么XX型号的设备需要开启云端模式？如何开启？
• 怎样为一个实体添加自定义属性？
• 为什么设备状态会有延迟？如何减小延迟？
• 如何翻译实体的选项文本？
• 如何让小爱同学播放文本(TTS)和执行语音命令？
• 如何在HA查看摄像头实体回放(看家助手)视频？
• 为什么设备状态会有延迟？如何减小延迟？
• 如何删除本插件生成的HA设备？
• [新手必读]更多其他常见问题…

3. 安装/更新

3.1 方法1: HACS

• 首次安装

  HACS > 集成 > ➕ 浏览并下载存储库 > Xiaomi Miot Auto > 下载此存储库

• 升级插件

  HACS > 集成 > Xiaomi Miot Auto > 更新 / 重新下载

3.2 方法2: 通过Samba或SFTP手动安装

下载并复制custom_components/xiaomi_miot文件夹到HA根目录下的custom_components文件夹

3.3 方法3: 通过SSH或Terminal & SSH加载项执行一键安装命令

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

3.4 方法4: shell_command服务

1. 复制下面的代码到HA配置文件configuration.yaml

   shell_command:
     update_xiaomi_miot: |-
       wget -q -O - https://ghproxy.com/raw.githubusercontent.com/al-one/hass-xiaomi-miot/master/install.sh | HUB_DOMAIN=ghproxy.com/github.com ARCHIVE_TAG=latest bash -
   

2. 重启HA
3. 在HA开发者工具中调用此服务service: shell_command.update_xiaomi_miot

3.5 视频教程

• 📺 HACS安装插件及使用视频教程 (感谢小帅同学Js)
• 📺 HACS安装插件视频教程 (感谢@老明)
• 📺 手动安装插件视频教程 (感谢@爱运动的数码君)

4. 配置

⚙️ 配置 > 设备与服务 > 🧩 集成 > ➕ 添加集成 > 🔍 搜索 Xiaomi Miot Auto

4.1 账号集成 (Add devices using Mi Account):

自v0.4.4版本开始，插件新增支持账号集成时选择连接设备的模式：

• 自动模式：插件定期更新支持本地miot协议的设备，并自动将用户筛选的设备中符合条件的型号使用本地连接（推荐）
• 本地模式：集成配置所筛选的设备都将使用本地连接，如勾选了不支持本地miot协议的设备将不可用
• 云端模式：集成配置所筛选的设备都将使用云端连接，建议旧版miio、蓝牙、ZigBee设备使用

4.2 本地集成 (Add device using host/token):

通过host/token接入设备，适用于在局域网环境下支持miot协议的设备

4.3 配置云端模式:

为通过token集成的设备开启云端模式

# configuration.yaml
xiaomi_miot:
  username: xiaomi_username
  password: xiaomi_password
  # server_country: cn # 小米云服务器位置: cn(默认), de, i2, ru, sg, tw, us
  # http_timeout: 15   # 请求小米接口的超时时间(秒)

⚙️ 配置 > 设备与服务 > 🧩 集成 > Xiaomi Miot Auto > 选项 > ☑️ 开启云端模式

创建HA开机自动播报“Homeassistant启动啦，快来和我玩呀”


触发条件yaml

platform: homeassistant
event: start

点击执行动作，就可播报啦

参考文献：
Xiaomi Miot For HomeAssistant
Homeassistant - 使用小爱音箱控制 Hass 设备
9 个月前 (1月 8 2022)