IcdManagement Cluster

Cluster ID: 0x0046  |  Endpoint: Fixed on Endpoint 0 (Root Endpoint)

ICD Management manages Intermittently Connected Devices (ICD), commonly known as "sleepy devices" — door/window sensors, temperature/humidity sensors, battery-powered buttons, etc. These devices spend most of their time in sleep mode to conserve power, only briefly waking for communication at fixed intervals or specific events. ICD Management defines the device's sleep/wake cycles, manages subscriber registrations, and maintains connectivity through the Check-In protocol.

Commands

ICD Management has 4 commands. RegisterClient and UnregisterClient manage the Check-In message subscriber list; StayActiveRequest keeps the device temporarily awake. Click a command ID in the table below to jump to its detailed description.

RegisterClient — Register Client (0x00)

Registers a Check-In client with the ICD device. After successful registration, the device sends a Check-In message to the client each time it wakes from sleep, saying "I'm awake, send any pending requests now." This is the core mechanism for LIT devices to maintain connectivity with Controllers.

↑ Back to Commands

RegisterClientResponse — Registration Response (0x01)

Device response to RegisterClient. Returns the current ICDCounter value, which the client uses to verify the freshness of subsequent Check-In messages (prevents replay attacks).

↑ Back to Commands

UnregisterClient — Unregister Client (0x02)

Removes a Check-In client from the ICD device's registration list. After removal, the device no longer sends Check-In messages to that client.

↑ Back to Commands

StayActiveRequest — Request Stay Active (0x03)

Requests the ICD device to stay in active mode for an additional period, temporarily not returning to sleep. Applicable when needing to perform a series of interactions with the device (e.g. OTA upgrade, batch configuration) but the device's default active time is too short.

↑ Back to Commands

StayActiveResponse — Stay Active Response (0x04)

Device response to StayActiveRequest. The device may not fully satisfy the requested duration (e.g. low battery), and the response contains the actual active duration the device promises.

↑ Back to Commands

Attributes

ICD Management attributes are divided into four functional groups. Click an attribute ID in the summary table below to jump to its detailed description.

Sleep/Wake Parameters (0x0000-0x0002)

Defines the device's sleep and wake cycle parameters. These three values directly determine the device's power saving level and communication responsiveness — the longer the idle time, the more power saved, but the slower the response.

↑ Back to Attributes

Registration Management (0x0003-0x0005)

Manages the Check-In client registration list. Only registered clients will receive Check-In messages from the device.

↑ Back to Attributes

User Wake-up Hints (0x0006-0x0007)

When the Controller needs to communicate with a LIT device but doesn't want to wait for Check-In, it can prompt the user to manually wake the device. These two attributes tell the App how to guide user actions — e.g. "press the button on the device" or "open/close the door once."

UserActiveModeTriggerBitmap Common Bits

↑ Back to Attributes

Operating Mode (0x0008-0x0009)

Device's current operating mode and Check-In back-off parameters.

↑ Back to Attributes

Enum Quick Reference

OperatingModeEnum — Operating Mode

Describes the ICD device's current operating mode, corresponding to the OperatingMode (0x0008) attribute.

Data Structures

MonitoringRegistrationStruct

Describes a registered Check-In client's information, the structure of each list element in the RegisteredClients (0x0003) attribute.

MonitoringRegistrationStruct data example:

{
  "CheckInNodeID": 1,                   // Check-In message target node ID
  "MonitoredSubject": 112233,           // Monitored Subject (typically the user's NodeID)
  "FabricIndex": 1                      // Fabric index
}

↑ Back to Attributes

Feature Bitmap

ICD Management declares device ICD capabilities through FeatureMap (0xFFFC):

Example Data

Read results from an ICD Management Cluster of a battery-powered door/window sensor running in LIT mode:

{
  // --- Sleep/Wake Time Parameters ---
  "0x0000": 300,              // IdleModeDuration = 300 seconds (idle mode lasts 5 minutes)
  "0x0001": 10,               // ActiveModeDuration = 10000 milliseconds (active mode lasts 10 seconds)
  "0x0002": 5000,             // ActiveModeThreshold = 5000 milliseconds (active mode extension threshold 5 seconds)

  // --- Registration Management ---
  "0x0003": [                 // RegisteredClients (list of registered monitoring clients)
    {
      "CheckInNodeID": 1,
      "MonitoredSubject": 1,
      "FabricIndex": 1
    }
  ],
  "0x0004": 42,               // ICDCounter = 42 (Check-In message counter)
  "0x0005": 2,                // ClientsSupportedPerFabric = 2 (max 2 clients per Fabric)

  // --- User Wake-up Hints ---
  "0x0006": 1,                // UserActiveModeTriggerHint = PowerCycle (hint user to wake by power cycling)
  "0x0007": "",               // UserActiveModeTriggerInstruction = "" (no additional instructions)

  // --- Operating Mode ---
  "0x0008": 1,                // OperatingMode = LIT (Long Idle Time mode)
  "0x0009": 3600              // MaximumCheckInBackOff = 3600 seconds (max Check-In back-off interval 1 hour)
}

Common Scenarios