【已评审】根据最新草案(2026-07-14)调整存储相关内容,整理差异和错误点

背景

《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 = RAID
1 = HBA
2 = JBOD
3 = 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。