FPGA驱动4.3寸RGB触摸屏：Verilog时序与I2C实战解析

说实话，把一块RGB接口的4.3寸触摸屏点亮，说难不难，说简单也真不简单。我从流水灯玩到数码管，再玩到串口收发，一直觉得显示这块是FPGA学习路上最值得啃的硬骨头。RGB屏不像SPI屏那样有现成的控制器芯片帮你刷像素，它把时序、同步、像素时钟全抛给你，逼着你去真正理解显示设备的工作方式。这篇文章就把我用Verilog驱动4.3寸RGB电容触摸屏的整个思路、代码和调试过程完整复盘一遍，适合已经会Verilog基础语法、想挑战一个综合项目的朋友。

先说清楚这个项目做到什么程度：板子上电后，屏幕会显示红、绿、蓝、白四色横条；手指点到哪里，对应位置就会出现一个黄色十字光标；手指移开，光标消失。整个工程分两条链路：显示链路负责把图像数据送进RGB屏，触摸链路通过I2C读取电容屏控制芯片的坐标值，再叠加到显示画面上。无论你是想搞FPGA图像处理、做仪器界面，还是纯粹练手，这个项目都能帮你把“时序”和“状态机”这两件事彻底吃透。

1. 项目拆解：RGB触摸屏背后要解决的三件事

1.1 RGB接口屏和常见TFT屏有什么不一样

很多初学者第一次接触屏幕是用STM32或ESP32驱动0.96寸OLED、1.8寸TFT，这些屏里面内置了控制器芯片，比如ST7735、SSD1306之类。你在单片机上写命令、写像素数据，控制器会帮你管理行列扫描、刷新率这些底层细节，你只需要关心SPI或I2C接口怎么发数据就行。

RGB接口屏完全不同。它的面板上只有行信号、场信号、像素时钟、数据使能以及并行RGB数据线，没有控制器帮你生成任何时序。屏幕内部就像一张按行扫描的“像素矩阵”，每来一个像素时钟，它就把当时数据线上出现的24位颜色数据写到当前行列位置，然后自动跳到下一个位置。如果像素时钟中断、行场同步信号异常，画面就会出现撕裂、偏移甚至完全黑屏。

所以驱动RGB屏的关键，不是在“发数据”，而是在“生成时序”。你需要用计数器精确模拟屏幕的扫描过程：一行一行从左到右扫，扫完一行就换行，扫完一屏再从左上角重新开始。这个听起来复杂，实际拆开就是几个计数器和比较器的事情。

1.2 硬件准备与整体框图

我的硬件组合比较常规：一块Xilinx Artix-7系列的开发板，板载50MHz晶振；一块4.3寸480×272的RGB电容触摸屏模组。屏幕模组上集成了FT5206电容触摸控制器，触摸信号通过I2C接口引出，显示接口是RGB888，模组自带背光驱动电路，只需要一个背光使能脚。

整体框图很简单：FPGA内部用PLL把50MHz时钟转成9MHz像素时钟，送给LCD驱动模块生成行场同步和有效区信号；图像生成模块根据当前扫描位置输出颜色数据；触摸读取模块通过I2C定时读取FT5206的坐标寄存器，把触摸坐标送进图像生成模块，画一个光标。最后所有信号通过引脚约束连到屏幕模组。

1.3 为什么这套方案推荐用Verilog来写

有人可能会问，这种RGB屏为什么不用现成的HDMI转RGB芯片、或者直接用带LCD控制器的MCU？一个很重要的原因是：RGB屏的行场时序和像素时钟千变万化，FPGA可以做到精确到单时钟周期的控制。用Verilog写，一方面能让你彻底看清显示时序的本质，另一方面后续如果要做图像缩放、边缘检测、OSD叠加，这些都是在像素流上做文章，用硬件描述语言非常自然。

而且Verilog写出来的驱动代码可移植性也强。同一个LCD驱动模块，换成800×480的屏幕，只需要改几个参数；换成其他分辨率的RGB屏，调整有效区和同步参数就行。这种“一套逻辑适配多块屏”的体验，是MCU工程很难给你的。

2. 时序与硬件：先搞懂像素时钟和引脚连接再写代码

2.1 行场同步和有效区，到底谁先谁后

RGB屏扫描的核心就是“行场同步”。想象屏幕左上角有一个光标，它先从左上角开始，一个像素一个像素向右移动，每移动一格就需要一个像素时钟。等到光标到达这一行最右边，屏幕会进入一小段“行消隐”时间，这时候HSYNC拉低（或者拉高，取决于屏的极性），通知屏幕“我要换行了”。然后光标回到下一行的最左边，继续扫描。

一行扫完，就轮到VSYNC出场。当最后一行的最右边扫完之后，VSYNC拉低，通知屏幕“这一屏扫完了”，接下来是场消隐时间，光标回到左上角，开始下一帧。整个过程中，DE（数据使能）信号只在一行中的“有效像素区”为高，告诉屏幕“现在数据线上的颜色是真实有效的”。消隐期间DE为低，数据线可以随意。

我们常说的“前肩”“后肩”“同步脉宽”，其实就是同步信号和有效区之间的等待时间。这些等待时间不能省，因为你不知道屏幕内部电路需要多少时间才能安全地把光标从右挪到左、从底挪到顶。具体数值以屏幕规格书为准，我用的这块4.3寸屏比较常规，行同步脉宽41个时钟，行前肩2个时钟，行后肩2个时钟；场同步脉宽10行，场前肩2行，场后肩2行。

2.2 像素时钟9MHz是怎么算出来的

计算像素时钟可以套一个很直观的公式：像素时钟 ≈ 帧率 × 每行总像素 × 总行数。其中每行总像素等于有效区、前肩、同步、后肩相加，总行数同理。

以480×272@60Hz为例：水平总长度480+2+41+2=525，垂直总行数272+2+10+2=286，那么像素时钟就是525×286×60≈9MHz。这个9MHz就是这么来的。有的屏时序参数稍有差异，算出来可能是8.5MHz或者9.2MHz，问题不大，PLL不一定要锁到整数倍，只要在这个范围内屏幕就能正常工作。

我实际工程里用PLL把50MHz倍频得到9MHz像素时钟。如果你手头没有PLL，也可以用一个简单的计数器把50MHz分频成8.33MHz（50/6），虽然频率低了一点，但多数屏也能显示。正式项目我建议还是走PLL，让像素时钟精确满足屏的规格。

2.3 4.3寸屏引脚与FPGA连接表

拿到屏幕模组，先别急着接线，把模组上的丝印和规格书信号名核对一遍。我这块屏的接口大致如下：

接线时注意几个细节：RGB数据线数量多，最好用杜邦线逐一对应，避免交叉；I2C的SDA和SCL一定要接上拉电阻（一般模组自带了，没有的话在板上加4.7kΩ）；背光是高电平点亮，别一上来就接错信号导致屏幕不亮还以为程序有问题。触摸部分的RST可以先直接接高电平，让触摸芯片处于正常供电状态。

3. 显示链路从0到1：LCD驱动、彩条和光标

3.1 LCD驱动模块：用计数器还原整屏扫描过程

显示链路的核心是一个LCD驱动模块。它的任务就是跑两个计数器：一个水平计数器h_cnt，一个垂直计数器v_cnt，然后用组合逻辑判断当前是否处于有效区、同步信号该拉低还是拉高。

下面是我用的lcd_driver.v完整代码，参数部分可以直接改：

module lcd_driver ( input wire clk, input wire rst_n, input wire [23:0] pixel_data_in, output reg [23:0] pixel_data_out, output reg lcd_hs, output reg lcd_vs, output reg lcd_de, output reg [9:0] h_cnt, output reg [9:0] v_cnt ); localparam H_ACTIVE = 480; localparam H_FP = 2; localparam H_SYNC = 41; localparam H_BP = 2; localparam V_ACTIVE = 272; localparam V_FP = 2; localparam V_SYNC = 10; localparam V_BP = 2; // 总长度 localparam H_TOTAL = H_ACTIVE + H_FP + H_SYNC + H_BP; // 525 localparam V_TOTAL = V_ACTIVE + V_FP + V_SYNC + V_BP; // 286 // 水平、垂直计数 always @(posedge clk or negedge rst_n) begin if (!rst_n) begin h_cnt <= 10'd0; v_cnt <= 10'd0; end else begin if (h_cnt == H_TOTAL - 1) begin h_cnt <= 10'd0; if (v_cnt == V_TOTAL - 1) v_cnt <= 10'd0; else v_cnt <= v_cnt + 1'b1; end else begin h_cnt <= h_cnt + 1'b1; end end end // HSYNC 和 VSYNC，我这里按低有效设计 always @(posedge clk or negedge rst_n) begin if (!rst_n) begin lcd_hs <= 1'b1; lcd_vs <= 1'b1; end else begin if (h_cnt < H_SYNC) lcd_hs <= 1'b0; else lcd_hs <= 1'b1; if (v_cnt < V_SYNC) lcd_vs <= 1'b0; else lcd_vs <= 1'b1; end end // 有效区判断 wire h_active = (h_cnt >= H_SYNC + H_BP) && (h_cnt < H_SYNC + H_BP + H_ACTIVE); wire v_active = (v_cnt >= V_SYNC + V_BP) && (v_cnt < V_SYNC + V_BP + V_ACTIVE); // DE 信号 always @(posedge clk or negedge rst_n) begin if (!rst_n) lcd_de <= 1'b0; else lcd_de <= h_active & v_active; end // 数据输出，只在有效区透传 always @(posedge clk or negedge rst_n) begin if (!rst_n) pixel_data_out <= 24'b0; else if (h_active & v_active) pixel_data_out <= pixel_data_in; else pixel_data_out <= 24'b0; end endmodule

这里有一个很容易踩的坑：h_cnt和v_cnt刚计数到消隐区的时候，有效区为假，但是DE和数据输出的寄存器是打了一拍的，所以HS、VS、DE、DATA之间会存在一个时钟周期的相位差。只要保持所有输出信号都是从reg里出去的，相位差是统一的，屏幕通常不会出问题。千万别让DE走组合逻辑直接输出、数据却从reg输出，那样相位对不上，画面会怪怪的。

3.2 图像生成模块：彩条测试与中心十字光标

LCD驱动模块只负责把pixel_data_in搬到屏幕上，至于屏幕显示什么，由另一个模块决定。我写了一个image_gen模块，它根据当前扫描到的行列坐标，生成四种颜色横条，同时接收触摸模块的坐标，在对应位置画十字光标。

module image_gen ( input wire clk, input wire rst_n, input wire [9:0] h_cnt, input wire [9:0] v_cnt, input wire touch_valid, input wire [11:0] touch_x, input wire [11:0] touch_y, output reg [23:0] pixel_data ); localparam H_ACTIVE_START = 43; // H_SYNC + H_BP localparam V_ACTIVE_START = 12; // V_SYNC + V_BP wire h_valid = (h_cnt >= H_ACTIVE_START) && (h_cnt < H_ACTIVE_START + 480); wire v_valid = (v_cnt >= V_ACTIVE_START) && (v_cnt < V_ACTIVE_START + 272); wire [9:0] px = h_cnt - H_ACTIVE_START; wire [9:0] py = v_cnt - V_ACTIVE_START; always @(posedge clk or negedge rst_n) begin if (!rst_n) begin pixel_data <= 24'b0; end else if (h_valid & v_valid) begin // 四色横条，方便判断数据线是否接对 if (py < 68) pixel_data <= 24'hFF0000; // 红 else if (py < 136) pixel_data <= 24'h00FF00; // 绿 else if (py < 204) pixel_data <= 24'h0000FF; // 蓝 else pixel_data <= 24'hFFFFFF; // 白 // 在触摸坐标位置叠加十字光标 if (touch_valid) begin if ((px >= touch_x - 5 && px <= touch_x + 5 && py == touch_y) || (py >= touch_y - 5 && py <= touch_y + 5 && px == touch_x)) pixel_data <= 24'hFFFF00; // 黄色 end end else begin pixel_data <= 24'b0; end end endmodule

仔细看会发现在四色横条的基础上加了十字光标，颜色直接覆盖为黄色。这里px和py是相对有效区的坐标，范围分别是0到479、0到271，正好对应屏幕的480×272。如果触摸坐标需要对X或Y方向做翻转，就在这个模块里转换一下再比较，不要在触摸底层乱改。

3.3 顶层接线与时钟生成

顶层模块把上面两个模块和PLL串起来。我用的是Vivado的Clocking Wizard IP，输入50MHz，输出9MHz，名称叫clk_wiz_0。如果你的开发板是其他品牌，用对应的PLL IP或者手动分频都行。

module top_lcd_touch ( input wire clk_50m, input wire rst_n, output wire lcd_clk, output wire lcd_hs, output wire lcd_vs, output wire lcd_de, output wire lcd_bl, output wire [23:0] lcd_rgb, inout wire tp_sda, output wire tp_scl, output wire tp_rstn ); wire clk_pix; wire locked; wire [9:0] h_cnt; wire [9:0] v_cnt; wire [23:0] pixel_data; wire [11:0] touch_x; wire [11:0] touch_y; wire touch_valid; clk_wiz_0 u_clk_wiz ( .clk_in1 (clk_50m), .reset (~rst_n), .locked (locked), .clk_out1(clk_pix) ); lcd_driver u_lcd_driver ( .clk (clk_pix), .rst_n (rst_n & locked), .pixel_data_in (pixel_data), .pixel_data_out(lcd_rgb), .lcd_hs (lcd_hs), .lcd_vs (lcd_vs), .lcd_de (lcd_de), .h_cnt (h_cnt), .v_cnt (v_cnt) ); image_gen u_image_gen ( .clk (clk_pix), .rst_n (rst_n & locked), .h_cnt (h_cnt), .v_cnt (v_cnt), .touch_valid (touch_valid), .touch_x (touch_x), .touch_y (touch_y), .pixel_data (pixel_data) ); touch_ctrl u_touch_ctrl ( .clk (clk_50m), .rst_n (rst_n & locked), .sda (tp_sda), .scl (tp_scl), .touch_valid (touch_valid), .touch_x (touch_x), .touch_y (touch_y) ); assign lcd_clk = clk_pix; assign lcd_bl = rst_n; assign tp_rstn = rst_n; endmodule

PLL锁定之前，FPGA的时钟输出还不稳定，所以我用locked信号作为所有模块的复位条件之一，避免屏幕抓到乱七八糟的数据。这个细节特别重要，很多第一次做PLL的哥们儿直接忽略了locked，结果屏幕偶尔闪屏，查半天查不到。

4. 触摸链路从0到1：I2C读FT5206坐标

4.1 FT5206寄存器初体验：0x02、0x03、0x05

RGB屏显示正常之后，接下来就是把触摸数据读回来。触摸链路说复杂也复杂，说简单也简单，本质就是一个I2C从机设备的寄存器读取操作。

FT5206是这颗触摸控制器的核心，它通过I2C接口对外提供触摸状态和坐标。常用的寄存器有这几个：

设备地址是0x38（7位地址）。I2C通信时，写操作发送的8位地址是0x70（0x38左移1位再或0），读操作发送0x71。这也是初学者最容易懵的地方：7位地址和8位地址经常搞混。

以一次读取为例：先发送起始条件，接着发送0x70并等待ACK，然后发送寄存器地址0x02；紧接着重新发送一个起始条件（重复起始），再发送0x71并等待ACK；随后连续读取6个字节，分别是0x02、0x03、0x04、0x05、0x06、0x07的寄存器内容。前5个字节读完后要回ACK，最后一个字节回NACK，最后发送停止条件。

4.2 I2C读流程：从START到连续读6个字节

我习惯把I2C读序列分成几个状态来写，代码结构更清晰。下面是核心状态机的伪代码级别描述：

• IDLE：等待触摸读取启动信号，每隔10ms触发一次。
• START：产生起始条件，此时SCL保持高，SDA从高拉低。
• SEND_ADDR_W：发送0x70，等待从机ACK。
• SEND_REG：发送寄存器地址0x02，等待ACK。
• RESTART：再次产生起始条件。
• SEND_ADDR_R：发送0x71，等待ACK。
• READ_BYTE：连续读6字节，每字节8位。前5字节发ACK，最后一字节发NACK。
• STOP：产生停止条件，SDA从低拉高，SCL保持高。
• PARSE：把读回的寄存器拼接成坐标，送入图像生成模块。

坐标拼法是：X = (0x03寄存器值 << 4) | (0x04寄存器值的高4位)，Y同理。这里注意，0x04寄存器的低4位是无效的，只有高4位有效。代码里可以用按位与和移位处理。

4.3 触摸状态机代码片段与完整工程说明

因为完整I2C控制器的代码比较长，我这里把最关键的读坐标状态机部分整理出来。如果你的目标是赶紧跑起来，也可以直接用FPGA厂商自带的I2C IP，或者把下面这套状态机扩展成完整模块。

// 触摸读取状态机核心结构 localparam IDLE = 5'd0; localparam START = 5'd1; localparam ADDR_W = 5'd2; localparam ACK1 = 5'd3; localparam REG_ADDR = 5'd4; localparam ACK2 = 5'd5; localparam RESTART = 5'd6; localparam ADDR_R = 5'd7; localparam ACK3 = 5'd8; localparam READ_LOOP = 5'd9; localparam STOP = 5'd10; localparam DONE = 5'd11; always @(posedge clk or negedge rst_n) begin if (!rst_n) begin state <= IDLE; end else begin case (state) IDLE: if (read_trig) state <= START; START: state <= ADDR_W; ADDR_W: begin // 逐位发送0x70 if (bit_done) state <= ACK1; end ACK1: if (ack_done) state <= REG_ADDR; // ... 类似地推进 DONE: state <= IDLE; endcase end end

真正的I2C位时钟生成，建议用计数器做一个100kHz的SCL，再在SCL低电平期间改变SDA，SCL高电平期间采样数据。不要天真地把SCL做成50MHz自由运行的方波，否则SDA变化时序完全对不上。

完整工程我放在文末资源区，里面包含可综合的touch_ctrl.v、引脚约束XDC文件，以及一个简单的仿真testbench。工程里触摸读取模块我做了双保险：先读一次设备ID寄存器0x00，如果读不到0xA8就打印一串ASCII警告，方便排查I2C通信问题。

5. 调试实录与避坑指南

5.1 屏幕没反应，先查供电、复位、背光

屏幕完全黑屏，是最容易让人慌的。其实你按顺序排查就很快：先量背光引脚电压，如果是高电平还黑，说明背光电路有问题，大概率是模组供电没接对；然后看PLL锁定信号，用逻辑分析仪抓一下像素时钟有没有；最后看复位按键有没有抬起，如果复位一直拉低，所有模块都停在复位态，自然什么都不显示。

我在第一次上板时遇到一个奇怪现象，屏幕背光亮了但没有任何颜色。排查了很久，发现是顶层把lcd_rgb接到了24位数据，但模组实际只接了RGB666，低两位悬空。这事本身不影响显示，因为高6位数据没错。真正的问题是DE信号没接，屏幕不知道什么时候才算有效数据，整个画面全黑。所以提醒一下：DE不是可有可无的，大多数RGB屏都用DE作为数据有效判定，务必确认引脚已经连到FPGA。

5.2 画面不对，从彩条颜色判断数据线接错

如果你看到了彩条但颜色顺序不对，比如红绿变成了绿红，不用怀疑，就是RGB数据线接反或者接错位了。用四色横条测试图案的好处就在这：看到整屏是红色，说明R通道数据正常；看到绿色该在第二段却出现在第一段，说明最可能G和R两组线交叉。

还有一种常见问题是画面整体偏左或者偏右，明明图案显示出来了，但有半截跑到屏幕外。这个一般是行后肩设置不对。把H_BP调大，画面会整体右移；调小，画面左移。你可以做一个实验：在上电后按一下按键，让H_BP在2、4、8这三个值之间切换，观察画面位置，这样就能理解后肩参数对画面偏移的影响。

颜色数据位数也要小心。我的代码是24位RGB888，但很多4.3寸屏模块是RGB666，只有18根数据线。顶层例化的时候，让高6位接到屏的R/G/B[5:0]，低2位直接绑0，这样降低位宽后颜色整体会偏淡一点，但不会错乱。不要试图把24位硬塞给18位，那样反而会错位。

5.3 触摸读不到数据，I2C上拉和时序是重灾区

触摸部分最常见的坑是I2C没有上拉电阻。FT5206的SDA和SCL都是开漏输出，必须外接上拉才能出来高电平。很多模组板上已经贴了上拉电阻，但如果你是买的那种裸屏排线转接板，很可能没有。测量方法很简单：断电后量SDA对地电阻，如果接近无穷大，大概率没上拉。加上4.7kΩ电阻再试。

第二个坑是地址搞错。寄存器读设备ID时，如果发现读出来全是0xFF，大概率是地址写错了。先确认FT5206的7位地址是0x38还是0x3A，有些模组通过地址引脚拉高拉低来切换。我的模组是0x38，如果你的读不到，试着把设备地址改成0x3A试试。

第三个坑和时序有关。I2C的SCL频率虽然规范上可以到400kHz，但FT5206不少模组跑100kHz最稳。采样时机也很关键：释放SDA后，要等到SCL高电平稳定后再采样，不能刚释放就立刻读，否则采到的是SDA还没翻转完全的电平。我的状态机里专门用一个时钟周期的等待，确保采样点落在SCL高电平的中间位置。

5.4 坐标方向反了？别急着改代码，先判断正坐标

触摸坐标读回来之后，你会发现一个有意思的现象：手指往下滑，屏幕上的光标反而往上跑。这是因为不同模组的触摸芯片Y轴方向和液晶显示坐标方向不一定一致。FT5206内部的坐标原点通常在左上角，但有些模组因为排线方向不同，实际上Y轴是反的。

解决办法有很多，最简单的是在image_gen模块里做坐标翻转，例如把touch_y改为271减去touch_y再参与比较。这个操作不需要动触摸底层代码，也不影响数据精度。我在调试时喜欢先做一个测试手势：手指从左下角划到右上角，如果光标方向和手指方向完全一致，那就说明不需要翻转；如果上下左右都反了，就在顶层做一次坐标映射。别小看这一步，坐标反了在正式项目里会造成极其糟糕的体验。

还有一点，FT5206单点模式上报的坐标有时候会轻微抖动，尤其是手指停在屏幕上的时候，光标会在两三个像素之间跳。如果你后续要做手写识别或者精确点击，建议加一个简单的均值滤波：连续采3次，取中间值或者平均值。这个滤波在Verilog里用移位加加法就能实现，不会消耗太多逻辑资源。我在工程里加了一版最简单的三点中值滤波，效果很明显。

最后再分享一点自己的调试心得

整个项目从零到全部跑通，我大概花了两天半。第一天卡在PLL的locked信号接入上，第二天卡在I2C的ACK等待死循环上，第三天下午才真正把触摸坐标和画面光标联动起来。回头来看，这个项目最有价值的地方不在于最终效果多炫酷，而在于它逼着你一次性接触了PLL时钟、计数时序、组合逻辑有效区判断、状态机通信、开漏总线仲裁这么多知识点。

如果你也打算照着做一遍，我有三个建议：第一，先把显示部分单独调通，再碰触摸，不要一开始就两条链路一起调试；第二，写代码的时候统一信号的时序，确保DE、数据、行场同步都从寄存器输出，避免组合逻辑和时序逻辑混搭；第三，I2C状态机里一定要加超时退出机制，否则从机没ACK，你的状态机会卡在等待里，连仿真都测不下去。

后面的扩展方向也很明确：把彩色横条换成一张存在ROM里的图片，就可以做成开机画面；把触摸坐标转化成简单的点击区域判断，就能做一个带GUI的菜单；再加上文字字模模块，就能显示汉字和数字。RGB屏这条路一旦走通，后面很多界面类项目都会变得顺手很多。