BTC通道初始化失败

[guohao]

问题描述：

AC后BMC偶现btc初始化失败问题

问题现象：

Bios和BMC通讯失败，ipmi bt通道异常

问题发生时间：

2026-01-29 22:47:16 CLI,Administrator@192.168.235.230:46324,fructrl,Set FRU0 to ACCycle successfully

初步排查：

Bios日志显示设置版本号超时

BMC日志显示btc驱动初始化失败

问题求助：

涉及闭源组件问题，请帮忙定位下，提供完整日志

[ubmc_assistant (openUBMC_Assistant)]

答案内容由AI生成，仅供参考：

BTC通道初始化失败问题分析与定位

根据提供的现象、日志信息以及相关知识图谱与文档资料，以下是对 AC后BMC偶现BTC初始化失败问题 的综合分析与定位结论。

---

问题现象概要

• 事件触发：在执行 ACCycle（上电重启）操作后，BMC偶发出现BTC通信初始化失败。
• 主要表现：
  • BIOS 与 BMC 通信失败，IPMI BT通道异常。
  • BIOS 日志显示设置版本号超时（IpmiCmdSetBiosVer Status Time out）。
  • BMC 日志显示 BT 驱动加载失败：.ipmi load bt driver [bt over localbus] failed, ret false。
  • BTC通信尝试3次均超时，Read data: Time out 持续出现。
• 关键日志线索：
  • BTC control register 值为 0x0，而非预期的可用状态。
  • BMC侧检测到 BT Channel mode 为 3。
  • bt_ioctl_transfer 调用失败，/dev/ipmidev/0 设备文件未创建。

---

根本原因分析

1. BTC通信失败的直接原因：B2H_ATN 中断缺失

根据知识图谱中的因果链分析：

• BTC Communication Failure 的核心原因是 BMC 或 CPLD 未能触发 B2H_ATN 中断信号，该信号是 BTC 通信建立的关键握手机制。
• 若无此中断，CPU 侧无法感知 BMC 已准备好接收命令，导致 btReadData 和 btWriteData 超时。
• 这直接导致日志中出现：
  • BTC do not send data bt ctrl:0x0
  • Read data: Time out
  • Write data: Time out

结论：通信通道物理或逻辑未正确激活，中断机制未触发，是导致通信失败的直接技术原因。

---

2. 驱动加载失败的原因：BT Over LocalBus 初始化异常

从 BMC 日志看：

2026-01-29 22:56:56.368204 hmo_core ERROR: load_bt_ko.lua(74): .ipmi load bt driver [bt over localbus] failed, ret false

结合知识库和文档【IPMI管理定位问题】中 Q3 的排查思路：

• bt over localbus 模式需要严格配套升级流程，包括：
  1. 升级并生效 BMC 固件
  2. 升级 CSR
  3. 升级 CPLD 和 MCU
  4. 升级 BIOS
  5. 通过 AC 生效最终配置

若其中任意一步异常，可能导致：

• mode 值错误地设置为 3
• 系统加载了错误类型的 BT 驱动
• 驱动无法正常扫描到 BMC 设备 → /dev/ipmidev/0 无法创建

此外，日志中 BTCChannelNotice object mode value: 3 表明系统检测到了 BT Mode 配置值为 3，但当前驱动（bt over localbus）不能正常支持该模式或未完成初始化。

文档依据：《IPMI管理定位问题》指出：“该问题大概率是硬件 Get BT Channel 命令字返回了错误的值，导致加载了错误的驱动类型”。

---

3. BMC端行为溯源：OS侧BT驱动未能创建设备节点

• 正常流程中，系统由 OS Side BT Driver 启动并扫描 BMC 设备。
• 成功后应创建 /dev/ipmidev/0，用于后续 IPMI 命令交互。
• 日志显示该文件未生成，说明：
  • BMC 设备未被 OS 正确识别
  • 或 BT Module 处于不可访问状态（如 register 访问失败）

关联错误包括：

• Write DATA Reg Failed
• Write CTRL Reg Failed
• BtWaitRead TIMEOUT
• BtReadTransaction Failed

这些均属于 BT Module 级别的底层通信故障，表明 硬件抽象层通信中断。

---

4. 闭源组件影响：BIOS 与 CPLD 的协同依赖

• BIOS 在启动初期试图通过 BTC 发送 BIOS 版本号（ReportBiosVersionToBmc），但因通信失败而超时。

• 知识图谱明确指出：

  "The BIOS is unable to communicate with BTC, resulting in startup failure."

• 而 BTC 功能依赖于 CPLD 提供的控制信号（如 B2H_ATN）和通道模式配置（via PCIe 或寄存器配置）。

• 若 CPLD 固件存在 bug 或状态紊乱，将导致 BTC 模式不一致或中断无法触发。

实际案例佐证：参考知识库文档 DC-2 中用户 guohao 的案例，最终定界为 “硬件 CPLD 问题” 导致 BTC 异常。

---

排查与解决建议

推荐排查步骤

步骤	操作	目标
1	收集一键日志（log_collector.lua）	获取完整 BMC + BIOS 日志
2	检查 ipmi_core 和 firmware_mgm 版本	确保 ≥ 1.10.30 和 ≥ 1.10.44（见《升级FAQ》）
3	验证 CPLD 是否已正确升级并生效	使用 AC 命令触发完全生效
4	检查 BT Mode 读取逻辑是否正确	确认是否因命令字错误导致 mode=3 被误判
5	抓取 I2C/SMBus 上对 BT Module 寄存器访问过程	分析写 CTRL/DATA Reg 是否成功
6	尝试 AC 多次复现，观察是否可恢复	确认定界于硬件初始化随机性

解决方案建议

1. 升级并重新生效 CPLD 固件

   • 执行标准五步升级流程（参考 Search Result ID:1）
   • 确保每步后 BT 通信正常

2. 更新 BIOS 至兼容版本

   • 例如使用已在生产环境验证的 21.24 或更高版本
   • 确保支持 bt over localbus 模式

3. 确认 BT 驱动加载顺序与 Ko 兼容性

   • 检查 btc_drv.ko 是否与当前内核和硬件 mode 匹配
   • 排查是否存在 ko 文件损坏或权限问题

4. 增加初始化重试机制

   • 在 load_bt_ko.lua 中对驱动加载增加最多 3 次重试
   • 加入延时等待 CPLD 稳定后再加载

---

最终结论

本次 BTC 通道初始化失败的根本原因，极有可能是 CPLD 在 ACCycle 后未能正确初始化 BT 通道，导致 B2H_ATN 中断缺失，进而引发 OS 侧 BT 驱动加载失败与 BIOS 通信超时。

虽然表现为软件驱动加载异常（.ipmi load bt driver [bt over localbus] failed），但实质上是 硬件管理单元（CPLD）与固件（BIOS/BMC）之间协同不一致所引发的偶发性底层通信故障。

---

参考资料

• 知识图谱节点：
  • BTC Communication Failure
  • BMC or CPLD
  • B2H_ATN Interrupt
  • BIOS
  • BT Driver
• 文档引用：
  • Search Result #1: 《IPMI管理定位问题》——Q3 bt over localbus 排查
  • Search Result #2: 《升级常见问题指南》——组件版本要求
  • Document Chunk #2: 用户案例【已解决，硬件CPLD问题】

相关链接：

1. BIOS启动失败，BTC is busy ，BTC bt ctrl:0x80
2. 发帖和回帖时碰到418问题
3. 版本级自动化冒烟测试设计分享
4. 【教学培训篇】新增组件
5. IPMI管理定位问题 | 文档中心 | openUBMC

[duzhou13_51cdj (wanghaozhou)]

该日志打印表示加载 bt 驱动失败，可通过在环境上尝试手动加载驱动确认失败原因，驱动所在路径为 /lib/modules/ko/btc_drv.ko