3. Log采集与配置：如何配置HAL层的Log开关、动态调整Log等级、使用宏控制Log输出

在嵌入式HAL调试中，Log系统是定位问题的“第一双眼睛”。本章聚焦于HAL层Log的三大核心能力：静态开关配置、运行时动态等级调整、以及宏驱动的输出控制。掌握这些技能，能让你在预览卡顿等复杂故障中快速锁定数据流异常点。

3.1 HAL层Log架构与开关配置

HAL层Log通常采用分层过滤架构，从全局开关到模块宏，逐级控制输出。典型的配置层次如下：

在头文件中定义全局开关与模块宏：

// hal_log_config.h
#ifndef HAL_LOG_CONFIG_H
#define HAL_LOG_CONFIG_H

// 全局Log开关：1使能，0关闭
#define HAL_LOG_ENABLE         1

// 模块级Log宏开关
#define HAL_LOG_MOD_CSI        1   // Camera Serial Interface
#define HAL_LOG_MOD_ISP        1   // Image Signal Processor
#define HAL_LOG_MOD_VENC       0   // Video Encoder (生产环境关闭)
#define HAL_LOG_MOD_DISPLAY    1   // Display Output

// Log等级定义
#define HAL_LOG_LEVEL_ERROR    0
#define HAL_LOG_LEVEL_WARN     1
#define HAL_LOG_LEVEL_INFO     2
#define HAL_LOG_LEVEL_DEBUG    3

// 当前编译等级（可调整）
#define HAL_LOG_CURRENT_LEVEL  HAL_LOG_LEVEL_DEBUG

#endif // HAL_LOG_CONFIG_H

3.2 动态调整Log等级

静态开关无法满足运行时诊断需求。通过注册等级控制接口，可以在系统运行时通过命令行或调试接口动态调整Log输出粒度。

动态等级调整的实现示例：

// hal_log_ctrl.c
#include "hal_log_config.h"

static int g_log_level = HAL_LOG_LEVEL_INFO;  // 默认等级

// 运行时设置Log等级，可通过UART或adb调用
void hal_log_set_level(int level) {
    if (level < HAL_LOG_LEVEL_ERROR) level = HAL_LOG_LEVEL_ERROR;
    if (level > HAL_LOG_LEVEL_DEBUG) level = HAL_LOG_LEVEL_DEBUG;
    g_log_level = level;
    printf("[HAL] Log level set to %d\n", level);
}

int hal_log_get_level(void) {
    return g_log_level;
}

// 等级过滤判断
int hal_log_is_enabled(int msg_level) {
    return (msg_level <= g_log_level) ? 1 : 0;
}

3.3 使用宏控制Log输出

宏控制是HAL层Log的基石，兼顾编译期优化与代码可读性。标准做法是定义带等级过滤的打印宏：

// hal_log.h
#include <stdio.h>
#include "hal_log_config.h"

// 基础打印宏（带模块标签）
#define HAL_LOG_PRINT(level, mod, fmt, ...) \
    do { \
        if (hal_log_is_enabled(level)) { \
            printf("[HAL][%s][%s] " fmt "\r\n", \
                   hal_log_level_str(level), mod, ##__VA_ARGS__); \
        } \
    } while(0)

// 模块快捷宏（以CSI模块为例）
#if HAL_LOG_MOD_CSI
    #define HAL_LOG_CSI_ERROR(fmt, ...) \
        HAL_LOG_PRINT(HAL_LOG_LEVEL_ERROR, "CSI", fmt, ##__VA_ARGS__)
    #define HAL_LOG_CSI_WARN(fmt, ...) \
        HAL_LOG_PRINT(HAL_LOG_LEVEL_WARN, "CSI", fmt, ##__VA_ARGS__)
    #define HAL_LOG_CSI_INFO(fmt, ...) \
        HAL_LOG_PRINT(HAL_LOG_LEVEL_INFO, "CSI", fmt, ##__VA_ARGS__)
    #define HAL_LOG_CSI_DEBUG(fmt, ...) \
        HAL_LOG_PRINT(HAL_LOG_LEVEL_DEBUG, "CSI", fmt, ##__VA_ARGS__)
#else
    // 模块关闭时，所有宏展开为空
    #define HAL_LOG_CSI_ERROR(fmt, ...)
    #define HAL_LOG_CSI_WARN(fmt, ...)
    #define HAL_LOG_CSI_INFO(fmt, ...)
    #define HAL_LOG_CSI_DEBUG(fmt, ...)
#endif

// 等级转字符串辅助函数
static inline const char* hal_log_level_str(int level) {
    switch(level) {
        case 0: return "ERR";
        case 1: return "WRN";
        case 2: return "INF";
        case 3: return "DBG";
        default: return "UNK";
    }
}

在CSI驱动中使用示例：

// hal_csi.c
#include "hal_log.h"

void hal_csi_start_stream(void) {
    HAL_LOG_CSI_INFO("Stream start requested");

    if (csi_hw_init() != 0) {
        HAL_LOG_CSI_ERROR("HW init failed, error code: %d", hw_errno);
        return;
    }

    HAL_LOG_CSI_DEBUG("Register dump: 0x%08X 0x%08X", reg1, reg2);
    HAL_LOG_CSI_INFO("Stream started successfully");
}

3.4 典型配置场景对比