4、时间戳生成机制：硬件SOF信号→驱动层→HAL层→应用层的传递链路

多摄同步的核心挑战在于：每帧图像的时间戳必须精确对应同一物理时刻。如果时间戳在传递链路中发生偏移、抖动或丢失，将直接导致多路视频流无法对齐。本章深入剖析从硬件SOF信号到应用层时间戳的完整传递链路，定位常见故障根因。

4.1 硬件SOF信号：时间戳的物理基准

SOF（Start of Frame）是传感器输出的帧起始脉冲信号，通常由MIPI CSI-2接口的VSYNC（垂直同步）引脚承载。SOF信号具有以下关键特性：

4.2 驱动层时间戳：从硬件信号到内核空间

驱动层负责捕获SOF硬件中断，并将硬件时间戳记录到内核空间。这是时间戳传递链路中最容易引入误差的环节。

4.2.1 驱动层时间戳采集流程

1. 硬件中断触发：SOF上升沿触发GPIO中断或MIPI D-PHY中断。
2. 中断服务程序（ISR）：在原子上下文中调用 ktime_get_real_ns() 或 ktime_get_boottime_ns() 获取当前内核时间。
3. 时间戳绑定：将时间戳写入V4L2 buffer的 timestamp 字段。
4. DMA传输完成：等待DMA将图像数据写入内存后，将时间戳随buffer一起上报。

/* 驱动层时间戳采集示例（伪代码） */
static irqreturn_t sensor_sof_isr(int irq, void *dev_id)
{
    struct sensor_dev *sdev = dev_id;
    u64 timestamp_ns;

    /* 在ISR中立即获取时间戳 */
    timestamp_ns = ktime_get_boottime_ns();

    /* 将时间戳暂存到驱动上下文 */
    sdev->current_sof_timestamp = timestamp_ns;

    /* 唤醒等待队列，通知DMA传输 */
    wake_up_interruptible(&sdev->sof_wait);

    return IRQ_HANDLED;
}

4.2.2 驱动层时间戳误差来源

4.3 HAL层时间戳：从内核空间到框架层

HAL（Hardware Abstraction Layer）层负责将驱动层上报的时间戳转换为框架层可识别的格式，并进行必要的校准和补偿。

4.3.1 HAL层时间戳处理流程

• 接收驱动层时间戳：通过V4L2的 DQBUF 操作获取buffer中的 timestamp 字段。
• 时钟域转换：将驱动层的 CLOCK_BOOTTIME 或 CLOCK_MONOTONIC 时间戳转换为 CLOCK_REALTIME（应用层常用）。
• 偏移补偿：根据传感器与SoC之间的硬件延迟，对时间戳进行固定偏移补偿。
• 帧序号绑定：将时间戳与帧序号（frame_number）绑定，确保时间戳与帧数据一一对应。

/* HAL层时间戳转换示例（伪代码） */
status_t CameraHAL::processCaptureResult(const camera3_capture_result *result)
{
    struct timespec ts;
    int64_t timestamp_ns;

    /* 获取驱动层时间戳 */
    timestamp_ns = result->metadata->entry[ANDROID_SENSOR_TIMESTAMP].data.i64[0];

    /* 时钟域转换：BOOTTIME → REALTIME */
    clock_gettime(CLOCK_BOOTTIME, &ts);
    int64_t boottime_ns = ts.tv_sec * 1000000000LL + ts.tv_nsec;
    clock_gettime(CLOCK_REALTIME, &ts);
    int64_t realtime_ns = ts.tv_sec * 1000000000LL + ts.tv_nsec;
    int64_t offset = realtime_ns - boottime_ns;

    /* 应用偏移补偿 */
    int64_t compensated_timestamp = timestamp_ns + offset + HARDWARE_DELAY_NS;

    /* 写入metadata */
    result->metadata->entry[ANDROID_SENSOR_TIMESTAMP].data.i64[0] = compensated_timestamp;

    return OK;
}

4.3.2 HAL层时间戳常见问题

4.4 应用层时间戳：从框架层到用户空间

应用层通过Camera2 API或Camera3 API获取时间戳，用于多路视频流的同步渲染、录制或算法处理。

4.4.1 应用层时间戳获取方式

• Camera2 API：通过 CaptureResult 的 get(CaptureResult.SENSOR_TIMESTAMP) 获取。
• Camera3 API：直接从 camera3_capture_result 的metadata中读取 ANDROID_SENSOR_TIMESTAMP。
• SurfaceTexture：通过 getTimestamp() 获取，但该时间戳是SurfaceTexture内部生成的，可能与传感器时间戳不同步。

4.4.2 应用层时间戳对齐策略

4.5 完整传递链路总结

时间戳从硬件到应用层的完整传递链路如下：

1. 硬件层：传感器输出SOF脉冲信号，精度纳秒级。
2. 驱动层：ISR捕获SOF中断，记录内核时间戳（ktime_get_boottime_ns），绑定到V4L2 buffer。
3. HAL层：接收驱动层时间戳，进行时钟域转换（BOOTTIME→REALTIME），应用硬件延迟补偿，写入metadata。
4. 框架层：Camera3 API将metadata传递给应用层。
5. 应用层：读取 ANDROID_SENSOR_TIMESTAMP，执行多摄对齐策略。