4. printk 基础用法：日志级别与格式化输出

在嵌入式 Linux 内核调试中，printk 是最直接、最可靠的输出手段。与用户空间的 printf 不同，printk 需要显式指定日志级别，并支持针对设备树节点的专用格式化符号 %pOF。本章将系统讲解这两项核心技能，为后续跟踪 of_ 函数调用路径打下基础。

4.1 日志级别：控制消息的“优先级”

每个 printk 调用都带有一个日志级别宏，它决定了消息是否显示在控制台以及写入系统日志的紧急程度。内核使用 前缀来标记级别，级别数字越小，优先级越高。

4.2 格式化输出：从基础到设备树专用

printk 的格式化语法与 printf 基本一致，但在内核调试中，有几个格式符需要特别掌握，尤其是针对设备树的 %pOF。

4.2.1 基础格式符回顾

4.2.2 设备树专用格式符：%pOF

%pOF 是内核为设备树节点提供的专用格式化扩展，它可以直接接收一个 struct device_node * 指针，自动输出节点的全路径。相比手动调用 of_node_full_name()，%pOF 更简洁、更安全，且在内核 4.x 之后广泛支持。

struct device_node *np;
np = of_find_node_by_name(NULL, "uart0");
if (np) {
    printk(KERN_INFO "找到节点: %pOF\n", np);   // 输出: /soc/uart@ffe00000
    printk(KERN_ERR "节点 %pOF 解析失败\n", np); // 错误时也打印路径
    of_node_put(np);
}

%pOF 的额外优势：

• 自动处理 NULL 指针：如果传入 NULL，输出 (null)，不会崩溃。
• 与日志级别无缝配合：可以在 KERN_ERR、KERN_DEBUG 等任何级别中使用。
• 可读性强：直接输出类似 /soc/i2c@ffd00000/rtc@51 的完整路径，便于定位。

4.3 实战组合：在 of 函数路径中使用 printk

将日志级别与格式化输出结合，可以构建出清晰的调试信息。以下是一个在设备树节点查找函数中插入 printk 的典型模式：

struct device_node *np;
int ret;

np = of_find_node_by_name(NULL, "uart0");
if (!np) {
    printk(KERN_ERR "of_find_node_by_name: 未找到节点 uart0\n");
    return -ENODEV;
}
printk(KERN_INFO "成功找到节点: %pOF\n", np);

/* 读取属性 */
ret = of_property_read_u32(np, "reg", ®_val);
if (ret) {
    printk(KERN_ERR "节点 %pOF 读取 reg 属性失败, ret=%d\n", np, ret);
    of_node_put(np);
    return -EINVAL;
}
printk(KERN_DEBUG "节点 %pOF reg = 0x%x\n", np, reg_val);

of_node_put(np);

4.4 日志级别控制：让调试消息可见

即使代码中使用了 KERN_DEBUG，如果当前控制台日志级别低于 7，消息也不会显示在终端上。以下是常用的控制方法：