间歇连接设备管理 Cluster（IcdManagement）

Cluster ID: 0x0046  |  所在 Endpoint: 固定在 Endpoint 0（根端点）

ICD Management 管理「间歇连接设备」（Intermittently Connected Device，简称 ICD）， 也就是俗称的「休眠设备」或「Sleepy Device」—— 门窗传感器、温湿度传感器、电池供电的按钮等。 这些设备为了省电，大部分时间处于休眠状态，只在固定周期或特定事件时短暂唤醒通信。 ICD Management 负责定义设备的休眠/唤醒周期、管理订阅者注册、以及通过 Check-In 协议保持连接。

命令（Commands）

ICD Management 共有 4 个命令。RegisterClient 和 UnregisterClient 用于管理 Check-In 消息的订阅者列表；StayActiveRequest 让设备临时保持唤醒。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

RegisterClient —— 注册客户端（0x00）

向 ICD 设备注册一个 Check-In 客户端。注册成功后，设备每次从休眠中唤醒时都会向该客户端发送 Check-In 消息，告知「我醒了，有什么事赶紧说」。这是 LIT 设备与 Controller 保持连接的核心机制。

↑ 返回命令列表

RegisterClientResponse —— 注册响应（0x01）

设备对 RegisterClient 的响应。返回当前的 ICDCounter 值， 客户端用它来验证后续收到的 Check-In 消息的新鲜度（防重放攻击）。

↑ 返回命令列表

UnregisterClient —— 取消注册（0x02）

从 ICD 设备的注册列表中移除一个 Check-In 客户端。 移除后，设备不再向该客户端发送 Check-In 消息。

↑ 返回命令列表

StayActiveRequest —— 请求保持活跃（0x03）

请求 ICD 设备在活跃模式下额外保持一段时间，暂时不要回到休眠状态。 适用于需要与设备进行一系列交互（如 OTA 升级、批量配置）但设备默认活跃时间太短的场景。

↑ 返回命令列表

StayActiveResponse —— 保持活跃响应（0x04）

设备对 StayActiveRequest 的响应。设备可能无法完全满足请求的时长（例如电池电量不足）， 响应中包含设备实际承诺的活跃时长。

↑ 返回命令列表

属性详解

ICD Management 的属性按功能分为四组。点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

休眠/唤醒参数（0x0000-0x0002）

定义设备的休眠与唤醒周期参数。这三个值直接决定了设备的省电程度和通信响应速度 —— 空闲时间越长越省电，但响应越慢。

↑ 返回属性列表

注册管理（0x0003-0x0005）

管理 Check-In 客户端的注册列表。只有注册过的客户端才会收到设备的 Check-In 消息。

↑ 返回属性列表

用户唤醒提示（0x0006-0x0007）

当 Controller 需要与 LIT 设备通信但不想等 Check-In 时，可以提示用户手动唤醒设备。 这两个属性告诉 App 如何指导用户操作 —— 比如「按一下设备上的按钮」或「打开/关闭门窗一次」。

UserActiveModeTriggerBitmap 常见位

↑ 返回属性列表

运行模式（0x0008-0x0009）

设备当前的运行模式和 Check-In 回退参数。

↑ 返回属性列表

枚举速查

OperatingModeEnum —— 运行模式

描述 ICD 设备的当前运行模式，对应 OperatingMode (0x0008) 属性。

数据结构

MonitoringRegistrationStruct

描述一个已注册的 Check-In 客户端的信息，是 RegisteredClients (0x0003) 属性中每个列表元素的结构。

MonitoringRegistrationStruct 数据示例：

{
  "CheckInNodeID": 1,                   // Check-In 消息目标节点 ID
  "MonitoredSubject": 112233,           // 被监控的 Subject（通常是用户的 NodeID）
  "FabricIndex": 1                      // 所属 Fabric 索引
}

↑ 返回属性列表

Feature 位图

ICD Management 通过 FeatureMap（0xFFFC）声明设备支持的 ICD 能力：

示例数据

一个运行在 LIT 模式下的电池门窗传感器的 ICD Management Cluster 读取结果：

{
  // --- 休眠/唤醒时间参数 ---
  "0x0000": 300,              // IdleModeDuration = 300 秒（空闲模式持续 5 分钟）
  "0x0001": 10,               // ActiveModeDuration = 10000 毫秒（活跃模式持续 10 秒）
  "0x0002": 5000,             // ActiveModeThreshold = 5000 毫秒（活跃模式延长阈值 5 秒）

  // --- 注册管理 ---
  "0x0003": [                 // RegisteredClients（已注册的监控客户端列表）
    {
      "CheckInNodeID": 1,
      "MonitoredSubject": 1,
      "FabricIndex": 1
    }
  ],
  "0x0004": 42,               // ICDCounter = 42（Check-In 消息计数器）
  "0x0005": 2,                // ClientsSupportedPerFabric = 2（每个 Fabric 最多注册 2 个客户端）

  // --- 用户唤醒提示 ---
  "0x0006": 1,                // UserActiveModeTriggerHint = PowerCycle（提示用户通过重新上电唤醒）
  "0x0007": "",               // UserActiveModeTriggerInstruction = ""（无额外说明）

  // --- 运行模式 ---
  "0x0008": 1,                // OperatingMode = LIT（长空闲时间模式）
  "0x0009": 3600              // MaximumCheckInBackOff = 3600 秒（最大 Check-In 回退间隔 1 小时）
}

常见场景