简介这份资源是面向嵌入式与手机摄像头驱动开发者的 OV5645 传感器 MIPI YUV 驱动代码用于帮助设备正确识别并操作 OV5645 高清 CMOS 图像传感器将采集到的 YUV 格式数据转换为可用图像。内容围绕驱动初始化、MIPI 数据传输、图像处理、缓冲管理、同步信号处理、用户接口、错误处理与电源管理等环节展开适合从事 Android、Linux 平台 Camera 驱动移植与调试的工程师参考。压缩包共 4 个文件以 3 个 .h 头文件和 1 个 .c 源文件为主分别承载传感器寄存器配置、参数定义与驱动主体逻辑整体约 40KB结构精简便于快速阅读。目前已有 583 人学习下载可借此理解 OV5645 驱动与上层相机应用的对接方式掌握 MIPI YUV 数据链路的关键实现与常见排错思路。1. OV5645 MIPI YUV 驱动从零把摄像头点亮的实战路径OV5645 是一颗 500 万像素的 MIPI CSI-2 摄像头模组输出格式支持 RAW、YUV422、RGB 等常见于嵌入式视觉、工业检测和 FPGA 图像采集方案。很多人拿到模组后卡在第一步I2C 能读到 ID但 MIPI 数据流死活出不来或者出图花屏、颜色错乱。问题往往不在驱动本身而在上电时序、时钟配置、MIPI 通道映射和 YUV 格式对齐这几个环节。这篇笔记围绕 OV5645 的 MIPI YUV 驱动落地把寄存器配置、设备树、数据流验证和常见翻车点拆开讲适合正在调摄像头驱动的嵌入式工程师和 FPGA 图像采集开发者。2. OV5645 MIPI YUV 驱动架构从 I2C 配置到 CSI-2 数据流2.1 OV5645 的寄存器空间与 YUV 输出模式选择OV5645 的寄存器是 16 位地址、8 位数据通过 SCCB兼容 I2C访问。上电后第一件事是读0x300A和0x300B这两个寄存器组合起来是芯片 ID正常值分别是0x56和0x45。如果读不到先查 I2C 地址——OV5645 的 7 位地址通常是0x3C写地址0x78读地址0x79。YUV 输出模式的选择在0x4300寄存器。这个寄存器控制输出格式寄存器值输出格式说明0x00RAW原始 Bayer 数据0x30YUV422YUYV 排列最常用0x32YUV422UYVY 排列0x20RGB565RGB 格式我一般用0x30因为大多数 CSI-2 接收端和 ISP 对 YUYV 的支持最成熟。设置完格式后还要配0x4301到0x430D这一组寄存器来定义 YUV 通道的映射关系。如果这部分配错出来的图会偏色或者 Y/U/V 分量错位。另一个关键点是 PLL 配置。OV5645 的 MIPI 时钟来自内部 PLL由0x3035到0x3037以及0x3108这几个寄存器决定。MIPI 的像素时钟和 CSI-2 的 lane 速率必须匹配接收端的能力。常见做法是先确定模组输入的 XVCLK通常是 24MHz然后根据目标分辨率和帧率反推 PLL 倍频参数。2.2 MIPI CSI-2 通道配置与设备树绑定OV5645 支持 1 lane 和 2 lane 的 MIPI 输出。2 lane 模式下0x3018寄存器的 bit4 要置 1同时0x3019和0x301A要配成对应的 lane 使能。很多开发板的 CSI-2 接收端只支持特定 lane 组合比如 Rockchip 平台通常要求 lane0 和 lane1 成对使用。设备树里的绑定是另一个容易翻车的地方。以 Linux 平台为例OV5645 的节点需要声明i2c2 { ov5645: camera3c { compatible ovti,ov5645; reg 0x3c; clocks clk_cam24m; clock-names xclk; reset-gpios gpio1 10 GPIO_ACTIVE_LOW; powerdown-gpios gpio1 11 GPIO_ACTIVE_HIGH; port { ov5645_ep: endpoint { remote-endpoint csi_ep; >media-ctl -p正常输出里应该能看到 OV5645 的 entity以及它和 CSI-2 接收端、ISP 之间的 link。如果 link 是 disabled用media-ctl -l手动打开。接着用 v4l2-ctl 抓一帧v4l2-ctl -d /dev/video0 \ --set-fmt-videowidth1280,height720,pixelformatYUYV \ --stream-mmap4 \ --stream-toframe.raw \ --stream-count1--stream-mmap4表示用 4 个 buffer 做内存映射--stream-count1只抓一帧就退出。抓到的frame.raw可以用 ffmpeg 转成图片看ffmpeg -f rawvideo -pix_fmt yuyv422 -s 1280x720 -i frame.raw frame.png如果图片是绿的或者只有一半先查>import smbus bus smbus.SMBus(2) addr 0x3c def wr(reg_h, reg_l, val): bus.write_i2c_block_data(addr, reg_h, [reg_l, val]) def rd(reg_h, reg_l): bus.write_i2c_block_data(addr, reg_h, [reg_l]) return bus.read_byte(addr) # 1. 软复位 wr(0x30, 0x08, 0x82) time.sleep(0.05) # 2. 读芯片 ID print(hex(rd(0x30, 0x0A)), hex(rd(0x30, 0x0B))) # 期望输出: 0x56 0x45 # 3. 设置 PLL wr(0x30, 0x35, 0x11) # PLL 控制 wr(0x30, 0x36, 0x30) # PLL 倍频 wr(0x30, 0x37, 0x02) # PLL 分频 # 4. 设置 YUV422 输出 wr(0x43, 0x00, 0x30) # 5. 使能 2 lane MIPI wr(0x30, 0x18, 0x10) # 6. 设置分辨率 1280x720 wr(0x38, 0x0A, 0x05) # H 高位 wr(0x38, 0x0B, 0x00) # H 低位 wr(0x38, 0x0C, 0x02) # V 高位 wr(0x38, 0x0D, 0xD0) # V 低位 # 7. 启动流 wr(0x30, 0x08, 0x02)0x3008是系统控制寄存器写0x82是软复位写0x02是启动流。0x3035到0x3037决定 MIPI 的时钟频率具体值要根据 XVCLK 和目标帧率算。上面这组值对应 24MHz 输入、720p30fps 的常见配置。3.2 YUV422 格式对齐与字节序处理YUV422 在 MIPI 上传输时每个像素周期传两个字节。YUYV 的排列是 Y0 U0 Y1 V0UYVY 是 U0 Y0 V0 Y1。如果接收端按 YUYV 解析但 sensor 输出的是 UYVY颜色就会偏。0x4300设成0x30时默认是 YUYV。但有些模组的出厂配置是 UYVY这时候要么改0x4300为0x32要么在接收端做字节交换。我一般优先改 sensor 寄存器因为接收端改字节序可能影响其他 sensor。还有一个坑是0x4301到0x430D这组寄存器。它们定义 Y、U、V 分量在 MIPI 包里的位置。如果这组值不对出来的图会像“鬼影”一样Y 分量和 UV 分量错位。常见做法是直接抄模组厂商给的初始化序列不要自己改。3.3 用 media-ctl 和 v4l2-ctl 做链路调试如果 v4l2-ctl 抓不到帧先用 media-ctl 看链路media-ctl -p -d /dev/media0输出里会列出所有 entity 和 link。重点看 OV5645 的 pad0 到 CSI-2 接收端的 link 是不是ENABLED。如果是IMMUTABLE但没使能用media-ctl -l ov5645 2-003c:0-csi2:0[1]方括号里的1表示使能。然后设置格式media-ctl --set-v4l2 ov5645 2-003c:0[fmt:YUYV8_2X8/1280x720]注意YUYV8_2X8这个格式名不同内核版本可能写成YUYV8_1X16或YUYV8_2X8。如果格式名不对media-ctl 会报错。我一般先用media-ctl -p看驱动支持的格式列表再照着写。4. 避坑与排查OV5645 MIPI YUV 驱动最常见的五个翻车点4.1 现象I2C 能读到 ID 但 MIPI 无波形原因PLL 没锁或者 MIPI lane 没使能。OV5645 的 MIPI 输出依赖内部 PLL如果0x3035到0x3037配错PLL 不锁clock lane 就没有波形。另外0x3018的 lane 使能位如果没置数据 lane 也不输出。解决先用示波器看 clock lane 有没有差分波形。没有的话把0x3035设成0x11、0x3036设成0x30、0x3037设成0x02试一下。然后确认0x3018的 bit4 是 1。如果用的是 1 lane 模式0x3018要设成0x00。4.2 现象出图花屏颜色错乱原因YUV 字节序不对或者0x4300的格式和接收端不匹配。常见的是 sensor 输出 UYVY 但接收端按 YUYV 解析。解决把0x4300从0x30改成0x32或者反过来。如果改完还是不对检查0x4301到0x430D这组寄存器直接抄模组厂商的初始化序列。4.3 现象图像只有上半部分或者下半部分绿原因MIPI 的虚拟通道Virtual Channel或者数据类型Data Type配置不对。OV5645 的 YUV422 数据类型是0x1E如果接收端期望的是0x1FYUV420就会解析错位。解决查 CSI-2 接收端的寄存器确认它期望的 data type。如果是 FPGA 接收检查 IP 核里的 data type 过滤设置。Linux 平台下media-ctl 的格式名YUYV8_2X8对应的就是0x1E。4.4 现象帧率只有预期的一半原因MIPI 时钟频率不够或者 PLL 分频比不对。OV5645 的 MIPI 时钟和像素时钟是联动的如果0x3036的倍频值太小lane 速率上不去帧率就掉。解决算一下目标帧率需要的 lane 速率。1280x72030fps 的 YUV422 数据量是 12807202*30 55.3MB/s2 lane 下每 lane 约 27.6MB/s加上开销lane 速率至少 300Mbps。对应 PLL 配置0x3036要设到0x30以上。4.5 现象驱动加载后 /dev/video0 不存在原因设备树里的remote-endpoint没对上或者bus-type写错。Linux 的 media 框架要求 sensor 的 endpoint 和 CSI-2 接收端的 endpoint 互相引用如果引用错了链路建不起来video 节点就不生成。解决用media-ctl -p看链路。如果 OV5645 的 entity 根本没出现查 I2C 地址和compatible字符串。如果出现了但 link 是 disabled手动使能。如果 link 使能了但 video 节点还是没有查 CSI-2 接收端的驱动是否加载。5. 进阶技巧用 FPGA 抓 MIPI 数据流做协议级验证5.1 用 FPGA 做 MIPI CSI-2 协议解析的硬件连接当 Linux 驱动层查不出问题时我一般会直接上 FPGA 抓 MIPI 波形。常见做法是用 Xilinx 或 Intel 的 MIPI CSI-2 IP 核把 OV5645 的 clock lane 和 data lane 接到 FPGA 的差分输入对。FPGA 侧配置成 2 lane、YUV422、data type0x1E然后通过 ILA 或者逻辑分析仪看数据包。硬件连接上要注意MIPI 是差分信号阻抗 100 欧姆走线等长。如果 FPC 排线太长或者阻抗不匹配眼图会闭合FPGA 的 MIPI IP 核可能锁不住。我见过有人用 20cm 的杜邦线接 MIPI结果完全没数据——MIPI 不是 I2C不能飞线。5.2 用 ILA 抓 CSI-2 包并解析 YUV 分量FPGA 里抓到的数据是 CSI-2 的 packet。一个典型的 YUV422 帧包含包类型内容说明Short PacketFrame Start帧起始同步Long PacketLine Data每行 YUV 数据Short PacketFrame End帧结束同步Long Packet 的 header 里有 4 字节的包头包含 data type、virtual channel、word count。YUV422 的 data type 是0x1Eword count 是每行字节数。Payload 里就是 YUYV 数据。在 ILA 里设置触发条件为data_type 0x1E然后看 payload 的第一个字节。如果是0x80左右说明 Y 分量正常如果是0x00或者0xFF说明 sensor 没输出有效数据。5.3 从 FPGA 抓包反推寄存器配置是否生效FPGA 抓包最大的好处是能直接验证寄存器配置。比如你改了0x4300从0x30到0x32FPGA 抓到的 payload 里 U 和 Y 的顺序应该反过来。如果没变说明寄存器没写进去或者写进去后被其他初始化序列覆盖了。我一般会做一个对照实验先用 Linux 驱动抓一帧再用 FPGA 抓同一帧对比两者的 YUV 数据。如果 FPGA 抓到的数据正常但 Linux 出图不对问题就在接收端驱动如果 FPGA 也抓不到问题就在 sensor 配置或者硬件连接。从那以后我每次调新 sensor都会先用 FPGA 抓一包数据确认 sensor 本身没问题再回头调 Linux 驱动。这样能把问题域缩小一半不用在驱动和硬件之间反复猜。希望帮到你。本文还有配套的精品资源点击获取