背景
《T CESA 服务器南向接口技术要求 草案2025.12.23.doc》8.15存储设备相关接口中,属性类型、签名类型以及方法无法满足开发需求,需要补充调整。
关联ISSUE
整体方案
当前按照web端9560Raid卡实际操作内容,根据最新草案内容,整理差异和错误内容。
评审点1:变更资源协作接口 bmc.dev.Storage.Controller.Capability.DiskWriteCachePolicy
变更描述:取值 Eanbled 拼写错误,应为 Enabled。
变更属性描述
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
ConfigedDriveWCP |
String |
true |
false |
取值 "Eanbled" -> "Enabled" |
不持久化 |
无影响 |
||
变更 |
UnconfigedDriveWCP |
String |
true |
false |
取值 "Eanbled" -> "Enabled" |
不持久化 |
无影响 |
||
变更 |
HBADriveWCP |
String |
true |
false |
取值 "Eanbled" -> "Enabled" |
不持久化 |
无影响 |
评审点2:变更资源协作接口 bmc.dev.Storage.Controller.Capability.RAIDLevel
变更描述:Tripple 拼写错误(多 p),应为 Triple。
变更属性名称
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
RAID1TrippleSupported -> RAID1TripleSupported |
Boolean |
true |
false |
是否支持组建RAID1 Triple,仅PMC RAID卡涉及 |
不持久化 |
契约级拼写,需同步 mdb + 生成头文件 |
||
变更 |
RAID10TrippleSupported -> RAID10TripleSupported |
Boolean |
true |
false |
是否支持组建RAID10 Triple,仅PMC RAID卡涉及 |
不持久化 |
契约级拼写,需同步 mdb + 生成头文件 |
注:拼写错误。
评审点3:变更资源协作接口 bmc.dev.Storage.Controller.Settings
变更描述:SetMode 方法缺 ProfileId 参数。
变更方法签名类型
| 方法名称 | 请求签名 | 请求参数描述 | 响应签名 | 响应参数描述 | 方法描述 | 访问权限 |
|---|---|---|---|---|---|---|
SetMode |
y -> yy |
Mode: 工作模式0 = RAID1 = HBA2 = JBOD3 = Mixed+ ProfileId: 配置文件的ID, 取值为0 |
i |
成功:0;失败:错误码 |
设置控制器的工作模式 |
BasicSetting |
评审点4:变更资源协作接口 bmc.dev.Storage.Volume
变更描述:MaxResizableSize 类型标注错误,U8 应为 U32。
变更属性签名
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
MaxResizableSize |
y -> u |
true |
false |
逻辑盘最大可调整的容量 |
不持久化 |
无影响 |
注:
MaxResizableSize赋值来源为SML_LD_BASIC_INFO_S.max_resizeable_size(sml_public.h:161),字段类型guint32;生成头文件mc::engine::property<uint32_t> MaxResizableSize(Volume.h:36),赋值见 volume.cpp:42。结构体定义类型为guint32,草案标注U8错误,应为U32。
评审点5:变更资源协作接口 bmc.dev.Storage.Volume.Settings
变更描述:BGIEnable 类型标注错误,Boolean 应为 U8(需表示0xFF第三态,Boolean无法表示)。
变更属性签名
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
BGIEnable |
b -> y |
false |
false |
逻辑盘是否使能BGI |
不持久化 |
无影响 |
注:
BGIEnable赋值来源为SML_LD_BASIC_INFO_S.bgi_enabled(sml_public.h:154),字段类型guint8;生成头文件mc::engine::property<uint8_t> BGIEnable(Volume/Settings.h:26),赋值见 volume/settings.cpp:55。结构体定义类型为guint8,需表示0xFF第三态,Boolean无法表示,草案标注Boolean错误,应为U8。
变更方法名称
| 方法名称 | 请求签名 | 请求参数描述 | 响应签名 | 响应参数描述 | 方法描述 | 访问权限 |
|---|---|---|---|---|---|---|
SetBootPriorify-> SetBootPriority |
y |
BootPriority: 启动优先级0:非启动盘 1:主启动盘 2.次启动盘 |
i |
成功:0;失败:错误码 |
设置启动优先级 |
BasicSetting |
注:
SetBootPriorify为草案拼写错误,应为 /SetBootPriority。
评审点6:变更资源协作接口 bmc.dev.Storage.Drive.Metrics
变更描述:BlcoksSentToInitiator 属性名拼写错误;VendorPoh 类型标注错误。
变更属性名称
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
BlcoksSentToInitiator -> BlocksSentToInitiator |
u |
true |
false |
SAS硬盘发送到启动器的块数 |
不持久化 |
无影响 |
注:拼写错误。
变更属性签名
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
VendorPoh |
y -> u |
true |
false |
厂商自定义Smart信息:累计上电时长 |
不持久化 |
无影响 |
注:
VendorPoh赋值来源为EST_LFSP_VENDOR_S.power_on_hours(sml_physical_drive.h),字段类型guint32;生成头文件mc::engine::property<uint32_t> VendorPoh(Drive/Metrics.h:45),赋值见 drive/metrics.cpp:60。结构体定义类型为guint32,草案标注U8错误,应为U32。
评审点7:变更资源协作接口 bmc.dev.Storage.Drive.Settings
变更描述:BootPrority 属性名与 SetBootPrority 方法名拼写错误(少字母 i)。
变更属性名称
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
变更 |
BootPrority -> BootPriority |
y |
true |
false |
物理盘启动优先级 |
不持久化 |
无影响 |
变更方法名称
| 方法名称 | 请求签名 | 请求参数描述 | 响应签名 | 响应参数描述 | 方法描述 | 访问权限 |
|---|---|---|---|---|---|---|
SetBootPrority -> SetBootPriority |
y |
BootPriority: 启动优先级 |
i |
成功:0;失败:错误码 |
设置启动优先级 |
BasicSetting |
注:
BootPrority/SetBootPrority为草案拼写错误(少字母i),应为BootPriority/SetBootPriority。