HomeKit 配件输出配置:补温度 / 湿度
空调插座、部分空调本身没有环境温湿度,但家里另有温湿度传感器时,可以在 HomeKit 配件的「输出配置」 里,把别的设备属性绑到本配件的特征上——不用改系统映射文件。
原理
Olink 把设备接到 HomeKit 时,大致是三层:
- 输入(米家等) — 设备真实属性进状态机(每条属性有稳定的
attr_id) - Schema — 统一设备模型(空调、温湿度计等)
- 输出(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 变成你写的那条(例如指向温感 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。可直接追加相对湿度特征:
[[characteristics]]
hap_service = "HeaterCooler"
hap_type = "CurrentRelativeHumidity"
attr_id = "mijia.<温感did>.attr.<siid>.<piid>#relative-humidity"单独建一个湿度传感器服务
[[characteristics]]
hap_service = "HumiditySensor"
hap_type = "CurrentRelativeHumidity"
attr_id = "mijia.<温感did>.attr.<siid>.<piid>#relative-humidity"只改绑当前温度(特征已有时)
[[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。认不出时再显式写,例如:
[[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 桥接与配件。