Skip to content

HomeKit 配件输出配置:补温度 / 湿度 ​

空调插座、部分空调本身没有环境温湿度,但家里另有温湿度传感器时,可以在 HomeKit 配件的「输出配置」 里,把别的设备属性绑到本配件的特征上——不用改系统映射文件。

原理 ​

Olink 把设备接到 HomeKit 时,大致是三层:

  1. 输入(米家等) — 设备真实属性进状态机(每条属性有稳定的 attr_id)
  2. Schema — 统一设备模型(空调、温湿度计等)
  3. 输出(HAP) — 按系统 mapping 生成配件上的服务 / 特征,每个可读特征绑一个 attr_id

「家庭」App 读到的湿度 / 温度,本质是:HAP 特征 ↔ 状态机里某个 attr_id 的当前值。传感器上报 → 状态机更新 → HAP 按 attr_id 推给 iPhone。

系统 mapping 只描述「这一类设备默认怎么映」。空调插座默认没有湿度特征,所以 Home 里看不到湿度——不是状态机没有湿度,而是这个配件模型上没挂那条特征。

输出配置存在该配件的数据库字段里,在「按系统 mapping 生成配件模型」之后再合并一次:

系统 HAP mapping → 配件模型
        ↓
本配件 output_config(你写的 TOML)
        ↓
最终发给 HomeKit 的服务 / 特征

合并时按 hap_service + hap_type:

  • 特征已有 → 可改绑 attr_id(例如当前温度改成温感那条)
  • 没有该特征 → 追加特征(可挂到已有 HeaterCooler)
  • 没有该服务 → 新建服务再挂特征(例如单独的 HumiditySensor)

改绑后,空调插座配件上的湿度特征读的是温湿度传感器的 attr_id;温感一更新,插座配件上的湿度也会更新。温感自己仍可作为独立配件存在,两边只是共用同一条状态机属性。

和「适配器接入配置」的区别:接入配置改的是输入怎么建成 Schema;输出配置改的是这个 HomeKit 配件最终长什么样、特征绑谁。补跨设备温湿度用输出配置即可。

刷新 / 重建映射时会重新走 convert,并再次应用已保存的 output_config,所以手改不会被下次刷新冲掉(只要配置还在库里)。

入口 ​

控制台 → HomeKit 桥接器 → 配件列表 → 对应配件的 输出配置(TOML 文本)。保存后会刷新该配件映射。

保存后如何确认是否生效 ​

不要只看 TOML 保存成功。打开同一个配件的详情(标题类似「类型 … AID …」),对照折叠区块是否变成你期望的样子:

  • 每个折叠区块 = 一个 HAP 服务(如 AccessoryInformation、Switch、HeaterCooler、HumiditySensor)
  • 区块里每一行 = 一个特征(如 PowerState、CurrentRelativeHumidity)
  • 特征下方灰色小字 = 当前绑定的 attr_id(有绑定才会显示)

配件详情:服务 / 特征与 attr_id

按你改的内容逐项核对:

你在输出配置里做了什么详情里应看到
改绑 attr_id原特征还在,灰色 attr_id 变成你写的那条(例如指向温感 did)
往已有服务追加特征原服务区块里多出一行(如 HeaterCooler 下出现 CurrentRelativeHumidity)
新建服务 + 特征多出一个折叠区块(如 HumiditySensor),里面有对应特征与 attr_id

若详情与配置不一致:确认保存的是目标配件的输出配置、保存后映射已刷新,再对照 TOML 里的 hap_service / hap_type 拼写是否与详情区块名一致。attr_id 写错时特征可能仍会出现,但数值不更新——再对照源设备属性路径。

「家庭」App 侧:新建服务 / 特征后,必要时在桥接器上做一次配置刷新或等 iOS 同步;改绑 attr_id 一般无需重新配对。

能做什么 ​

情况行为
特征已有覆盖写出的字段(常用:改 attr_id、min/max)
服务有、特征没有追加该特征
服务也没有新建服务,再挂特征

attr_id 可指向其它设备的完整属性路径(在温湿度传感器配件详情 / 特征列表里复制即可)。缺省 attr_id 仍可保存,但特征不会有真实读数。

示例:空调插座用外部湿度 ​

挂在现有制冷制热服务上 ​

空调插座一般是 HeaterCooler。可直接追加相对湿度特征:

toml
[[characteristics]]
hap_service = "HeaterCooler"
hap_type = "CurrentRelativeHumidity"
attr_id = "mijia.<温感did>.attr.<siid>.<piid>#relative-humidity"

单独建一个湿度传感器服务 ​

toml
[[characteristics]]
hap_service = "HumiditySensor"
hap_type = "CurrentRelativeHumidity"
attr_id = "mijia.<温感did>.attr.<siid>.<piid>#relative-humidity"

只改绑当前温度(特征已有时) ​

toml
[[characteristics]]
hap_service = "HeaterCooler"
hap_type = "CurrentTemperature"
attr_id = "mijia.<温感did>.attr.<siid>.<piid>#current-temperature"

把示例里的 attr_id 换成你温湿度传感器上真实的属性 id。格式通常类似:

mijia.<设备did>.attr.<siid>.<piid>#<schema属性名>

可选字段 ​

新建特征时,若标准 HAP 表里能认出 hap_type,一般不用写 format / perms。认不出时再显式写,例如:

toml
[[characteristics]]
hap_service = "HumiditySensor"
hap_type = "CurrentRelativeHumidity"
format = "float"
perms = ["pr", "ev"]
attr_id = "mijia....#relative-humidity"
min_value = 0
max_value = 100

也可继续写 min_value / max_value / step_value / default_value 覆盖约束。

模板里的 [services.Lightbulb] adaptive_lighting = true 用于开启 HomeKit 自适应灯光能力;使用步骤与「首次开启会自动开灯」的注意见 自适应灯光。

注意 ​

  • 这是 配件级输出配置,不是米家设备的「接入配置」。
  • 保存校验:未知的 hap_type 且没写 format 会被拒绝;标准名(如 CurrentRelativeHumidity)可直接用。
  • 不校验 attr_id 是否存在;绑错路径时 Home 里可能一直无更新,需对照源设备属性再改。
  • 删除输出配置并保存空内容,可恢复为仅系统映射结果。

桥接与配对总览见帮助 HomeKit 桥接与配件。