管理员配网 Cluster（AdministratorCommissioning）

Cluster ID: 0x003C  |  所在 Endpoint: 固定在 Endpoint 0（Root Endpoint）

AdministratorCommissioning 负责控制设备的配网窗口（Commissioning Window）的开启与关闭。 当一个设备已经加入了某个 Fabric（已被配网），想要让新的管理员也能配网这台设备时， 就需要通过这个 Cluster 打开配网窗口。它不负责配网流程本身（那是 GeneralCommissioning 的事）， 而是控制「设备是否接受新的配网请求」这个开关。

Feature Map

命令（Commands）

AdministratorCommissioning Cluster 共有 3 个命令，分别用于开启增强配网窗口、开启基础配网窗口和关闭配网窗口。 这三个命令都没有专属的响应结构体，通过通用的 Status 响应返回结果。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

OpenCommissioningWindow —— 增强配网开窗（0x00）

开启增强配网窗口（Enhanced Commissioning Window）。调用者需要提供一个全新的 PAKE 验证器， 新的 Commissioner 将使用这个验证器而非设备出厂密码来建立 PASE 安全通道。 这是最安全的开窗方式 —— 每次开窗都使用一次性的密码，即使密码被截获也无法用于下一次配网。

↑ 返回命令列表

OpenBasicCommissioningWindow —— 基础配网开窗（0x01）

开启基础配网窗口（Basic Commissioning Window）。与增强方式不同，基础配网使用设备的出厂 passcode （印在设备标签上的那个配对码）来建立 PASE 安全通道。操作简单，但安全性较低。

↑ 返回命令列表

RevokeCommissioning —— 关闭配网窗口（0x02）

关闭当前已开启的配网窗口。此命令没有参数。 调用成功后，设备立即停止接受新的配网请求，WindowStatus 恢复为 WindowNotOpen (0)， AdminFabricIndex 和 AdminVendorId 重置为 null。

↑ 返回命令列表

属性详解

AdministratorCommissioning Cluster 共有 3 个属性，描述配网窗口的当前状态和操作者信息。

窗口状态（0x0000）

↑ 返回属性列表

管理员信息（0x0001, 0x0002）

记录是谁开启了当前的配网窗口。窗口关闭或未开启时，这两个属性均为 null。

↑ 返回属性列表

枚举定义

CommissioningWindowStatusEnum

表示设备当前的配网窗口状态，用于 WindowStatus 属性。

Cluster 状态码（StatusCode）

AdministratorCommissioning 命令通过通用 Status 响应返回结果，除标准状态码外还定义了以下 Cluster 专属状态码：

示例数据

属性数据示例（窗口未开启）

设备处于正常状态，没有活跃的配网窗口：

{
  // --- 配网窗口状态 ---
  "0x0000": 0,                // WindowStatus = WindowNotOpen（当前未开启配网窗口）

  // --- 管理员信息 ---
  "0x0001": null,             // AdminFabricIndex = null（无管理员开启窗口）
  "0x0002": null              // AdminVendorId = null（无管理员开启窗口）
}

属性数据示例（窗口已开启）

某管理员已通过增强方式开启了配网窗口：

{
  // --- 配网窗口状态 ---
  "0x0000": 1,                // WindowStatus = EnhancedWindowOpen（增强配网窗口已开启）

  // --- 管理员信息 ---
  "0x0001": 1,                // AdminFabricIndex = 1（Fabric 索引为 1 的管理员开启了窗口）
  "0x0002": 4996              // AdminVendorId = 0x1384（开启窗口的管理员供应商 ID）
}

OpenCommissioningWindow 交互示例

使用增强配网方式开启配网窗口：

// Commissioner → Device：开启增强配网窗口
{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 0,
      "clusterId": "0x003C",
      "commandId": "0x00"              // OpenCommissioningWindow
    },
    "commandFields": {
      "commissioningTimeout": 180,     // 180 秒后自动关闭
      "PAKEPasscodeVerifier": "base64...",  // 新的 PAKE 验证器
      "discriminator": 3840,           // 12-bit 设备识别码
      "iterations": 1000,             // PBKDF2 迭代次数
      "salt": "base64..."             // PBKDF2 盐值
    }
  }]
}

// Device → Commissioner：成功开启（Status = SUCCESS）
// 此命令无专属响应结构体，通过通用 Status 返回结果

OpenBasicCommissioningWindow 交互示例

使用基础配网方式开启配网窗口（需要 BC Feature）：

// Commissioner → Device：开启基础配网窗口
{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 0,
      "clusterId": "0x003C",
      "commandId": "0x01"              // OpenBasicCommissioningWindow
    },
    "commandFields": {
      "commissioningTimeout": 180      // 180 秒后自动关闭
    }
  }]
}

// Device → Commissioner：成功开启（Status = SUCCESS）

RevokeCommissioning 交互示例

关闭当前已开启的配网窗口：

// Commissioner → Device：关闭配网窗口
{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 0,
      "clusterId": "0x003C",
      "commandId": "0x02"              // RevokeCommissioning
    },
    "commandFields": {}                // 无参数
  }]
}

// Device → Commissioner：成功关闭（Status = SUCCESS）

常见场景