基本信息 Cluster（BasicInformation）

Cluster ID: 0x0028  |  所在 Endpoint: 仅在 Endpoint 0（Root Node）

BasicInformation 提供设备的核心元数据 —— 包括厂商信息、产品标识、硬件/软件版本、序列号、设备外观和协议能力。 这是每个 Matter 设备必须实现的 Cluster，且只存在于 Endpoint 0。 它的属性大多是只读的，仅 NodeLabel 和 LocalConfigDisabled 可写。

属性总览

BasicInformation 共有 23 个属性，按功能分为五组。点击属性 ID 可跳转到对应的详细说明。

厂商信息（0x00 – 0x04）

设备的厂商和产品标识，由 CSA 分配或厂商自行设定。这些属性在设备出厂时就已固定，运行时不可更改。

↑ 返回属性列表

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

描述产品的详细信息 —— 用户标签、生产日期、序列号等。 这些属性中大部分是可选的，实际设备可能只实现其中几个。

↑ 返回属性列表

版本信息（0x07 – 0x0A）

设备的硬件和软件版本信息。OTA 升级流程依赖这些版本号来判断是否需要更新。

↑ 返回属性列表

设备状态（0x10 – 0x11）

描述设备当前的运行状态和配置模式。

↑ 返回属性列表

规格能力（0x13 – 0x16）

描述设备支持的协议能力和产品外观。

CapabilityMinima 结构体

描述设备的最小协议处理能力，Controller 可据此调整交互策略。

ProductAppearance 结构体

描述产品的物理外观特征，用于在 App 中展示设备图标或配色。

ProductFinishEnum（表面材质）

ColorEnum（产品颜色）

↑ 返回属性列表

Command

早期版本的 BasicInformation 有一个可选的 Command；较新版本（本站对照 v1.6）中这个 Cluster 已经没有任何命令：

示例数据

一个典型 Matter 设备的 BasicInformation Cluster 读取结果：

{
  // --- 厂商信息 ---
  "0x0": 17,                   // DataModelRevision = 17
  "0x1": "Acme Corp",          // VendorName
  "0x2": 65521,                // VendorID = 0xFFF1（测试厂商）
  "0x3": "Smart Light",        // ProductName
  "0x4": 32769,                // ProductID = 0x8001

  // --- 产品信息 ---
  "0x5": "Living Room Light",  // NodeLabel（用户自定义名称）
  "0x6": "CN",                 // Location = 中国
  "0xB": "2025-01-15",         // ManufacturingDate
  "0xC": "ABC-1234",           // PartNumber
  "0xD": "https://example.com/product",  // ProductURL
  "0xE": "Smart Light Pro",    // ProductLabel
  "0xF": "SN20250115001",      // SerialNumber
  "0x12": "a1b2c3d4e5f6",     // UniqueID

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

  // --- 设备状态 ---
  "0x10": false,               // LocalConfigDisabled = false（允许本地配置）
  "0x11": true,                // Reachable = true（设备可达）

  // --- 规格能力 ---
  "0x13": {                    // CapabilityMinima
    "CaseSessionsPerFabric": 3,
    "SubscriptionsPerFabric": 3
  },
  "0x14": {                    // ProductAppearance
    "Finish": 1,               // Matte（哑光）
    "PrimaryColor": 7          // Gray（灰色）
  },
  "0x15": 65792,               // SpecificationVersion = 0x01010000 → 1.1.0.0
  "0x16": 1                    // MaxPathsPerInvoke = 1
}