【公示中，下次评议时间8.11】GPU卡驱动规范v0.1

[yelvsub (huangleisheng)]

GPU卡驱动规范v0.1

注意！
本驱动规范定义了GPU部件需实现的驱动接口。目前面向社区进行意见征集，欢迎大家反馈。

1 总览

PCIeGPUCard指PCIe GPU插卡，通常插在Riser卡上，接入整机PCIe拓扑链路

1.1 设备类型

"DeviceCategory": PCIeGPUCard

1.2 设备特有器件

• GPU卡自身
• GPU卡上的图形处理器
• GPU内存，位于GPU卡上或与GPU紧密集成

1.3 通用器件

• i2c器件

1.4 设备树结构

└/bmc/dev/Systems/1/PCIeGPUCard/{CardId}
   ├/bmc/dev/Systems/1/PCIeGPUCard/{CardId}/GPU/{GPUId}
   ├/bmc/dev/Systems/1/PCIeGPUCard/{CardId}/Memory/{MemoryId}

2 独有对象

2.1 PCIeGPUCard

说明： 描述整体PCIeGPUCard自身的对象
对象路径：/bmc/dev/Systems/1/PCIeGPUCard/{CardId}
类： Component（组件）

interface	说明	可选/必选
bmc.dev.PCIeDevice	描述PCIe设备的接口	必选
bmc.dev.PCIeDevice.Topology	描述PCIe设备拓扑信息的接口	必选
bmc.dev.PCIeDevice.Status	描述PCIe设备状态的接口	必选
bmc.dev.PCIeCard	描述PCIe标卡的接口	必选

2.2 GPU

说明： 描述GPU卡上图形处理器的对象
对象路径：/bmc/dev/Systems/1/PCIeGPUCard/{CardId}/GPU/{GPUId}
类： Component（组件）

interface	说明	可选/必选
bmc.dev.Processor	描述通用处理器的接口	必选
bmc.dev.GPU	描述GPU特有功能的接口	必选
bmc.dev.GPU.Power	描述GPU供电功能的接口	可选
bmc.dev.GPU.Status	描述GPU状态的接口	可选

2.3 Memory

说明： 描述GPU内存的对象
对象路径：/bmc/dev/Systems/1/PCIeGPUCard/{CardId}/Memory/{MemoryId}
类： Component（组件）

interface	说明	可选/必选
bmc.dev.Memory	描述通用内存的接口	必选

3 接口定义

3.1 bmc.dev.Processor

属性名	类型	可读写	信号通知	描述
SystemId	U8	只读	无	系统Id
Id	U8	只读	无	处理器Id
Presence	U8	只读	变更广播	在位状态
InstructionSet	String	只读	无	指令集
Architecture	String	只读	无	芯片架构
Manufacturer	String	只读	无	厂商
Family	String	只读	无	处理器家族
Model	String	只读	无	型号
PartNumber	String	只读	无	部件号
SerialNumber	String	只读	无	序列号
FirmwareVersion	String	只读	无	固件版本
Location	String	只读	无	位置

3.2 bmc.dev.GPU

属性名	类型	可读写	信号通知	描述
InfoRomVersion	String	只读	无	InfoRom版本号
BuildDate	String	只读	无	构建时间
UUID	String	只读	无	通用唯一标识符
Utilization	U16	只读	无	GPU利用率（%）
TemperatureCelsius	Double	只读	无	处理器温度

3.3 bmc.dev.GPU.Power

属性名	类型	可读写	信号通知	描述
PowerWatts	U16	只读	无	功率
PowerBrakeState	U8	只读	无	power brake状态，0-释放，1-设置
ExternalPowerSufficient	U8	只读	无	外部供电是否充足，0-不充足，1-充足

3.4 bmc.dev.GPU.Status

属性名	类型	可读写	信号通知	描述
ECCModeEnabled	U8	只读	无	ECC模式当前使能状态，0-未使能，1-使能
ECCModePendingEnabled	U8	只读	无	ECC模式重启后使能状态，0-未使能，1-使能
ResetRequired	U8	只读	无	是否需要重启，0-不需要，1-需要

3.5 bmc.dev.Memory

属性名	类型	可读写	信号通知	描述
SystemId	U8	只读	无	系统Id
Id	U8	只读	无	内存Id
Manufacturer	String	只读	无	厂商
PartNumber	String	只读	无	部件号
Utilization	U16	只读	无	内存利用率（%）
DoubleBitErrorPageCount	U32	只读	无	双bit失效故障页个数
SingleBitErrorPageCount	U32	只读	无	单bit失效故障页个数