代码仓
中
硬盘驱动规范
更新时间: 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 定义说明
PCIeNVMePCIeNVMe.jsonNVMe 硬盘主对象,接口全部组合在主对象上

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. 相关文档 ​

5. 覆盖范围说明 ​

  • RAID 控制器下的物理盘由《RAID 驱动规范》定义,本文只覆盖独立挂在 System 下的 PCIe NVMe 硬盘。
  • SAS/SATA 直出等形态不在本文范围内:dmc/path 目前只定义了 PCIe NVMe 这一类硬盘对象。这类形态入库后,在本目录增补对应的对象与分册。