桥接设备基本信息 Cluster（BridgedDeviceBasicInformation）

Cluster ID: 0x0039  |  所在 Endpoint: 桥接子设备的 Endpoint（Endpoint 1+）

BridgedDeviceBasicInformation 是 BasicInformation（0x0028） 的子集版本， 专门用于描述通过 Bridge 接入 Matter 网络的非原生设备 —— 比如 Zigbee 温度传感器、Z-Wave 门锁、蓝牙灯泡等。 这些设备本身不具备 Matter 能力，由 Bridge 代理它们暴露为 Matter 节点。

与 BasicInformation 相比，它去掉了若干仅属于根节点的属性 （如 DataModelRevision、Location、CapabilityMinima）， 保留了对子设备有意义的信息（厂商、版本、序列号等）， 并强调了 Reachable 属性和 ReachableChanged 事件 —— 这是桥接场景的核心机制。

属性总览

BridgedDeviceBasicInformation 共有 17 个属性，是 BasicInformation 的子集。按功能分为五组：

厂商信息（0x01 – 0x04）

子设备原始厂商和产品标识。注意这里的厂商信息描述的是被桥接的子设备本身， 而不是 Bridge 网关。比如一个 Aqara 网关桥接了一个 Philips Hue 灯泡， 这里的 VendorName 应该是 "Philips" 而不是 "Aqara"。

↑ 返回属性列表

产品信息（0x05, 0x0B – 0x0F, 0x12）

子设备的详细产品信息。这些属性大部分是可选的，Bridge 会尽力从原始协议中提取并填充。 其中 NodeLabel 是唯一可写的属性。

↑ 返回属性列表

版本信息（0x07 – 0x0A）

子设备的硬件和软件版本信息。如果子设备支持 OTA（通过原始协议升级），这些版本号会反映其当前状态。

↑ 返回属性列表

设备状态（0x11）

桥接场景下最关键的属性 —— 子设备的在线状态。

↑ 返回属性列表

产品外观（0x14）

子设备的物理外观描述。

ProductAppearance 结构体

描述子设备的物理外观特征，App 可据此展示设备图标配色。

ProductFinishEnum（表面材质）

ColorEnum（产品颜色）

↑ 返回属性列表

Command

BridgedDeviceBasicInformation 没有定义任何 Command。

事件（Events）

BridgedDeviceBasicInformation 定义了 4 个事件，用于通知 Controller 子设备的生命周期和可达状态变化。

示例数据

一个通过 Zigbee Bridge 接入的温度传感器的 BridgedDeviceBasicInformation Cluster 读取结果：

{
  // --- 厂商信息 ---
  "0x1": "Aqara",                // VendorName
  "0x2": 4447,                   // VendorID = 0x115F（Aqara）
  "0x3": "Temperature Sensor",   // ProductName
  "0x4": 514,                    // ProductID = 0x0202

  // --- 产品信息 ---
  "0x5": "客厅温度计",          // NodeLabel（用户自定义名称）
  "0xB": "2024-08-20",           // ManufacturingDate
  "0xC": "WSDCGQ11LM",          // PartNumber
  "0xD": "https://www.aqara.com/sensor",  // ProductURL
  "0xE": "Aqara Temp Sensor",   // ProductLabel
  "0xF": "AQ20240820T001",      // SerialNumber
  "0x12": "aqara-wsdcgq11lm-001",  // UniqueID

  // --- 版本信息 ---
  "0x7": 2,                      // HardwareVersion = 2
  "0x8": "v2.0",                 // HardwareVersionString
  "0x9": 3,                      // SoftwareVersion = 3
  "0xA": "v1.2.1",               // SoftwareVersionString

  // --- 设备状态 ---
  "0x11": true,                  // Reachable = true（当前可达）

  // --- 产品外观 ---
  "0x14": {                      // ProductAppearance
    "Finish": 1,                 // Matte（哑光）
    "PrimaryColor": 14           // White（白色）
  }
}

使用场景

场景一：Zigbee 网关桥接多个子设备

一个常见的 Matter Bridge 场景：Zigbee 网关（如 Aqara Hub M2）同时管理多个 Zigbee 子设备， 通过 Matter 协议将它们暴露给 Apple Home / Google Home / Amazon Alexa。

注意 Endpoint 3 的 Reachable 为 false —— 这意味着该 IKEA 智能插座当前不可达（可能是信号问题或已断电）。 App 应在设备列表中将其标记为离线状态。

场景二：Reachable 状态监控

App 需要实时追踪桥接子设备的在线状态，以提供准确的 UI 反馈和可靠的自动化执行。

场景三：设备识别与去重

当 Bridge 重启或固件升级后，子设备的 Endpoint 编号可能发生变化。 App 需要正确识别"这还是之前那台设备"，避免出现重复设备或丢失用户配置。