代码收藏家技术教程 2024-08-15

小米MIOT协议与HomeAssistant集成详解指南

小米MIOT协议在HomeAssistant中的集成指南

hass-xiaomi-miotAutomatic integrate all Xiaomi devices to HomeAssistant via miot-spec, support Wi-Fi, BLE, ZigBee devices. 小米米家智能家居设备接入Hass集成项目地址:https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot

一、项目介绍

小米MIOT协议是小米物联网平台设计的标准规格,旨在依据硬件产品的网络模式、产品功能特征、用户场景特点以及对硬件使用体验的需求定义设备的功能细节. hass-xiaomi-miot 是一个开源组件,它利用MIOT协议将各种小米IoT设备自动整合到HomeAssistant环境中.目前这个组件支持大多数的小米智能家庭设备并且兼容HomeAssistant的Web界面,简化了设备的配置过程而无需编辑YAML文件.

二、项目快速启动

安装方式1: 使用HACS(Home Assistant Community Store)

首次安装:

打开HACS.
导航至"Integrations".
选择 "+" 或者 "Explore & Download Repositories".
搜索并找到 "Xiaomi Miot Auto".
下载此仓库(DOWNLOAD THIS REPOSITORY)以安装组件.

更新组件步骤类似,但是选择"Update"或重新下载(Redownload)进行操作.

安装方式2: 手动安装通过Samba/SFTP

手动安装过程中需将custom_components/xiaomi_miot目录复制到您的HomeAssistant配置目录下的custom_components文件夹中.

# 复制文件夹示例命令(假设你的SFTP服务器是example.com)
scp -r <local_path>/custom_components/xiaomi_miot user@example.com:/path/to/your/homeassistant/custom_components/

应用启动及验证

完成安装后重启HomeAssistant,然后导航至“Integrations”页面搜索“xiaomi_miot”,按提示添加您的小米云账户以及指定要发现的设备类型,如Wi-Fi、BLE(BLE)、Zigbee等.

验证连接状态

检查“Devices”列表以确保所有受支持的小米设备都已被HomeAssistant正确识别.

# HomeAssistant Configuration YAML 示例 (仅为展示目的)
sensor:
  # 实际上不需要配置这些传感器，在组件初始化时它们会被自动创建。
  - platform: xiaomi_miot
    username: YOUR_XIAOMI_USERNAME
    password: YOUR_XIAOMI_PASSWORD
    country: CN  # 根据你的账号地区设置
    discover: [all] # 可选值: ['wifi', 'ble', 'zigbee']
    debug: true # 开启调试日志