代码仓
中
thermal_mgmt
更新时间： 2025/12/31
在AtomGit上查看源码

功能简介 ​

thermal_mgmt负责散热器件管理，提供散热器件状态监测、调速、异常告警和资产信息收集与展示的功能。

关键特性 ​

1 风扇特性 ​

  1. 风扇型号识别

    通过对风扇槽位、转速、是否为双转子的筛选对风速型号进行唯一类别的判断。app启动后每检测到一个风扇就下发一个风扇识别转速，等待一定时间后，采集5次转速，舍去最大值和最小值，取剩余3次的转速计算平均值，平均值是落在哪个FanType的IdentifyRangeLow和IdentifyRangeHigh之间，则风扇类型识别成功

  2. 单双转子识别

    根据单双转子在位识别，提供设置转子类型混插告警的功能。在刷新风扇转速是否稳定时，支持前、后转子最大转速区间内的稳定告警。

  3. 风扇转速管理

    支持风扇批量转速管理与单风扇转速管理。批量转速管理提供对所有风扇PWM值批量下发与查询的能力。单风扇调速支持对单个风扇的转速管理。支持查询风扇转速的功能。 示例：

    • 资源协作接口
    shell
        ├─/bmc/kepler/Systems
    │ └─/bmc/kepler/Systems/1
    │   └─/bmc/kepler/Systems/1/Thermal
    │     ├─/bmc/kepler/Systems/1/Thermal/FanTypes
    │     │ ├─/bmc/kepler/Systems/1/Thermal/FanTypes/FanType_8038P_010103
    │     │ └─/bmc/kepler/Systems/1/Thermal/FanTypes/FanType_8080P_010103
    │     └─/bmc/kepler/Systems/1/Thermal/Fans
    │       ├─/bmc/kepler/Systems/1/Thermal/Fans/Fan_1_010103
    │       ├─/bmc/kepler/Systems/1/Thermal/Fans/Fan_2_010103
    │       ├─/bmc/kepler/Systems/1/Thermal/Fans/Fan_3_010103
    │       └─/bmc/kepler/Systems/1/Thermal/Fans/Fan_4_010103
    • busctl设置所有风扇转速为50%
    shell
    > busctl --user call bmc.kepler.thermal_mgmt /bmc/kepler/Systems/1/Thermal/Fans bmc.kepler.Systems.Fans SetPWM a{ss}ad 0 4 50 50 50 50
    • busctl设置风扇1转速为50%
    shell
    > busctl --user call bmc.kepler.thermal_mgmt /bmc/kepler/Systems/1/Thermal/Fans/Fan_1_010103 bmc.kepler.Systems.Fan SetFanPWM a{ss}d 0 50

  4. 风扇状态监测

    风扇状态监测包含状态异常、风扇类型混插监测的能力。 风扇异常状态：

    1. 风扇不在位。
    2. 风扇转速偏差大。风扇pwm稳定期间，多次采集的转子转速与预期转速相差超过25%则状态异常。

  5. 风扇信息收集与展示

在Web风扇&散热界面与一键收集日志fan_info.txt、thermal_info.txt中可查看风扇槽位号、名称、型号、转速、速率比以及部件编码等信息。

2 液冷泵特性 ​

  1. 液冷泵转速管理

    支持液冷泵批量转速管理，提供对所有液冷泵PWM值批量下发与查询的能力。 示例：

    • 资源协作接口
    shell
        ├─/bmc/kepler/Systems
    │ └─/bmc/kepler/Systems/1
    │   └─/bmc/kepler/Systems/1/Thermal
    │     ├─/bmc/kepler/Systems/1/Thermal/FanTypes
    │     │ ├─/bmc/kepler/Systems/1/Thermal/FanTypes/FanType_8038P_010103
    │     │ └─/bmc/kepler/Systems/1/Thermal/FanTypes/FanType_8080P_010103
    │     ├─/bmc/kepler/Systems/1/Thermal/Fans
    │     │ ├─/bmc/kepler/Systems/1/Thermal/Fans/Fan_1_010103
    │     │ ├─/bmc/kepler/Systems/1/Thermal/Fans/Fan_2_010103
    │     │ ├─/bmc/kepler/Systems/1/Thermal/Fans/Fan_3_010103
    │     │ └─/bmc/kepler/Systems/1/Thermal/Fans/Fan_4_010103
    │     └─/bmc/kepler/Systems/1/Thermal/Pumps
    │       ├─/bmc/kepler/Systems/1/Thermal/Pumps/Pump_1_010103
    │       └─/bmc/kepler/Systems/1/Thermal/Pumps/Pump_2_010103
    • 设置所有泵转速50%
    shell
    > busctl --user call bmc.kepler.thermal_mgmt /bmc/kepler/Systems/1/Thermal/Pumps bmc.kepler.Systems.Pumps SetPWM a{ss}ad 0 2 50 50

  2. 液冷泵状态监测

    液冷泵状态监测，包括液冷泵正常状态、异常转速、是否在位、与停转监测的能力。

  3. 液冷泵信息收集与展示

在Web风扇&散热界面可查看LAAC泵转速、速率比与部件编码信息。

3 关断阀特性 ​

  1. 关断阀基础信息

    支持关断阀硬件基础信息的查询，包括槽位号、在位状态、开度、标定开度、开度状态。

  2. 关断阀开度值管理

    在关断阀巡检时，会对关断阀设置目标开度值并对下发的值进行误差检验，最后将检验结果更新为开度值状态。支持查询、设置开度值。

  3. 关断阀巡检

    支持巡检信息的查询，包括关断阀巡检类型、巡检结果、巡检状态、最后一次巡检时间。提供两种巡检方式，分别是不巡检与例行巡检（仅支持月度巡检）。月度巡检会对关断阀进行批量读值，以定期监控阀的健康状况，记录日志，并上报网管。

对外接口 ​

1 资源协作接口 ​

  1. Fan

    Object(path)interfacemethod/property/signalType取值类型备注
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFanIdpropertyU16风扇ID
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanSlotpropertyU8风扇槽位
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanTypepropertyU8风扇类型
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanModelpropertyString风扇类型
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanCoefficientpropertyU8风扇转速系数
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFanHealthpropertyU8风扇健康
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFanEntitypropertyString风扇实例
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFrontPresencepropertyU8前风扇在位
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanRearPresencepropertyU8后风扇在位
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFrontSpeedpropertyU16前风扇转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanRearSpeedpropertyU16后风扇转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFrontStatuspropertyU8前风扇状态
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanRearStatuspropertyU8后风扇状态
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFrontRPMpropertyU16前泵转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanRearRPMpropertyU16后泵转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanHardwarePWMpropertyDouble硬件转速百分比
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanPWMPercentagepropertyU32转速百分比
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanExpectedPWMpropertyDouble预期转速百分比
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFanAlarmLedpropertyU8风扇告警
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanBOMpropertyStringBOM编码
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanSystemIdpropertyU8系统Id
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanMaxSupportedPWMpropertyU32最大支持转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanIdentifySpeedLevelpropertyU8识别风速级别
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanPartNumberpropertyString部件号
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFrontMaxSpeedpropertyU32前转子最大转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanRearMaxSpeedpropertyU32后转子最大转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanIsTwinspropertyBoolean是否为单双转子
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanPositionpropertyString容器信息
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanFunctionDescpropertyString功能描述
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanDeviceNamepropertyString部件名称
    /bmc/kepler/Systems/:SystemId/Thermal/Fans/:Idbmc.kepler.Systems.FanSpeedStablepropertyBoolean风扇转速是否稳定（true:稳定，false:不稳定），期望转速与实际转速比相差25%以内为稳定

  2. Pump

    Object(path)interfacemethod/property/signalType取值类型备注
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpIdpropertyU16泵ID
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpSlotpropertyU8槽位
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpModelpropertyString型号
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpExpectedPWMpropertyDouble预期的PWM值
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpActualPWMpropertyDouble实际PWM值
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpMaxSupportedPWMpropertyU32泵全速额定PWM值
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpSpeedRPMpropertyU16泵转速（转/分钟）
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpPresencepropertyU8在位信息：1在位，0不在位
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpStatuspropertyU8泵状态
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpMaxSpeedRPMpropertyU32泵全速额定转速（转/分钟）
    /bmc/kepler/Systems/:SystemId/Thermal/Pumps/:Idbmc.kepler.Systems.PumpPartNumberpropertyString部件号

  3. Fans

    Object(path)interfacemethod/property/signalType取值类型备注
    /bmc/kepler/Systems/:SystemId/Thermal/Fansbmc.kepler.Systems.FansSetPWMmethodDouble[]设置所有风扇转速
    /bmc/kepler/Systems/:SystemId/Thermal/Fansbmc.kepler.Systems.FansWorkInStandbypropertyU8standby下风扇是否可以运转

  4. Pumps

    Object(path)interfacemethod/property/signalType取值类型备注
    /bmc/kepler/Systems/:SystemId/Thermal/Pumpsbmc.kepler.Systems.PumpsWorkInStandbypropertyU8standby下是否可以运转
    /bmc/kepler/Systems/:SystemId/Thermal/Pumpsbmc.kepler.Systems.PumpsSetPWMmethodDouble[]设置所有泵转速

  5. Valves

    Object(path)interfacemethod/property/signalType取值类型备注
    /bmc/kepler/Chassis/:ChassisId/Thermal/Valvesbmc.kepler.Chassis.ValvesStartPatrolmethodU32启动关断阀巡检
    /bmc/kepler/Chassis/:ChassisId/Thermal/Valvesbmc.kepler.Chassis.ValvesPatrolStatepropertyString巡检状态
    /bmc/kepler/Chassis/:ChassisId/Thermal/Valvesbmc.kepler.Chassis.ValvesLastPatrolTimestamppropertyU32最近一次巡检时间

  6. Valve

Object(path)interfacemethod/property/signalType取值类型备注
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValveIdpropertyU8关断阀Id
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValveSlotpropertyU8关断阀槽位
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValvePresencepropertyU8关断阀在位。1在位，0不在位
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValveStatuspropertyU16关断阀故障状态：0-正常，非0-关断阀故障
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValveOpeningDegreeStatepropertyU8关断阀开度状态:0-正常，1-异常
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValvePatrolResultpropertyU8关断阀巡检结果：0-成功，1-失败
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValveOpeningDegreepropertyU32关断阀开度
/bmc/kepler/Chassis/:ChassisId/Thermal/Valves/:Idbmc.kepler.Chassis.ValveStandardOpeningDegreepropertyU32关断阀标称开度

方法 ​

/bmc/kepler/Systems/{SystemId}/Thermal/Fans - SetPWM ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/Thermal/Fansbmc.kepler.Systems.FansSetPWMa{ss}ady输入参数：
PWM：给所有风扇下发的转速百分比数组
输出参数：
Result：返回结果，0：设置成功；1：设置失败		设置所有风扇的转速PWM数组长度需与风扇数量相同，且按风扇ID从小到大一一对应不涉及在风扇型号识别过程中或识别失败时不允许设置PWM数组长度需与风扇数量相同PWM为双精度浮点数数组，Result为0或1风扇ID在相同SystemId下唯一不涉及

/bmc/kepler/Systems/{SystemId}/Thermal/Pumps - SetPWM ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/Thermal/Pumpsbmc.kepler.Systems.PumpsSetPWMa{ss}ady输入参数：
PWM：给所有泵下发的转速百分比数组
输出参数：
Result：返回结果，0：设置成功；1：设置失败		设置所有泵的转速PWM数组长度需与泵数量相同，且按泵ID从小到大一一对应不涉及在泵型号识别过程中或识别失败时不允许设置PWM数组长度需与泵数量相同PWM为双精度浮点数数组，Result为0或1泵ID在相同SystemId下唯一不涉及

/bmc/kepler/Chassis/{ChassisId}/Thermal/Valves - StartPatrol ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Chassis/{ChassisId}/Thermal/Valvesbmc.kepler.Chassis.ValvesStartPatroluy输入参数：
DelaySeconds为巡检开始等待时间		启动关断阀巡检关断阀关闭时不巡检DelaySeconds：秒关断阀关闭时不巡检1.环境有Valve对象
2.依赖关断阀开启/关闭状态		十进制整数不涉及不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - SetCtrlMode ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigSetCtrlModea{ss}su-输入参数：
CtrlMode：冷却单元控制模式
Timeout：超时时长		设置冷却单元控制模式CtrlMode取值范围：
"Auto"：自动模式
"Manual"：手动模式
"Mixed"：混合模式		CtrlMode：不涉及
Timeout：秒		只能为所有设备设置控制模式，不能为单个冷却设备设置控制模式支持混合模式的机型才可以设置混合模式CtrlMode：字符串
Timeout：十进制整数		冷却设备ID在相同SystemId下唯一不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - SetManualLevel ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigSetManualLevela{ss}yy-输入参数：
UnitId：冷却单元Id
Level：设置的转速级别		设置手动模式冷却级别不涉及不涉及自动模式下不能设置转速级别冷却单元当前的控制模式为手动十进制整数冷却设备ID在相同SystemId下唯一不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - SetMedium ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigSetMediuma{ss}s-输入参数：
Medium：散热介质		设置散热介质类型Medium取值范围：
"Air"：风冷
"Liquid"：液冷		不涉及不涉及支持风冷的机型才可以设置风冷，支持液冷的机型才可以设置液冷"Air"或"Liquid"不涉及不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - SetSmartCoolingMode ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigSetSmartCoolingModea{ss}s-输入参数：
Mode：智能调速模式		设置智能调速模式Mode取值范围：
Custom：自定义
HighPerformance：高性能
LowNoise：低噪
EnergySaving：节能
LiquidCooling：液冷		不涉及只能批量设置散热器件的散热模式设置液冷模式环境需支持液冷模式Mode取值范围：
Custom：自定义
HighPerformance：高性能
LowNoise：低噪
EnergySaving：节能
LiquidCooling：液冷		不涉及不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - GetAbnormalPolicyEffectiveStatus ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigGetAbnormalPolicyEffectiveStatusa{ss}sb
输入参数：
PolicyType：异常调速类型
输出参数：
EffectiveStatus：异常调速策略生效状态(Fan, Pump, Temperature, All)
true:触发异常调速
false:未触发异常调速		获取异常调速策略生效状态PolicyType取值范围：Fan/Pump/Temperature/All不涉及没有触发异常调速时，该方法返回值为false-PolicyType：Fan/Pump/Temperature/All；
EffectiveStatus：true/false		风扇、泵的ID在相同SystemId下唯一，温度点ID全局唯一PSR兼容BMC版本

/bmc/kepler/Systems/{SystemId}/CoolingConfig - SetMinPWM ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigSetMinPWMa{ss}sayay-输入参数：
DeviceType：散热设备类型（Fan/Pump）
DeviceIds：散热设备ID数组
DeviceSpeeds：散热设备转速数组		设置转速下限值1.DeviceIds和DeviceSpeeds数组长度相同，且DeviceIds中的ID存在；
2.DeviceSpeeds中的值在LevelPercentRange的范围内		设置转速下限值不涉及DeviceSpeeds中的值要在LevelPercentRange的范围内DeviceType：Fan/Pump
DeviceIds、DeviceSpeeds：十进制整数数组		风扇、泵的ID在相同SystemId下唯一不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - GetComponentThermalZone ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigGetComponentThermalZonea{ss}sa(yayay)获取指定温度点器件类型与散热器件对应关系输入参数：
DeviceType：温度器件类型
输出参数：
ComponentThermalZone：指定温度器件对应散热器件数组
[Slot：器件槽位号
FanIds：器件对应风扇ID
PumpIds：器件对应泵ID]		不涉及不涉及不涉及DeviceType：字符串
ComponentThermalZone：十进制整数
FanIds、PumpIds：十进制整数数组		温度器件、风扇、泵的ID在相同SystemId下唯一不涉及

/bmc/kepler/Systems/{SystemId}/CoolingConfig - GetCustomTargetTemperatures ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigGetCustomTargetTemperaturesa{ss}a(uyyy)
输出参数：
CustomTargetTemperatures：自定义目标温度点数组：
[TemperatureType：温度点类型
TargetTemperatureCelsius：目标调速温度值
MinTargetTemperatureCelsius：目标温度调速温度值的最小值
MaxTargetTemperatureCelsius：目标温度调速温度值的最大值]		获取自定义目标温度点TemperatureType：温度点类型 1:Cpu 2:Outlet 3:Disk 4:Memory 5:PCH 6:VRD 7:VDDQ 8:NPUHbm 9:NPUAiCore 10:NPUBoard不涉及温度点ID唯一温度点不支持自定义（CustomSupported为false）时，不返回十进制整数数组温度点ID唯一兼容BMC版本

/bmc/kepler/Systems/{SystemId}/CoolingConfig - SetMinAllowedFanSpeedEnabled ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingConfigbmc.kepler.Systems.CoolingConfigSetMinAllowedFanSpeedEnableda{ss}b-输入参数：
MinAllowedFanSpeedEnabled：MinAllowedFanSpeedPercent 使能状态		设置失联状态场景风扇转速级别（MinAllowedFanSpeedPercent）使能状态不涉及不涉及不涉及需要MinAllowedFanSpeedPercent属性存在MinAllowedFanSpeedPercent：true/false风扇ID在相同SystemId下唯一CSR兼容BMC版本

/bmc/kepler/Systems/{SystemId}/AirCoolingConfig - SetCtrlMode ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/AirCoolingConfigbmc.kepler.Systems.AirCoolingConfigSetCtrlModea{ss}su-输入参数：
CtrlMode：风扇控制模式
Timeout：超时时长		设置风扇控制模式CtrlMode取值范围：
"Auto"：自动模式
"Manual"：手动模式
"Mixed"：混合模式		CtrlMode：不涉及
Timeout：秒		只能设置所有风扇的控制模式，不能为单个风扇设置控制模式支持混合模式的机型才可以设置混合模式CtrlMode：字符串
Timeout：十进制整数		风扇ID在相同SystemId下唯一兼容老版本的CoolingConfig对象

/bmc/kepler/Systems/{SystemId}/AirCoolingConfig - SetCtrlModePersist ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/AirCoolingConfigbmc.kepler.Systems.AirCoolingConfigSetCtrlModePersista{ss}syu-输入参数：
CtrlMode：风扇控制模式
CtrlModePersistType：当前风扇模式的持久化类型
Timeout：超时时长		设置可持久化的风扇控制模式，为了区分风冷和液冷CtrlMode取值范围：
"Auto"：自动模式
"Manual"：手动模式
"Mixed"：混合模式		CtrlMode、CtrlModePersistType：不涉及
Timeout：秒		只能批量设置风扇的控制模式支持混合模式的机型才可以设置混合模式CtrlMode：字符串
CtrlModePersistType、Timeout：十进制整数		风扇ID在相同SystemId下唯一兼容老版本的CoolingConfig对象

/bmc/kepler/Systems/{SystemId}/AirCoolingConfig - SetManualSpeedPercent ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/AirCoolingConfigbmc.kepler.Systems.AirCoolingConfigSetManualSpeedPercenta{ss}yy-输入参数：
FanId：风扇Id
SpeedPercent：风扇转速百分比		设置风扇手动模式转速百分比1.SpeedPercent要在LevelPercentage的范围内
2.风扇控制模式为手动		不涉及风扇手动模式未开启时不支持设置依赖LevelPercentage取值和风扇控制模式开启十进制整数风扇ID在相同SystemId下唯一兼容老版本的CoolingConfig对象

/bmc/kepler/Systems/{SystemId}/AirCoolingConfig - GetPreAdjustSpeedPercent ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/AirCoolingConfigbmc.kepler.Systems.AirCoolingConfigGetPreAdjustSpeedPercenta{ss}a{yy}输出参数：
SpeedPercent：所有风扇的预调整转速百分比
{Key: 风扇Id
Value: 风扇预调整转速百分比}		获取风扇对应的预调整转速百分比不涉及不涉及不涉及不涉及SpeedPercent:
{1, 90}, {2, 90}
即字典数组，key为FanId，Value为预调整转速百分比		风扇ID在相同SystemId下唯一不涉及

/bmc/kepler/Systems/{SystemId}/AirCoolingConfig - GetActivatedPolicyFactors ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/AirCoolingConfigbmc.kepler.Systems.FanSnapshotGetActivatedPolicyFactorsa{ss}(byys)输出参数：
RetData：返回的数据
[ValidFlag：表示Cooling组件是否有获取到风扇信息，true表示获取成功，false表示获取失败
ActivatedType：策略激活类型，1表示触发异常调速，0表示无异常调速
PWM：风扇转速百分比
FactorName：当前转速生效的调速因子名称]		获取已激活的风扇转速最高的调速策略因子不涉及不涉及不涉及当前为正常调速，且环境为上电状态ValidFlag：true/false
ActivatedType：0/1
PWM：十进制整数
FactorName：字符串		风扇ID在相同SystemId下唯一，温度点、调速策略ID唯一兼容老版本的CoolingConfig对象

/bmc/kepler/Systems/{SystemId}/LiquidCoolingConfig - SetManualLevel ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/LiquidCoolingConfigbmc.kepler.Systems.LiquidCoolingConfigSetManualLevela{ss}yy-输入参数：
UnitId：冷却单元ID
Level：设置的转速级别		设置手动模式冷却级别不涉及不涉及自动模式下不能设置转速级别冷却单元当前的控制模式为手动十进制整数冷却设备ID在相同SystemId下唯一兼容老版本的CoolingConfig对象

/bmc/kepler/Systems/{SystemId}/LiquidCoolingConfig - SetCtrlMode ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/LiquidCoolingConfigbmc.kepler.Systems.LiquidCoolingConfigSetCtrlModea{ss}su-输入参数：
CtrlMode：液冷单元控制模式
Timeout：超时时长		设置液冷单元控制模式CtrlMode取值范围：
"Auto"：自动模式
"Manual"：手动模式
"Mixed"：混合模式		CtrlMode：不涉及
Timeout：秒		只能批量设置液冷单元的控制模式，不能设置单个的支持混合模式的机型才可以设置混合模式CtrlMode：字符串
Timeout：十进制整数		液冷设备ID在相同SystemId下唯一兼容老版本的CoolingConfig对象

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetTargetTemperature ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetTargetTemperaturea{ss}y-输入参数：
TemperatureCelsius：目标温度值		设置目标温度值输入参数TemperatureCelsius在TargetTemperatureRangeCelsius范围内摄氏度不涉及1.可以匹配到调速区域
2.温度点支持自定义（CustomSupported为true）		十进制整数调速区域、温度点ID唯一SR兼容BMC

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetSmartCoolingTargetTemperature ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetSmartCoolingTargetTemperaturea{ss}an-输入参数：
SmartCoolingTargetTemperature：SmartCooling目标值数组		设置SmartCooling目标值数组输入参数SmartCoolingTargetTemperature数组长度为3，每一项分别对应节能、高性能、低噪模式的目标温度，且要设置的温度不高于对应模式的原始目标温度摄氏度不涉及温度点的原始SmartCoolingTargetTemperature数组长度为3长度为3的十进制整数数组温度点ID唯一SR兼容BMC

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetBasicCoolingTargetTemperature ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetBasicCoolingTargetTemperaturea{ss}y-输入参数：
BasicCoolingTargetTemperature：目标温度		设置目标温度BasicCoolingTargetTemperature不小于0，且不高于温度点原始的目标温度值摄氏度不涉及不涉及十进制整数温度点ID唯一SR兼容BMC

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetMaxAllowedTemperature ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetMaxAllowedTemperaturea{ss}y-输入参数：
MaxAllowedTemperature：全速阈值		设置全速阈值输入参数MaxAllowedTemperature不小于0，且不高于温度点原始的全速阈值摄氏度不涉及不涉及十进制整数温度点ID唯一SR兼容BMC

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetFailedValue ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetFailedValuea{ss}t-输入参数：
FailedValue：温度失效转速		设置温度失效转速输入参数MaxAllowedTemperature不高于100，且不低于温度点原始的温度失效转速不涉及不涉及不涉及十进制整数温度点ID唯一SR兼容BMC

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetBackupTemperatureCelsius ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetBackupTemperatureCelsiusa{ss}d-暂未实现设置备用温度点温度值摄氏度

/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id} - SetBackupTemperatureStatus ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingRequirement/{Id}bmc.kepler.Systems.CoolingRequirementSetBackupTemperatureStatusa{ss}y-暂未实现设置备用温度点状态

/bmc/kepler/Systems/{SystemId}/CoolingPolicy/{Id} - SetCustomCoolingPolicy ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingPolicy/{Id}bmc.kepler.Systems.CoolingPolicySetCustomCoolingPolicya{ss}ayay-输入参数：
TemperatureArray：温度数组
FanSpeedArray：风扇速度数组		设置自定义调速策略1.TemperatureArray中温度值范围为[0,60]，数组长度为[3,63]，非升序排列；
2.FanSpeedArray中转速范围在SpeedPercent内，数组长度范围为[4,64]，且长度比TemperatureArray长度大1		TemperatureArray：摄氏度不支持进风口温度设置不涉及TemperatureArray、FanSpeedArray：十进制整数风扇ID在相同SystemId下唯一，温度点、调速策略、调速区域ID唯一SR兼容BMC版本

/bmc/kepler/Systems/{SystemId}/CoolingPolicy/{Id} - SetHysteresis ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Systems/{SystemId}/CoolingPolicy/{Id}bmc.kepler.Systems.CoolingPolicySetHysteresisa{ss}y-输入参数：
Hysteresis：迟滞量		设置迟滞量输入参数Hysteresis范围为[0,5]不涉及不涉及温度过高触发风扇满转后，当温度降到MaxAllowedTemperature减Hysteresis以下时，风扇退出满转调速状态十进制整数风扇ID在相同SystemId下唯一，调速策略ID唯一SR兼容BMC版本

/bmc/kepler/Chassis/{ChassisId}/ThermalSubsystem/CoolingPolicies - GetSpecificPWM ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Chassis/{ChassisId}/ThermalSubsystem/CoolingPoliciesbmc.kepler.Chassis.CoolingPoliciesGetSpecificPWMa{ss}sysny输入参数：
Medium：介质
PolicyType：温度曲线类型
SmartCoolingMode：SmartCooling模式
Temperature：温度值
输出参数：
ControlPWM：控制占空比		获取指定条件下环温策略控制PWM输入参数：
Medium：Air/Liquid
PolicyType：1-Inlet,2-Disk
SmartCoolingMode：EnergySaving/LowNoise/HighPerformance/Custom/LiquidCooling		Temperature：摄氏度不涉及不涉及输入参数：
Medium：Air/Liquid
PolicyType：1-Inlet,2-Disk
SmartCoolingMode：EnergySaving/LowNoise/HighPerformance/Custom/LiquidCooling
Temperature：十进制整数
输出参数：
ControlPWM：十进制整数		风扇ID在相同SystemId下唯一，调速策略ID唯一SR兼容BMC版本

/bmc/kepler/Chassis/{ChassisId}/ThermalSubsystem - ResetMetrics ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/Chassis/{ChassisId}/ThermalSubsystembmc.kepler.Chassis.ThermalSubsystem.MetricsResetMetricsa{ss}-刷新重新统计的时间，散热器件累计耗电量重新统计散热器件累计耗电量信息重新统计不涉及不涉及不涉及刷新ResetTime和EnergyConsumptionkWh不涉及不涉及不涉及

/bmc/kepler/ThermalMgmt - SetFanPWM ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/ThermalMgmtbmc.kepler.Chassis.ThermalSubsystem.MetricsSetFanPWMa{ss}yydy输入参数：
SystemId：系统Id
FanId：风扇Id
PWM：风扇转速占空比
输出参数：
Result：返回结果，0-设置成功；1-设置失败		设置风扇转速不涉及不涉及风扇识别过程中或风扇识别失败时不可设置依赖风扇是否识别成功PWM：双精度浮点数
其余：十进制整数		风扇ID在相同SystemId下唯一SR兼容BMC版本

/bmc/kepler/ThermalMgmt - GetActivatedPolicy ​

接口路径接口名称方法名输入参数输出参数说明业务作用约束单位互斥关系依赖关系格式样例唯一性要求兼容性要求
/bmc/kepler/ThermalMgmtbmc.kepler.Release.ThermalControlStrategyGetActivatedPolicya{ss}sys输入参数：
Type：散热器件类型
Mode：查询模式，0表示生效因子，1表示生效算法
输出参数：
ActivatedPolicy：返回结果当前生效的散热策略		获取指定散热器件和模式生效的调速因子Type需为"Fan"，否则无法获取生效的调速因子不涉及无法获取除风扇以外散热器件的生效的调速因子当前为正常调速，且环境为上电状态Mode：0/1
其余：字符串		散热器件ID在相同SystemId下唯一，温度点、调速策略、调速区域ID唯一SR兼容BMC版本

2 IPMI接口 ​

命令路径命令名称功能说明
/bmc/kepler/IpmiCmds/30/93/GetFanSpeedGetFanSpeed获取风扇转速
/bmc/kepler/IpmiCmds/30/93/GetValveOpeningDegreeGetValveOpeningDegree获取节流阀开度
/bmc/kepler/IpmiCmds/30/93/GetValveStandardOpeningDegreeGetValveStandardOpeningDegree获取节流阀标定开度
/bmc/kepler/IpmiCmds/30/93/SetValveOpeningDegreeSetValveOpeningDegree设置节流阀开度
/bmc/kepler/IpmiCmds/30/93/GetTotalFanPowerGetTotalFanPower获取风扇总功耗
/bmc/kepler/IpmiCmds/30/91/SetFanCtlModeSetFanCtlMode设置风扇控制模式
/bmc/kepler/IpmiCmds/30/91/GetFanCtlModeGetFanCtlMode获取风扇控制模式
/bmc/kepler/IpmiCmds/2C/15/SetFanLevelSetFanLevel设置风扇等级
/bmc/kepler/IpmiCmds/2C/16/GetFanLevelGetFanLevel获取风扇等级
/bmc/kepler/IpmiCmds/30/92/SetCoolingModeSetCoolingMode设置散热模式
/bmc/kepler/IpmiCmds/30/92/GetCoolingModeGetCoolingMode获取散热模式
/bmc/kepler/IpmiCmds/2C/14/GetFanSpdPropsGetFanSpdProps获取风扇转速信息
/bmc/kepler/IpmiCmds/30/93/GetInletPolicyGetInletPolicy获取进风口调速策略
/bmc/kepler/IpmiCmds/30/93/SetInletPolicySetInletPolicy设置进风口调速策略
/bmc/kepler/IpmiCmds/30/93/SetInitCoolingUnitLevelSetInitCoolingUnitLevel设置初始散热单元等级
/bmc/kepler/IpmiCmds/30/93/GetInitCoolingUnitLevelGetInitCoolingUnitLevel获取初始散热单元等级
/bmc/kepler/IpmiCmds/30/91/SetCoolingDeviceModeSetCoolingDeviceMode设置散热器件模式
/bmc/kepler/IpmiCmds/30/91/GetCoolingDeviceModeGetCoolingDeviceMode获取散热器件模式
/bmc/kepler/IpmiCmds/30/91/SetCoolingDeviceLevelSetCoolingDeviceLevel设置散热器件转速级别
/bmc/kepler/IpmiCmds/30/91/GetCoolingDeviceLevelGetCoolingDeviceLevel获取散热器件转速级别

配置介绍 ​

CSR配置 ​

  1. Fan对象配置：

    propertytype备注
    FanIdU16风扇Id
    SlotU8风扇槽位
    CoefficientU8风扇转速系数
    FrontPresenceU8前转子在位状态
    RearPresenceU8后转子在位状态
    FrontSpeedU16前转子转速
    RearSpeedU16后转子转速
    HardwarePWMDouble硬件占空比
    SystemIdU8系统Id
    MaxSupportedPWMU32支持的最大转速
    IdentifySpeedLevelU8识别风速级别
    PositionString容器信息
    PowerGoodU8PG状态

  2. FanType配置

    propertytype备注
    NameString风扇型号名
    IndexU8风扇型号索引
    IsDefaultTypeBoolean是否为默认风扇型号
    IsTwinsBoolean是否为双转子
    FrontMaxSpeedU32前转子最大转速
    RearMaxSpeedU32后转子最大转速
    IdentifyRangeLowU32风扇型号识别转速左区间
    IdentifyRangeHighU32风扇型号识别转速右区间
    PartNumberString部件编码
    BOMStringBOM编码
    SystemIdU8系统Id
    SpeedRangeU8[]风扇转速和功率映射关系的风扇转速数组
    PowerRangeU8[]风扇转速和功率映射关系的功率数组
    FanDiameterMmU16风扇组件的直径，单位毫米

  3. Fans对象配置

    propertytype备注
    PWMChipU8[]转速下发Chip地址
    SetPWMCmdU32转速下发SMC地址

  4. Pump对象配置

    propertytype备注
    IdU16泵ID
    SlotU8槽位
    ActualPWMDouble实际PWM值
    MaxSupportedPWMU32泵全速额定PWM值
    SpeedRPMU16转速
    MaxSpeedRPMU32全速额定转速
    PresenceU81在位，0不在位
    PartNumberString部件编码
    PowerGoodU8PG状态

  5. Pumps对象配置

    propertytype备注
    PWMChipU8[]转速下发Chip地址
    SetPWMCmdU32转速下发SMC地址

  6. 多风扇板配置

    propertytype备注
    StandbyFanU8standby下风扇是否可以运转，1:可以，0:不可以
    FanStartSlotU8[]风扇起始槽位，下标为风扇板槽位，值为风扇起始槽位
下一篇探索openUBMC