代码仓
中
风扇电源驱动规范
更新时间: 2026/11/10
在AtomGit上查看源码

风扇电源驱动规范 ​

NOTE

契约 SSOT:dmc/。总览见 3-DeviceMgmtContract.md。 适配实操:南向风扇电源驱动适配指南。

前置阅读:

1. 概述 ​

本规范定义服务器风扇(DeviceCategory: Fan)与电源(DeviceCategory: OnePower)两类部件南向驱动需实现的对象树与接口组合。风扇对象挂在 /bmc/dev/Chassis/.../ThermalSubsystem 下,电源对象挂在 /bmc/dev/Chassis/.../PowerSubsystem 下,按契约实现后可被 devmon 挂载。

设备特有器件通常包括:

  • 风扇框(Fans)与框内风扇(Fan)
  • 风扇型号(FanType),描述同型号风扇的共有属性
  • 电源本体(PowerSupply),对外提供状态、指标、控制、日志与升级能力
  • 电源内置风扇:不作为独立 Fan 对象建模,通过 PowerSupply.Status 的风扇状态字节与 PowerSupply.Metrics 的转速属性暴露

入库状态 ​

项状态
dmc/intf(Fan* / Fans* / FanType / PowerSupply*,及共享的 Cooling / Fru / PCB / Temperature / Upgrade)已有
dmc/path/.../Fan/已有 Fan/(Fan.json / Fans.json / FanType.json)
dmc/path/.../PowerSupply/已有 PowerSupply/(PowerSupply.json)
型号 DDS风扇 drivers/fan/{huawei,rs485}/csr/*.dds;电源 drivers/psu/csr/14191046_PSU_*.dds

NOTE

上游 component_drivers/docs 目前只有网卡、xPU、硬盘、RAID 四篇驱动规范(3.1~3.4),风扇电源没有上游规范分册。本文的接口集合取自 dmc/path,必选/可选口径取自参考实现的 MC_OBJECT 组合,差异说明见 §3.2、§3.4。

2. 设备树 ​

text
/bmc/dev/Chassis/${SystemId}/ThermalSubsystem
├── Fans/{FansId}                 # 风扇框
│   └── {FanId}                   # 风扇,挂在风扇框下
└── FanTypes/{TypeId}             # 风扇型号

/bmc/dev/Chassis/${SystemId}/PowerSubsystem
└── PowerSupplies/{PsuId}         # 电源
对象path 定义说明
FansFans.json风扇框,风扇的父对象
FanFan.json单个风扇
FanTypeFanType.json风扇型号
PowerSupplyPowerSupply.json电源

NOTE

命名说明:风扇与电源都挂在 Chassis 下(不是 Systems),前缀统一为 /bmc/dev/Chassis/${SystemId}/。型号 DDS 里写作 :SystemId / :Id 占位(风扇见 drivers/fan/huawei/csr/14100363_00000001050302023924.dds,电源见 drivers/psu/csr/14191046_PSU_pmbus.dds);Fan 在 DDS 中的路径写作 :Parent/:Id,即挂在 Fans 下,与 dmc 的多级路径等价。

边界说明:电源内置风扇与风扇部件是两套契约。内置风扇走 bmc.dev.PowerSupply.Status / Metrics,风扇部件(风扇框、风扇、风扇型号)走 bmc.dev.Fans / Fan.* / FanType。给电源写驱动时不要额外组合 bmc.dev.Fan*,反之亦然。

3. 对象–接口矩阵 ​

3.1 Fans(风扇框) ​

接口必选/可选dmc/intf
bmc.dev.Fans必选Fans.json
bmc.dev.Fans.Oem必选Fans/Oem.json

3.2 Fan(风扇) ​

接口必选/可选dmc/intf
bmc.dev.Fan必选Fan.json
bmc.dev.Fan.PWMChannel必选Fan/PWMChannel.json
bmc.dev.Fan.Status必选Fan/Status.json
bmc.dev.Fan.Metrics必选Fan/Metrics.json
bmc.dev.Fan.Control必选Fan/Control.json
bmc.dev.Fan.LogCollection必选Fan/LogCollection.json
bmc.dev.Fan.Oem必选Fan/Oem.json
bmc.dev.Upgrade可选Upgrade.json
bmc.dev.Fru可选Fru.json
bmc.dev.PCB可选PCB.json
bmc.dev.Temperature可选Temperature.json

NOTE

后四个是风扇的可选增强能力:bmc.dev.Fru / bmc.dev.PCB / bmc.dev.Temperature 由型号按需引入(适配指南中标注为 CESA 表 58 可选),bmc.dev.Upgrade 在风扇升级场景才需要。参考实现 drivers/fan/huawei/smc/fan_object.h:55-57 组合了前 7 个接口,未组合这 4 个。

3.3 FanType(风扇型号) ​

接口必选/可选dmc/intf
bmc.dev.FanType必选FanType.json

参考实现见 drivers/fan/huawei/smc/fantype_object.h:24,只组合 bmc.dev.FanType 一个接口。

3.4 PowerSupply(电源) ​

接口必选/可选dmc/intf
bmc.dev.PowerSupply必选PowerSupply.json
bmc.dev.PowerSupply.Status必选PowerSupply/Status.json
bmc.dev.PowerSupply.Control必选PowerSupply/Control.json
bmc.dev.PowerSupply.Metrics必选PowerSupply/Metrics.json
bmc.dev.PowerSupply.LogCollection必选PowerSupply/LogCollection.json
bmc.dev.PowerSupply.Oem必选PowerSupply/Oem.json
bmc.dev.Upgrade必选Upgrade.json
bmc.dev.Cooling可选Cooling.json
bmc.dev.PowerSupply.DualInputs可选PowerSupply/DualInputs.json
bmc.dev.PowerSupply.DualChannel可选PowerSupply/DualChannel.json
bmc.dev.PowerSupply.Capacitor可选PowerSupply/Capacitor.json
bmc.dev.PowerSupply.Capacitor.Metrics可选PowerSupply/Capacitor/Metrics.json

NOTE

可选接口对应型号差异化能力:Cooling 供需要把电源纳入整机调速环的场景使用(参考实现 drivers/psu/pmbus/one_power.h:34-36 未组合,温度与内置风扇转速走 PowerSupply.Metrics);DualInputs / DualChannel 对应双路输入与双通道轮询电源;Capacitor / Capacitor.Metrics 对应超级电容型号。

属性与方法细节以 dmc/intf/bmc/dev/Fan*、dmc/intf/bmc/dev/PowerSupply* 为准,本文不重复。

4. 相关文档 ​