首页/新闻资讯/正文详情

将小米设备接入 Home Assistant:ha_xiaomi_home 集成上手指南

发布时间:2026/11/21 3:33:07 来源:云帆数科 栏目:资讯中心
将小米设备接入 Home Assistant:ha_xiaomi_home 集成上手指南
将小米设备接入 Home Assistantha_xiaomi_home 集成上手指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home如果你希望把家里的小米智能家居设备灯光、插座、空调、扫地机器人等纳入 Home Assistant 统一管理ha_xiaomi_home是一个由小米官方支持的集成组件。它通过 MIoT 协议把设备解析成 Home Assistant 的实体并提供云端与本地两种控制路径。下面从安装、配置到使用建议带你跑通第一条接入链路。需要接入小米设备的常见场景小米生态里的设备通常分散在各自的小程序或 App 中跨品牌联动和自动化编写并不方便。当你遇到下面这类需求时这套集成比较合适想把不同小米设备的状态集中到 Home Assistant统一做开关、读取传感器数值希望基于设备属性变化或事件触发自动化如人体感应后开灯需要在家外通过 Home Assistant 查看或控制家中设备家里有多个小米账号、不同地区的设备想归到同一个区域里管理。ha_xiaomi_home 覆盖的能力与使用边界该组件按 MIoT-Spec-V2 协议把设备的属性、事件、动作转换成 Home Assistant 实体可写属性映射为 Switch、Select、Number、Text只读属性映射为 Sensor事件映射为 Event 实体。它支持多小米账号登录允许把不同账号、不同地区的设备导入同一区域。需要明确几个边界避免选型时产生误解暂不支持蓝牙设备、红外设备和虚拟设备可用的地区包括中国大陆、欧洲、印度、俄罗斯、新加坡、美国导入时需在配置流程中选择对应地区完整本地控制依赖小米中枢网关固件 3.3.0_0023 及以上或内置中枢功能的设备软件 0.8.9 及以上其中小米中枢网关目前仅在中国大陆可用。从安装到首次设备导入的落地步骤前置条件Home Assistant 版本需满足Core ≥ 2024.4.4、Operating System ≥ 13.0并准备好小米账号。安装组件有三种方式按习惯选择Git 克隆官方推荐便于切换 tag 更新版本在config目录执行git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home进入目录后运行./install.sh /config。HACS 一键安装在 HACS 搜索框输入Xiaomi Home进入详情页下载安装。手动安装将custom_components/xiaomi_home文件夹复制到 Home Assistant 的config/custom_components目录。登录与首次验证安装后重启 Home Assistant进入 设置 设备与服务 添加集成搜索Xiaomi Home并选择 OAuth 登录小米账号。登录成功后会弹出“Select Home and Devices”对话框勾选包含目标设备的家庭完成导入。验证方式在设备页确认目标设备已出现且生成了可操作的实体如灯光的 Switch、传感器的 Sensor。用 Home Assistant 的界面控制一次灯光或插座能立即看到设备响应即代表接入链路正常。云端控制与本地控制的取舍云端控制组件在 MIoT 云端的 MQTT Broker 上订阅设备消息设备属性变化或事件发生时由云端推送控制命令则通过 MIoT 云的 HTTP 接口下发。这种方式无需局域网适合出门在外查看和控制家中设备是大多数用户的默认路径。本地控制本地控制借助小米中枢网关内置的标准 MQTT Broker 完成订阅与发布指令在局域网内直达设备减少了对云端的依赖。它要求网关或内置中枢设备固件/软件达到指定版本且网关仅在中国大陆销售。此外组件还提供了“小米局域网控制”开关但它只能控制与 Home Assistant 同网段的 IP 设备WiFi 或网线接入无法覆盖 BLE Mesh、ZigBee 设备官方并不建议默认开启。多账号与区域完成一个账号的配置后可在集成的配置页继续添加其它小米账号并将不同账号、不同地区的设备加入同一区域便于统一编组与自动化。排障提示与后续入口设备导入后不显示确认账号选择的地区与设备归属一致检查小米 App 中的家庭共享设置必要时重启网关与 Home Assistant 后重新导入。本地控制不生效核对中枢网关固件/软件版本是否达标、网关是否在中国大陆、目标设备是否为 IP 设备存在中枢网关时局域网控制开关可能不会生效。配置安全组件采用 OAuth 2.0 登录不保存账号密码但登录后的用户信息设备信息、证书、令牌等会明文写入配置文件请妥善保管该目录怀疑令牌泄露时可在小米账号管理中取消授权。文档与源码入口中文文档见 doc/README_zh.md变更记录见 CHANGELOG.md配置流程语言包位于 custom_components/xiaomi_home/translations/设备名称多语言字典在custom_components/xiaomi_home/miot/specs/自动化与转换规则可用spec_filter.yaml、multi_lang.json调整改动后需在集成配置页更新实体转换规则组件测试脚本位于 test/可用于验证云端、局域网、MDNS 等模块行为。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

能用的Docker镜像
能用的Docker镜像

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 10:06:04

【芳芯科技】硫化氢、氨气、一氧化碳等气体采集报警器
【芳芯科技】硫化氢、氨气、一氧化碳等气体采集报警器

效果图:实现功能:面向污水处理厂的气体检测电子鼻系统硬件部分主要由以下的部分组成:硫化氢传感器、氨气传感器、甲烷传感器、一氧化碳传感器、AD转换模块、按键模块、电源供电模块、STC89C51单片机最小系统、液晶显示模块、声光报警电路。由… · 2026/11/15 18:20:14

混沌时间序列相空间重构:Cao方法与互信息法MATLAB实现
混沌时间序列相空间重构:Cao方法与互信息法MATLAB实现

简介:非线性系统与混沌时间序列分析中,相空间重构是揭示系统内在规律的关键步骤,而延迟时间与嵌入维数的选取直接影响重构质量。互信息法通过度量信号在时延前后的信息依赖,适用于非线性数据的延迟时间估计;Cao方法则基… · 2026/11/16 16:25:50

剑川县电工证怎么考证?学历不高怕报不上名?考前押题帮你解决
剑川县电工证怎么考证?学历不高怕报不上名?考前押题帮你解决

剑川县电工证怎么考证?学历不高怕报不上名?考前押题帮你解决 你不是一个人,很多人学历不高,担心考不上电工证,怕报名时被拒,怕考试时挂科,甚至怕后续复审时出问题。但别担心, 剑川县电工证怎么考证… · 2026/11/21 10:05:37

初中毕业也能考低压电工证电路检测在哪考?别让学历挡住你前路
初中毕业也能考低压电工证电路检测在哪考?别让学历挡住你前路

初中毕业也能考低压电工证电路检测在哪考?别让学历挡住你前路 你是不是也担心学历不够,考不了低压电工证?其实, 初中毕业也能考低压电工证电路检测 ,关键是你得知道 在哪考 ,还得选对地方、走对流程。… · 2026/11/21 10:05:37

广州南沙初级电工证通过率揭秘:外省证书能转吗?这样备考更稳
广州南沙初级电工证通过率揭秘:外省证书能转吗?这样备考更稳

广州南沙初级电工证通过率揭秘:外省证书能转吗?这样备考更稳 之前考的证在外省能不能转过来?这几乎是每个想在广州南沙从事电工工作的朋友最关心的问题。特别是在河南等外省考取的电工证,是否能直接在广州南沙使用,是很多人在准备换证或报考前的首要疑问… · 2026/11/21 10:05:37

县里培训电工证在外省考的能转过来吗在哪考
县里培训电工证在外省考的能转过来吗在哪考

县里培训电工证在外省考的能转过来吗在哪考 之前考的证在外省能不能转过来?这是很多准备在县里培训电工证的小伙伴最关心的问题之一。特别是从外地回来,手里拿着一个外地的电工证,担心到了县里培训电工证是否还能继续使用,或者能不能顺利转过来。其实,根… · 2026/11/21 10:05:37

电工证忘记复审怎么办 这些避坑指南帮你多久拿证不耽误事
电工证忘记复审怎么办 这些避坑指南帮你多久拿证不耽误事

电工证忘记复审怎么办 这些避坑指南帮你多久拿证不耽误事 不知道去哪报名怕被中介坑,尤其是电工证这种关乎生命安全的特种作业证,一旦过期没复审,不仅影响工作,还可能面临罚款甚至被清退。最近不少电工朋友私信问“电工证忘记复审怎么办”,今天就从郑州… · 2026/11/21 10:05:37

璧山区特种工招聘电话网上查询:没证别想上岗!手把手教你避坑
璧山区特种工招聘电话网上查询:没证别想上岗!手把手教你避坑

璧山区特种工招聘电话网上查询:没证别想上岗!手把手教你避坑 找工作最怕什么?不是工资低、不是加班多,而是连门都进不去! 特种作业证… · 2026/11/21 10:04:37

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码