部件适配-部件驱动 2.0-GPU 驱动规范
更新时间: 2026/09/12
在AtomGit上查看源码GPU 驱动规范
契约 SSOT:
dmc/。总览见 3-DeviceMgmtContract.md。 适配实操:4.2 GPU驱动适配指南。 方案概述:《部件驱动接入》概述。
1. 概述
本规范定义加速卡类设备(当前以 PCIe GPU 卡 为主,DeviceCategory: PCIeGpuCard)南向驱动需实现的对象树与接口组合,后续同类加速器(xPU)扩展时可参照本规范;对象路径与接口命名当前仍以 PCIeGpuCard / bmc.dev.Gpu 落地。
设备特有器件通常包括:
- xPU/GPU 板卡本身
- 卡上处理器(Gpu / Processor)
- 卡上或紧密集成的 Memory
入库状态
| 项 | 状态 |
|---|---|
dmc/path/.../PCIeGpuCard/ | 已有 |
dmc/intf 通用 PCIe* / Board | 已有 |
dmc/intf:bmc.dev.Gpu / Processor / Memory(及 Metrics/Cooling/Power/Status) | 已有 |
2. 设备树
text
/bmc/dev/Systems/${SystemId}/PCIeGpuCard/{CardId}
├── Gpu/{GpuId}
└── Memory/{MemoryId}| 对象 | path 定义 | 说明 |
|---|---|---|
| PCIeGpuCard | dmc/path/bmc/dev/PCIeGpuCard/PCIeGpuCard.json | 加速卡主对象 |
| Gpu | dmc/path/bmc/dev/PCIeGpuCard/Gpu.json | 卡上 GPU/处理器 |
| Memory | dmc/path/bmc/dev/PCIeGpuCard/Memory.json | 卡上内存 |
命名说明:部分 gen 对象名使用
GraphicsController,DMC path 使用子对象名Gpu。实现侧映射时以 DMC path 与接口集合为准。
3. 对象–接口矩阵
3.1 PCIeGpuCard
| 接口 | 必选/可选 | dmc/intf |
|---|---|---|
bmc.dev.PCIeDevice | 必选 | PCIeDevice.json |
bmc.dev.PCIeDevice.PCIeFunction | 必选 | PCIeDevice/PCIeFunction.json |
bmc.dev.PCIeDevice.Status | 必选 | PCIeDevice/Status.json |
bmc.dev.PCIeCard | 必选 | PCIeCard.json |
bmc.dev.PCIeCard.Metrics | 必选 | PCIeCard/Metrics.json |
bmc.dev.PCIeDevice.*(Bandwidth/Oem 等) | 可选 | PCIeDevice/ |
bmc.dev.Board | 可选 | Board.json |
3.2 Gpu(见 path 声明)
| 接口 | 必选/可选 | dmc/intf |
|---|---|---|
bmc.dev.Processor | 必选 | Processor.json |
bmc.dev.Processor.Metrics | 必选 | Processor/Metrics.json |
bmc.dev.Gpu | 必选 | Gpu.json |
bmc.dev.Gpu.Power | 可选 | Gpu/Power.json |
bmc.dev.Gpu.Status | 可选 | Gpu/Status.json |
path 引用见 Gpu.json。
3.3 Memory(见 path 声明)
| 接口 | 必选/可选 | dmc/intf |
|---|---|---|
bmc.dev.Memory | 必选 | Memory.json |
bmc.dev.Memory.Metrics | 可选 | Memory/Metrics.json |
bmc.dev.Cooling | 可选 | Cooling.json |
path 引用见 Memory.json。
4. 相关文档
- 3-DeviceMgmtContract.md
- 4.2 GPU驱动适配指南
- 特性设计示例:
docs/26.06/openUBMC支持NVIDIA多型号GPU驱动详细设计说明书.md等
5. 历史 RFC
- 社区公示(历史参考):https://discuss.openubmc.cn/t/topic/1735