4. 日志系统设计原则

摄像头驱动日志系统是调试与故障排查的“第一现场”。设计不当的日志系统要么淹没关键信息，要么在性能敏感路径上拖垮帧率，要么在安全审计时留下盲区。本章从四个核心维度展开：日志级别（控制输出粒度）、日志分类（按模块与功能组织）、性能影响评估（量化开销与优化策略）、安全审计要求（合规与溯源）。

4.1 日志级别定义

摄像头驱动通常采用 5 级日志体系，与 Linux 内核的 printk 级别对齐，但针对摄像头场景做了微调：

4.2 日志分类

按摄像头驱动功能模块将日志分为 6 大类，每类使用独立标签前缀，便于 grep 过滤和日志分析工具解析：

• [SENSOR] — 传感器初始化、寄存器配置、ID 读取、电源序列
• [CSI] — MIPI CSI 接收、时钟 lane 同步、数据 lane 解析
• [DMA] — 描述符链管理、缓冲区分配、帧完成中断、地址跳转
• [V4L2] — 视频设备节点操作、ioctl 处理、队列管理、格式协商
• [PM] — 电源管理、休眠/唤醒、时钟门控、电压调节
• [CTRL] — 控制命令、曝光/增益/白平衡、AE/AWB 状态

4.3 性能影响评估

摄像头驱动对实时性要求极高，日志输出不能阻塞帧处理路径。以下是关键性能指标与优化策略：

4.3.1 性能评估方法

使用 ftrace 或 perf 工具测量日志函数耗时：

# 使用 ftrace 测量 dev_dbg 耗时
echo 0 > /sys/kernel/debug/tracing/tracing_on
echo function_graph > /sys/kernel/debug/tracing/current_tracer
echo dev_dbg > /sys/kernel/debug/tracing/set_ftrace_filter
echo 1 > /sys/kernel/debug/tracing/tracing_on
# 运行摄像头驱动测试用例
cat /sys/kernel/debug/tracing/trace | grep "dev_dbg"

4.4 安全审计要求

摄像头驱动日志可能包含敏感信息（如传感器寄存器值、缓冲区物理地址、用户控制参数），必须满足以下安全审计要求：

• 敏感信息脱敏：物理地址、DMA 描述符指针、用户空间缓冲区地址等不得直接输出。使用 %pK 格式符（内核指针安全格式）替代 %p。
• 日志完整性：关键操作（如流启动/停止、固件加载、电源切换）必须记录不可篡改的审计日志，建议使用内核 audit_log() 接口。
• 日志保留策略：生产环境日志保留至少 30 天，使用 logrotate 按大小或时间轮转，避免磁盘写满。
• 访问控制：日志文件权限设为 640，仅 root 和 audit 组可读。通过 dmesg_restrict 内核参数限制非特权用户访问内核日志。

4.4.1 审计日志示例

使用内核审计接口记录关键操作：

#include <linux/audit.h>
#include <linux/lsm_audit.h>

void cam_audit_stream_start(struct device *dev, u32 stream_id)
{
    struct audit_buffer *ab;

    ab = audit_log_start(NULL, GFP_KERNEL, AUDIT_CAMERA_STREAM);
    if (!ab)
        return;

    audit_log_format(ab, "cam_stream_start: dev=%s stream_id=%u",
                     dev_name(dev), stream_id);
    audit_log_end(ab);
}

4.5 设计原则总结