4. DCMIPP管线配置入门

DCMIPP（Digital Camera Interface Pixel Pipeline）是STM32N6中负责把摄像头传感器输出的原始像素数据，经过一系列硬件处理单元后写入内存或显示控制器的核心外设。它并不是一个简单的“接收—搬运”接口，而是一条可配置的像素流水线。理解这条流水线的数据流方向、各处理单元的作用以及旁路关系，是后续用HAL库正确初始化并捕获RAW8/RAW10数据的前提。

4.1 DCMIPP内部数据流的整体结构

DCMIPP的输入可以来自并行接口（Parallel Interface，DCMI）或CSI-2接口。两者在进入管线后先经过接口层，再汇入统一的像素处理路径。典型的数据流顺序为：接口接收 → 像素打包/解包 → 裁剪（Crop）→ 下采样（Downsize）→ 格式转换（Format Conversion）→ 输出到内存或显示。其中裁剪、下采样和格式转换属于可配置处理单元，在RAW数据捕获场景中通常需要根据目标格式决定是否旁路。

需要特别注意的是，DCMIPP内部存在多个“管道”（Pipe），例如Pipe0通常用于显示或主数据流，Pipe1用于辅助数据流或内存写入。每个管道可以独立配置裁剪、下采样和格式转换参数。对于“捕获一帧RAW8/RAW10到内存”这一目标，我们通常使用一个管道，并让格式转换单元输出RAW8或RAW10，而不是RGB或YUV。

4.2 各处理单元在RAW捕获中的取舍

裁剪单元用于从传感器有效像素区域中截取一个矩形窗口。它的配置参数包括起始坐标和窗口宽高。如果传感器输出已经是目标分辨率，裁剪可以旁路；如果只需要感兴趣区域（ROI），则必须正确设置窗口，否则后续DMA搬运的字节数会与预期不符。

下采样单元用于降低分辨率，支持水平与垂直方向的整数比例缩小。在RAW8/RAW10捕获中，如果不需要降分辨率，应将其旁路，避免像素被平均或抽取后破坏Bayer排列。格式转换单元则决定输出像素格式。对于RAW8，每个像素占1字节；对于RAW10，每个像素占10位，通常按紧凑方式打包，每4个像素占5字节。这一点直接影响DMA传输长度和内存缓冲区大小的计算。

4.3 使用HAL库初始化DCMIPP并捕获一帧

STM32N6的HAL库为DCMIPP提供了句柄结构和初始化函数。典型流程包括：使能DCMIPP时钟、配置GPIO和接口引脚、填充DCMIPP_HandleTypeDef、调用HAL_DCMIPP_Init()，然后配置管道参数、启动DCMIPP，最后等待帧完成标志并将数据从DMA缓冲区读出。

下面给出一个面向RAW8捕获的配置片段，参数为教学示例，实际使用时需根据传感器时序和板级连接调整。

DCMIPP_HandleTypeDef hdcmipp;
DCMIPP_PipeConfigTypeDef pipeCfg;

/* 1. 使能时钟与接口引脚（略） */

/* 2. 初始化DCMIPP */
hdcmipp.Instance = DCMIPP;
hdcmipp.Init.InterfaceType = DCMIPP_INTERFACE_PARALLEL;
hdcmipp.Init.PixelClockPolarity = DCMIPP_PIXCLK_RISING;
hdcmipp.Init.HSyncPolarity = DCMIPP_HSYNC_ACTIVE_HIGH;
hdcmipp.Init.VSyncPolarity = DCMIPP_VSYNC_ACTIVE_HIGH;
if (HAL_DCMIPP_Init(&hdcmipp) != HAL_OK) {
    Error_Handler();
}

/* 3. 配置Pipe0：RAW8，旁路裁剪与下采样 */
pipeCfg.Pipe = DCMIPP_PIPE0;
pipeCfg.FrameFormat = DCMIPP_FORMAT_RAW8;
pipeCfg.CropEnable = DISABLE;
pipeCfg.DownsizeEnable = DISABLE;
pipeCfg.OutputWidth = 640;
pipeCfg.OutputHeight = 480;
if (HAL_DCMIPP_ConfigPipe(&hdcmipp, &pipeCfg) != HAL_OK) {
    Error_Handler();
}

/* 4. 启动捕获，缓冲区大小 = 640 × 480 × 1 字节 */
HAL_DCMIPP_Start(&hdcmipp, DCMIPP_PIPE0, rawBuffer, 640*480);

若目标为RAW10，则FrameFormat改为DCMIPP_FORMAT_RAW10，缓冲区大小按640 × 480 × 1.25 = 384000字节计算。启动后，可通过轮询或中断方式等待帧完成。使用HAL_DCMIPP_GetState()或帧事件回调判断一帧是否写入完毕。读取数据时，RAW8可直接按字节索引；RAW10需要按5字节一组解包为4个10位像素，再根据Bayer排列还原颜色。

4.4 结果判断与常见问题

捕获完成后，判断是否成功的最直接依据是：帧完成标志置位、DMA传输计数与预期字节数一致、缓冲区首尾数据不是全0或全0xFF。如果出现全黑或全白，优先检查接口极性、像素时钟是否正常、传感器是否已输出有效帧。如果图像出现错位或撕裂，检查裁剪窗口和输出宽度是否与DMA长度匹配。如果RAW10解包后像素值异常，检查打包顺序和字节对齐。

掌握DCMIPP内部数据流后，配置就不再是盲目填参数，而是明确知道每个处理单元是否参与、输出格式如何决定缓冲区大小、以及出现异常时应该回到哪一级去排查。这是后续实现更复杂成像链路的基础。