【待评审】电源新增ac下电相关属性和方法及调压功能相关属性和方法

背景

支持电源 AC 复位的新特性,需要配置电源 AC 下电后的自动上电延时,使电源在下电后按配置的时间自动恢复上电。
支持电源输出电压调节的新特性,需要能够开启/关闭电源输出电压调节,并配置调节的目标输出电压。

关联ISSUE

[需求]: csr2.0支持IPMI命令执行电源AC操作-power_mgmt-AtomGit
[需求]: CSR2.0支持新增电源调压接口-power_mgmt-AtomGit

整体方案

1.电源部件在设备树资源协作接口 bmc.dev.PowerSupply.Control 下新增以下成员:

属性PowerOnDelaySeconds:用于表示电源 AC 下电后自动上电的延时时间;
方法SetPowerOnDelaySeconds:用于配置该延时时间。

上述成员共同支撑电源 AC 复位新特性。

2.电源部件在设备树资源协作接口 bmc.dev.PowerSupply.Control 下新增以下成员:

属性OutputVoltageAdjustmentEnabled:用于表示电源输出电压调节的使能状态;
属性TargetOutputVoltage:用于表示调节的目标输出电压;
方法SetOutputVoltageAdjustmentEnabled:用于开启/关闭电源输出电压调节;
方法SetTargetOutputVoltage:用于配置调节的目标输出电压。

上述成员共同支撑电源输出电压调节新特性。

评审点

  1. bmc.dev.PowerSupply.Control 新增开机延时属性 PowerOnDelaySeconds与方法SetPowerOnDelaySeconds

  2. bmc.dev.PowerSupply.Control 新增调压属性 OutputVoltageAdjustmentEnabled、TargetOutputVoltage 与方法SetOutputVoltageAdjustmentEnabled、SetTargetOutputVoltage

详细描述

评审点1:bmc.dev.PowerSupply.Control 新增开机延时属性与方法(AC 下电)

变化描述:新增属性`PowerOnDelaySeconds`与方法`SetPowerOnDelaySeconds`,承载电源模块开机延时配置,实现 AC 下电后按配置延时自动上电

接口链接:bmc.dev.PowerSupply.Control

应用场景:定制 IPMI Set AC Mode(0x3e/0x25)配置 AC 下电后自动上电延时,配合Reset(“PowerCycle”)(向 OPERATION 写 OFF)完成 AC 下电;上电时刻由 PMBus 0xC0 低字节的延时决定

属性列表

变更类型 属性名称 签名 只读 变化通知 属性描述 取值举例 作用 访问权限 属性来源 持久化类型 变更影响
新增 PowerOnDelaySeconds u True true 电源模块开机延时时间,AC 下电后按该延时自动上电,单位秒;默认值 0,取值范围 0~255 0(上电不等待)
15(15 秒后上电)
255(最大延时)
决定 AC 下电后电源自动上电的等待时间 Read: ReadOnly PMBus 寄存器 0xC0 低字节(驱动回读) 不持久化 无影响

方法列表

变更类型 方法名 参数 类型 参数说明 取值举例 作用 响应 类型 响应说明 方法说明
新增 SetPowerOnDelaySeconds PowerOnDelaySeconds U32 电源模块开机延时时间,单位秒
取值 0~255
0(上电不等待)
15(15 秒后上电)
255(最大延时)
配置 AC 下电后自动上电延时 无 无 无,
失败时抛错给上层
写 PMBus 0xC0 低字节,高字节保持不变;参数大于 255 抛参数错误;底层写失败抛执行失败

评审点2:bmc.dev.PowerSupply.Control 新增调压属性与方法(输出电压调节)

变化描述:新增属性OutputVoltageAdjustmentEnabled、TargetOutputVoltage与方法SetOutputVoltageAdjustmentEnabled、SetTargetOutputVoltage,承载电源模块输出电压调节使能与目标电压配置

接口链接:bmc.dev.PowerSupply.Control

应用场景:上层(Redfish/运维)按需开启电源输出电压调节并配置目标电压;关闭调压或配置非法值时拒绝设置

属性列表

变更类型 属性名称 签名 只读 变化通知 属性描述 取值举例 作用 访问权限 属性来源 持久化类型 变更影响
新增 OutputVoltageAdjustmentEnabled b True true 电源模块输出电压调节使能状态,默认值 false true(开启调压)
false(关闭调压)
控制是否允许调节电源输出电压 Read: ReadOnly PMBus 寄存器 0xCE SF4 bit7(驱动回读) 不持久化 无影响
新增 TargetOutputVoltage d True true 电源模块目标输出电压,单位 V;默认值 0,取值为大于 0 的有限值且不超过电源能力,两位小数展示,实际步进由 0x20 的 linear16 指数决定,以回读值为准 12(12.00V)
12.1(12.10V)
11.95(11.95V)
指定电源输出电压调节的目标值 Read: ReadOnly PMBus 寄存器 0x21(驱动回读) 不持久化 无影响

方法列表

变更类型 方法名 参数 类型 参数说明 取值举例 作用 响应 类型 响应说明 方法说明
新增 SetOutputVoltageAdjustmentEnabled Enabled Boolean 调压使能
true-开启
false-关闭
true(开启调压)
false(关闭调压)
开启或关闭电源输出电压调节能力 无 无 无,
失败时抛错给上层
设置电源模块输出电压调节使能;PMBus 0xCE SF4 bit7 读-改-写,保留其余位(含深休眠、N+R 等)
新增 SetTargetOutputVoltage Voltage Double 目标输出电压,单位 V
取值为大于 0 的有限值且不超过电源能力
12.1(12.10V)
12(12.00V)
11.95(11.95V)
设置电源输出电压调节的目标值 无 无 无,
失败时抛错给上层
设置电源模块目标输出电压;按 0x20 的 VOUT_MODE 指数做 linear16 编码(尾数 = round(电压 × 2^-指数))写 0x21;调压关闭时拒绝设置;12.05V(备机电压)、非有限值、≤0、超范围一律拒绝

评审结论