HAP (HomeKit Accessory Protocol) 服务文档
基于 system.json (Version 880) 自动生成
目录
- 1. 配件信息服务 (Accessory Information)
- 2. 光灯 (Lightbulb)
- 3. 开关 (Switch)
- 4. 插座 (Outlet)
- 5. 风扇 (Fan)
- 6. 风扇V2 (Fanv2)
- 7. 恒温器 (Thermostat)
- 8. 加热冷却器 (Heater Cooler)
- 9. 空气净化器 (Air Purifier)
- 10. 加湿除湿器 (Humidifier Dehumidifier)
- 11. 百叶窗 (Slats)
- 12. 窗帘/窗覆盖 (Window Covering)
- 13. 门 (Door)
- 14. 窗 (Window)
- 15. 车库门开启器 (Garage Door Opener)
- 16. 门锁 (Lock Mechanism)
- 17. 门锁管理 (Lock Management)
- 18. 安防系统 (Security System)
- 19. 门铃 (Doorbell)
- 20. 阀门 (Valve)
- 21. 灌溉系统 (Irrigation System)
- 22. 水龙头 (Faucet)
- 23. 传感器 - 运动 (Motion Sensor)
- 24. 传感器 - 温度 (Temperature Sensor)
- 25. 传感器 - 湿度 (Humidity Sensor)
- 26. 传感器 - 光照 (Light Sensor)
- 27. 传感器 - 接触 (Contact Sensor)
- 28. 传感器 - 泄漏 (Leak Sensor)
- 29. 传感器 - 烟雾 (Smoke Sensor)
- 30. 传感器 - 占用 (Occupancy Sensor)
- 31. 传感器 - 空气质量 (Air Quality Sensor)
- 32. 传感器 - 二氧化碳 (Carbon Dioxide Sensor)
- 33. 传感器 - 一氧化碳 (Carbon Monoxide Sensor)
- 34. 电池 (Battery)
- 35. 电视 (Television)
- 36. 可编程开关 - 有状态 (Stateful Programmable Switch)
- 37. 可编程开关 - 无状态 (Stateless Programmable Switch)
- 38. 滤网维护 (Filter Maintenance)
- 39. 服务标签 (Service Label)
- 40. 麦克风 (Microphone)
- 41. 扬声器 (Speaker)
- 42. 智能扬声器 (Smart Speaker)
- 43. 摄像头流管理 (Camera RTP Stream Management)
- 44. 摄像头录制管理 (Camera Recording Management)
- 45. 摄像头工作模式 (Camera Operating Mode)
- 46. Siri
- 47. Siri 端点 (Siri Endpoint)
- 48. 目标控制 (Target Control)
- 49. 目标控制管理 (Target Control Management)
- 50. 配件运行时信息 (Accessory Runtime Information)
- 51. 输入源 (Input Source)
- 52. 访问控制 (Access Control)
- 53. 访问码 (Access Code)
- 54. NFC 访问 (NFC Access)
- 55. WiFi 路由器 (Wi-Fi Router)
- 56. WiFi 卫星 (Wi-Fi Satellite)
- 57. WiFi 传输 (Wi-Fi Transport)
- 58. Thread 传输 (Thread Transport)
- 59. 数据流传输管理 (Data Stream Transport Management)
- 60. 传输传输管理 (Transfer Transport Management)
- 61. 诊断 (Diagnostics)
- 62. 电源管理 (Power Management)
- 63. 云中继 (Cloud Relay)
- 64. 资产更新 (Asset Update)
- 65. 配件指标 (Metrics)
- 66. 助手 (Assistant)
- 67. 协议信息 (Protocol Information)
- 68. 配对 (Pairing)
- 附录 A: 特征枚举值速查表
- 附录 B: 单位对照表
1. 配件信息服务 (Accessory Information)
ShortUUID: 0000003E | 描述: 配件信息，每个配件必须包含此服务
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
identify | Yes | bool | 标识配件，触发配件识别动作（如闪烁灯光） |
manufacturer | Yes | string | 制造商名称 |
model | Yes | string | 配件型号 |
name | Yes | string | 配件名称 |
serial-number | Yes | string | 序列号 |
accessory-flags | No | uint32 | 配件标志位 |
app-matching-identifier | No | tlv8 | 应用匹配标识符 |
configured-name | No | string | 用户配置的名称 |
firmware.revision | No | string | 固件版本号 |
hardware-finish | No | tlv8 | 硬件外观（材质/颜色） |
hardware.revision | No | string | 硬件版本号 |
product-data | No | data | 产品数据 |
software.revision | No | string | 软件版本号 |
2. 光灯 (Lightbulb)
ShortUUID: 00000043 | 描述: 可调光/色温的智能灯泡
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
on | Yes | bool | - | - | 开关状态 |
brightness | No | int | 0–100 | percentage | 亮度百分比 |
color-temperature | No | int | 140–500 | - | 色温（Mired值，140=冷白，500=暖白） |
hue | No | float | 0–360 | arcdegrees | 色相角度 |
saturation | No | float | 0–100 | percentage | 饱和度百分比 |
characteristic-value-active-transition-count | No | uint8 | - | - | 当前活跃过渡计数 |
characteristic-value-transition-control | No | tlv8 | - | - | 特征值过渡控制 |
name | No | string | - | - | 名称 |
supported-characteristic-value-transition-configuration | No | tlv8 | - | - | 支持的过渡配置 |
3. 开关 (Switch)
ShortUUID: 00000049 | 描述: 智能开关
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
on | Yes | bool | 开关状态 |
name | No | string | 名称 |
4. 插座 (Outlet)
ShortUUID: 00000047 | 描述: 智能插座
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
on | Yes | bool | 开关状态 |
name | No | string | 名称 |
outlet-in-use | No | bool | 插座是否正在使用 |
5. 风扇 (Fan)
ShortUUID: 00000040 | 描述: 简单风扇控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
on | Yes | bool | - | 开关状态 |
name | No | string | - | 名称 |
rotation.direction | No | int | 0–1 | 旋转方向：0=顺时针，1=逆时针 |
rotation.speed | No | float | 0–100 | 旋转速度百分比 |
6. 风扇V2 (Fanv2)
ShortUUID: 000000B7 | 描述: 增强版风扇控制，支持风扇状态
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
active | Yes | uint8 | 0–1 | 活跃状态 |
fan.state.current | No | uint8 | 0–2 | 当前风扇状态（见枚举） |
fan.state.target | No | uint8 | 0–1 | 目标风扇状态 |
lock-physical-controls | No | uint8 | 0–1 | 物理控制锁定 |
name | No | string | - | 名称 |
rotation.direction | No | int | 0–1 | 旋转方向 |
rotation.speed | No | float | 0–100 | 旋转速度 |
swing-mode | No | uint8 | 0–1 | 摆动模式 |
枚举值 - fan.state.current:
| 值 | 含义 |
|---|---|
| 0 | INACTIVE（不活跃） |
| 1 | IDLE（空闲） |
| 2 | BLOWING（吹风） |
7. 恒温器 (Thermostat)
ShortUUID: 0000004A | 描述: 恒温器，支持加热/制冷模式和目标温度
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
heating-cooling.current | Yes | uint8 | 0–2 | - | 当前加热/制冷状态 |
heating-cooling.target | Yes | uint8 | 0–3 | - | 目标加热/制冷模式 |
temperature.current | Yes | float | 0–100 | celsius | 当前温度 |
temperature.target | Yes | float | 10–38 | celsius | 目标温度 |
temperature.units | Yes | uint8 | 0–1 | - | 温度显示单位 |
name | No | string | - | - | 名称 |
relative-humidity.current | No | float | 0–100 | percentage | 当前相对湿度 |
relative-humidity.target | No | float | 0–100 | percentage | 目标相对湿度 |
temperature.cooling-threshold | No | float | 10–35 | celsius | 制冷阈值温度 |
temperature.heating-threshold | No | float | 0–25 | celsius | 加热阈值温度 |
枚举值 - heating-cooling.current:
| 值 | 含义 |
|---|---|
| 0 | OFF（关闭） |
| 1 | HEAT（制热） |
| 2 | COOL（制冷） |
枚举值 - heating-cooling.target:
| 值 | 含义 |
|---|---|
| 0 | OFF（关闭） |
| 1 | HEAT（制热） |
| 2 | COOL（制冷） |
| 3 | AUTO（自动） |
枚举值 - temperature.units:
| 值 | 含义 |
|---|---|
| 0 | 摄氏度 |
| 1 | 华氏度 |
8. 加热冷却器 (Heater Cooler)
ShortUUID: 000000BC | 描述: 加热/冷却一体设备
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
active | Yes | uint8 | 0–1 | - | 活跃状态 |
heater-cooler.state.current | Yes | uint8 | 0–3 | - | 当前状态 |
heater-cooler.state.target | Yes | uint8 | 0–2 | - | 目标模式 |
temperature.current | Yes | float | 0–100 | celsius | 当前温度 |
lock-physical-controls | No | uint8 | 0–1 | - | 物理控制锁定 |
name | No | string | - | - | 名称 |
rotation.speed | No | float | 0–100 | - | 旋转速度 |
swing-mode | No | uint8 | 0–1 | - | 摆动模式 |
temperature.cooling-threshold | No | float | 10–35 | celsius | 制冷阈值 |
temperature.heating-threshold | No | float | 0–25 | celsius | 加热阈值 |
temperature.units | No | uint8 | 0–1 | - | 温度单位 |
枚举值 - heater-cooler.state.current:
| 值 | 含义 |
|---|---|
| 0 | INACTIVE（不活跃） |
| 1 | IDLE（空闲） |
| 2 | HEATING（加热中） |
| 3 | COOLING（制冷中） |
枚举值 - heater-cooler.state.target:
| 值 | 含义 |
|---|---|
| 0 | AUTO（自动） |
| 1 | HEAT_AUTO（加热自动） |
| 2 | COOL_AUTO（制冷自动） |
9. 空气净化器 (Air Purifier)
ShortUUID: 000000BB | 描述: 空气净化器控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
active | Yes | uint8 | 0–1 | 活跃状态 |
air-purifier.state.current | Yes | uint8 | 0–2 | 当前状态 |
air-purifier.state.target | Yes | uint8 | 0–1 | 目标模式 |
lock-physical-controls | No | uint8 | 0–1 | 物理控制锁定 |
name | No | string | - | 名称 |
rotation.speed | No | float | 0–100 | 风扇转速 |
swing-mode | No | uint8 | 0–1 | 摆动模式 |
枚举值 - air-purifier.state.current:
| 值 | 含义 |
|---|---|
| 0 | INACTIVE（不活跃） |
| 1 | IDLE（空闲） |
| 2 | PURIFYING_AIR（净化中） |
枚举值 - air-purifier.state.target:
| 值 | 含义 |
|---|---|
| 0 | MANUAL（手动） |
| 1 | AUTO（自动） |
10. 加湿除湿器 (Humidifier Dehumidifier)
ShortUUID: 000000BD | 描述: 加湿器/除湿器一体设备
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
active | Yes | uint8 | 0–1 | - | 活跃状态 |
humidifier-dehumidifier.state.current | Yes | uint8 | 0–3 | - | 当前状态 |
humidifier-dehumidifier.state.target | Yes | uint8 | 0–2 | - | 目标模式 |
relative-humidity.current | Yes | float | 0–100 | percentage | 当前相对湿度 |
lock-physical-controls | No | uint8 | 0–1 | - | 物理控制锁定 |
name | No | string | - | - | 名称 |
relative-humidity.dehumidifier-threshold | No | float | 0–100 | percentage | 除湿阈值 |
relative-humidity.humidifier-threshold | No | float | 0–100 | percentage | 加湿阈值 |
rotation.speed | No | float | 0–100 | - | 旋转速度 |
swing-mode | No | uint8 | 0–1 | - | 摆动模式 |
water-level | No | float | 0–100 | percentage | 水位 |
枚举值 - humidifier-dehumidifier.state.current:
| 值 | 含义 |
|---|---|
| 0 | INACTIVE（不活跃） |
| 1 | IDLE（空闲） |
| 2 | HUMIDIFYING（加湿中） |
| 3 | DEHUMIDIFYING（除湿中） |
枚举值 - humidifier-dehumidifier.state.target:
| 值 | 含义 |
|---|---|
| 0 | AUTO（自动） |
| 1 | HUMIDIFY_AUTO（加湿自动） |
| 2 | DEHUMIDIFY_AUTO（除湿自动） |
11. 百叶窗 (Slats)
ShortUUID: 000000B9 | 描述: 百叶窗叶片控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
slat.state.current | Yes | uint8 | 0–3 | 当前叶片状态 |
slat.type | Yes | uint8 | 0–1 | 叶片类型 |
name | No | string | - | 名称 |
swing-mode | No | uint8 | 0–1 | 摆动模式 |
tilt.current | No | int | -90–90 | 当前倾斜角度 |
tilt.target | No | int | -90–90 | 目标倾斜角度 |
枚举值 - slat.state.current:
| 值 | 含义 |
|---|---|
| 0 | INACTIVE（不活跃） |
| 1 | FIXED（固定） |
| 2 | SWINGING（摆动中） |
| 3 | JAMMED（卡住） |
12. 窗帘/窗覆盖 (Window Covering)
ShortUUID: 0000008C | 描述: 窗帘、百叶窗等窗覆盖物控制
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
position.current | Yes | uint8 | 0–100 | percentage | 当前位置（0=完全关闭，100=完全打开） |
position.state | Yes | uint8 | 0–2 | - | 位置移动状态 |
position.target | Yes | uint8 | 0–100 | percentage | 目标位置 |
horizontal-tilt.current | No | int | -90–90 | arcdegrees | 当前水平倾斜角度 |
horizontal-tilt.target | No | int | -90–90 | arcdegrees | 目标水平倾斜角度 |
name | No | string | - | - | 名称 |
obstruction-detected | No | bool | - | - | 是否检测到障碍物 |
position.hold | No | bool | - | - | 保持当前位置 |
vertical-tilt.current | No | int | -90–90 | arcdegrees | 当前垂直倾斜角度 |
vertical-tilt.target | No | int | -90–90 | arcdegrees | 目标垂直倾斜角度 |
枚举值 - position.state:
| 值 | 含义 |
|---|---|
| 0 | 运动到最小值位置（关闭中） |
| 1 | 运动到最大值位置（打开中） |
| 2 | 停止（Stopped） |
13. 门 (Door)
ShortUUID: 00000081 | 描述: 电动门控制
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
position.current | Yes | uint8 | 0–100 | percentage | 当前位置 |
position.state | Yes | uint8 | 0–2 | - | 位置移动状态 |
position.target | Yes | uint8 | 0–100 | percentage | 目标位置 |
name | No | string | - | - | 名称 |
obstruction-detected | No | bool | - | - | 是否检测到障碍物 |
position.hold | No | bool | - | - | 保持当前位置 |
14. 窗 (Window)
ShortUUID: 0000008B | 描述: 电动窗控制
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
position.current | Yes | uint8 | 0–100 | percentage | 当前位置 |
position.state | Yes | uint8 | 0–2 | - | 位置移动状态 |
position.target | Yes | uint8 | 0–100 | percentage | 目标位置 |
name | No | string | - | - | 名称 |
obstruction-detected | No | bool | - | - | 是否检测到障碍物 |
position.hold | No | bool | - | - | 保持当前位置 |
15. 车库门开启器 (Garage Door Opener)
ShortUUID: 00000041 | 描述: 车库门控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
door-state.current | Yes | uint8 | 0–4 | 当前门状态 |
door-state.target | Yes | uint8 | 0–1 | 目标门状态 |
obstruction-detected | Yes | bool | - | 是否检测到障碍物 |
lock-mechanism.current-state | No | uint8 | 0–3 | 当前锁定状态 |
lock-mechanism.target-state | No | uint8 | 0–1 | 目标锁定状态 |
name | No | string | - | 名称 |
枚举值 - door-state.current:
| 值 | 含义 |
|---|---|
| 0 | 开（Open） |
| 1 | 关（Closed） |
| 2 | 开门中（Opening） |
| 3 | 关门中（Closing） |
| 4 | 阻塞（Stopped） |
枚举值 - door-state.target:
| 值 | 含义 |
|---|---|
| 0 | 开（Open） |
| 1 | 关（Closed） |
16. 门锁 (Lock Mechanism)
ShortUUID: 00000045 | 描述: 门锁控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
lock-mechanism.current-state | Yes | uint8 | 0–3 | 当前锁定状态 |
lock-mechanism.target-state | Yes | uint8 | 0–1 | 目标锁定状态 |
name | No | string | - | 名称 |
枚举值 - lock-mechanism.current-state:
| 值 | 含义 |
|---|---|
| 0 | 未锁定（Unsecured） |
| 1 | 已锁定（Secured） |
| 2 | 卡住（Jammed） |
| 3 | 未知（Unknown） |
枚举值 - lock-mechanism.target-state:
| 值 | 含义 |
|---|---|
| 0 | 解锁（Unsecured） |
| 1 | 上锁（Secured） |
17. 门锁管理 (Lock Management)
ShortUUID: 00000044 | 描述: 门锁管理，支持日志和管理员控制
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
lock-management.control-point | Yes | tlv8 | 锁管理控制点 |
version | Yes | string | 版本 |
administrator-only-access | No | bool | 仅管理员可访问 |
audio-feedback | No | bool | 音频反馈 |
door-state.current | No | uint8 | 当前门状态 |
lock-management.auto-secure-timeout | No | uint32 | 自动安全超时（秒） |
lock-mechanism.last-known-action | No | uint8 | 上次已知操作 |
logs | No | tlv8 | 日志 |
motion-detected | No | bool | 运动检测 |
18. 安防系统 (Security System)
ShortUUID: 0000007E | 描述: 家庭安防系统
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
security-system-state.current | Yes | uint8 | 0–4 | 当前安防状态 |
security-system-state.target | Yes | uint8 | 0–3 | 目标安防状态 |
name | No | string | - | 名称 |
security-system.alarm-type | No | uint8 | 0–1 | 告警类型 |
status-fault | No | uint8 | 0–1 | 故障状态 |
status-tampered | No | uint8 | 0–1 | 篡改状态 |
枚举值 - security-system-state.current:
| 值 | 含义 |
|---|---|
| 0 | 布防-在家（Stay Arm） |
| 1 | 布防-离家（Away Arm） |
| 2 | 布防-夜间（Night Arm） |
| 3 | 撤防（Disarm） |
| 4 | 已触发告警（Alarm Triggered） |
枚举值 - security-system-state.target:
| 值 | 含义 |
|---|---|
| 0 | 布防-在家（Stay Arm） |
| 1 | 布防-离家（Away Arm） |
| 2 | 布防-夜间（Night Arm） |
| 3 | 撤防（Disarm） |
19. 门铃 (Doorbell)
ShortUUID: 00000121 | 描述: 门铃触发事件
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
input-event | Yes | uint8 | 0–2 | 按键事件类型 |
brightness | No | int | 0–100 | 亮度 |
mute | No | bool | - | 静音 |
name | No | string | - | 名称 |
operating-state-response | No | tlv8 | - | 操作状态响应 |
volume | No | uint8 | 0–100 | 音量 |
枚举值 - input-event:
| 值 | 含义 |
|---|---|
| 0 | 单按（Single Press） |
| 1 | 双按（Double Press） |
| 2 | 长按（Long Press） |
20. 阀门 (Valve)
ShortUUID: 000000D0 | 描述: 水阀门控制
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
active | Yes | uint8 | 0–1 | - | 活跃状态 |
in-use | Yes | uint8 | 0–1 | - | 使用中状态 |
valve-type | Yes | uint8 | 0–3 | - | 阀门类型 |
is-configured | No | uint8 | 0–1 | - | 是否已配置 |
name | No | string | - | - | 名称 |
remaining-duration | No | uint32 | 0–3600 | seconds | 剩余运行时间 |
service-label-index | No | uint8 | 1–255 | - | 服务标签索引 |
set-duration | No | uint32 | 0–3600 | seconds | 设置的运行时间 |
status-fault | No | uint8 | 0–1 | - | 故障状态 |
枚举值 - valve-type:
| 值 | 含义 |
|---|---|
| 0 | 通用阀门 |
| 1 | 水龙头 |
| 2 | 淋浴 |
| 3 | 其他 |
21. 灌溉系统 (Irrigation System)
ShortUUID: 000000CF | 描述: 灌溉/喷淋系统
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
active | Yes | uint8 | 0–1 | 活跃状态 |
program-mode | Yes | uint8 | 0–2 | 程序模式 |
in-use | Yes | uint8 | 0–1 | 使用中 |
remaining-duration | No | uint32 | 0–3600 | 剩余时间（秒） |
name | No | string | - | 名称 |
status-fault | No | uint8 | 0–1 | 故障状态 |
22. 水龙头 (Faucet)
ShortUUID: 000000D7 | 描述: 水龙头开关
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
active | Yes | uint8 | 活跃状态 |
name | No | string | 名称 |
status-fault | No | uint8 | 故障状态 |
23. 传感器 - 运动 (Motion Sensor)
ShortUUID: 00000085 | 描述: 运动检测传感器
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
motion-detected | Yes | bool | 是否检测到运动 |
name | No | string | 名称 |
status-active | No | bool | 传感器是否活跃 |
status-fault | No | uint8 | 故障状态 |
status-lo-batt | No | uint8 | 低电量状态 |
status-tampered | No | uint8 | 篡改状态 |
24. 传感器 - 温度 (Temperature Sensor)
ShortUUID: 0000008A | 描述: 温度传感器
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
temperature.current | Yes | float | 0–100 | celsius | 当前温度 |
name | No | string | - | - | 名称 |
status-active | No | bool | - | - | 传感器是否活跃 |
status-fault | No | uint8 | - | - | 故障状态 |
status-lo-batt | No | uint8 | - | - | 低电量状态 |
status-tampered | No | uint8 | - | - | 篡改状态 |
25. 传感器 - 湿度 (Humidity Sensor)
ShortUUID: 00000082 | 描述: 湿度传感器
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
relative-humidity.current | Yes | float | 0–100 | percentage | 当前相对湿度 |
name | No | string | - | - | 名称 |
status-active | No | bool | - | - | 传感器是否活跃 |
status-fault | No | uint8 | - | - | 故障状态 |
status-lo-batt | No | uint8 | - | - | 低电量状态 |
status-tampered | No | uint8 | - | - | 篡改状态 |
26. 传感器 - 光照 (Light Sensor)
ShortUUID: 00000084 | 描述: 光照强度传感器
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
light-level.current | Yes | float | 0.0001–100000 | lux | 当前光照强度 |
name | No | string | - | - | 名称 |
status-active | No | bool | - | - | 传感器是否活跃 |
status-fault | No | uint8 | - | - | 故障状态 |
status-lo-batt | No | uint8 | - | - | 低电量状态 |
status-tampered | No | uint8 | - | - | 篡改状态 |
27. 传感器 - 接触 (Contact Sensor)
ShortUUID: 00000080 | 描述: 接触传感器（门窗开关检测）
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
contact-state | Yes | uint8 | 接触状态 |
name | No | string | 名称 |
status-active | No | bool | 传感器是否活跃 |
status-fault | No | uint8 | 故障状态 |
status-lo-batt | No | uint8 | 低电量状态 |
status-tampered | No | uint8 | 篡改状态 |
枚举值 - contact-state:
| 值 | 含义 |
|---|---|
| 0 | 未检测到接触（门窗关闭） |
| 1 | 检测到接触（门窗打开） |
28. 传感器 - 泄漏 (Leak Sensor)
ShortUUID: 00000083 | 描述: 水泄漏检测传感器
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
leak-detected | Yes | uint8 | 是否检测到泄漏 |
name | No | string | 名称 |
status-active | No | bool | 传感器是否活跃 |
status-fault | No | uint8 | 故障状态 |
status-lo-batt | No | uint8 | 低电量状态 |
status-tampered | No | uint8 | 篡改状态 |
枚举值 - leak-detected:
| 值 | 含义 |
|---|---|
| 0 | 未检测到泄漏（Leak Not Detected） |
| 1 | 检测到泄漏（Leak Detected） |
29. 传感器 - 烟雾 (Smoke Sensor)
ShortUUID: 00000087 | 描述: 烟雾检测传感器
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
smoke-detected | Yes | uint8 | 是否检测到烟雾 |
name | No | string | 名称 |
status-active | No | bool | 传感器是否活跃 |
status-fault | No | uint8 | 故障状态 |
status-lo-batt | No | uint8 | 低电量状态 |
status-tampered | No | uint8 | 篡改状态 |
30. 传感器 - 占用 (Occupancy Sensor)
ShortUUID: 00000086 | 描述: 空间占用检测传感器
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
occupancy-detected | Yes | uint8 | 是否检测到占用 |
name | No | string | 名称 |
status-active | No | bool | 传感器是否活跃 |
status-fault | No | uint8 | 故障状态 |
status-lo-batt | No | uint8 | 低电量状态 |
status-tampered | No | uint8 | 篡改状态 |
枚举值 - occupancy-detected:
| 值 | 含义 |
|---|---|
| 0 | 未检测到占用（Occupancy Not Detected） |
| 1 | 检测到占用（Occupancy Detected） |
31. 传感器 - 空气质量 (Air Quality Sensor)
ShortUUID: 0000008D | 描述: 空气质量传感器
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
air-quality | Yes | uint8 | 0–5 | - | 空气质量等级 |
density.no2 | No | float | 0–1000 | micrograms/m^3 | 二氧化氮浓度 |
density.ozone | No | float | 0–1000 | micrograms/m^3 | 臭氧浓度 |
density.pm10 | No | float | 0–1000 | micrograms/m^3 | PM10 颗粒物浓度 |
density.pm2_5 | No | float | 0–1000 | micrograms/m^3 | PM2.5 颗粒物浓度 |
density.so2 | No | float | 0–1000 | micrograms/m^3 | 二氧化硫浓度 |
density.voc | No | float | 0–1000 | micrograms/m^3 | 挥发性有机化合物浓度 |
name | No | string | - | - | 名称 |
status-active | No | bool | - | - | 传感器是否活跃 |
status-fault | No | uint8 | - | - | 故障状态 |
status-lo-batt | No | uint8 | - | - | 低电量状态 |
status-tampered | No | uint8 | - | - | 篡改状态 |
枚举值 - air-quality:
| 值 | 含义 |
|---|---|
| 0 | UNKNOWN（未知） |
| 1 | EXCELLENT（优秀） |
| 2 | GOOD（良好） |
| 3 | FAIR（一般） |
| 4 | INFERIOR（较差） |
| 5 | POOR（很差） |
32. 传感器 - 二氧化碳 (Carbon Dioxide Sensor)
ShortUUID: 00000097 | 描述: CO2 传感器
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
carbon-dioxide.detected | Yes | uint8 | 0–1 | - | 是否检测到 CO2 异常 |
carbon-dioxide.level | No | float | 0–100000 | ppm | CO2 浓度 |
carbon-dioxide.peak-level | No | float | 0–100000 | ppm | CO2 峰值浓度 |
name | No | string | - | - | 名称 |
status-active | No | bool | - | - | 传感器是否活跃 |
status-fault | No | uint8 | - | - | 故障状态 |
status-lo-batt | No | uint8 | - | - | 低电量状态 |
status-tampered | No | uint8 | - | - | 篡改状态 |
枚举值 - carbon-dioxide.detected:
| 值 | 含义 |
|---|---|
| 0 | NORMAL（正常） |
| 1 | ABNORMAL（异常） |
33. 传感器 - 一氧化碳 (Carbon Monoxide Sensor)
ShortUUID: 0000007F | 描述: CO 传感器
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
carbon-monoxide.detected | Yes | uint8 | 0–1 | - | 是否检测到 CO |
carbon-monoxide.level | No | float | 0–100 | ppm | CO 浓度 |
carbon-monoxide.peak-level | No | float | 0–100 | ppm | CO 峰值浓度 |
name | No | string | - | - | 名称 |
status-active | No | bool | - | - | 传感器是否活跃 |
status-fault | No | uint8 | - | - | 故障状态 |
status-lo-batt | No | uint8 | - | - | 低电量状态 |
status-tampered | No | uint8 | - | - | 篡改状态 |
34. 电池 (Battery)
ShortUUID: 00000096 | 描述: 电池状态
| 特征 | 必需 | 格式 | 范围 | 单位 | 说明 |
|---|---|---|---|---|---|
status-lo-batt | Yes | uint8 | 0–1 | - | 低电量状态 |
battery-level | No | uint8 | 0–100 | percentage | 电池电量百分比 |
charging-state | No | uint8 | 0–2 | - | 充电状态 |
name | No | string | - | - | 名称 |
枚举值 - status-lo-batt:
| 值 | 含义 |
|---|---|
| 0 | 电池正常（Battery Normal） |
| 1 | 电池低电量（Battery Low） |
枚举值 - charging-state:
| 值 | 含义 |
|---|---|
| 0 | 未充电（Not Charging） |
| 1 | 充电中（Charging） |
| 2 | 不可充电（Not Chargeable） |
35. 电视 (Television)
ShortUUID: 000000D8 | 描述: 电视控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
active | Yes | uint8 | 0–1 | 开关状态 |
active-identifier | Yes | uint32 | - | 当前活动输入源标识符 |
configured-name | Yes | string | - | 配置的名称 |
remote-key | Yes | uint8 | 0–16 | 遥控器按键 |
sleep-discovery-mode | Yes | uint8 | 0–1 | 睡眠发现模式 |
brightness | No | int | 0–100 | 亮度 |
closed-captions | No | uint8 | 0–1 | 字幕开关 |
display-order | No | tlv8 | - | 显示顺序 |
media-state.current | No | uint8 | 0–5 | 当前媒体状态 |
media-state.target | No | uint8 | 0–2 | 目标媒体状态 |
name | No | string | - | 名称 |
picture-mode | No | uint8 | 0–13 | 画面模式 |
power-mode-selection | No | uint8 | 0–1 | 电源模式选择 |
枚举值 - media-state.current:
| 值 | 含义 |
|---|---|
| 0 | 已停止（Stopped） |
| 1 | 播放中（Playing） |
| 2 | 暂停中（Paused） |
| 3 | 快退中（Seeking Backward） |
| 4 | 快进中（Seeking Forward） |
| 5 | 未加载（None） |
枚举值 - media-state.target:
| 值 | 含义 |
|---|---|
| 0 | 播放（Play） |
| 1 | 暂停（Pause） |
| 2 | 停止（Stop） |
36. 可编程开关 - 有状态 (Stateful Programmable Switch)
ShortUUID: 00000088 | 描述: 带状态记忆的可编程开关
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
input-event | Yes | uint8 | 按键事件 |
output-state | Yes | uint8 | 输出状态（可读写） |
name | No | string | 名称 |
枚举值 - input-event:
| 值 | 含义 |
|---|---|
| 0 | 单按（Single Press） |
| 1 | 双按（Double Press） |
| 2 | 长按（Long Press） |
37. 可编程开关 - 无状态 (Stateless Programmable Switch)
ShortUUID: 00000089 | 描述: 无状态可编程开关（如按钮触发自动化）
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
input-event | Yes | uint8 | 按键事件 |
name | No | string | 名称 |
service-label-index | No | uint8 | 服务标签索引 |
38. 滤网维护 (Filter Maintenance)
ShortUUID: 000000BA | 描述: 滤网更换提醒
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
filter.change-indication | Yes | uint8 | 0–1 | 滤网更换指示 |
filter.life-level | No | float | 0–100 | 滤网寿命百分比 |
filter.reset-indication | No | uint8 | 1 | 滤网重置（写入 1 重置） |
name | No | string | - | 名称 |
枚举值 - filter.change-indication:
| 值 | 含义 |
|---|---|
| 0 | 无需更换（No Change Needed） |
| 1 | 需要更换（Change Needed） |
39. 服务标签 (Service Label)
ShortUUID: 000000CC | 描述: 服务标签，用于多服务配件的标识
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
service-label-namespace | Yes | uint8 | 0–4 | 标签命名空间类型 |
枚举值 - service-label-namespace:
| 值 | 含义 |
|---|---|
| 0 | 阿拉伯数字（Arabic Numerals） |
| 1 | 英文字母（Roman Numerals） |
| 2 | 英文文本（Labels） |
40. 麦克风 (Microphone)
ShortUUID: 00000112 | 描述: 麦克风控制
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
mute | Yes | bool | 静音状态 |
volume | No | uint8 | 音量百分比 |
41. 扬声器 (Speaker)
ShortUUID: 00000113 | 描述: 扬声器控制
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
mute | Yes | bool | - | 静音状态 |
active | No | uint8 | 0–1 | 活跃状态 |
volume | No | uint8 | 0–100 | 音量百分比 |
volume-control-type | No | uint8 | 0–3 | 音量控制类型 |
volume-selector | No | uint8 | 0–1 | 音量选择器 |
42. 智能扬声器 (Smart Speaker)
ShortUUID: 00000228 | 描述: 智能扬声器（如 HomePod）
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
media-state.current | Yes | uint8 | 当前媒体状态 |
media-state.target | Yes | uint8 | 目标媒体状态 |
airplay-enable | No | uint8 | AirPlay 启用 |
configured-name | No | string | 配置名称 |
mute | No | bool | 静音 |
name | No | string | 名称 |
volume | No | uint8 | 音量 |
43. 摄像头流管理 (Camera RTP Stream Management)
ShortUUID: 00000110 | 描述: 摄像头 RTP 流管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
selected-stream-configuration | Yes | tlv8 | 已选择的流配置 |
setup-stream-endpoint | Yes | tlv8 | 设置流端点 |
streaming-status | Yes | tlv8 | 流状态 |
supported-audio-stream-configuration | Yes | tlv8 | 支持的音频流配置 |
supported-rtp-configuration | Yes | tlv8 | 支持的 RTP 配置 |
supported-video-stream-configuration | Yes | tlv8 | 支持的视频流配置 |
active | No | uint8 | 活跃状态 |
44. 摄像头录制管理 (Camera Recording Management)
ShortUUID: 00000204 | 描述: 摄像头录制管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
active | Yes | uint8 | 活跃状态 |
supported-camera-recording-configuration | Yes | tlv8 | 支持的摄像头录制配置 |
supported-video-recording-configuration | Yes | tlv8 | 支持的视频录制配置 |
supported-audio-recording-configuration | Yes | tlv8 | 支持的音频录制配置 |
selected-camera-recording-configuration | Yes | tlv8 | 已选择的录制配置 |
recording-audio-active | No | uint8 | 录音是否活跃 |
45. 摄像头工作模式 (Camera Operating Mode)
ShortUUID: 0000021A | 描述: 摄像头工作模式设置
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
event-snapshots-active | Yes | bool | 事件快照是否启用 |
homekit-camera-active | Yes | bool | HomeKit 摄像头是否活跃 |
camera-operating-mode-indicator | No | bool | 工作模式指示灯 |
manually-disabled | No | bool | 是否手动禁用 |
night-vision | No | bool | 夜视模式 |
periodic-snapshots-active | No | bool | 定期快照是否启用 |
third-party-camera-active | No | bool | 第三方摄像头是否活跃 |
46. Siri
ShortUUID: 00000133 | 描述: Siri 集成
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
siri-input-type | Yes | uint8 | 0–1 | Siri 输入类型 |
multifunction-button | No | uint8 | 0–1 | 多功能按钮 |
siri-enable | No | uint8 | 0–1 | Siri 启用 |
siri-engine-revision | No | string | - | Siri 引擎版本 |
siri-light-on-use | No | uint8 | 0–1 | 使用时亮灯 |
siri-listening | No | uint8 | 0–1 | Siri 监听状态 |
siri-touch-to-use | No | uint8 | 0–1 | 触摸使用 |
47. Siri 端点 (Siri Endpoint)
ShortUUID: 00000253 | 描述: Siri 端点服务
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
siri-endpoint-session-status | Yes | tlv8 | Siri 会话状态 |
version | Yes | string | 版本 |
active-identifier | No | uint32 | 活跃标识符 |
manually-disabled | No | bool | 是否手动禁用 |
48. 目标控制 (Target Control)
ShortUUID: 00000125 | 描述: 目标设备控制
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
active | Yes | uint8 | 活跃状态 |
active-identifier | Yes | uint32 | 活跃目标标识符 |
button-event | Yes | tlv8 | 按钮事件 |
name | No | string | 名称 |
49. 目标控制管理 (Target Control Management)
ShortUUID: 00000122 | 描述: 目标控制列表管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
supported-target-configuration | Yes | tlv8 | 支持的目标配置 |
target-list | Yes | tlv8 | 目标列表 |
50. 配件运行时信息 (Accessory Runtime Information)
ShortUUID: 00000239 | 描述: 配件运行状态信息
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
ping | Yes | data | 心跳/探活 |
activity-interval | No | uint32 | 活动间隔 |
heart-beat | No | uint32 | 心跳 |
sleep-interval | No | uint32 | 休眠间隔 |
51. 输入源 (Input Source)
ShortUUID: 000000D9 | 描述: 电视/显示器的输入源
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
configured-name | Yes | string | - | 配置的输入源名称 |
input-source-type | Yes | uint8 | 0–10 | 输入源类型 |
is-configured | Yes | uint8 | 0–1 | 是否已配置 |
name | Yes | string | - | 名称 |
visibility-state.current | Yes | uint8 | 0–3 | 当前可见性状态 |
identifier | No | uint32 | - | 标识符 |
input-device-type | No | uint8 | 0–6 | 输入设备类型 |
visibility-state.target | No | uint8 | 0–1 | 目标可见性状态 |
枚举值 - input-source-type:
| 值 | 含义 |
|---|---|
| 0 | 其他（Other） |
| 1 | 桌面端（Home Screen） |
| 2 | 应用（Application） |
| 3 | 蓝光（Blu-ray） |
| 4 | CD |
| 5 | HDMI |
| 6 | 辅助设备（Auxiliary） |
| 7 | 蓝牙（Bluetooth） |
| 8 | 调谐器（Tuner） |
| 9 | TV |
| 10 | DVD |
枚举值 - visibility-state.current:
| 值 | 含义 |
|---|---|
| 0 | 已显示（Shown） |
| 1 | 已隐藏（Hidden） |
| 2 | 用户隐藏（User Hidden） |
52. 访问控制 (Access Control)
ShortUUID: 000000DA | 描述: 访问控制，管理用户权限
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
privilege | Yes | uint16 | 访问权限级别 |
password-setting | No | tlv8 | 密码设置 |
枚举值 - privilege:
| 值 | 含义 |
|---|---|
| 0 | 管理员（Administrator） |
| 1 | 普通用户（Regular User） |
| 2 | 受限用户（Restricted User） |
53. 访问码 (Access Code)
ShortUUID: 00000260 | 描述: 访问码管理（如密码锁）
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
access-code-control-point | Yes | tlv8 | 访问码控制点 |
access-code-supported-configuration | Yes | tlv8 | 支持的访问码配置 |
configuration-state | Yes | uint16 | 配置状态 |
54. NFC 访问 (NFC Access)
ShortUUID: 00000266 | 描述: NFC 门禁卡服务
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
configuration-state | Yes | uint16 | 配置状态 |
nfc-access-control-point | Yes | tlv8 | NFC 访问控制点 |
nfc-access-supported-configuration | Yes | tlv8 | 支持的 NFC 配置 |
55. WiFi 路由器 (Wi-Fi Router)
ShortUUID: 0000020A | 描述: WiFi 路由器管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
configured-name | Yes | string | 配置名称 |
managed-network-enable | Yes | uint8 | 托管网络启用 |
network-access-violation-control | Yes | tlv8 | 网络访问违规控制 |
network-client-control | Yes | tlv8 | 网络客户端控制 |
network-client-status-control | Yes | tlv8 | 网络客户端状态控制 |
router-status | Yes | uint8 | 路由器状态 |
supported-router-configuration | Yes | tlv8 | 支持的路由器配置 |
wan-configuration-list | Yes | tlv8 | WAN 配置列表 |
wan-status-list | Yes | tlv8 | WAN 状态列表 |
56. WiFi 卫星 (Wi-Fi Satellite)
ShortUUID: 0000020F | 描述: WiFi 卫星节点
| 特征 | 必需 | 格式 | 范围 | 说明 |
|---|---|---|---|---|
wifi-satellite-status | Yes | uint8 | 0–2 | WiFi 卫星状态 |
57. WiFi 传输 (Wi-Fi Transport)
ShortUUID: 0000022A | 描述: WiFi 传输层
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
current-transport | Yes | bool | 当前传输类型 |
wifi-capabilities | Yes | uint32 | WiFi 能力 |
wifi-configuration-control | No | tlv8 | WiFi 配置控制 |
58. Thread 传输 (Thread Transport)
ShortUUID: 00000701 | 描述: Thread 网络传输层
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
current-transport | Yes | bool | 当前传输类型 |
thread-control-point | Yes | tlv8 | Thread 控制点 |
thread-node-capabilities | Yes | uint16 | Thread 节点能力 |
thread-status | Yes | uint16 | Thread 状态 |
cca-energy-detect-threshold | No | int | CCA 能量检测阈值 |
cca-signal-detect-threshold | No | int | CCA 信号检测阈值 |
event-retransmission-maximum | No | uint8 | 事件最大重传次数 |
event-transmission-counters | No | uint32 | 事件传输计数器 |
mac-retransmission-maximum | No | uint8 | MAC 最大重传次数 |
mac-transmission-counters | No | data | MAC 传输计数器 |
receiver-sensitivity | No | int | 接收灵敏度 |
rssi | No | int | 接收信号强度 |
snr | No | int | 信噪比 |
thread-openthread-version | No | string | OpenThread 版本 |
transmit-power | No | int | 发射功率 |
transmit-power-maximum | No | int | 最大发射功率 |
59. 数据流传输管理 (Data Stream Transport Management)
ShortUUID: 00000129 | 描述: 数据流传输配置管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
setup-data-stream-transport | Yes | tlv8 | 设置数据流传输 |
supported-data-stream-transport-configuration | Yes | tlv8 | 支持的传输配置 |
version | Yes | string | 版本 |
60. 传输传输管理 (Transfer Transport Management)
ShortUUID: 00000203 | 描述: 传输层管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
supported-transfer-transport-configuration | Yes | tlv8 | 支持的传输配置 |
setup-transfer-transport | Yes | tlv8 | 设置传输 |
61. 诊断 (Diagnostics)
ShortUUID: 00000237 | 描述: 设备诊断
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
supported-diagnostics-snapshot | Yes | tlv8 | 支持的诊断快照 |
selected-diagnostics-modes | No | uint32 | 已选择的诊断模式 |
supported-diagnostics-modes | No | uint32 | 支持的诊断模式 |
62. 电源管理 (Power Management)
ShortUUID: 00000221 | 描述: 电源管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
wake-configuration | Yes | tlv8 | 唤醒配置 |
63. 云中继 (Cloud Relay)
ShortUUID: 0000005A | 描述: 云中继控制
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
cloud-relay.control-point | Yes | tlv8 | 云中继控制点 |
cloud-relay.current-state | Yes | uint8 | 当前状态 |
cloud-relay.enabled | Yes | bool | 是否启用 |
64. 资产更新 (Asset Update)
ShortUUID: 00000267 | 描述: 资产更新管理
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
asset-update-readiness | Yes | uint32 | 资产更新就绪状态 |
supported-asset-types | Yes | uint32 | 支持的资产类型 |
65. 配件指标 (Metrics)
ShortUUID: 00000270 | 描述: 配件运行指标
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
active | Yes | uint8 | 活跃状态 |
66. 助手 (Assistant)
ShortUUID: 0000026A | 描述: 语音助手服务
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
active | Yes | uint8 | 活跃状态 |
identifier | Yes | uint32 | 标识符 |
name | Yes | string | 名称 |
67. 协议信息 (Protocol Information)
ShortUUID: 000000A2 | 描述: HAP 协议版本信息
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
version | Yes | string | HAP 协议版本号 |
68. 配对 (Pairing)
ShortUUID: 00000055 | 描述: HomeKit 配对服务
| 特征 | 必需 | 格式 | 说明 |
|---|---|---|---|
list-pairings | Yes | tlv8 | 已配对设备列表 |
pair-setup | Yes | tlv8 | 配对设置 |
pair-verify | Yes | tlv8 | 配对验证 |
pairing-features | Yes | uint8 | 配对特性 |
附录 A: 特征枚举值速查表
布尔状态特征
| 特征 | 0 | 1 |
|---|---|---|
on | OFF | ON |
active | INACTIVE | ACTIVE |
motion-detected | 未检测到运动 | 检测到运动 |
smoke-detected | 未检测到烟雾 | 检测到烟雾 |
obstruction-detected | 无障碍物 | 有障碍物 |
outlet-in-use | 未使用 | 使用中 |
contact-state | 未接触（关闭） | 接触（打开） |
mute | 非静音 | 静音 |
状态特征
| 特征 | 值含义 |
|---|---|
heating-cooling.current | 0=OFF, 1=HEAT, 2=COOL |
heating-cooling.target | 0=OFF, 1=HEAT, 2=COOL, 3=AUTO |
heater-cooler.state.current | 0=INACTIVE, 1=IDLE, 2=HEATING, 3=COOLING |
heater-cooler.state.target | 0=AUTO, 1=HEAT_AUTO, 2=COOL_AUTO |
air-purifier.state.current | 0=INACTIVE, 1=IDLE, 2=PURIFYING |
air-purifier.state.target | 0=MANUAL, 1=AUTO |
humidifier-dehumidifier.state.current | 0=INACTIVE, 1=IDLE, 2=HUMIDIFYING, 3=DEHUMIDIFYING |
humidifier-dehumidifier.state.target | 0=AUTO, 1=HUMIDIFY_AUTO, 2=DEHUMIDIFY_AUTO |
fan.state.current | 0=INACTIVE, 1=IDLE, 2=BLOWING |
fan.state.target | 0=MANUAL, 1=AUTO |
lock-mechanism.current-state | 0=Unsecured, 1=Secured, 2=Jammed, 3=Unknown |
lock-mechanism.target-state | 0=Unsecured, 1=Secured |
door-state.current | 0=Open, 1=Closed, 2=Opening, 3=Closing, 4=Stopped |
door-state.target | 0=Open, 1=Closed |
security-system-state.current | 0=StayArm, 1=AwayArm, 2=NightArm, 3=Disarm, 4=Alarm |
security-system-state.target | 0=StayArm, 1=AwayArm, 2=NightArm, 3=Disarm |
position.state | 0=GoingToMin, 1=GoingToMax, 2=Stopped |
media-state.current | 0=Stopped, 1=Playing, 2=Paused, 3=SeekingBack, 4=SeekingFwd, 5=None |
media-state.target | 0=Play, 1=Pause, 2=Stop |
air-quality | 0=Unknown, 1=Excellent, 2=Good, 3=Fair, 4=Inferior, 5=Poor |
charging-state | 0=NotCharging, 1=Charging, 2=NotChargeable |
slat.state.current | 0=Inactive, 1=Fixed, 2=Swinging, 3=Jammed |
input-source-type | 0=Other, 1=HomeScreen, 2=App, 3=BluRay, 4=CD, 5=HDMI, 6=Aux, 7=BT, 8=Tuner, 9=TV, 10=DVD |
input-event | 0=SinglePress, 1=DoublePress, 2=LongPress |
valve-type | 0=Generic, 1=Faucet, 2=Shower, 3=Irrigation |
privilege | 0=Admin, 1=RegularUser, 2=RestrictedUser |
传感器检测特征
| 特征 | 值含义 |
|---|---|
leak-detected | 0=NotDetected, 1=Detected |
occupancy-detected | 0=NotDetected, 1=Detected |
carbon-dioxide.detected | 0=Normal, 1=Abnormal |
status-lo-batt | 0=Normal, 1=Low |
filter.change-indication | 0=NoChange, 1=ChangeNeeded |
附录 B: 单位对照表
| 单位标识 | 名称 | 使用场景 |
|---|---|---|
celsius | 摄氏度 | 温度 |
fahrenheit | 华氏度 | 温度 |
percentage | 百分比 | 湿度、亮度、音量、位置 |
lux | 勒克斯 | 光照强度 |
arcdegrees | 角度 | 色相、倾斜角度 |
ppm | 百万分比 | 气体浓度 |
micrograms/m^3 | 微克/立方米 | 颗粒物浓度 |
seconds | 秒 | 持续时间 |