📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

Connector 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

使用 #/xxx 格式实现属性间的动态关联：

# 语法格式
属性名: "#/目标类.属性名"

# 实际示例
Presence: "#/Scanner_BoardPresence.Value"  # 关联在位状态扫描器
Id: "#/Accessor_BoardId.Value"             # 关联BoardId访问器
Buses: ["#/I2c_2", "#/I2c_4"]            # 关联总线对象

关联说明 ​

• Presence: 可关联Scanner或Accessor对象获取实时在位状态
• Id: 根据IdentifyMode配置关联不同的ID获取方式
• Buses: 关联系统中的总线对象，为下级组件提供通信通道

📂 分类标准 ​

硬件属性 ​

• 定义：与物理硬件连接和组件管理直接相关的参数
• 特点：所有属性均为硬件相关，涉及物理连接、总线配置和组件识别
• 示例：Bom, Slot, Position, IdentifyMode, Presence, Id, AuxId, Buses, SystemId, ManagerId, ChassisId, SilkText, Type

📝 配置示例 ​

天池标准组件配置 ​

{
  "Connector": {
    "Bom": "14140130",
    "Slot": 1,
    "Position": 1,
    "IdentifyMode": 3,
    "Presence": 1,
    "Id": "10000017",
    "AuxId": "10009440",
    "Buses": ["I2c_2", "I2c_4"],
    "SystemId": "${SystemId}",
    "ManagerId": "${ManagerId}",
    "ChassisId": "${ChassisId}",
    "SilkText": "SEU",
    "Type": "DiskBackplane"
  }
}

BoardId可读组件配置 ​

{
  "Connector": {
    "Bom": "14140131",
    "Slot": 2,
    "Position": 2,
    "IdentifyMode": 1,
    "Presence": "#/Scanner_BoardPresence.Value",
    "Id": "#/Accessor_BoardId.Value",
    "Buses": ["I2c_1", "I2c_3"],
    "SystemId": "1",
    "ManagerId": "1",
    "ChassisId": "1",
    "Type": "PCIeSlot"
  }
}

BoardId不可读组件配置 ​

{
  "Connector": {
    "Bom": "14140132",
    "Slot": 3,
    "Position": 3,
    "IdentifyMode": 2,
    "Presence": 1,
    "Buses": ["I2c_5"],
    "SystemId": "1",
    "ManagerId": "1",
    "ChassisId": "1",
    "Type": "PSU"
  }
}

多host场景配置 ​

{
  "Connector": {
    "Bom": "14140133",
    "Slot": 1,
    "Position": 1,
    "IdentifyMode": 3,
    "Presence": 1,
    "Id": "10000018",
    "Buses": ["I2c_2", "I2c_4"],
    "SystemId": "2",
    "ManagerId": "1",
    "ChassisId": "1",
    "Type": "NVMe"
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 分配槽位和位置：设置Slot和Position确保唯一性
2. 选择识别模式：根据组件类型配置IdentifyMode
3. 配置总线连接：通过Buses指定下级组件使用的总线
4. 设置在位检测：配置Presence获取组件在位状态
5. 配置ID信息：根据识别模式设置Id和AuxId
6. 设置系统信息：配置SystemId、ManagerId、ChassisId
7. 可选信息：根据需要配置Type、SilkText等

注意事项 ​

• Position唯一性：同一CSR中所有Connector的Position必须唯一
• 识别模式匹配：IdentifyMode必须与实际组件类型匹配
• 总线有效性：Buses中的总线必须在系统中存在
• 在位状态：Presence为1时才会加载下级SR
• ID配置规则：根据IdentifyMode选择合适的ID获取方式
• 多场景配置：多host/BMC/机框场景需要正确配置相应ID

性能建议 ​

• 按需加载：合理配置Presence避免不必要的SR加载
• 总线优化：选择合适的总线避免冲突和性能问题
• ID缓存：对于频繁访问的ID信息考虑缓存机制
• 分组管理：相同类型的Connector可以统一管理

识别模式详解 ​

• IdentifyMode=1（BoardId可读）：
  • 组件支持BoardId读取
  • 需要配置Id获取方式
  • 通过硬件代理读取寄存器数据
• IdentifyMode=2（BoardId不可读）：
  • 组件不支持BoardId读取
  • 由多样化硬件上报设置
  • Id配置不生效
• IdentifyMode=3（天池标准）：
  • 天池标准类型组件
  • 通过Chip属性关联器件对象
  • 从Eeprom数据获取Board Id

系统ID配置规则 ​

• SystemId:
  • 单host场景配置为"1"
  • 多host场景按主机编号递增
• ManagerId:
  • 单BMC场景配置为"1"
  • 多BMC场景按BMC编号递增
• ChassisId:
  • 单机框场景配置为"1"
  • 多机框场景按机框编号递增

常见问题 ​

• Q: Position是否可以随意配置？
  • A: 不可以，Position必须在同一CSR中保持唯一性，建议按实际物理位置递增配置
• Q: 为什么只有部分Connector配置了Type？
  • A: Type属性是可选的，主要用于标识连接器后端设备类型，根据实际需求配置
• Q: 多host/BMC/机框场景如何配置ID？
  • A: 按照系统架构规划，为每个host/BMC/机框分配唯一的数字ID
• Q: 丝印信息主要用在哪里？
  • A: 丝印信息主要用于物理标识和维护，帮助技术人员识别具体的硬件组件