风扇电源驱动规范
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. 设备树
/bmc/dev/Chassis/${SystemId}/ThermalSubsystem
├── Fans/{FansId} # 风扇框
│ └── {FanId} # 风扇,挂在风扇框下
└── FanTypes/{TypeId} # 风扇型号
/bmc/dev/Chassis/${SystemId}/PowerSubsystem
└── PowerSupplies/{PsuId} # 电源| 对象 | path 定义 | 说明 |
|---|---|---|
| Fans | Fans.json | 风扇框,风扇的父对象 |
| Fan | Fan.json | 单个风扇 |
| FanType | FanType.json | 风扇型号 |
| PowerSupply | PowerSupply.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* 为准,本文不重复。