终极HomeAssistant小米设备集成指南：实现智能家居跨平台无缝控制

【免费下载链接】hass-xiaomi-miot Automatic 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

hass-xiaomi-miot是一款强大的小米米家智能家居设备接入HomeAssistant的集成工具，它利用MIoT协议规范，可自动将小米设备接入HomeAssistant，目前已支持大部分小米米家智能设备。通过该插件，用户无需复杂配置即可轻松实现小米设备与HomeAssistant的无缝对接，打造个性化的智能生活体验。

快速了解hass-xiaomi-miot的核心优势

hass-xiaomi-miot作为一款专为HomeAssistant设计的小米设备集成插件，具有以下显著优势：

• 广泛的设备支持：涵盖插座、智能灯、空调、风扇、摄像头、电视、小爱音箱等多种类型设备，基本满足家庭智能设备的接入需求。
• 灵活的集成方式：支持账号集成和本地集成两种模式，账号集成又分为自动模式、本地模式和云端模式，可根据设备类型和网络环境灵活选择。
• 便捷的配置过程：提供HA后台界面集成，无需手动编写大量yaml配置文件，新手也能轻松上手。
• 丰富的自定义功能：允许用户自定义实体属性、翻译词典、过滤实体属性等，满足个性化需求。

超简单的安装步骤，5分钟上手

方法1：通过HACS安装（推荐）

HACS是HomeAssistant的社区商店，通过它安装hass-xiaomi-miot非常方便：

1. 打开HomeAssistant，进入HACS界面。
2. 点击“集成”，然后点击右上角的“浏览并下载存储库”。
3. 搜索“Xiaomi Miot”，找到对应的存储库并下载。
4. 下载完成后，重启HomeAssistant使插件生效。

对于已安装的用户，升级插件也很简单：在HACS的集成页面找到“Xiaomi Miot”，点击“更新”或“重新下载”即可。

方法2：手动安装

如果没有安装HACS，也可以通过Samba或SFTP手动安装：

1. 下载hass-xiaomi-miot的源代码。
2. 将custom_components/xiaomi_miot文件夹复制到HomeAssistant根目录下的custom_components文件夹。
3. 重启HomeAssistant。

方法3：一键安装命令

通过SSH或Terminal & SSH加载项执行以下命令：

wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot bash -

详细的配置教程，轻松连接设备

账号集成（Add devices using Mi Account）

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

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

配置步骤：

1. 进入HomeAssistant的配置界面，选择“设备与服务”。
2. 点击“集成”，然后点击“添加集成”。
3. 搜索“Xiaomi Miot”，选择对应的集成。
4. 根据提示输入小米账号和密码，选择连接模式，完成设备筛选。

本地集成（Add device using host/token）

通过host/token接入设备，适用于在局域网环境下支持miot协议的设备。需要获取设备的IP地址和token。

实用的自定义技巧，打造个性化智能体验

配置翻译词典

可以通过配置文件将大部分miot属性的选项描述（如：模式、风速等）翻译成你想要的语言。在configuration.yaml中添加如下配置：

xiaomi_miot:
  language: zh # 使用内置词典，目前仅支持`zh`
  translations:
    # 全局词典，对所有实体生效
    idle: '空闲'
    busy: '工作中'
    # 指定风扇模式的词典
    fan.mode:
      straight wind: '直吹模式'
      natural wind: '自然风'

更多词典配置可参考custom_components/xiaomi_miot/core/translation_languages.py。

自定义实体

通过配置可以对实体进行个性化设置，例如：

# customize.yaml
domain.your_entity_id:
  miot_local: true        # 使用本地模式 (通过账号接入的设备)
  miot_cloud: true        # 为该实体开启云端模式 (read, write, action)
  interval_seconds: 30 # 每次更新状态间隔秒数(需重载集成配置)

详细的自定义配置可参考custom_components/xiaomi_miot/core/device_customizes.py。

过滤实体属性

过多的实体属性会导致HomeAssistant数据库变得庞大，可以通过配置exclude_state_attributes来忽略不需要的属性：

# configuration.yaml
xiaomi_miot:
  exclude_state_attributes:
    - miot_type
    - stream_address

常见问题解答，解决使用难题

支持哪些设备？

hass-xiaomi-miot支持多种类型的小米设备，包括插座、智能灯、空调、风扇、摄像头、电视、小爱音箱、万能遥控器、智能门锁、洗衣机、冰箱、净水器、空气净化器、温湿度传感器等。详细的设备列表可参考相关说明。

为什么设备状态会有延迟？如何减小延迟？

本插件使用轮询的方式获取设备状态，可能会导致一定的延迟。可以通过调整interval_seconds参数来减小延迟，但过于频繁的轮询可能会增加设备负担和网络流量。

如何获取设备的token？

可以使用HomeAssistant的xiaomi_miot.get_token服务来获取设备token。在开发者工具中选择该服务，输入设备名称关键词，然后在HA通知列表中查看token。

强大的服务功能，拓展智能控制能力

hass-xiaomi-miot提供了多种服务，方便用户进行设备控制和管理，例如：

• xiaomi_miot.set_property：设置设备属性。
• xiaomi_miot.call_action：调用设备动作。
• xiaomi_miot.get_properties：获取设备属性。
• xiaomi_miot.intelligent_speaker：控制小爱音箱播放文本或执行命令。

更多服务及其使用方法可查看custom_components/xiaomi_miot/services.yaml。

通过hass-xiaomi-miot，你可以轻松实现小米设备与HomeAssistant的集成，打造更加智能、便捷的生活方式。无论是新手还是有经验的用户，都能快速上手并充分发挥其强大功能。如果你在使用过程中遇到问题，可参考常见问题解答或加入相关交流群获取帮助。现在就开始尝试，让你的智能家居系统更加完善吧！

【免费下载链接】hass-xiaomi-miot Automatic 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