背景
1.BMC需要获取光模块的通道信息以及通道号
2.BMC需要适配灵渠的升级功能
关联ISSUE
暂无
整体方案
1.redfish光模块资源 /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/Metrics 新增部分光模块通道参数
2.redfish光模块资源 /redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{DeviceId}/UpdateService/Actions/UpdateService.SimpleUpdate 新增固件升级参数
评审点
-
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/Metrics资源新增属性：Transceivers 下新增 ByLane 数组结构及 LaneId 属性，支持多通道光模块的逐通道指标上报 -
/redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{DeviceId}/UpdateService/Actions/UpdateService.SimpleUpdate资源新增 Action 入参：SimpleUpdate Action 新增 ActiveMode 可选参数，支持指定升级生效模式
详细描述
评审点1：PortMetrics 资源新增属性
资源URI：/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/Metrics
资源版本：PortMetrics.v1_9_0
操作类型：GET
属性列表：
注1：列表内属性默认均支持 GET 操作。
注2：若属性在 Schema 中未显式定义 readonly 关键字，则默认为只读。
| 属性名 | 类型 | 示例/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
Transceivers |
array |
/ |
/ |
/ |
/ |
/ |
光模块收发器指标数组。 |
RXInputPowerMilliWatts |
[number, null] |
minimum: 0，单位：mW，值不可用返回null |
true |
是 |
/ |
ReadOnly |
接收光功率（聚合值，跨所有通道） |
TXOutputPowerMilliWatts |
[number, null] |
minimum: 0，单位：mW，值不可用返回null |
true |
是 |
/ |
ReadOnly |
发射光功率（聚合值，跨所有通道） |
TXBiasCurrentMilliAmps |
[number, null] |
minimum: 0，单位：mA，值不可用返回null |
true |
是 |
/ |
ReadOnly |
偏置电流（聚合值，跨所有通道） |
SupplyVoltage |
[number, null] |
单位：V，值不可用返回null |
true |
否 |
/ |
ReadOnly |
光模块供电电压 |
WavelengthNanometers |
[string, null] |
单位：nm，值不可用返回null |
true |
否 |
/ |
ReadOnly |
光模块激光波长 |
ByLane |
array |
/ |
/ |
/ |
/ |
/ |
**新增**，按通道维度的指标数组，每个元素代表一个通道 |
LaneId |
[integer, null] |
minimum: 0 |
true |
否 |
/ |
ReadOnly |
**新增**，通道号 |
RXInputPowerMilliWatts |
[number, null] |
minimum: 0，单位：mW |
true |
是 |
/ |
ReadOnly |
该通道的接收光功率 |
TXOutputPowerMilliWatts |
[number, null] |
minimum: 0，单位：mW |
true |
是 |
/ |
ReadOnly |
该通道的发射光功率 |
TXBiasCurrentMilliAmps |
[number, null] |
minimum: 0，单位：mA |
true |
是 |
/ |
ReadOnly |
该通道的偏置电流 |
{
"Transceivers": {
"WavelengthNanometers": null,
"SupplyVoltage": null,
"ByLane": [
{
"LaneId": 0,
"RXInputPowerMilliWatts": null,
"TXOutputPowerMilliWatts": null,
"TXBiasCurrentMilliAmps": null
}
]
}
}
评审点2：LCN UpdateService 资源新增 Action 入参
资源URI：/redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{DeviceId}/UpdateService/Actions/UpdateService.SimpleUpdate
资源版本：LCNUpdateService.v1_0_0
操作权限：BasicSetting
操作类型：POST
变更描述：LCN 交换设备升级接口 SimpleUpdate Action 新增 ActiveMode 可选入参，用于指定升级生效模式（立即生效或默认模式），使升级操作支持更灵活的生效策略。
输入参数：
| 参数名 | 类型 | 必填 | 示例/取值约束 | 描述 |
|---|---|---|---|---|
ImageURI |
string |
是 |
升级包文件路径 |
升级包文件路径（已有参数） |
ImageType |
string |
是 |
枚举值：UpdatePackage、PatchPackage |
升级包文件类型，UpdatePackage 为系统软件包，PatchPackage 为补丁包（已有参数） |
ActiveMode |
string |
否 |
枚举值：Immediately、NoAction |
**新增**，生效模式。不传时为默认模式（升级后需手动激活），传 Immediately 时为立即生效模式 |
ActionInfo：/redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{DeviceId}/UpdateService/SimpleUpdateActionInfo
SimpleUpdateActionInfo 的 Parameters 数组需新增 ActiveMode 条目：
| Name | Required | DataType | AllowableValues |
|---|---|---|---|
ActiveMode |
false |
String |
["Immediately","NoAction"] |
对应资源协作接口变更
接口：bmc.kepler.LCN.UpdateService
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 易变属性 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | ActiveMode | s | False | false | 生效模式，支持 Immediately 和默认模式 | Write: BasicSetting | ReqBody | 不持久化 | false |
是否准备好AI预审
是