【已评审】新增Circuit资源协作接口

背景

新需求:支持新增redfish标准Circuit资源
当前差距:
支持查询redfish资源Circuit下的CircuitType、PhaseWiringType、NominalVoltage、Status字段,当前没有支持这些字段的接口,需要新增对应的资源协作接口;

关联ISSUE

[需求]: 支持新增redfish标准Circuit资源 - openUBMC/rackmount - GitCode

评审点

1、新增路径/bmc/kepler/PowerEquipment/PowerDistributions/:PowerDistributionId/Circuits/:CircuitId,新增资源协作接口bmc.kepler.PowerEquipment.Circuit,在该接口下新增属性Id、CircuitType、PhaseWiringType、NominalVoltage、InputVoltageStatus

详细描述

评审点1、新增路径/bmc/kepler/PowerEquipment/PowerDistributions/:PowerDistributionId/Circuits/:CircuitId,新增资源协作接口bmc.kepler.PowerEquipment.Circuit,在该接口下新增属性Id、CircuitType、PhaseWiringType、NominalVoltage、InputVoltageStatus

资源path(新增):/bmc/kepler/PowerEquipment/PowerDistributions/:PowerDistributionId/Circuits/:CircuitId
资源interface(新增):bmc.kepler.PowerEquipment.Circuit
新增属性:Id 、CircuitType、PhaseWiringType、NominalVoltage、InputVoltageStatus

属性名称 变化类型 签名 访问权限 持久化 变化通知 属性值来源 说明 约束
Id 新增属性 y 只读,读:ReadOnly 不持久化 false CSR 电路Id,默认值为0
CircuitType 新增属性 s 只读,读:ReadOnly 不持久化 false CSR 电路类型,取值范围:[“Branch”,“Bus”,“Feeder”,“Mains”,“Subfeed”,“”],默认值为""
PhaseWiringType 新增属性 s 只读,读:ReadOnly 不持久化 false 软件刷新 电路的相线类型,表示未接地的载流导体(相)的数量以及导线(线)的总数,取值范围:[“OneOrTwoPhase3Wire”, “OnePhase3Wire”, “ThreePhase4Wire”, “ThreePhase5Wire”, “TwoPhase3Wire”, “TwoPhase4Wire”, “”],默认值为""
NominalVoltage 新增属性 s 只读,读:ReadOnly 不持久化 true 软件刷新 电路的额定电压,取值范围:[“AC100To127V”, “AC100To240V”, “AC100To277V”, “AC120V”, “AC200To240V”, “AC200To277V”, “AC208V”, “AC230V”, “AC240AndDC380V”, “AC240V”, “AC277AndDC380V”, “AC277V”, “AC400V”, “AC480V”, “DC12V”, “DC16V”, “DC1_8V”, “DC240V”, “DC380V”, “DC3_3V”, “DC48V”, “DC5V”, “DC9V”, “DCNeg48V”, “”],默认值为""
InputVoltageStatus 新增属性 y 只读,读:ReadOnly 不持久化 true 软件刷新 电路的输入状态,0:输入正常, 1:输入过压 ,2:输入欠压 ,3:输入掉电 ,255:未知状态,默认值为255

评审结论

通过,同意新增路径/bmc/kepler/PowerEquipment/PowerDistributions/:PowerDistributionId/Circuits/:CircuitId,新增资源协作接口bmc.kepler.PowerEquipment.Circuit,在该接口下新增属性Id、CircuitType、PhaseWiringType、NominalVoltage、InputVoltageStatus,依次表示电路Id、电路的相线类型、电路的额定电压、电路的输入状态(参见评审点描述)

遗留问题

【预审】

  1. path 中的 PowerDistribution 是一个集合资源,建议变更为:PowerDistributions
  2. Circuit 是一个通用接口,对于各种 Distribution 以及其他方式的电路资源均可用,对于不同的电路对象可以使用 Id 和 CircuitType 属性进行区分即可。资源协作接口不需要增加 PowerDistribution,建议变更为 bmc.kepler.PowerEquipment.Circuit

@luchen @wwwhhh @zhangfuhai 请参考

已按预审意见修改