📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

OCPCard 类

属性	值
类名称	`OCPCard`
功能描述	OCP卡配置和状态管理
所属SIG组	system
所属组件	PCIe卡管理
责任人	系统架构组
最后更新	2026-06-22
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Name`	String	无	-	-	产品名称	北向接口显示OCP卡名称	`"OCPCard1"`	CSR配置	软件
`Model`	String	无	-	-	PCIe卡的型号	显示OCP卡型号	`"XX001"`	CSR配置	软件
`NodeID`	String	无	-	-	唯一标识符	标识OCP卡唯一ID	`"Node1"`	CSR配置	软件
`SlotID`	U8	无	0~255	-	槽位号	标识OCP卡所在槽位	`1`	CSR配置	软件
`DeviceName`	String	无	-	-	设备资源名称	显示OCP卡设备资源名称	`"OCPDev1"`	CSR配置	软件
`FunctionClass`	U8	无	0~255	-	功能分类	OCP卡功能分类标识	`1`	CSR配置	软件
`Description`	String	无	-	-	描述	OCP卡描述信息	`"OCP NIC Card"`	CSR配置	软件
`PcbVersion`	String	无	-	-	PCB版本	显示OCP卡PCB版本	`"V1.0"`	CSR配置	软件
`BoardName`	String	无	-	-	单板名称	显示OCP卡单板名称	`"Board1"`	CSR配置	软件
`LinkSpeedCapability`	String	无	-	-	最大链路速率	显示OCP卡最大链路速率	`"10Gb/s"`	CSR配置	软件
`LinkSpeed`	String	无	-	-	链路速率	显示OCP卡当前链路速率	`"5Gb/s"`	CSR配置	软件
`VendorID`	U16	无	0~65535	-	制造商ID	标识OCP卡制造商	`8088`	CSR配置	软件
`DeviceID`	U16	无	0~65535	-	设备ID	标识OCP卡设备	`1000`	CSR配置	软件
`SubVendorID`	U16	无	0~65535	-	子厂商ID	标识OCP卡子厂商	`8088`	CSR配置	软件
`SubDeviceID`	U16	无	0~65535	-	子设备ID	标识OCP卡子设备	`1001`	CSR配置	软件
`Position`	String	无	-	-	位置信息	显示OCP卡位置	`"Slot1"`	CSR配置	软件
`Manufacturer`	String	无	-	-	厂商	显示OCP卡厂商名称	`"Huawei"`	CSR配置	软件
`LaneOwner`	U8	无	0~255	-	资源归属	OCP卡资源归属标识	`1`	CSR配置	软件
`FirmwareVersion`	String	无	-	-	固件版本	显示OCP卡固件版本	`"1.0.0"`	CSR配置	软件
`PartNumber`	String	无	-	-	部件编码	显示OCP卡部件编码	`"021XXXXX"`	CSR配置	软件
`SerialNumber`	String	无	-	-	序列号	显示OCP卡序列号	`"SN001"`	CSR配置	软件
`Health`	U8	无	0~255	-	健康状态	OCP卡健康状态告警配置	`1`	CSR配置	软件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`BoardID`	U16	65535	0~65535	-	单板ID	标识OCP卡单板ID	`65535`	CSR配置	软件
`LinkWidthAbility`	String	"N/A"	-	-	最大链路带宽	显示OCP卡最大链路带宽	`"x4"`	CSR配置	软件
`LinkWidth`	String	"N/A"	-	-	链路带宽	显示OCP卡当前链路带宽	`"x4"`	CSR配置	软件

🔗 动态关联机制

语法规范

OCPCard类属性均为静态配置属性，无动态关联机制。

关联说明

无动态关联：OCPCard类所有属性均通过CSR配置直接赋值，不依赖Scanner、Accessor或Component关联
接口继承：OCPCard使用 bmc.kepler.Systems.PCIeDevices.PCIeCard 接口，与PCIeCard共享相同的属性定义

📂 分类标准

硬件属性

无硬件属性：OCPCard类不含直接从硬件获取或控制硬件的参数

软件属性

定义：用于软件层面的OCP卡管理和配置
特点：包含标识、配置、资产信息、状态管理等功能
示例：Name, Model, NodeID, SlotID, DeviceName, FunctionClass, Description, PcbVersion, BoardID, BoardName, LinkWidthAbility, LinkWidth, LinkSpeedCapability, LinkSpeed, VendorID, DeviceID, SubVendorID, SubDeviceID, Position, Manufacturer, LaneOwner, FirmwareVersion, PartNumber, SerialNumber, Health

📝 配置示例

标准OCP卡配置

json

{
  "OCPCard": {
    "Name": "OCPCard1",
    "Model": "XX001",
    "NodeID": "Node1",
    "SlotID": 1,
    "DeviceName": "OCPDev1",
    "FunctionClass": 1,
    "Description": "OCP NIC Card",
    "PcbVersion": "V1.0",
    "BoardID": 65535,
    "BoardName": "Board1",
    "LinkWidthAbility": "x4",
    "LinkWidth": "x4",
    "LinkSpeedCapability": "10Gb/s",
    "LinkSpeed": "5Gb/s",
    "VendorID": 8088,
    "DeviceID": 1000,
    "SubVendorID": 8088,
    "SubDeviceID": 1001,
    "Position": "Slot1",
    "Manufacturer": "Huawei",
    "LaneOwner": 1,
    "FirmwareVersion": "1.0.0",
    "PartNumber": "021XXXXX",
    "SerialNumber": "SN001",
    "Health": 1
  }
}

多槽位OCP卡配置（Slot2）

json

{
  "OCPCard_Slot2": {
    "Name": "OCPCard2",
    "Model": "XX002",
    "NodeID": "Node2",
    "SlotID": 2,
    "DeviceName": "OCPDev2",
    "FunctionClass": 2,
    "Description": "OCP NIC Card Slot2",
    "PcbVersion": "V2.0",
    "BoardID": 1,
    "BoardName": "Board2",
    "LinkWidthAbility": "x8",
    "LinkWidth": "x8",
    "LinkSpeedCapability": "25Gb/s",
    "LinkSpeed": "25Gb/s",
    "VendorID": 8088,
    "DeviceID": 1002,
    "SubVendorID": 8088,
    "SubDeviceID": 1002,
    "Position": "Slot2",
    "Manufacturer": "Huawei",
    "LaneOwner": 1,
    "FirmwareVersion": "2.0.0",
    "PartNumber": "021XXXXY",
    "SerialNumber": "SN002",
    "Health": 1
  }
}

最小化OCP卡配置

json

{
  "OCPCard_Minimal": {
    "Name": "OCPCard1",
    "Model": "XX001",
    "NodeID": "Node1",
    "SlotID": 1,
    "DeviceName": "OCPDev1",
    "FunctionClass": 1,
    "Description": "OCP NIC Card",
    "PcbVersion": "V1.0",
    "BoardName": "Board1",
    "LinkSpeedCapability": "10Gb/s",
    "LinkSpeed": "5Gb/s",
    "VendorID": 8088,
    "DeviceID": 1000,
    "SubVendorID": 8088,
    "SubDeviceID": 1001,
    "Position": "Slot1",
    "Manufacturer": "Huawei",
    "LaneOwner": 1,
    "FirmwareVersion": "1.0.0",
    "PartNumber": "021XXXXX",
    "SerialNumber": "SN001",
    "Health": 1
  }
}

🔧 使用指南

配置步骤

设置基本标识：配置Name、NodeID、SlotID、DeviceName
配置型号信息：设置Model、FunctionClass、Description
设置链路参数：配置LinkSpeedCapability、LinkSpeed、LinkWidthAbility、LinkWidth
配置资产信息：设置VendorID、DeviceID、SubVendorID、SubDeviceID、Manufacturer、PartNumber、SerialNumber
设置版本信息：配置PcbVersion、FirmwareVersion
可选配置：根据需要配置BoardID、BoardName等可选属性

注意事项

接口共享：OCPCard与PCIeCard使用相同的PCIeCard接口，属性定义一致
路径格式：对象路径为 /bmc/kepler/Systems/${SystemId}/PCIeDevices/OCPCards/${Id}
权限要求：访问需ConfigureSelf权限
链路带宽：LinkWidthAbility和LinkWidth默认值为"N/A"，表示未配置时无链路带宽信息
BoardID默认：BoardID默认值为65535，表示未指定单板ID时的占位值
Health状态：Health属性用于OCP卡健康状态监控

性能建议

链路配置：合理设置LinkWidth和LinkSpeed以匹配实际硬件能力
资产管理：确保VendorID、DeviceID等资产信息准确，便于故障定位
版本追踪：维护PcbVersion和FirmwareVersion以便版本管理
资源优化：根据实际需求配置可选属性

ID体系说明

NodeID: 全局唯一标识符，用于跨系统识别OCP卡
SlotID (0-255): 槽位标识，标识OCP卡所在物理槽位
BoardID (0-65535): 单板标识，默认65535表示未指定

常见问题

Q: OCPCard和PCIeCard有什么关系？
- A: OCPCard使用与PCIeCard相同的 bmc.kepler.Systems.PCIeDevices.PCIeCard 接口，属性定义一致，但对象路径不同
Q: LinkWidthAbility和LinkWidth为什么默认值是"N/A"？
- A: 默认"N/A"表示未配置链路带宽信息，实际使用时应根据硬件规格配置具体值如"x4"、"x8"
Q: BoardID默认值65535的含义是什么？
- A: 65535是U16类型的最大值，作为未指定单板ID时的占位默认值
Q: Health属性如何使用？
- A: Health属性用于标识OCP卡的健康状态，具体取值含义由健康状态枚举定义

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

OCPCard 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

关联说明 ​

📂 分类标准 ​

硬件属性 ​

软件属性 ​

📝 配置示例 ​

标准OCP卡配置 ​

多槽位OCP卡配置（Slot2） ​

最小化OCP卡配置 ​

🔧 使用指南 ​

配置步骤 ​

注意事项 ​

性能建议 ​

ID体系说明 ​

常见问题 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

OCPCard 类

📊 属性定义详表

必选属性

可选属性

🔗 动态关联机制

语法规范

关联说明

📂 分类标准

硬件属性

软件属性

📝 配置示例

标准OCP卡配置

多槽位OCP卡配置（Slot2）

最小化OCP卡配置

🔧 使用指南

配置步骤

注意事项

性能建议

ID体系说明

常见问题