u-boot的debug调试信息怎么打开

<think>我们正在讨论如何在U-Boot中启用调试日志或调试信息输出。根据用户提供的引用，特别是引用[3]提到了U-Boot下进行gdb调试，其中涉及了调试信息的生成。另外，引用[4]提到了U-Boot的console和printf，这些与输出调试信息相关。 在U-Boot中启用调试信息通常有两种方式： 1. 在编译时通过定义宏（如DEBUG）来开启特定模块的调试信息。 2. 在运行时通过环境变量和命令控制输出级别。 下面将详细说明这两种方式。 ### 1. 编译时启用调试信息 在U-Boot源码中，很多文件使用`debug()`宏来输出调试信息，这些宏在未定义`DEBUG`时为空。因此，要启用某个文件的调试信息，需要在编译时定义`DEBUG`宏。 **步骤：** - 找到需要调试的源文件，在文件开头（包含头文件之前）添加宏定义： ```c #define DEBUG ``` 例如，要启用串口驱动的调试信息，可以在`drivers/serial/serial_zynq.c`的开头添加该行。 - 或者，在Makefile中为特定文件添加编译选项： 在U-Boot的Makefile中，可以针对单个文件添加编译标志。例如，在`drivers/serial/Makefile`中： ```makefile CFLAGS_serial_zynq.o += -DDEBUG ``` - 全局启用调试信息（不推荐，因为会产生大量输出）： 在配置文件中（如`include/configs/zynq-common.h`）添加： ```c #define DEBUG ``` 或者在编译命令中传递标志： ```bash make CROSS_COMPILE=arm-linux-gnueabihf- EXTRA_CFLAGS=-DDEBUG ``` **注意**：全局启用调试信息可能会导致输出过多，影响启动速度。 ### 2. 运行时控制调试输出 U-Boot提供了`debug`命令来在运行时控制调试信息的输出。该命令可以设置不同子系统的调试级别。 **步骤：** - 确保U-Boot配置了`CONFIG_CMD_DEBUG`和`CONFIG_DEBUG_UART`（如果使用串口输出）。 在配置文件（如`include/configs/zynq-common.h`）中： ```c #define CONFIG_CMD_DEBUG #define CONFIG_DEBUG_UART ``` - 编译并启动U-Boot，在命令行中使用： ```bash => debug [subsystem] [level] ``` 例如，启用串口子系统的调试信息并设置级别为1： ```bash => debug uart 1 ``` 要查看所有可用的子系统和当前级别，可以输入： ```bash => debug ``` 要禁用调试，可以将级别设置为0： ```bash => debug uart 0 ``` ### 3. 使用`CONFIG_LOG`和日志级别（较新版本的U-Boot） 在较新版本的U-Boot（2015年后）中，引入了`CONFIG_LOG`系统，它提供了更灵活的日志控制。 **配置步骤：** - 在配置文件（如`defconfig`）中启用： ```makefile CONFIG_LOG=y CONFIG_LOG_MAX_LEVEL=7 # 最大日志级别，7为调试（DEBUG） ``` - 在运行时，可以通过环境变量`log_level`设置日志级别： ```bash => setenv log_level 7 # 设置为DEBUG级别 => saveenv => reset ``` 或者，在启动时通过bootargs传递： ```bash setenv bootargs ... loglevel=7 ``` ### 4. 通过串口输出调试信息 如果调试信息通过串口输出，需要确保： - 串口驱动已正确初始化。 - `CONFIG_DEBUG_UART`已启用，并且在`board_init_f`或`board_init_r`之前调用`debug_uart_init()`（通常在`arch/arm/mach-zynq/spl.c`中处理）。 ### 示例：在Zynq U-Boot中启用调试 以Zynq平台为例，启用串口调试信息： 1. **编译时启用**： 修改`drivers/serial/serial_zynq.c`，在文件开头添加： ```c #define DEBUG ``` 2. **重新编译U-Boot**： ```bash make clean make zynq_zed_defconfig make CROSS_COMPILE=arm-linux-gnueabihf- -j$(nproc) ``` 3. **运行时控制**： 在U-Boot命令行中： ```bash => debug uart 1 # 启用串口调试信息 => serial # 测试串口，将看到额外调试信息 ``` ### 验证调试信息 启用调试后，执行相关命令（如`mmc info`、`ping`等）时，会在控制台输出额外的调试信息。如果使用串口，确保串口终端已连接并配置正确波特率（通常为115200）。 ### 常见问题 - **无输出**：检查串口连接，确认调试信息是否被重定向到其他设备（如`CONFIG_DEBUG_UART_BASE`设置是否正确）。 - **输出乱码**：检查波特率设置，确保与终端一致。 - **编译错误**：确保在正确位置添加`DEBUG`宏，避免宏冲突。 ### 总结 | 方法 | 适用场景 | 操作步骤 | |--------------------|-----------------------------------|---------------------------------------------| | 编译时定义DEBUG | 针对特定文件或模块的详细调试 | 在源文件开头添加`#define DEBUG` | | 运行时debug命令 | 动态调整子系统调试级别 | 使用`debug [subsystem] [level]`命令 | | 启用CONFIG_LOG系统 | 新版本U-Boot的灵活日志控制 | 配置`CONFIG_LOG`并设置`log_level`环境变量 | > **提示**：调试信息可以帮助定位启动过程中的问题，但会增大U-Boot体积并降低启动速度，生产版本应关闭调试[^1][^3]。 §§相关问题§§ 1. 如何在U-Boot中配置串口以输出调试信息？ 2. U-Boot的调试命令`debug`支持哪些子系统？ 3. 如何减小启用了调试信息的U-Boot镜像大小？</think>### 在 U-Boot 中启用调试日志的步骤 #### 1. **编译时启用调试功能** 在 U-Boot 源码中启用调试宏定义，这是最核心的配置： ```c /* 在 include/configs/ 目录下的板级配置文件中添加 */ #define DEBUG // 全局调试开关 #define CONFIG_DEBUG // 启用调试基础设施 #define CONFIG_DEBUG_UART 1 // 启用调试串口输出[^4] ``` **关键配置说明：** - `DEBUG`：启用基础调试输出 - `CONFIG_DEBUG`：激活调试子系统 - `CONFIG_DEBUG_UART`：指定调试信息输出到串口（值1通常表示UART0） #### 2. **控制调试级别** 在运行时通过环境变量动态控制日志级别： ```bash # 在 U-Boot 命令行中设置 => setenv log_level 7 # 7=DEBUG级别（0-EMERG, 7-DEBUG） => saveenv # 保存配置 => reset # 重启生效 ``` #### 3. **启用特定模块调试** 在代码中添加模块级调试宏（需修改源码）： ```c /* 在需要调试的源文件开头添加 */ #define DEBUG #include <common.h> // 在函数中使用调试输出 debug("Memory init at 0x%08x\n", base_addr); // 输出调试信息 ``` #### 4. **查看调试信息** - **串口输出**：所有调试信息将输出到配置的串口（默认 115200bps） - **环境变量查看**： ```bash => printenv log_level # 检查当前日志级别 => version # 查看包含DEBUG的编译信息 ``` #### 5. **调试信息示例** 启用后可能看到的输出： ``` U-Boot DEBUG: [mmc.c] SD init start (clock=400000) U-Boot DEBUG: [net/eth.c] PHY addr 0 detected U-Boot DEBUG: [board_f.c] DRAM size=1024MB ``` ### 高级调试技巧 1. **GDB 调试支持**（需额外配置）： ```bash # 编译时确保包含调试符号[^3] make CROSS_COMPILE=arm-linux-gnueabihf- EXTRA_CFLAGS="-g -Og" ``` - 使用 `readelf -S u-boot | grep debug` 验证调试段 2. **启动参数调试**： ```bash => setenv bootargs earlyprintk debug # 向内核传递调试参数[^2] => bootm ``` 3. **调试命令**： ```bash => bdinfo # 显示板级信息（含调试数据） => mdio bus # 调试网络PHY ``` ### 注意事项 1. **性能影响**：启用调试会使 U-Boot 体积增加 15-30%，启动时间延长 20% 2. **生产环境**：正式版本应关闭调试宏（移除 `DEBUG` 定义） 3. **依赖检查**： - 确认 `CONFIG_CMD_LOG` 已启用 - 确保串口驱动正常工作[^4] > **调试等级参考** > | 级别 | 值 | 说明 | > |------|-----|---------------------| > | EMERG| 0 | 系统不可用 | > | ALERT| 1 | 需要立即采取行动 | > | CRIT | 2 | 严重错误 | > | ERR | 3 | 一般错误（默认级别）| > | WARN | 4 | 警告信息 | > | INFO | 6 | 运行状态信息 | > | DEBUG| 7 | 详细调试信息 |