背景
新机型NPU虚拟网卡的网口和光模块在数量和连接关系等方面和旧机型存在较大差异，原有北向接口无法完全满足新的相关信息显示，需要对已有接口展示效果进行优化
关联ISSUE
整体方案
新增北向接口
评审点
1、web光模块通道和网口通道的关联关系增加图示
2、web网口增加关联处理器端口号和端口的DieId归属
3、web光模块页签新增位置信息
4、redfish光模块资源新增位置信息
详细描述
评审点1：光模块通道和网口通道的关联关系增加图示
web界面
webrest 接口
webrest 接口 /UI/Rest/System/NetworkAdapter/:adapterid/PortMappings
变化类型：新增属性
操作类型：GET
应用场景：获取该网卡下的所有光模块通道和网口通道的关联关系
属性列表：
| 一级属性 | 二级属性 | 三级属性 | 四级属性 | 类型 | 示例/默认值/取值约束 | 描述 |
|---|---|---|---|---|---|---|
| PortMappings | / | / | / | Arrays | 网口的关联关系 | |
| PortId | / | / | 数字 | 1 | 网口Id | |
| LaneMap | / | / | Arrays | / | 此网口的通道关联关系 | |
| PortLaneId | / | 数字 | 1 | 网口通道Id | ||
| Transceiver | / | Arrays | / | 该网口通道关联的光模块 | ||
| SilkText | 字符串 | “OSFP-2” | 光模块丝印 | |||
| Id | 数字 | 1 | 光模块Id | |||
| LaneId | 数字 | 7 | 光模块通道Id |
响应示例：
{
"PortMappings": [
{
"PortId": 1,
"LaneMap": [
{
"PortLaneId": 1,
"Transceiver": {
"SilkText": "OSFP-2"
"LaneId": 7,
"Id": "1"
}
},
{
"PortLaneId": 2,
"Transceiver": {
"SilkText": "OSFP-2"
"LaneId": 8,
"Id": "1"
}
}
]
},
{
"PortId": 2
"LaneMap": [
{
"PortLaneId": 1,
"Transceiver": {
"SilkText": "OSFP-3"
"LaneId": 7,
"Id": "2"
}
},
{
"PortLaneId": 2,
"Transceiver": {
"SilkText": "OSFP-3"
"LaneId": 8,
"Id": "2"
}
}
]
}
]
}
评审点2：网口增加关联处理器端口号和端口的DieId归属
web界面
webrest 接口
不涉及
评审点3：光模块页签新增位置信息
web界面
webrest 接口
URL：/UI/Rest/System/NetworkAdapter/:adapterid/Transceivers/:id
变化类型：新增属性
操作类型：GET
应用场景：获取光模块的丝印信息
属性列表：
| 属性 | 类型 | 示例/默认值/取值约束 | 描述 |
|---|---|---|---|
| SilkText | 字符串 | “PIC-11” | 光模块丝印信息 |
响应示例：
{
"SilkText": "PIC-11"
}
评审点4：光模块资源新增属性
资源URI：/redfish/v1/Chassis/:chassisid/Transceivers/OpticalModule_:opticalid
资源版本：HwTransceiver.v1_0_0
属性列表：
| 一级属性 | 二级属性 | 三级属性 | 类型 | 示例/默认值/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|---|---|
| Location | / | / | / | / | / | / | / | / | 位置信息 |
| PartLocation | / | Arrays | / | / | / | / | / | 资源在封闭装置内的部件位置 | |
| ServiceLabel | 字符串 | “PIC-8 ETH1” | true | 否 | / | ReadOnly | 部件位置的标签 | ||
| LocationType | 字符串 | “Connector” | true | 否 | / | ReadOnly | 部件位置的类型 | ||
| LocationOrdinalValue | 数字 | 1 | true | 否 | / | ReadOnly | 部件位置的序号 | ||
| PartLocationContext | / | 字符串 | “NPU BOX 2” | true | 否 | / | ReadOnly | 部件位置上下文，用于区分同一外壳内不同零件的PartLocation值，其中可能包含该零件所包含的PartLocation值的层级信息 |
Schema定义：
{
"HwTransceiver": {
"properties": {
"Location": {
"$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Location"
}
}
}
}
评审结论
1、同意新增webrest接口 /UI/Rest/System/NetworkAdapter/:adapterid/PortMappings 用于展示光模块通道和网口通道的关联关系，并在网卡界面增加关联图示。显示效果及接口定义详见评审点1
2、同意网口界面增加关联处理器端口号和端口的DieId归属。显示效果见评审点2
3、同意webrest接口 /UI/Rest/System/NetworkAdapter/:adapterid/Transceivers/:id 新增属性 SilkText，并在光模块界面新增位置展示该属性。显示效果见评审点3
4、同意新增如下标准属性用于展示光模块位置信息
资源URL：/redfish/v1/Chassis/:chassisid/Transceivers/OpticalModule_:opticalid
资源版本：HwTransceiver.v1_0_0
变化类型：新增标准Location属性，属性说明详见评审点4
遗留问题
1、光模块页签下的丝印信息展示需要明确中文名称
结论：与其他页签保持一致，调整为位置