一、日志系统概述：为什么摄像头调试需要日志系统？日志的级别与分类
做摄像头调试这些年，我见过太多工程师对着黑屏抓耳挠腮的场景。说实话，没有日志系统的调试，就像闭着眼睛修车——全靠摸。今天咱们就来聊聊，为什么日志系统是摄像头调试的“眼睛”。
1.1 为什么摄像头调试离不开日志？
摄像头调试有个特点：看不见的坑特别多。你想想看，sensor上电时序对不对、I2C通信有没有丢包、ISP参数是否生效——这些问题肉眼根本看不出来。
我个人习惯，拿到一块新模组，第一件事不是调图像，而是先把日志系统搭起来。为什么？因为日志能告诉你三件事：
- 发生了什么：系统启动时，sensor初始化成功了吗？
- 什么时候发生的：是上电瞬间报错，还是运行一段时间后崩溃？
- 上下文是什么：报错时，前一帧的曝光参数是多少？
我在项目中遇到过最典型的例子：某款sensor在低温环境下偶尔出图异常。没有日志，你只能反复插拔模组碰运气。有了日志，我直接定位到是PLL锁定超时——温度低导致晶振起振慢。你看，日志就是破案的关键线索。
核心观点：日志系统不是“锦上添花”，而是“雪中送炭”。没有日志的调试，等于在黑暗中摸索。
1.2 日志的级别：从“废话”到“救命”
日志级别这东西，说白了就是给信息贴个“紧急程度”标签。我刚开始做调试时，所有日志都用printf，结果刷屏刷到怀疑人生。后来才明白，分级管理才是正道。
常见的日志级别，我一般分五档：
| 级别 | 名称 | 含义 | 使用场景 |
|---|---|---|---|
| 0 | FATAL | 致命错误 | 系统无法继续运行，必须停机 |
| 1 | ERROR | 错误 | 功能异常，但系统可继续运行 |
| 2 | WARNING | 警告 | 潜在风险，需要关注 |
| 3 | INFO | 信息 | 正常流程的关键节点 |
| 4 | DEBUG | 调试 | 开发阶段的详细输出 |
嗯，这里要注意：DEBUG级别的日志，发布版本一定要关掉。我曾经吃过这个亏——某次量产版本忘了关DEBUG日志，结果I2C每帧都打印寄存器值，帧率直接掉了一半。教训啊！
我的建议：用宏控制日志开关。比如 #ifdef DEBUG_ENABLE，这样发布时只需要取消宏定义，所有调试日志自动消失，干净利落。
1.3 日志的分类：按模块切分，按功能归类
光有级别还不够。你想想看，一个摄像头系统涉及sensor驱动、ISP算法、AE/AWB控制、文件系统……所有日志混在一起，跟一锅粥似的，根本没法看。
我习惯把日志按模块分类：
- SENSOR：上电时序、寄存器读写、帧同步信号
- ISP：黑电平校正、去噪、色彩校正参数
- 3A：AE曝光统计、AWB色温估计、AF对焦位置
- DRIVER：V4L2接口、DMA传输、buffer管理
- SYSTEM：内存分配、任务调度、中断响应
每个分类用不同的前缀标识。比如：
[SENSOR] I2C write reg 0x10 = 0x03 success
[ISP] BLC offset updated: R=64, Gr=62, Gb=63, B=65
[AE] Current exposure: 33ms, gain: 2.5x
[DRIVER] Frame buffer queued: index=7, addr=0x84000000
[SYSTEM] WARNING: ISR latency exceeded 500us这样做的好处是什么？一眼就能定位问题。如果图像偏色，直接过滤出 [AWB] 相关的日志；如果帧率不稳，就看 [AE] 和 [DRIVER] 的配合情况。
避坑指南：我曾经在一个项目里，把所有日志都打上 [CAMERA] 前缀。结果出问题时，根本分不清是sensor还是ISP的锅。后来花了整整两天，才把日志分类重构好。所以，一开始就设计好分类，能省下大把时间。
1.4 日志系统的设计原则
说了这么多，总结几条我这些年摸爬滚打总结出来的原则：
- 够用就好：日志不是越多越好。INFO级别只打印关键节点，比如初始化完成、开始采集、异常退出。
- 带上时间戳：没有时间戳的日志，等于没有上下文。我习惯用微秒级精度，方便分析时序问题。
- 可过滤：支持按级别、按模块过滤。调试时只看自己关心的部分。
- 低开销：日志不能影响主流程。特别是DEBUG级别，建议用环形缓冲区，避免频繁IO操作。
说白了，日志系统就像你的“调试助手”。它不替你解决问题，但能告诉你问题出在哪。我见过太多工程师，遇到bug第一反应是“加打印”，然后满屏乱刷——这其实是在给自己挖坑。
好了，这一章我们聊了日志系统为什么重要，以及怎么分级、怎么分类。下一章，我会手把手教你搭建一个轻量级的日志框架，从代码层面落地这些理念。到时候咱们再细聊。