变更声明
背景
受影响的版本
- openUBMC 25.03
- openUBMC 25.06
- openUBMC 25.09
- openUBMC 25.12
变更描述
规格变化
不涉及
外观变化
不涉及
外部接口变化
资源协作接口 bmc.kepler.Systems.NetworkPort 的属性 AutoSpeedNegotiation、FullDuplex 类型变更
变更前
- 属性类型：Boolean，对应 DBus 类型签名为
b
变更后
- 属性类型：U8，对应 Dbus 类型签名为
y
北向接口变化
说明： 由于上述资源协作接口的属性类型的变化，导致 openUBMC 的北向 Redfish/UIRest 接口也会进行变化适配。具体的变化说明如下：
redfish接口变化
- 接口：/redfish/v1/Systems/:systemid/EthernetInterfaces/:ethernetinterfaceid
- 变化：在获取不到对应网口自协商、全双工状态的情况下，变更前：属性展示 false；变更后：属性展示 null
UIRest接口变化
- 接口：/UI/Rest/System/NetworkAdapter/:adapterid/NetworkPorts/:portnum
- 变化：在获取不到对应网口自协商、全双工状态的情况下，变更前：属性展示 false；变更后：属性展示 null
web页面变化
- 页面：网络适配器页面的网口显示栏
- 变化：在获取不到对应网口自协商、全双工状态的情况下，变更前：显示为否；变更后：属性不显示
安装方式变化
不涉及
兼容性说明
-
BMC固件兼容性：当前变更仅涉及BMC的固件，跟周边组件不涉及兼容性
-
openUBMC 和 BMC SDK 兼容性：所有修改仅涉及openUBMC相关组件代码，不涉及SDK，与SDK相关组件不存在交互，不存在兼容性问题
-
BMC与上层网管的兼容性： BMC北向接口返回的数据类型无变化，不存在兼容性问题
文档影响
无
建议动作
1、排查redfish接口/redfish/v1/Systems/:systemid/EthernetInterfaces/:ethernetinterfaceid返回体里面的AutoNeg、FullDuplex是否直接用资源协作属性AutoSpeedNegotiation、FullDuplex赋值，若存在直接赋值的场景则需要写script或plugin将0/1/255处理后分别转化成false/true/null回显；
2、排查web接口/UI/Rest/System/NetworkAdapter/:adapterid/NetworkPorts/:portnum返回体里面的AutoNeg、FullDuplex是否直接用资源协作属性AutoSpeedNegotiation、FullDuplex赋值，若存在直接赋值的场景则需要写script或plugin写逻辑将0/1/255处理后分别转化成false//true/null回显；