【已评审】新增web接口支持能效调速算法的可替换性

背景

当前能效智能调速算法涉及使用机器学习相关算法,而算法所需要的训练数据内置在BMC中无法进行修改,为满足不同客户的诉求,需提供替换和恢复训练数据的能力。

关联ISSUE

新增web接口支持能效调速算法的可替换性

评审点

  1. webrest新增GET接口:/UI/Rest/System/Thermal/AlgorithmsEngine,展示当前能效智能调速算法配置生效列表
  2. webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.Import,用于能效智能调速算法相关配置导入
  3. 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 恢复所有配置到默认值
恢复默认值的配置类型

评审结论

  1. 同意新增webrest新增GET接口:/UI/Rest/System/Thermal/AlgorithmsEngine,展示当前能效智能调速算法配置生效列表
  2. 同意新增webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.Import,用于能效智能调速算法相关配置导入
  3. 同意新增webrest新增POST接口:/UI/Rest/System/Thermal/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults,恢复指定算法对应配置的默认值

遗留问题

1、为什么不考虑备件更换后配置恢复?
结论:
1)MPC的模型配置文件存放在BMC的数据区,AC掉电和恢复出厂设置都不会删除文件;
2)MPC算法主要关注CPU的温度,其余的硬件更换对于MPC算法的影响不大;
3)MPC算法具有自检测精度能力,如果检测到预测精度不足时,会触发在线重训练功能,保证MPC算法的可靠性;