📋 文档信息

项目	内容
文档标题	BusinessConnector类配置字典
版本	v1.0
创建日期	2025-01-27
最后更新	2025-01-27
维护状态	✅ 活跃维护

📋 变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2025-01-27	初始版本	创建BusinessConnector类配置字典	全新文档	系统管理员

🎯 类概览

BusinessConnector 类

属性	值
类名称	`BusinessConnector`
功能描述	业务连接器管理对象，提供业务连接器的配置、状态监控和连接管理功能
所属SIG组	connectivity
所属组件	业务连接器
责任人	连接器管理组
最后更新	2025-01-27
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Name`	String	""	String	-	连接器名称	PCIe业务拓扑建立	`"Up_1"`	CSR配置	硬件
`Direction`	String	""	String	-	连接器方向 "Downstream"：下行连接器 "Upstream"：上行连接器下行连接器与槽位一一对应，上行连接器与基础板BCU的UBC口对应	PCIe业务拓扑建立	`"Downstream"`	CSR配置	硬件
`Slot`	U32	0	U32	-	下行连接器的槽位索引表示在当前组件里的槽位索引，业务拓扑建立后，用来确定全局槽位号	PCIe业务拓扑建立	`1`	CSR配置	硬件
`LinkWidth`	String	""	String	-	连接器PCIe链路宽度	PCIe业务拓扑建立	`"X16"`	CSR配置	硬件
`MaxLinkRate`	String	""	String	-	连接器支持的最大PCIe规范	PCIe业务拓扑建立	`"PCIe4.0"`	CSR配置	硬件
`ConnectorType`	String	""	String	-	连接器类型	PCIe业务拓扑建立	`"UBCDD"`	CSR配置	硬件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`UpstreamResources`	Array	[]	Array	-	下行连接器对应的上行连接器资源根据Name字段匹配到上行连接器的Name，根据Offset字段匹配上行连接器的Port	PCIe业务拓扑建立	`[{"Name": "Up_1", "ID": 255, "Offset": 8, "Width": 8}]`	CSR配置	硬件
`RefMgmtConnector`	String	""	String	Connector_PCIE_SLOT2	下行连接器关联对应的管理连接器对象，后续加载对应卡的CSR	PCIe业务拓扑建立	`"#/Connector_PCIE_SLOT2"`	CSR配置	硬件
`RefPCIeAddrInfo`	String	""	String	PcieAddrInfo_2	下行连接器关联对应的槽位PCIeAddrInfo对象	PCIe业务拓扑建立	`"#/PcieAddrInfo_2"`	CSR配置	硬件

🔗 动态关联机制

语法规范

使用标准配置语法：

yaml

# 基础连接器信息
Id: 1
ConnectorType: "PCIe"
ConnectorName: "PCIe_Slot_1"

# 物理属性
Location: "Slot1"
MaxSupportedDevices: 1
SupportedProtocols: "PCIe3.0,PCIe4.0"
MaxBandwidth: 8000
HotPlugSupport: true

# 状态监控
CurrentConnectedDevices: 0
ConnectionStatus: 0
PowerStatus: 1
OperatingMode: 0
HealthStatus: 0
Temperature: 45

# 功能配置
AutoDetection: true

# 统计信息
ErrorCount: 0
ResetCount: 0

关联说明

连接器标识: Name唯一标识连接器
拓扑建立: Direction、Slot、LinkWidth、MaxLinkRate定义PCIe拓扑结构
资源关联: UpstreamResources关联上行连接器资源
对象关联: RefMgmtConnector、RefPCIeAddrInfo关联管理对象
连接器类型: ConnectorType定义连接器的具体类型

📂 分类标准

硬件属性

定义：与业务连接器硬件特性和PCIe拓扑直接相关的参数
特点：连接器的物理特性、拓扑结构和对象关联
示例：Name, Direction, Slot, LinkWidth, MaxLinkRate, ConnectorType, UpstreamResources, RefMgmtConnector, RefPCIeAddrInfo

软件属性

定义：由软件管理和维护的连接器参数
特点：当前实现中所有属性都是硬件属性，用于PCIe业务拓扑建立
示例：无（当前版本无软件属性）

📝 配置示例

下行连接器配置

json

{
  "BusinessConnector_Down1": {
    "Name": "Down_1",
    "Direction": "Downstream",
    "Slot": 1,
    "LinkWidth": "X16",
    "MaxLinkRate": "PCIe4.0",
    "ConnectorType": "UBCDD",
    "UpstreamResources": [
      {
        "Name": "Up_1",
        "ID": 255,
        "Offset": 8,
        "Width": 8
      }
    ],
    "RefMgmtConnector": "#/Connector_PCIE_SLOT2",
    "RefPCIeAddrInfo": "#/PcieAddrInfo_2"
  }
}

上行连接器配置

json

{
  "BusinessConnector_Up1": {
    "Name": "Up_1",
    "Direction": "Upstream",
    "Slot": 0,
    "LinkWidth": "X16",
    "MaxLinkRate": "PCIe4.0",
    "ConnectorType": "UBC"
  }
}

多槽位下行连接器配置

json

{
  "BusinessConnector_Down2": {
    "Name": "Down_2",
    "Direction": "Downstream",
    "Slot": 2,
    "LinkWidth": "X8",
    "MaxLinkRate": "PCIe3.0",
    "ConnectorType": "UBCDD",
    "UpstreamResources": [
      {
        "Name": "Up_1",
        "ID": 255,
        "Offset": 0,
        "Width": 8
      }
    ],
    "RefMgmtConnector": "#/Connector_PCIE_SLOT3",
    "RefPCIeAddrInfo": "#/PcieAddrInfo_3"
  }
}

复杂拓扑连接器配置

json

{
  "BusinessConnector_Complex": {
    "Name": "Down_Multi",
    "Direction": "Downstream",
    "Slot": 3,
    "LinkWidth": "X4",
    "MaxLinkRate": "PCIe4.0",
    "ConnectorType": "UBCDD",
    "UpstreamResources": [
      {
        "Name": "Up_1",
        "ID": 255,
        "Offset": 12,
        "Width": 4
      },
      {
        "Name": "Up_2",
        "ID": 254,
        "Offset": 0,
        "Width": 4
      }
    ],
    "RefMgmtConnector": "#/Connector_PCIE_SLOT4",
    "RefPCIeAddrInfo": "#/PcieAddrInfo_4"
  }
}

🔧 使用指南

配置步骤

基础信息配置：设置Name、Direction、ConnectorType等基本信息
拓扑参数配置：配置Slot、LinkWidth、MaxLinkRate等拓扑参数
资源关联配置：设置UpstreamResources关联上行连接器资源
对象关联配置：配置RefMgmtConnector、RefPCIeAddrInfo关联管理对象
拓扑验证：验证PCIe业务拓扑建立的正确性

连接器方向说明

Downstream（下行）：下行连接器与槽位一一对应，用于连接扩展卡
Upstream（上行）：上行连接器与基础板BCU的UBC口对应，用于上行连接

连接器类型说明

UBCDD：UBC下行连接器，用于下行连接
UBC：UBC连接器，用于上行连接
其他类型：根据实际硬件定义的连接器类型

链路宽度说明

X16：16通道PCIe链路，提供最大带宽
X8：8通道PCIe链路，适中带宽
X4：4通道PCIe链路，基础带宽
X1：1通道PCIe链路，最小带宽

注意事项

名称唯一性：确保每个连接器的Name在系统中唯一
槽位索引：Slot用于确定全局槽位号，必须正确配置
资源匹配：UpstreamResources中的Name必须与实际上行连接器匹配
对象关联：RefMgmtConnector和RefPCIeAddrInfo必须指向有效对象

故障排除

拓扑建立失败：
- 检查Name是否唯一且正确
- 验证Direction配置是否正确
- 确认Slot索引是否正确
- 检查LinkWidth和MaxLinkRate是否匹配硬件
资源关联异常：
- 确认UpstreamResources中的Name是否存在
- 检查Offset和Width配置是否正确
- 验证资源分配是否冲突
对象关联问题：
- 检查RefMgmtConnector指向的对象是否存在
- 确认RefPCIeAddrInfo指向的对象是否正确
- 验证对象关联的完整性

性能优化

链路宽度优化：根据实际需求选择合适的LinkWidth
资源分配优化：合理配置UpstreamResources，避免资源冲突
拓扑结构优化：优化PCIe拓扑结构，提高系统性能

📚 相关文档

PCIeAddrInfo配置

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

BusinessConnector 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

关联说明 ​

📂 分类标准 ​

硬件属性 ​

软件属性 ​

📝 配置示例 ​

下行连接器配置 ​

上行连接器配置 ​

多槽位下行连接器配置 ​

复杂拓扑连接器配置 ​

🔧 使用指南 ​

配置步骤 ​

连接器方向说明 ​

连接器类型说明 ​

链路宽度说明 ​

注意事项 ​

故障排除 ​

性能优化 ​

📚 相关文档 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

BusinessConnector 类

📊 属性定义详表

必选属性

可选属性

🔗 动态关联机制

语法规范

关联说明

📂 分类标准

硬件属性

软件属性

📝 配置示例

下行连接器配置

上行连接器配置

多槽位下行连接器配置

复杂拓扑连接器配置

🔧 使用指南

配置步骤

连接器方向说明

连接器类型说明

链路宽度说明

注意事项

故障排除

性能优化

📚 相关文档