DS90UB935-Q1图形发生器配置实战：从寄存器到1080p30彩条信号

1. 图形发生器在视频系统开发中的核心价值

在嵌入式视频系统，尤其是摄像头模组、车载环视、工业视觉这类对图像传输可靠性要求极高的领域，开发调试阶段最头疼的问题之一就是“链路通了，但图像不对”。是传感器配置错了？是串行器（Serializer）和解串器（Deserializer）的FPD-Link链路不稳定？还是后端处理器（SoC）的CSI-2接口解析有问题？这时候，一个稳定、可控、可预测的视频信号源就成了定位问题的“火眼金睛”。图形发生器（Pattern Generator， 简称PGEN）正是为此而生。它内置于许多高性能视频串行器（如TI的FPD-Link III/IV系列芯片）中，能够不依赖外部图像传感器，自主生成标准的测试图案（如彩条、灰阶、棋盘格），直接通过芯片的CSI-2或DVP接口输出。这意味着，你可以将整个复杂的图像采集链路“一分为二”：用PGEN验证串行器到处理器的传输通路是否完好，极大简化了调试复杂度。

DS90UB935-Q1作为一款广泛用于车载摄像头的FPD-Link III串行器，其内置的图形发生器功能非常典型且强大。但官方数据手册往往只给出寄存器列表和公式，对于如何将这些冷冰冰的寄存器值，与一个生动的、在屏幕上正确显示的1080p30彩条图案联系起来，缺少一个“翻译”过程。很多工程师在配置时，容易在行周期、彩条大小等参数的计算上栽跟头，导致输出图像错位、撕裂或根本不出图。本文将结合我多次调试该芯片的经验，不仅带你逐行解读数据手册的配置逻辑，更会分享从参数计算、寄存器映射到I2C写入的完整实操流程，以及那些手册上不会写的“避坑指南”。

2. 图形发生器核心配置逻辑深度拆解

配置图形发生器，本质上是在用寄存器“描述”一个虚拟的、符合特定视频标准的“信号源”。这个过程和配置一个真实的图像传感器输出时序非常相似。你需要告诉PGEN模块：请以每秒30帧的速率（帧率），每帧输出1920个像素宽、1080行高（分辨率）的有效图像，每个像素用RGB888格式（3字节）表示，并且在有效图像区域填充标准的8色彩条图案。剩下的，如行消隐、场消隐、同步信号等，都需要通过一系列寄存器参数来精确“雕刻”。

2.1 核心寄存器组功能解析

DS90UB935-Q1的图形发生器相关寄存器位于间接访问区域，需通过特定的I2C地址索引进行配置。以下是几个最核心的寄存器及其作用的通俗化解读：

1. PGEN_CTL (0x01)：总开关。写入0x01通常用于启用图形发生器模式。这是启动PGEN输出的第一步。
2. PGEN_CFG (0x02)：配置寄存器。例如，示例代码中的0x33可能包含了彩条模式使能、时序发生器使能等控制位。需要结合数据手册的位定义来理解。
3. PGEN_CSI_DI (0x03)：数据类型（Data Type）和虚拟通道ID（VC-ID）。这是关键之一。MIPI CSI-2协议规定，不同的像素格式对应不同的DT值。例如，RGB888的DT通常是0x24（具体需查MIPI联盟规范或芯片手册）。VC-ID用于区分多路数据流，单路情况下常设为0。
4. PGEN_LINE_SIZE (0x04, 0x05)：一行图像的总字节数。注意，这里不是像素数，而是字节数。对于RGB888，一行1920个像素，总字节数 = 1920像素/行 * 3字节/像素 = 5760字节。转换为十六进制就是0x1680。所以高位字节（LINE_SIZE1）为0x16，低位字节（LINE_SIZE0）为0x80。
5. PGEN_BAR_SIZE (0x06, 0x07)：每个彩色条的宽度（字节数）。这是最容易算错的地方。彩条图案将一行图像在水平方向上等分为8个不同颜色的竖条。因此，每个条的字节数 = 一行总字节数 / 8。5760字节 / 8 = 720字节。720的十六进制是0x02D0。所以BAR_SIZE1为0x02，BAR_SIZE0为0xD0。
6. PGEN_ACT_LPF (0x08, 0x09)：每帧的有效行数（Active Lines Per Frame）。对于1080p，就是1080行（0x0438）。
7. PGEN_TOT_LPF (0x0A, 0x0B)：每帧的总行数（Total Lines Per Frame）。这包括了有效行和垂直消隐期（VBlank）的行数。以标准的1080p30时序为例，总行数通常是1125行（0x0465）。TOT_LPF必须大于ACT_LPF，差值就是垂直消隐行数。
8. PGEN_LINE_PD (0x0C, 0x0D)：行周期（Line Period）。这是整个配置中最需要计算的参数，单位是40/Fc。Fc是正向通道（Forward Channel）的串行数据速率，单位Gbps。公式为：LINE_PD = (1 / (帧率 * TOT_LPF)) * (Fc * 10^9) / 40。计算时务必注意单位统一。
9. PGEN_VBP (0x0E)与PGEN_VFP (0x0F)：垂直后沿（Vertical Back Porch）和垂直前沿（Vertical Front Porch）。它们定义了垂直消隐期内，有效图像区域之前和之后的具体行数。两者之和加上有效行数应等于总行数（TOT_LPF）。示例中VBP=33行（0x21），VFP=10行（0x0A），加上1080行有效行，正好是1123行，与示例的1125行有2行差异，这可能包含了垂直同步（VSYNC）的行数，或者示例采用了略微不同的时序标准。

避坑提示1：时序参数的“标准”与“灵活”视频时序（如1080p30）有多个标准（如CEA-861, VESA）。ACT_LPF和TOT_LPF的绝对值必须严格匹配你后端接收器（如SoC的CSI-2接口）所期望的时序。最稳妥的方法是先让传感器输出正常图像，用逻辑分析仪或芯片的调试寄存器读出实际的HSYNC、VSYNC、HACTIVE、VACTIVE等参数，然后用这些参数来配置PGEN。盲目套用“标准值”可能导致后端无法正确同步。

2.2 彩色条大小计算的算法与陷阱

数据手册中给出了计算PGEN_BAR_SIZE的算法，这里我们结合RGB888的例子再捋一遍，并指出关键点：

1. 确定数据类型与像素/块关系：对于RGB888，1个像素就是1个块（Block），且1个块=3个字节。
2. 计算块/行：一行有1920个像素，也就是1920个块。
3. 计算块/条：1920块/行 ÷ 8条 = 240块/条。这里手册说“向下取整”，但对于1920÷8这种能整除的情况，直接得到整数240。
4. 转换字节/条：240块/条 * 3字节/块 = 720字节/条。写入寄存器0x02D0。

陷阱在于非整除情况。假设一行是1280像素（RGB888），1280÷8=160，依然整除。但如果是一个RAW10格式（10位数据打包，5字节包含4个像素数据）的1280x720图像呢？

• 像素/行：1280
• 块/行：1280像素 ÷ 4像素/块 = 320块
• 块/条：320块 ÷ 8条 = 40块（整除）
• 字节/条：40块 * 5字节/块 = 200字节（0x00C8）

如果计算结果不是整数呢？例如，对于RAW12（12位数据打包，3字节包含2个像素数据）的1280x720：

• 像素/行：1280
• 块/行：1280像素 ÷ 2像素/块 = 640块
• 块/条：640块 ÷ 8条 = 80块（整除）
• 字节/条：80块 * 3字节/块 = 240字节（0x00F0）

关键在于，PGEN_LINE_SIZE（行总字节数）必须是PGEN_BAR_SIZE（条字节数）的整数倍，否则彩条图案无法在一行内完整、对齐地填充，会导致图像错乱或根本无输出。在规划测试分辨率时，应有意识地选择能被8整除的宽度（对于基于像素的格式如RGB），或选择能使“块/行”能被8整除的宽度（对于打包格式如RAW）。

3. 从零开始：配置一个1080p30 RGB888彩条信号

让我们抛开示例代码，从头推导并配置一遍。假设我们使用DS90UB935-Q1，其正向通道速率Fc= 1.6 Gbps（一个常见值），目标是生成标准的1080p30 RGB888彩条。

3.1 参数计算与寄存器值推导

���一步：确定视频基本参数

• 分辨率（有效区域）：1920 x 1080
• 帧率：30 Hz
• 像素格式：RGB888 (3字节/像素)
• 标准时序参考：采用CEA-861-F标准，1080p30的总行数TOTAL_LINES= 1125，有效行ACTIVE_LINES= 1080。水平方向，总像素TOTAL_PIXELS= 2200，有效像素ACTIVE_PIXELS= 1920。（注意：PGEN主要关心行时序，水平总像素通常由LINE_SIZE和行周期隐含决定，不一定直接配置总像素寄存器）。

第二步：计算核心寄存器值

1. PGEN_ACT_LPF：有效行数 = 1080。十进制1080 = 十六进制0x0438。因此：

   • PGEN_ACT_LPF1(0x08) =0x04
   • PGEN_ACT_LPF0(0x09) =0x38

2. PGEN_TOT_LPF：总行数 = 1125。十进制1125 = 十六进制0x0465。因此：

   • PGEN_TOT_LPF1(0x0A) =0x04
   • PGEN_TOT_LPF0(0x0B) =0x65

3. PGEN_LINE_SIZE：一行有效图像的字节数 = 有效像素 * 字节/像素 = 1920 * 3 = 5760。十进制5760 = 十六进制0x1680。因此：

   • PGEN_LINE_SIZE1(0x04) =0x16
   • PGEN_LINE_SIZE0(0x05) =0x80

4. PGEN_BAR_SIZE：每个彩条字节数 =LINE_SIZE/ 8 = 5760 / 8 = 720。十进制720 = 十六进制0x02D0。因此：

   • PGEN_BAR_SIZE1(0x06) =0x02
   • PGEN_BAR_SIZE0(0x07) =0xD0

5. PGEN_LINE_PD：行周期计算。

   • 公式：LINE_PD = (1 / (Frame_rate * TOT_LPF)) * (Fc * 10^9) / 40
   • 代入：Frame_rate=30,TOT_LPF=1125,Fc=1.6 Gbps = 1.6e9 bps
   • 计算一行的时间：1 / (30 * 1125) ≈ 29.6296 us
   • 计算40/Fc单位的时间：40 / (1.6e9) = 25 ns
   • 计算LINE_PD值：29.6296 us / 25 ns = 1185184 / 1000 ≈ 1185.184（这里注意单位换算：1us=1000ns，所以29.6296us = 29629.6ns， 29629.6ns / 25ns = 1185.184）
   • 取整：寄存器值为16位整数，需四舍五入或截断。我们取1185（0x04A1）。更精确的计算应使用分数，但寄存器只接受整数。这个取整误差会导致实际行周期和帧率有微小偏差，对于测试通常可接受。
   • 因此：
     • PGEN_LINE_PD1(0x0C) =0x04
     • PGEN_LINE_PD0(0x0D) =0xA1

6. PGEN_VBP & PGEN_VFP：垂直消隐分配。总消隐行 =TOT_LPF - ACT_LPF = 1125 - 1080 = 45行。这45行包括VBP、VSYNC和VFP。不同标准分配不同。假设我们采用VSYNC=5行，VBP=33行，VFP=7行（合计45行）。那么：

   • PGEN_VBP(0x0E) = 33 =0x21
   • PGEN_VFP(0x0F) = 7 =0x07

3.2 I2C配置代码实现与详解

DS90UB935-Q1的图形发生器寄存器需要通过间接寄存器访问机制来配置。即先向0xB0地址写入0x00（选择Pattern Gen寄存器组），然后通过0xB1指定目标寄存器地址，再通过0xB2写入数据。

以下是完整的、带注释的I2C配置序列：

// 假设使用I2C写函数 WriteI2C(寄存器地址, 数据) // 1. 进入图形发生器间接寄存器访问模式 WriteI2C(0xB0, 0x00); // 选择Pattern Generator寄存器组 // 2. 配置控制与基本设置 WriteI2C(0xB1, 0x01); // 指向PGEN_CTL寄存器 WriteI2C(0xB2, 0x01); // 启用图形发生器（具体位定义需查手册，通常bit0=1使能） WriteI2C(0xB1, 0x02); // 指向PGEN_CFG寄存器 WriteI2C(0xB2, 0x33); // 配置彩条模式等（0x33是一个常见值，代表使能彩条和内部时序发生器） WriteI2C(0xB1, 0x03); // 指向PGEN_CSI_DI寄存器 WriteI2C(0xB2, 0x24); // 设置数据类型为RGB888 (DT=0x24)，VC-ID通常默认为0包含在此值中 // 3. 配置图像尺寸与彩条大小 WriteI2C(0xB1, 0x04); // 指向PGEN_LINE_SIZE1 (高字节) WriteI2C(0xB2, 0x16); // 行大小高字节: 0x16 (对应5760字节的高8位) WriteI2C(0xB1, 0x05); // 指向PGEN_LINE_SIZE0 (低字节) WriteI2C(0xB2, 0x80); // 行大小低字节: 0x80 WriteI2C(0xB1, 0x06); // 指向PGEN_BAR_SIZE1 (高字节) WriteI2C(0xB2, 0x02); // 彩条大小高字节: 0x02 (对应720字节的高8位) WriteI2C(0xB1, 0x07); // 指向PGEN_BAR_SIZE0 (低字节) WriteI2C(0xB2, 0xD0); // 彩条大小低字节: 0xD0 // 4. 配置帧时序（行数） WriteI2C(0xB1, 0x08); // 指向PGEN_ACT_LPF1 (高字节) WriteI2C(0xB2, 0x04); // 有效行高字节: 0x04 (1080) WriteI2C(0xB1, 0x09); // 指向PGEN_ACT_LPF0 (低字节) WriteI2C(0xB2, 0x38); // 有效行低字节: 0x38 WriteI2C(0xB1, 0x0A); // 指向PGEN_TOT_LPF1 (高字节) WriteI2C(0xB2, 0x04); // 总行数高字节: 0x04 (1125) WriteI2C(0xB1, 0x0B); // 指向PGEN_TOT_LPF0 (低字节) WriteI2C(0xB2, 0x65); // 总行数低字节: 0x65 // 5. 配置行周期（关键时序参数） WriteI2C(0xB1, 0x0C); // 指向PGEN_LINE_PD1 (高字节) WriteI2C(0xB2, 0x04); // 行周期高字节: 0x04 (1185) WriteI2C(0xB1, 0x0D); // 指向PGEN_LINE_PD0 (低字节) WriteI2C(0xB2, 0xA1); // 行周期低字节: 0xA1 // 6. 配置垂直消隐（可选，但建议设置以符合标准时序） WriteI2C(0xB1, 0x0E); // 指向PGEN_VBP WriteI2C(0xB2, 0x21); // 垂直后沿: 33行 WriteI2C(0xB1, 0x0F); // 指向PGEN_VFP WriteI2C(0xB2, 0x07); // 垂直前沿: 7行 // 7. 可选：返回主寄存器空间，或进行其他配置 WriteI2C(0xB0, 0x00); // 通常写0x00即可，或根据需要切回其他间接寄存器组

实操心得：I2C写入顺序与稳定性理论上，这些寄存器的写入顺序没有严格要求，因为最终使能位（如PGEN_CTL）可能在最后设置。但良好的习惯是先配置所有参数，最后再打开使能开关。这可以避免在参数不全时，PGEN模块输出不稳定的信号，导致后端接收器失锁。另外，每次写入后，可以添加一个微秒级的短暂延时（特别是对于低速I2C总线），确保芯片内部逻辑稳定。对于关键配置，建议在全部写完后，再读回验证一遍，特别是PGEN_LINE_PD这种计算值。

4. 关键外围寄存器配置与系统集成

图形发生器不是孤立工作的。要让DS90UB935-Q1正确输出CSI-2信号，还必须正确配置与其相关的系统级寄存器。否则，你可能看到PGEN配置无误，但链路上没有数据，或者CSI-2接收端报错。

4.1 CSI-2接口与通道配置

在General_CFG寄存器（地址0x02）中，有两个关键位：

• CSI_LANE_SEL(位5:4)：这决定了CSI-2输出使用几条数据通道。必须根据你硬件实际的连接来设置。例如，如果只连接了1对差分线（LANE0），则必须设置为00（单通道）。如果设置为4通道（11）而硬件只接了一路，信号是无法输出的。
• CONTS_CLK(位6)：连续时钟模式。对于大多数处理器接收端，建议启用连续时钟（设为1），这样时钟线在消隐期也有时钟信号，更利于接收端PLL保持锁定，稳定性更好。

配置示例：

// 配置CSI-2为单通道，连续时钟模式 uint8_t general_cfg_value = 0x00; general_cfg_value |= (0x00 << 4); // CSI_LANE_SEL = 00 (单通道) general_cfg_value |= (1 << 6); // CONTS_CLK = 1 (连续时钟) // 注意保留位和CRC使能位（通常保持默认1使能CRC） general_cfg_value |= (1 << 1); // CRC_TX_GEN_ENABLE = 1 (默认) WriteI2C(0x02, general_cfg_value);

4.2 工作模式选择

MODE_SEL寄存器（地址0x03）决定了串行器的工作模式。对于使用内部图形发生器的场景，通常需要设置为CSI-2同步或非同步模式。

• MODE(位2:0)：000代表CSI-2同步模式（需要外部输入像素时钟和同步信号）。011���表CSI-2非同步内部AON时钟模式（使用芯片内部时钟，无需外部时序输入）。当使用PGEN时，通常选择011（非同步内部时钟），因为PGEN自己就能产生所有时序。
• MODE_OV(位4)：如果你想通过软件覆盖硬件strap引脚设置的模式，需要将此位置1。

配置示例：

// 覆盖strap设置，强制进入CSI-2非同步内部时钟模式 WriteI2C(0x03, 0x10); // 先设置MODE_OV=1 (bit4)，允许覆盖 // 然后设置MODE字段为011，注意寄存器值要整体写入 WriteI2C(0x03, 0x1B); // bit4=1 (MODE_OV), bit2:0=011 (内部时钟模式)

4.3 时钟输出配置（可选但重要）

如果你的系统需要串行器为其他器件（如传感器）提供参考时钟，就需要配置CLKOUT_CTRL0和CLKOUT_CTRL1。这涉及到M/N分频器的计算。

• 时钟源：来自正向通道数据速率经过HS_CLK_DIV分频。
• 输出频率：CLKOUT = (F_line_rate / HS_CLK_DIV) * (M / N)，且必须小于100MHz。
• 计算示例：假设线路速率F_line_rate= 1.6 Gbps，需要输出24MHz时钟给传感器。
  • 选择HS_CLK_DIV= 8分频（010），则时钟源频率 = 1.6G / 8 = 200 MHz。
  • 需要分频比 = 200 MHz / 24 MHz ≈ 8.333。
  • 选择M和N，使得M/N ≈ 1/8.333 ≈ 0.12。例如，M=3, N=25，则实际输出频率 = 200 * (3/25) = 24 MHz。完美匹配。
  • 因此，设置CLKOUT_CTRL0：HS_CLK_DIV=010(放在bit7:5)，DIV_M_VAL=3 (放在bit4:0)。即(2<<5) | 3=0x43。
  • 设置CLKOUT_CTRL1：DIV_N_VAL=25，即0x19。

// 配置CLKOUT输出24MHz (假设线路速率1.6Gbps) WriteI2C(0x06, 0x43); // CLKOUT_CTRL0: HS_CLK_DIV=8 (010), M=3 WriteI2C(0x07, 0x19); // CLKOUT_CTRL1: N=25

注意事项：时钟的稳定性确保计算出的M/N值是合理的（M≥0， N>0），且最终CLKOUT频率在芯片允许范围内（通常<100MHz）。不正确的分频比可能导致时钟输出不稳定或无输出。如果不需要时钟输出，可以将M值设为0来关闭CLKOUT，以节省功耗。

5. 调试与问题排查实战记录

即使按照上述步骤仔细配置，第一次尝试也可能失败。以下是几个最常见的故障现象及其排查思路。

5.1 常见问题速查表

5.2 高级调试技巧：使用BIST模式与状态寄存器

DS90UB935-Q1提供了内置自测试（BIST）模式和丰富的状态寄存器，是高级调试的利器。

1. 强制BIST模式：通过配置REMOTE_BIST_CTRL和FORCE_BIST_ERR寄存器，可以让串行器进入BIST模式，输出特定的伪随机码型。这可以用来隔离问题：如果BIST模式输出正常，但PGEN模式输出异常，问题就锁定在PGEN配置或内部逻辑；如果BIST模式也不正常，那问题很可能在CSI-2接口配置、时钟或物理链路上。

2. 检查警报状态：ALARM_CSI_EN寄存器用于使能各种CSI-2错误警报，而状态寄存器（如SENSOR_STATUS， 虽然主要用于传感器，但部分芯片有专门的CSI-2错误状态寄存器）可以读取具体的错误类型，如DPHY_SYNC_ERR（同步头错误）、CSI_CHKSUM_ERR（校验和错误）。在调试初期，建议使能所有警报，并在配置后读取状态寄存器，看是否有错误标志被置起。

3. 反向通道通信检查：确保解串器（Deserializer）已正确上电、配置，并与串行器建立了稳定的反向通道（BCC）连接。可以通过尝试从处理器端，通过解串器访问串行器的寄存器来验证。如果反向通道不通，某些配置可能无法生效。

一个实用的调试流程是：

1. 先配置最简单的BIST模式，确认基础链路正常。
2. 然后配置PGEN，但使用一个非常低的分辨率和帧率（如640x480@15fps），降低时序复杂度。
3. 逐步提高参数至目标规格，并在每一步用示波器测量CSI-2时钟频率和行频，与计算值比对。
4. 最后，在接收端（如FPGA或SoC）使用MIPI CSI-2分析工具或自定义逻辑，抓取并解析数据包头，确认DT、WC（Word Count）、VC等字段是否正确。

配置图形发生器是一个将视频时序理论、芯片寄存器手册和实际硬件调试相结合的过程。理解每个参数背后的物理意义，严谨地计算，并系统地验证，是成功的关键。DS90UB935-Q1的PGEN功能非常强大，一旦掌握，就能为你的视频系统开发提供一个稳定可靠的“信号灯塔”，大幅提升调试效率。