1. MIPS架构U-Boot调试打印实现原理
在嵌入式系统开发中，U-Boot作为最常用的Bootloader，其调试过程往往令人头疼。特别是在MIPS架构下，早期启动阶段的汇编代码调试更是困难重重。我曾在多个MIPS平台项目中通过添加调试打印解决了各种启动问题，这里分享一套经过验证的可靠方法。
MIPS架构与ARM/x86不同，其U-Boot启动流程中串口驱动初始化较晚，传统printk无法在汇编阶段使用。我们需要理解三个关键点：首先，MIPS处理器在复位后立即进入汇编环境；其次，串口控制器寄存器通常映射到固定物理地址；最后，汇编级打印本质上是直接操作硬件寄存器。
重要提示：调试打印会改变代码时序，可能影响敏感硬件初始化流程，建议仅在排查问题时临时启用，问题解决后立即移除。
2. 硬件环境准备与地址确认
2.1 确定串口寄存器基地址
以Broadcom BCM6358平台为例，其UART0寄存器基地址为0xb0000100。这个信息通常可以在：
- 芯片参考手册的"Memory Map"章节
- 原厂提供的头文件（如arch/mips/include/asm/mach-bcm63xx/bcm63xx_regs.h）
- 已有串口驱动代码中查找
典型串口寄存器偏移量：
| 寄存器 | 偏移量 | 功能说明 |
|---|---|---|
| THR | 0x00 | 发送保持寄存器 |
| LSR | 0x14 | 线路状态寄存器（第5位为发送空标志） |
2.2 验证串口工作模式
在添加打印前，先用现有U-Boot命令测试串口是否正常工作：
code复制=> baudrate 115200
=> serial console
如果基础通信正常，说明硬件链路没问题，可以继续实现底层打印。
3. 汇编级调试打印实现步骤
3.1 创建汇编宏定义
在arch/mips/include/asm/asm.h中添加宏：
c复制#define DEBUG_UART_BASE 0xb0000100
.macro early_putc ch
li t0, DEBUG_UART_BASE
1:
lw t1, 0x14(t0) /* 读取LSR寄存器 */
andi t1, t1, 0x20 /* 检查THRE位 */
beqz t1, 1b /* 等待发送缓冲区空 */
li t2, \ch /* 加载字符 */
sw t2, 0x00(t0) /* 写入THR寄存器 */
.endm
3.2 关键位置插入调试输出
在启动代码中（如arch/mips/cpu/start.S）关键位置添加：
assembly复制early_putc 'A' /* 标记CPU启动 */
bal cpu_init
early_putc 'B' /* CPU初始化完成 */
/* 内存初始化后 */
early_putc 'C'
3.3 实现字符串打印函数
对于复杂调试，可以扩展为字符串输出：
assembly复制LEAF(early_puts)
move t3, a0
1:
lb t2, 0(t3)
beqz t2, 3f
early_putc t2
addiu t3, t3, 1
b 1b
3:
jr ra
END(early_puts)
4. 高级调试技巧与问题排查
4.1 带PC指针的调试输出
在异常处理中添加定位信息：
assembly复制early_puts "\nPanic at PC:"
mfc0 t0, CP0_EPC
early_put_hex t0 /* 需要额外实现十六进制输出 */
4.2 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无任何输出 | 1. 地址错误 2. 时钟未初始化 |
1. 核对芯片手册 2. 检查时钟初始化代码 |
| 乱码 | 波特率不匹配 | 确认UART时钟源和分频设置 |
| 丢失字符 | 未检查发送空标志 | 完善LSR状态检测逻辑 |
4.3 性能优化技巧
- 使用延迟槽优化：MIPS架构下合理利用分支延迟槽可以提升20%以上的输出效率
assembly复制1:
lw t1, 0x14(t0)
andi t1, t1, 0x20
bnez t1, 2f
nop /* 延迟槽 */
b 1b
nop /* 延迟槽 */
2:
5. 与C环境的衔接过渡
当执行流进入C代码后，可以保留汇编打印接口供紧急调试使用：
c复制extern void early_puts(const char *str);
void board_init_f(ulong dummy)
{
early_puts("[C] board_init_f\n");
/* ... */
}
建议在relocation完成后切换到标准串口驱动，此时可以定义切换宏：
c复制#define DEBUG_SERIAL_INIT() \
do { \
if(gd->flags & GD_FLG_RELOC) \
serial_initialize(); \
} while(0)
6. 实战案例：DDR初始化调试
某次在MT7621平台调试时，DDR初始化失败导致系统挂起。通过添加以下调试点定位问题：
assembly复制/* arch/mips/mach-mtmips/ddr.c */
early_puts("DDR PLL init...");
ddr_pll_init();
early_puts("OK\n");
early_puts("DDR config...");
ddr_config();
early_puts("OK\n");
最终发现是DRAMC_DQS_SYNC寄存器配置错误，通过比对成功和失败时的打印时序，快速定位到问题阶段。
这套调试方法在多个MIPS平台（Broadcom、MTK、Loongson）上验证有效，关键是要准确获取目标平台的UART寄存器信息。实际项目中建议将调试代码封装为单独文件（如debug_early.S），方便不同项目复用。