一、ISSUE链接
二、背景
机柜管理场景需要新增调测命令，用于控制电源turbo能力的使能状态，当turbo使能关闭后，将禁用电源的turbo能力，同时不再上报turbo相关告警
三、决策点
1、资源协作接口新增设置电源电容开关机状态方法
2、cli接口新增设置电源能力状态方法
四、详细描述
1、 资源协作接口新增设置电源电容开关机状态方法
path：/bmc/kepler/Systems/:SystemId/PowerMgmt/:ID
interface：bmc.kepler.Chassis.PowerSubsystem.Capacitor（新增）
| 属性/方法名称 | 变化类型 | 签名 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|
| PowerState | 新增属性 | s | R：ReadOnly | 不持久化 | true | 电容开关机状态，取值： * Off：电容关机 * On：电容开机 * N/A：未知状态，默认 |
属性仅适用于电容管理场景 |
| Reset | 新增方法 | 请求： s 响应： NA |
PowerMgmt | NA | NA | 复位电容： 请求： ResetType：复位类型（ForceOff、On） 响应：NA |
属性仅适用于电容管理场景 |
2、 cli接口新增设置电源能力状态方法
CLI命令：ipmcset -t maintenance -d psu -v <psu_slot> <feature> <state>
变化类型：新增命令字
操作类型：SET
操作权限：PowerMgmt
| 参数名称 | 取值类型 | 说明 | 是否必选 | 约束 |
|---|---|---|---|---|
| psu_slot | integer | 电源槽位号 | 是 | 1-最大电源个数 |
| feature | string | 功能类型 | 是 | 取值： capacitorstate：电容供电能力 |
| state | string | 功能使能状态 | 是 | 取值： enabled：启用电源功能 disabled：禁用电源功能 |
命令描述：
Set the power supply feature state
回显格式:
Usage: ipmcset -t maintenance -d psu -v <psu_slot> <feature> <state>
psu_slot:
Power supply slot number, the range is from 1 to 3
feature：
capacitorstate - The power supply capability of the capacitor
state:
enabled - Enable power supply feature
disabled - Disable power supply feature
电源不在位:
openBMC:/->ipmcset -t maintenance -d psu -v 1 capacitorstate enabled
Power supply 1 does not exist.
设置成功:
openBMC:/->ipmcset -t maintenance -d psu -v 1 capacitorstate enabled
Enable power supply 1 capacitor capability successfully.
设置失败:
openBMC:/->ipmcset -t maintenance -d psu -v 1 capacitorstate disabled
Disable power supply 1 capacitor capability failed.
五、评审结论
决策点1：资源协作接口新增设置电源电容开关机状态方法
结论：同意新增资源协作接口bmc.kepler.Chassis.PowerSubsystem.Capacitor以及如下属性和方法:
- PowerState，表示电容实际开关机状态，签名为s，只读，读权限：ReadOnly，发送变更通知事件，取值范围：“On”，“Off”
- Reset，用于控制电容开关机状态，请求签名为s（取值范围：“On”，“ForceOff”），无响应签名，权限：PowerMgmt
遗留问题
1、确认电容开关机类型
结论：当前电容开机时间为8s-10s，结合redfish标准，不符合ForceOn的立即的定义，修改开机类型为On
决策点2：cli接口新增设置电源能力状态方法
结论：同意新增如下cli命令
命令名称：ipmcset -t maintenance -d psu -v <psu_slot> <feature> <state>
命令用途：控制电源能力的开关状态
参数说明：
- psu_slot：integer类型，PSU槽位号
- feature： string类型，电源功能类型，取值范围：“capacitorstate”
- state：string类型，电源功能使能状态，取值范围：“enabled”，“disabled”
权限：PowerMgmt
遗留问题
1、确认电源超频能力对外的呈现名字
结论：围绕电容供电能力来命名，不体现电源的超频能力