背景
当前触发“风扇转速偏差大”告警的风扇转速偏差阈值固定为25（百分比），客户希望可以通过redfish、web rest查询和设置风扇转速偏差大告警阈值，需要提供资源协作接口属性
关联ISSUE
[需求]: 支持风扇转速告警阈值查询和设置能力 - openUBMC/mdb_interface - GitCode
评审点
- 资源协作接口新增属性风扇转速偏差阈值
- web rest接口新增属性风扇转速偏差阈值
- Web前端新增设置和查询风扇告警阈值接口
详细描述
评审点1、资源协作接口新增属性风扇转速偏差阈值SpeedDeviationThresholdPercent
资源path（已有）： /bmc/kepler/Systems/:SystemId/AirCoolingConfig
资源interface（已有）： bmc.kepler.Systems.AirCoolingConfig
新增属性：SpeedDeviationThresholdPercent用于表示风扇转速偏差阈值
| 属性名称 | 变化类型 | 签名 | 访问权限 | 持久化 | 变化通知 | 属性值来源 | 说明 | 约束 |
|---|---|---|---|---|---|---|---|---|
| SpeedDeviationThresholdPercent | 新增属性 | y | 读写，读：ReadOnly，写：BasicSetting | 掉电持久化 | false | 默认值为25，可设置修改 | 风扇转速偏差阈值，默认值为25，取值范围：[10,100]，取值为100时表示告警关闭 | 适用于判断风扇转速实际值和预期值是否在正常范围内 |
评审点2、web rest接口下新增属性FanSpeedDeviationThresholdPercent ，表示风扇转速偏差阈值
URI（已有）：/UI/Rest/System/Thermal
变化类型：新增属性FanSpeedDeviationThresholdPercent
操作类型： GET/PATCH
应用场景：客户发送web rest接口查询和设置风扇转速偏差阈值
参数说明：
| 属性名称 | 取值类型 | 说明 | 取值范围 | 默认值 | 操作权限 | 是否频繁变化并需要屏蔽变化事件 | 约束 |
|---|---|---|---|---|---|---|---|
| FanSpeedDeviationThresholdPercent | Integer | 风扇转速偏差阈值 | [10,100] | 25 | R：ReadOnly，W：BasicSetting | 否 | PATCH接口设置该属性的参数为[10,100]，取值为100时表示告警关闭 |
响应示例：
{
"Inlet": {
"CurrentValue": "27.000",
"History": [],
},
"ModelPredictiveControlEnabled": null,
"SmartCooling": {
"Mode": "EnergySaving",
"CoolingMedium": "AirCooled",
"CustomConfig": {}
},
"TemperaturesInfo": {
"Temperatures": [],
"XScope": 16,
"YScope": 27
},
"Fans": [],
"Pumps": [],
"FanCtrlMode": "Auto",
"ManualLevel": 10,
"LevelPercentRange": [
10,
100
]，
"FanSpeedDeviationThresholdPercent": 30
}
评审点3、在“系统管理”/“风扇&散热”/“风扇设置”页面 ，“调速模式”页签下新增“转速告警阈值”字段
在风扇设置界面“调速模式”下面一行新加字段“转速告警阈值”，输入时会提示“转速阈值设置范围为10~100，100表示告警关闭”，打开页面“转速告警阈值”设置框里会显示上一次设置的值，如果用户未设置过则显示默认值。高仿真图如下：
评审结论
1、 同意在资源协作接口新增属性风扇转速偏差阈值SpeedDeviationThresholdPercent
资源path（已有）： /bmc/kepler/Systems/:SystemId/AirCoolingConfig
资源interface（已有）： bmc.kepler.Systems.AirCoolingConfig
新增属性：SpeedDeviationThresholdPercent用于表示风扇转速偏差阈值
| 属性名称 | 变化类型 | 签名 | 访问权限 | 持久化 | 变化通知 | 属性值来源 | 说明 | 约束 |
|---|---|---|---|---|---|---|---|---|
| SpeedDeviationThresholdPercent | 新增属性 | y | 读写，读：ReadOnly，写：BasicSetting | 掉电持久化 | false | 默认值为25，可设置修改 | 风扇转速偏差阈值，默认值为25，取值范围：[10,100] ，取值为100时表示告警关闭 | 适用于判断风扇转速实际值和预期值是否在正常范围内 |
2、同意在web rest接口/UI/Rest/System/Thermal下新增属性FanSpeedDeviationThresholdPercent
变化类型：新增属性FanSpeedDeviationThresholdPercent
操作类型： GET/PATCH
应用场景：客户发送web rest接口查询和设置风扇转速偏差阈值
参数说明：
| 属性名称 | 取值类型 | 说明 | 取值范围 | 默认值 | 操作权限 | 是否频繁变化并需要屏蔽变化事件 | 约束 |
|---|---|---|---|---|---|---|---|
| FanSpeedDeviationThresholdPercent | Integer | 风扇转速偏差阈值 | [10,100] | 25 | R：ReadOnly，W：BasicSetting | 否 | PATCH接口设置该属性的参数为[10,100]，取值为100时表示告警关闭 |
3、同意在“系统管理”/“风扇&散热”/“风扇设置”页面 ，“调速模式”页签下新增“转速告警阈值”字段（参考评审点描述）
（1）进入页面时，“转速告警阈值”编辑框里会显示最近一次设置的值，如果用户未设置过则显示默认值。
（2）用户在编辑框输入时，通过气泡方式提示“转速阈值设置范围为10~100，100表示告警关闭”。
遗留问题
1、bmc.kepler.Systems.AirCoolingConfig在多host场景会出现问题，需要确认SpeedDeviationThresholdPercent属性添加在哪个接口下
结论：SpeedDeviationThresholdPercent属性添加在bmc.kepler.Systems.AirCoolingConfig接口下。经排查，归属在System下的散热配置相关资源协作接口，涉及13个path以及其下的15个interface，如果整改会涉及sdk配套问题，需要在对应决策组织评审整体方案后确定整改计划。