背景
当前能效智能调速算法涉及使用机器学习相关算法,而算法所需要的训练数据内置在BMC中无法进行修改,为满足不同客户的诉求,需提供替换和恢复训练数据的能力。
关联ISSUE
评审点
- webrest新增GET接口:/UI/Rest/System/Thermal/AlgorithmsEngine,展示当前能效智能调速算法配置生效列表
- webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.Import,用于能效智能调速算法相关配置导入
- webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults,恢复指定算法对应配置的默认值
详细描述
评审点1:webrest新增uri,/UI/Rest/System/Thermal/AlgorithmsEngine,展示当前能效智能调速算法配置生效列表
资源URI:/UI/Rest/System/Thermal/AlgorithmsEngine
变化类型:新增uri
操作类型:GET
操作权限:ReadOnly
应用场景:展示当前能效智能调速算法配置生效列表
响应参数:
| 属性名称 | 取值类型 | 说明 | 取值范围 | 默认值 | 是否允许为null | 约束 |
|---|---|---|---|---|---|---|
| AlgorithmsList | array | 当前能效智能调速算法配置生效列表 | 具体见下表 | 空表 | 否 | 无 |
AlgorithmsList对象参数说明如下:
| 属性名称 | 取值类型 | 说明 | 取值范围 | 默认值 | 是否允许为null | 约束 |
|---|---|---|---|---|---|---|
| AlgorithmType | string | 智能调速算法类型 | 枚举值: MPC 模型预测控制算法 | 无 | 否 | 该字段需要根据AlgorithmsList显示,例如:AlgorithmsList默认返回空表,该字段不显示 |
| AlgorithmStatus | string | 智能调速算法当前状态 | 枚举值: MPC算法状态取值范围: Disabled:功能已关闭 Initialized:功能已完成初始化 Training:模型正在训练 Available:模型可用 Unavailable:模型不可用 |
无 | 否 | 该字段需要根据AlgorithmType显示,表示对应算法的工作状态 |
| CustomConfigurations | object | 对应算法类型的配置生效状态对象 | / | / | 否 | 无 |
CustomConfigurations对象参数说明如下:
该资源由业务逻辑处理后进行返回,当前仅返回TrainSet
| 属性名称 | 取值类型 | 说明 | 取值范围 | 默认值 | 是否允许为null | 约束 |
|---|---|---|---|---|---|---|
| TrainSet | string | MPC 导入自定义训练数据生效状态 | 枚举值: Default 未导入用户训练集,使用默认值 Pending 用户训练集待生效 Effective用户训练集已生效 |
无 | 是 | 该字段需要根据算法类型显示,如果后续增加其他算法不支持该配置,则为null |
评审点2:webrest新增POST接口/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.Import,用于能效智能调速算法相关配置导入
资源URI:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.Import
变化类型:新增uri
操作类型:POST
操作权限:BasicSetting
应用场景:用于能效智能调速算法相关配置导入
输入参数:
| 参数名 | 类型 | 必填 | 示例/取值约束 | 描述 |
|---|---|---|---|---|
| ReauthKey | string | 是 | 字符串长度:[1, 128] | Web公钥加密后的密文 |
| AlgorithmType | string | 是 | 枚举值: MPC 模型预测控制算法 | 导入的算法类型 |
| ConfigType | string | 是 | 枚举值:TrainSet 模型训练数据 | 导入的配置类型 |
| ConfigURI | string | 是 | 1. 本地导入:配置文件首先通过 https://device_ip/UI/Rest/FirmwareInventory接口上传至/tmp/web 2. 远程导入:“文件传输协议://用户名:密码@ip地址/目录/文件名”,文件传输协议包括五种:sftp、https、nfs、cifs、scp 注:导入TrainSet 训练集, 导入文件必须为csv格式, 所有训练数据必须一次性导入,训练数据打包为 单个 ZIP 压缩包,示例:“xxx.zip” |
导入配置文件路径 |
评审点3:webrest新增POST接口/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults,恢复指定算法对应配置的默认值
资源URI:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults
变化类型:新增uri
操作类型:POST
操作权限:BasicSetting
应用场景:用于能效智能调速算法相关配置恢复默认值
输入参数:
| 参数名 | 类型 | 必填 | 示例/取值约束 | 描述 |
|---|---|---|---|---|
| ReauthKey | string | 是 | 字符串长度:[1, 128] | Web公钥加密后的密文 |
| AlgorithmType | string | 是 | 枚举值: MPC 模型预测控制算法 | 恢复默认值的算法类型 |
| ResetType | string | 是 | 枚举值: ResetAll 恢复所有配置到默认值 |
恢复默认值的配置类型 |
评审结论
- 同意新增webrest新增GET接口:/UI/Rest/System/Thermal/AlgorithmsEngine,展示当前能效智能调速算法配置生效列表
- 同意新增webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.Import,用于能效智能调速算法相关配置导入
- 同意新增webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults,恢复指定算法对应配置的默认值
遗留问题
1、为什么不考虑备件更换后配置恢复?
结论:
1)MPC的模型配置文件存放在BMC的数据区,AC掉电和恢复出厂设置都不会删除文件;
2)MPC算法主要关注CPU的温度,其余的硬件更换对于MPC算法的影响不大;
3)MPC算法具有自检测精度能力,如果检测到预测精度不足时,会触发在线重训练功能,保证MPC算法的可靠性;