背景
风扇电子标签需要被上层组件和北向接口获取,需要新增FruData模型及接口,FruData对照IPMI Fru规范实现,供上层组件和北向接口查询设置
关联ISSUE
暂无
整体方案
1、新增FruDatas模型及接口表示电子标签数据内容,包含电子标签机框域、单板域、产品域、系统域具体字段。
2、风扇模型下新增FruData接口,用于查询风扇电子标签具体信息
评审点
新增FruDatas模型
详细描述
评审点1:新增FruDatas模型
Path:/bmc/dev/Systems/:SystemId/FruDatas/:Id
Interfaces:
| 接口 | 说明 | 是否必选 | 等级定义 |
|---|---|---|---|
| bmc.dev.FrudataService.Frudata | 描述电子标签数据内容的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Board | 描述电子标签单板域数据内容的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Chassis | 描述电子标签机箱域数据内容的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Overview | 描述电子标签概要信息的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Product | 描述电子标签产品域信息的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.System | 描述电子标签系统域信息的接口 | 是 | L1 |
bmc.dev.FrudataService.Frudata接口
方法信息参考下表:
| 方法名 | 请求参数 | 类型 | 参数说明 | 响应 | 类型 | 响应说明 | 方法说明 |
|---|---|---|---|---|---|---|---|
| Update | PropertyName Value |
String[] String[] |
电子标签属性名数组 电子标签属性值数组 |
无 | 无 | 无 | 非标准电子标签更新设备树属性值接口 |
| SetSysProductName | FruId ProductName |
U8 String |
电子标签唯一标识FruId 产品名称 |
无 | 无 | 无 | 设置系统产品名称接口 |
| SetProductAssetTag | FruId AssetTag |
U8 String |
电子标签ID 资产标签 |
无 | 无 | 无 | 设置产品资产标签 |
bmc.dev.Systems.FruData.Board接口
属性信息参考下表:
| 属性名 | 类型 | 可读 | 描述 |
|---|---|---|---|
| MfgDate | String | 只读 | 生产日期 |
| BoardManufacturer | String | 只读 | 单板生产厂商 |
| BoardProductName | String | 只读 | 单板产品名称 |
| BoardSerialNumber | String | 只读 | 单板系列化编号 |
| BoardPartNumber | String | 只读 | 单板部件号 |
| BoardFRUFileID | String | 只读 | 单板FrufileID |
| BoardCustomInfo | String | 只读 | 单板扩展域 |
bmc.dev.Systems.FruData.Chassis接口
属性信息参考下表:
| 属性名 | 类型 | 可读 | 描述 |
|---|---|---|---|
| ChassisType | String | 只读 | 机箱类型 |
| ChassisPartNumber | String | 只读 | 机箱部件号 |
| ChassisSerialNumber | String | 只读 | 机箱序列号 |
| ChassisCustomInfo | String | 只读 | 机箱扩展域 |
bmc.dev.Systems.FruData.Overview接口
属性信息参考下表:
| 属性名 | 类型 | 可读 | 描述 |
|---|---|---|---|
| FruId | U8 | 只读 | 所在的Fru的Fruid |
| FruType | String | 只读 | 所在的Fru的类型 |
| FruName | String | 只读 | 所在的Fru的名称 |
| Health | U8 | 只读 | FRU存储介质健康状态,取值如下: 0:读取正常 1:读取异常 255:未知 |
bmc.dev.Systems.FruData.Product接口
属性信息参考下表:
| 属性名 | 类型 | 可读 | 描述 |
|---|---|---|---|
| ManufacturerName | String | 只读 | 产品域制造商 |
| ProductName | String | 只读 | 产品域产品名 |
| ProductPartNumber | String | 只读 | 产品域部件号 |
| ProductVersion | String | 只读 | 产品域版本号 |
| ProductSerialNumber | String | 只读 | 产品域序列号 |
| AssetTag | String | 只读 | 产品域资产标签 |
| ProductFRUFileID | String | 只读 | 产品域FRU文件ID |
| ProductCustomInfo | String | 只读 | 产品域定制信息 |
bmc.dev.Systems.FruData.System接口
属性信息参考下表:
| 属性名 | 类型 | 可读 | 描述 |
|---|---|---|---|
| SystemManufacturer | String | 只读 | 系统域制造商 |
| SystemProductName | String | 只读 | 系统域产品名称 |
| SystemVersion | String | 只读 | 系统版本 |
| SystemSerialNumber | String | 只读 | 系统域序列号 |
评审点2:风扇模型下新增FruData接口,用于查询风扇电子标签具体信息
Path:/bmc/dev/Chassis/:ChassisId/ThermalSubsystem/Fans/:FansId/:Id
Interfaces:
| 接口 | 说明 | 是否必选 | 等级定义 |
|---|---|---|---|
| bmc.dev.FrudataService.Frudata | 描述风扇电子标签数据内容的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Board | 描述风扇电子标签单板域数据内容的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Chassis | 描述风扇电子标签机箱域数据内容的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Overview | 描述风扇电子标签概要信息的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.Product | 描述风扇电子标签产品域信息的接口 | 是 | L1 |
| bmc.dev.Systems.FruData.System | 描述风扇电子标签系统域信息的接口 | 是 | L1 |
属性信息参考评审点1内附表
评审结论
1、
2、