背景
支持电源 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:用于配置调节的目标输出电压。
上述成员共同支撑电源输出电压调节新特性。
评审点
-
bmc.dev.PowerSupply.Control 新增开机延时属性 PowerOnDelaySeconds与方法SetPowerOnDelaySeconds
-
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、超范围一律拒绝 |