SerDes 多模式配置解析与 openUBMC 适配指南

针对您在使用 openUBMC 适配 920 新机型基础板时遇到的 SerDes 多 M6 接口配置问题，本文将结合知识库中的信息提供全面解答。

疑惑背景分析

您的场景描述如下：

• 单个 CPU 下分出两个 M6 接口；
• 两个 M6 分别连接到不同的 UBC 端口；
• 存在 SerDes_1_6_A 配置实例，包含两个 ModeConfigs；
• 询问是否属于多模式配置，以及如何正确适配。

是否属于多模式配置？

是的，这种情况典型属于 SerDes 的“多模式配置”场景。

根据知识库中的文档《CSR配置字典之SerDes类》和 SerDes_1_6_A 的示例，ModeConfigs 正是用来支持多种运行模式的配置数组。一个 SerDes 对象可通过 WorkMode 控制切换其工作模式，从而选择不同的 Device 与 ControllerIndex 映射关系，以适应不同的硬件连接拓扑或功能需求。

SerDes 多模式工作机制详解

1. 核心属性说明

示例中：

"ModeConfigs": [
  { "Mode": 1, "Device": [16,16,17,...], "ControllerIndex": [2,2,...] },
  { "Mode": 4, "Device": [0,1,2,...],  "ControllerIndex": [0,0,...] }
]

表明：

• 当 WorkMode == 1 时，启用第一个模式，连接高端设备；
• 当 WorkMode == 4 时，启用第二个模式，连接低编号设备（如板载设备或扩展卡）。

2. ModeConfigs 与 WorkMode 如何协同？

• WorkMode 是运行时的“开关”，决定当前激活哪一组 ModeConfig；
• BMC 在系统启动或配置加载阶段读取该值，并据此配置 PCIe 拓扑；
• 不会同时激活多个 ModeConfig —— 每次仅一个 Mode 生效；
• 模式切换依赖外部控制（如 BIOS 设置、固件命令、硬件跳线等）。

注意：ModeConfigs 中的 Mode 字段必须与 WorkMode 的值匹配才能触发对应配置。

针对“两个 M6”接口的适配建议

基础板上的两个 M6 是否支持同时工作？

否，两个 M6 不会“同时”工作，而是代表两种不同物理连接可能性下的配置模式。

这正体现了 SerDes 的“多模式”设计初衷：

即：系统只能连接其中一个子板（M6A 或 M6B），通过设置 WorkMode 切换对应的拓扑配置，确保 PCIe 地址映射、控制器绑定正确。

类比：如同主板上有两组 PCIe 插槽，只能插一张卡，但 BIOS 支持识别不同类型并应用不同资源分配策略。

如何正确配置 ControllerIndex？

ControllerIndex 应依据以下原则设置：

1. 与 CPU 内部 PCIe 控制器对应；
   • 不同 ControllerIndex 对应 CPU 内不同 PCIe 核心；
   • 必须与硬件设计一致（参考芯片手册）；
2. 每个 ModeConfig 独立配置；
   • 不同模式可绑定到相同或不同的控制器；
   • 示例中 Mode 1 使用 ControllerIndex [2]，Mode 4 使用 [0]，表明连向不同控制器；
3. 与 PCIeAddrInfo 和 BDFConfig 保持一致；
   • Device 和 ControllerIndex 最终会参与生成 RootBDF；
   • 必须与 PCIeAddrInfo.PortId 及 BDFConfig 中的映射一致。

推荐实践：
在 PCIeAddrInfo 中定义时，确保 ControllerIndex 与 SerDes 配置相同，否则会导致业务拓扑建立失败。

配置建议与最佳实践（openUBMC 适配）

配置步骤总结

1. 确认硬件拓扑结构

   • 明确两个 M6 各自连接的目标设备（如 IEU_A / IEU_B）
   • 获取各链路的 Device 范围和对应控制器索引

2. 定义 SerDes 多模式配置

   "SerDes_1_6_A": {
     "Name": "SerDes_1_6_A",
     "ID": 6,
     "SocketID": 1,
     "LinkWidth": 8,
     "WorkMode": 1,
     "ModeConfigs": [
       {
         "Mode": 1,
         "Device": [16, 16, 17, 17, 18, 18, 19, 19],
         "ControllerIndex": [2, 2, 2, 2, 2, 2, 2, 2]
       },
       {
         "Mode": 4,
         "Device": [0, 1, 2, 3, 4, 5, 6, 7],
         "ControllerIndex": [0, 0, 0, 0, 0, 0, 0, 0]
       }
     ]
   }
   

3. 设置默认 WorkMode

   • 根据出厂默认连接方式设定初始 WorkMode（例如默认接 M6A，则设为 1）；
   • 支持运行时通过配置文件或 Redfish API 动态修改（需上层支持）；

4. 确保 ActualResourceOrder 一致性

   • 若涉及多个 SerDes 顺序（如 SerDes_1_10, SerDes_1_7 等），需在 BusinessConnector 中配置 ActualResourceOrder 与 Ports 对应（见文档 id=3）；

5. 弃用 PCIePorts/SASPorts

   • 文档明确指出：PCIePorts 和 SASPorts 已弃用；
   • 应优先使用 ModeConfigs 进行端口映射；

6. 验证与调试

   • 查看日志关键字：biz_topo, PCIe device discovery；
   • 故障排查方向：
     • 拓扑建立失败 → 检查 ModeConfigs 是否匹配；
     • 链路异常 → 检查 LinkWidth, SocketID；
     • 识别错误 → 检查 ControllerIndex 与 Device 是否一致。

相关文档推荐

结论总结

最佳实践总结：
使用 ModeConfigs 实现灵活拓扑适配，通过 WorkMode 实现“一卡多用”场景，充分契合 openUBMC 动态加载与自发现机制。

如需进一步验证配置，建议结合 BCU.sr、IEU.sr 文件中的 BusinessConnector 和 UnitConfiguration 设置进行端到端校验。

相关链接：

1. bingo build报错，任务 work.build.conan 执行失败
2. 咨询openUBMC是否同时支持两个调试网口
3. 【PSR】C5a和C4a有两种接法出现冲突导致卡不识别的问题
4. 【讨论】PCIe Switch场景下如何加载PCIe卡
5. CSR配置字典之SerDes类 | 文档中心 | openUBMC