Skip to content

米家设备状态和属性的 API 文档

标签
物联网/智能家居
物联网/IoT
开源/软件/Home-Assistant
开源/软件/Home-Assistant/HASS
物联网/智能家居/Home-Assistant/HASS
物联网/智能家居/生态/米家
物联网/智能家居/品牌/小米
物联网/智能家居/Home-Assistant
物联网/智能家居/Homekit
字数
409 字
阅读时间
2 分钟

为啥要文档

米家生态的智能家居设备状态虽然是直接能在 Home Assistant 中读取的,但是在玩转 Home Assistant 进行自动化和状态配置的时候一定会很摸不清头脑吧? 其实 Home Assistant 的集成 Xiaomi Miot Auto 在 Home Assistant 中会给一个带有链接的按钮方便你直接查看设备的状态、属性的文档的。

长话短说 TL;DR

你可以直接去 小米/米家产品库 - Xiaomi Miot Spec 输入自己的设备来查询相关的状态、属性的文档。

你可以通过前往「配置」->「设备与服务」->「Xiaomi Miot Auto」->「<n> 个设备」->「<某个特定的设备>」->「访问设备」来查看设备的 API 文档。

一般会带你去小米/米家产品库 - Xiaomi Miot Spec 然后自动附上产品的 API ID:

比如 米家夜灯2 蓝牙版 yeelink.light.nl1 - 小米/米家产品库

这个时候你点击产品右侧的「规格」,就会跳出来一个弹窗。

我们点击下面的固件版本号(一般不知道就点最后冒号之后的最大的数字的):

然后就能去到 API 文档了:

比如上图前往了 米家夜灯2 蓝牙版 - 产品规格

有了这个文档之后你就能看懂 Home Assistant 中的属性和状态啦。

贡献者

文件历史

撰写