硬盘驱动规范
更新时间: 2026/11/16
在AtomGit上查看源码硬盘驱动规范
NOTE
契约 SSOT:dmc/。总览见 3-DeviceMgmtContract.md。 适配实操:南向硬盘驱动适配指南。
前置阅读:
1. 概述
本规范定义 PCIe NVMe 硬盘(DeviceCategory: PCIeNVMe)南向驱动需实现的对象树与接口组合。部件按契约实现后,可被 devmon 挂载到 /bmc/dev/Systems/.../PCIeNVMe/... 设备树,支撑产品信息、健康状态、SMART、NVMe-MI、散热与日志收集等管理能力。
设备特有器件通常包括:
- NVMe 硬盘本体,对应主对象
PCIeNVMe,不拆子对象 - 硬盘的 PCIe 侧信息与链路状态,对应
bmc.dev.PCIeDevice及其子接口 - 盘内带外管理通道,对应
bmc.dev.NVMe及其子接口(ProductInfo / Status / Smart / NVMeMI 等)
入库状态
| 项 | 状态 |
|---|---|
dmc/intf(PCIeDevice* / NVMe* / Cooling / Upgrade) | 已有 |
dmc/path/.../PCIeNVMe/ | 已有 PCIeNVMe/ |
| 型号 DDS | 已有,见 drivers/pcie_nvme/{huawei,samsung,dera,dapustor}/csr/14140224_PROTOCOL_*.dds |
2. 设备树
text
/bmc/dev/Systems/${SystemId}/PCIeNVMe/{DriveId}| 对象 | path 定义 | 说明 |
|---|---|---|
| PCIeNVMe | PCIeNVMe.json | NVMe 硬盘主对象,接口全部组合在主对象上 |
NOTE
命名说明:dmc/path 的对象名与型号 DDS 的 DeviceCategory 同为 PCIeNVMe;DDS 里的路径占位符写作 :SystemId / :Id,代码中用 MC_OBJECT 的 "/bmc/dev/Systems/1/PCIeNVMe/${object_name}" 拼接(参考实现 drivers/pcie_nvme/huawei/hw_nvme_pcie4/hw_nvme_pcie4.h:53),三者语义一致。
3. 对象–接口矩阵
path 声明的完整接口列表见 PCIeNVMe.json。摘要如下:
| 接口 | 必选/可选 | dmc/intf |
|---|---|---|
bmc.dev.PCIeDevice | 必选 | PCIeDevice.json |
bmc.dev.PCIeDevice.PCIeFunction | 必选 | PCIeDevice/PCIeFunction.json |
bmc.dev.PCIeDevice.Status | 必选 | PCIeDevice/Status.json |
bmc.dev.NVMe | 必选 | NVMe.json |
bmc.dev.NVMe.ProductInfo | 必选 | NVMe/ProductInfo.json |
bmc.dev.NVMe.Status | 必选 | NVMe/Status.json |
bmc.dev.Cooling | 必选 | Cooling.json |
bmc.dev.NVMe.Management | 可选 | NVMe/Management.json |
bmc.dev.NVMe.BasicManagement | 可选 | NVMe/BasicManagement.json |
bmc.dev.NVMe.NVMeMI | 可选 | NVMe/NVMeMI.json |
bmc.dev.NVMe.Smart | 可选 | NVMe/Smart.json |
bmc.dev.NVMe.VendorSpecificSmart | 可选 | NVMe/VendorSpecificSmart.json |
bmc.dev.NVMe.MultiRecord | 可选 | NVMe/MultiRecord.json |
bmc.dev.NVMe.LogCollection | 可选 | NVMe/LogCollection.json |
bmc.dev.NVMe.Oem | 可选 | NVMe/Oem.json |
bmc.dev.PCIeDevice.Oem | 可选 | PCIeDevice/Oem.json |
bmc.dev.Upgrade | 可选 | Upgrade.json |
NOTE
必选/可选的口径沿用《3.3 硬盘驱动规范》:产品信息、健康状态与散热是带外管理的最小闭环,其余按型号能力裁剪。参考实现 drivers/pcie_nvme/huawei/hw_nvme_pcie4/hw_nvme_pcie4.h:52-54 的 MC_OBJECT 把上表 17 个接口全部组合,可作为「全量实现」的对照。
属性与方法细节以 dmc/intf/bmc/dev/NVMe* 为准,本文不重复。
4. 相关文档
- 3-DeviceMgmtContract.md
- 南向硬盘驱动适配指南
- 3.3 硬盘驱动规范(上游归档版本,本仓版本以本文为准)
- 型号 DDS 目录:
drivers/pcie_nvme/
5. 覆盖范围说明
- RAID 控制器下的物理盘由《RAID 驱动规范》定义,本文只覆盖独立挂在 System 下的 PCIe NVMe 硬盘。
- SAS/SATA 直出等形态不在本文范围内:
dmc/path目前只定义了 PCIe NVMe 这一类硬盘对象。这类形态入库后,在本目录增补对应的对象与分册。