背景
issue:暂无
新适配一款DPU卡, Host BMC通过CEM规范金手指上的标准SMBUS总线可以访问DPU网卡的I2C设备,Host可以看到多个I2C设备,CPLD,BMC和FRU。CPLD,BMC和FRU中各提供一组可以访问的寄存器,主机可以通过寄存器获取单板的基本物理信息,网卡的CPU启动状态,单板的功耗、温度、告警等监控信息
对于CPLD寄存器,规划部分地址为厂商标准寄存器,部分地址为厂商自定义寄存器,可进行功能拓展
决策点(必填,一句话描述待决策点)
bmc.kepler.Systems.DPUCard下,新增属性CPLDRegisterVersion、BOM、BMCVersion、UartControlStatus
bmc.kepler.Systems.DPUCard.System下,新增属性UEFIVersion
bmc.kepler.Systems.DPUCard.Processor下,新增属性IMUVersion
用于北向接口定制化回显和带外管理功能适配使用
详细描述(必填,描述待评审接口的详细内容)
决策点
在interface : bmc.kepler.Systems.DPUCard下,新增属性CPLDRegisterVersion、BOM、BMCVersion、NCSIUartDestination
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| CPLDRegisterVersion | as | 空字符串数组 | 只读。R: ReadOnly | CPLD协议版本,卡的CPLD新增功能时会更新该版本号 | 否 | 否 | |
| BOM | s | “” | 只读。R: ReadOnly | Bom版本信息 | 否 | 否 | |
| BMCVersion | s | “” | 只读。R: ReadOnly | BMC固件版本号 | 否 | 否 | |
| NCSIUartDestination | y | 255 | 读写。R:ReadOnly、W:BasicSetting | NCSI串口状态 0 – NCSI选通SCP串口 1 – NCSI选通IMU串口 2 – NCSI选通处理器串口 3 – NCSI串口关闭 | 否 | 否 |
在interface : bmc.kepler.Systems.DPUCard.System下,新增属性UEFIVersion
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| UEFIVersion | s | “” | 只读。R: ReadOnly | UEFI固件版本号 | 否 | 否 |
在interface : bmc.kepler.Systems.DPUCard.Processor下,新增属性IMUVersion
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| IMUVersion | s | “” | 只读。R: ReadOnly | IMU固件版本号 | 否 | 否 |
评审结论
1、同意在interface : bmc.kepler.Systems.DPUCard下,新增属性BOM和CPLDProtocolVersion
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| CPLDProtocolVersion | as | 空字符串数组 | 只读,R: ReadOnly | CPLD协议版本,卡的CPLD新增功能时会更新该版本号 | 否 | 否 | |
| BOM | s | “” | 只读,R: ReadOnly | Bom信息 | 否 | 否 |
2、同意在interface : bmc.kepler.Systems.DPUCard.Processor下,新增属性IMUVersion
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| IMUVersion | s | “” | 只读,R: ReadOnly | IMU固件版本号 | 否 | 否 |
3、同意新增如下新接口及其属性和方法用于DPU侧BMC版本、串口管理:
资源协作对象(已有):DPUCard
path(已有):/bmc/kepler/Systems/${SystemId}/PCIeDevices/PCIeCards/DPUCards/${Id}
新增interface:bmc.kepler.Systems.DPUCard.Manager
新增属性:FirmwareVersion、ManagerType,具体如下
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| FirmwareVersion | s | ““ | 只读,R: ReadOnly | Manager的固件版本号 | 否 | 否 | |
| ManagerType | s | ““ | 只读,R:ReadOnly | Manager的类型,例如BMC | 否 | 否 |
新增interface:bmc.kepler.Systems.DPUCard.Manager.SOL
新增属性:Enabled、SerialDirection,具体如下
| 属性名称 | 签名 | 默认值 | 操作权限 | 说明 | 持久化 | 变化通知 | 备注 |
|---|---|---|---|---|---|---|---|
| SerialDirection | y | 0 | 只读,R: ReadOnly | 串口连接方向,0:串口关闭 1:串口连接到管理控制单元,如IMU、MCP ; 2:串口连接到系统控制单元,如SCP;3:串口连接到计算处理单元,如AP | 否 | 否 | MCP(Manageability Control Processor);SCP(System Control Processor) ;AP(Application Processor) |
| Enabled | b | true | 只读,R: ReadOnly | 使能状态:true,使能;false,未使能 | 否 | 否 |
新增方法: SetSerialDirection,具体如下
| 项目 | 说明 |
|---|---|
| 方法名 | SetSerialDirection |
| 方法描述 | 设置串口方向 |
| 权限 | Basicsetting |
| 请求签名 | y |
| 请求说明 | SerialDirection:待设置的串口方向,0:串口关闭 1:串口连接到管理控制单元,如IMU、MCP ; 2:串口连接到系统控制单元,如SCP;3:串口连接到计算处理单元,如AP |
| 响应签名 | 无 |
| 响应说明 | 无 |
遗留问题
1、CPLDRegisterVersion需改名,可体现为“协议版本”
结论:改名为CPLDProtocolVersion
2、BMCVersion建议复用Manager模型、NCSIUartDestination建议复用串口管理模型
结论:参考DPU卡现有的接口,增加对应的Manager以及SOL接口

