做仪表类产品的人对 CYW240128 这款屏应该不陌生。240×128 的图形点阵 LCD内置主流控制器接口简洁能显示文字也能画图在很多工控面板、小型仪器、医疗设备上都能看到它的身影。我最近在一个基于 ESP32 与 FPGA 的项目里用到了这块屏第一件事就是联系屏厂要驱动例程。例程很快就拿到了但打开工程一看心里凉了半截代码是面向 STM32 写的底层清一色库函数调用跟 ESP32 没有任何关系FPGA 相关的调试代码更是连影子都没有。这个问题其实很有代表性。很多第一次把 CYW240128 接进自己方案的工程师都会卡在同一个地方屏厂给的例程在 MCU 上能点屏但换到 ESP32 FPGA 这种MCU 做控制、FPGA 做数据和时序的组合时代码根本没办法直接用。这篇文章我就以这次实际项目为例把例程能抄什么、不能抄什么、剩下的怎么自己拼完整讲一遍也会把 ESP32 侧和 FPGA 侧的移植要点、调试方法、踩过的坑一起整理出来。如果你正准备把这块屏接进类似的异构平台这篇文章应该能帮你省下不少走弯路的时间。1. 先弄清楚 CYW240128 和驱动例程到底给了什么1.1 这块屏的底细分辨率、控制器与接口CYW240128 是一款 240×128 分辨率的图形点阵液晶模组单色显示常见为 STN 或 FSTN 类型带背光。和那种需要外部显存的裸屏不同这块屏自带显示 RAM 和控制芯片MCU 只需要按照控制器的协议往里面写数据屏自己会完成扫描刷新。换句话说它内部的控制器承担了显存管理 时序生成两大任务外部芯片的压力小很多。内部控制器是移植时最需要关心的部分。CYW240128 不同批次可能搭载不同型号的控制器最常见的是 SED1335 兼容系列比如 RA8835、NT7534 等这些控制器的命令集基本一致指令代码也差不多。拿到屏之后我建议第一时间确认一下背面丝印或规格书上标注的控制器型号因为后面对比度设置、显存分区、扫描方向的个别参数可能因控制器而异搞错了屏会异常。接口方面这块屏通常引出 8080 或 6800 并行接口信号线包括 D0~D7、CS、WR、RD、A0也叫 RS区分命令和数据、RST 等。部分带 SPI 的可选版本也存在但主流还是并口。并口意味着一次传 8 位数据天然适合接到 MCU 的 GPIO 或者 FPGA 的 IO 上。显存需求也可以先算一笔账。240×128 30720 个像素点按每字节存 8 个点来算就是 30720 / 8 3840 字节也就是 3.75KB。这个容量并不大MCU 侧完全可以在内存里维护一份镜像方便做画点、画线的逻辑运算再整块同步给屏。1.2 厂商例程里通常有什么、不会有什么先给一个明确结论屏厂给的例程基本不会包含 ESP32 与 FPGA 的完整调试代码。原因不难理解屏模组厂商的客户千差万别有的用 51有的用 STM32有的用国产 MCUFPGA 平台更是分散在 Xilinx、Altera、高云、紫光等不同厂家里。厂商没有精力为每个平台维护一套完整例程所以最常见的做法是给一套 STM32 标准库或 HAL 库的例程再加一份控制器数据手册剩下的事情让用户自己移植。那例程里真正有价值的是什么我把这套 STM32 例程翻了一遍发现核心资产其实是三样初始化序列控制器上电后需要写入一组 SYSTEM SET、SCROLL、CURSOR FORM 等命令和参数这组参数和屏的物理特性强相关不同尺寸、不同驱动电压的屏配置不一样。这组参数如果自己瞎试可能试一整天都不亮直接抄例程是最稳的。单字节读写函数例程底层一定封装了写命令写数据读状态这几个基础操作虽然平台相关但操作逻辑和顺序可以参考照着换成自己的 GPIO 就行。显存地址组织方式例程里关于光标地址、显示起始地址、显示区划分的配置逻辑揭示了控制器在内部怎么把显存映射到屏幕上的像素位置。这部分不搞清楚后面画图一定会画花。而例程里没有的部分恰恰是你在异构平台上最需要的ESP32 的引脚配置、GPIO 寄存器直写代码、I2S/DMA 方案、FPGA 显示控制器状态机、双口 RAM 显存、MCU 与 FPGA 之间的通信协议。这些需要自己设计也是这篇文章接下来要解决的重点。所以别急着删例程。初期移植时把初始化序列原封不动地保留下来把底层 IO 操作替换掉一套可用的驱动框架很快就能搭出来。2. 为什么 ESP32 FPGA 要自己拼一套完整调试代码2.1 ESP32 直驱 LCD 的三种做法与取舍ESP32 驱动这类并口图形屏方案不算多但每种方案差异很大选型直接影响后续代码结构。第一种是 GPIO 直接模拟 8080 时序。这是最基础的做法把 D0~D7、WR、RD、CS、A0、RST 全部接到 GPIO用软件控制电平翻转来模拟控制器的读写时序。优点是任意引脚都可以用接线灵活调试方便对新手很友好缺点是每条数据都要靠 CPU 一条条翻转速度慢。实测用 GPIO 模拟方式写一个字节算上函数调用和延时大概需要几微秒刷一屏 3840 字节就要十几毫秒做简单状态显示没问题做高频动态刷新会比较吃力。第二种是 ESP32 的 I2S 外设并行模式加 DMA。ESP32 的 I2S 外设除了传音频还能配置成 8 位并行输出模式把 D0~D7 接到 I2S 的数据线上再利用 LRCK、BCK 引脚生成 WR 和 RS 控制信号。初始化好之后往缓冲区里塞数据DMA 会自动把数据按时序发出去CPU 几乎不参与刷新速度比 GPIO 模拟快一个数量级。缺点是引脚选择受限I2S 信号只能映射到固定引脚PCB 布线时要提前规划。第三种就是让 FPGA 来做桥接和驱动。这种方式下ESP32 不直接接触 LCD 总线而是通过 SPI、UART 或并行总线把要显示的数据发给 FPGAFPGA 内部用逻辑模拟出控制器的时序由 FPGA 完成对 LCD 的刷新。这样 ESP32 的 CPU 负担最轻刷新时序稳定而且 FPGA 本来就在数据链路上这样的架构顺理成章。我做项目时选择的是第三种方案因为系统里 FPGA 本身还要做实时数据采集和直方图统计它天然就是数据源。LCD 放到 FPGA 侧驱动省去了中间一次FPGA 把数据处理完再搬给 ESP32ESP32 再转发给屏幕的链路。当然如果你的系统里 FPGA 只是配角ESP32 直驱或者 I2S 方案会更简单这个后面可以按项目需求取舍。驱动方式典型刷新速率引脚占用CPU 占用调试难度适用场景GPIO 模拟每字节几微秒级别高约12~16个引脚高低静态仪表、调试验证I2S 并行 DMA每字节几百纳秒级别中引脚受限制低中动态刷新、音频项目复用FPGA 桥接驱动每字节亚微秒级别中极低中高数据链完整、刷新要求高2.2 FPGA 在显示链路里到底是干什么的这套系统里 FPGA 承担三件事数据采集、数据统计、LCD 驱动。比如我这个项目里FPGA 通过高速接口接收前端信号做 TDC 时间数字转换并统计出直方图数据。这些统计数据最终不仅要通过 ESP32 上报到网络还要在 CYW240128 上实时显示成曲线。如果让 ESP32 从 FPGA 拉回数据再画点显示不仅多一层搬运CPU 也会被频繁的绘图操作占住导致网络响应迟钝。FPGA 这边把 LCD 显示控制器做成一个独立模块内部用双口 RAM 做显存。ESP32 通过网络或本机用户输入改变显示内容时通过 SPI 接口把数据写入这个双口 RAM 的一端FPGA 的显示控制器从另一端不断读取显存内容并生成 8080 时序信号送给屏。这样一来刷屏和数据处理并行进行ESP32 只在内容变化时介入系统整体流畅度会好很多。2.3 两块代码的边界该怎么画明确了架构之后ESP32 侧代码和FPGA 侧代码的划分就清晰了。ESP32 侧要做的初始化 SPI 接口与 FPGA 通信设计一套简单的显示指令协议比如写入坐标 颜色数据清屏画矩形维护一份需要显示的界面逻辑通过 OTA 升级更新显示固件。它不需要关心 8080 时序怎么翻转不需要关心 A0 什么时候拉高。FPGA 侧要做的实例化双口 RAM 显存实现 SPI 从机接收模块解析 ESP32 发来的指令并写入显存实现 SED1335 类控制器的时序生成模块用状态机产生 WR、RD、A0、CS 和 D0~D7 信号把显存中的像素数据搬运到屏幕上。边界画清楚之后两边可以并行开发联调时只需要约定好协议。这一步很值得花时间因为后面所有问题排查都是在哪一侧出了问题这个前提之上进行的。3. 从例程到可跑通的代码完整移植思路3.1 建立硬件抽象层只改 4 个函数不管用哪种方式驱动我强烈建议你先做一个小小抽象层。把厂商例程中直接操作硬件的最底层函数找出来它们通常是下面几个void LCD_Reset(void); void LCD_Write_Cmd(uint8_t cmd); void LCD_Write_Data(uint8_t data); void LCD_DelayUs(uint32_t us);厂商例程里所有功能函数包括初始化、清屏、画点、显示字符串最终都是调用这几个底层函数实现的。所以移植时只要把这四个函数替换成自己平台的实现上层代码几乎不用动。这个抽象层的价值在于你可以在 ESP32 上先用 GPIO 模拟实现这四个函数快速验证初始化序列是否正确等系统调试稳定之后再把它们换到 I2S 或者 FPGA 方案上上层显示逻辑完全不用改。这就是典型的模块化思路也是后面例程能不能跨平台复用的关键。3.2 初始化序列这一步错了一切白搭控制器上电后必须写入一组配置命令。以 SED1335 系控制器为例核心命令包括 SYSTEM SET命令码 40H、SCROLL44H、CURSOR FORM5DH等每一条后面都跟着若干个参数。我再次强调这些参数值不要自己凭感觉推算直接用屏厂例程里提供的配置因为字符宽度、扫描行数、显存起始地址这些参数和屏的玻璃结构直接相关厂商调好了就是最优解。初始化时序同样重要。上电后要先给 RST 引脚一个低脉冲典型宽度在微秒级别等待控制器完成内部复位再依次写入命令。如果初始化时序不对后续所有操作都可能无效表现为屏幕完全不亮、全屏黑或灰屏。下面是一段典型的 ESP32 GPIO 模拟初始化流程可以参考void LCD_Init(void) { LCD_Reset(); // 先复位RST 拉低-延时-拉高 LCD_DelayUs(200); // 以下命令序列从厂商例程原样保留 // SYSTEM SET: 设置显示区域、字符宽度、扫描行数等 LCD_Write_Cmd(0x40); LCD_Write_Data(0x30); LCD_Write_Data(0x87); LCD_Write_Data(0x07); // ... 省略后续参数以你屏厂例程为准 // SCROLL: 设置显示起始地址和显示区长度 LCD_Write_Cmd(0x44); // ... 参数 // CURSOR FORM: 光标形状 LCD_Write_Cmd(0x5D); // ... 参数 // 开显示等设置 // ... }调试时有个技巧初始化代码写完后先不要急着画图先做一个全屏填充测试往显存里写满 0xFF。如果整屏能显示出均匀的图案说明初始化、显存访问、时序基本通了再往下做画点画线。这一步能快速把初始化问题和绘图逻辑问题隔离开。3.3 ESP32 端驱动框架与寄存器直写实测如果只是临时验证硬件用 Arduino 框架的digitalWrite写 GPIO 是最快的。但digitalWrite有函数调用开销和位操作开销一个字节 8 个数据位写下来速度会被明显拖慢。实测在 240MHz 主频下用digitalWrite写一个字节大概要 3~5 微秒而直接操作 GPIO 寄存器能把时间压到 1 微秒以内。我推荐用 ESP32 的 GPIO 输出寄存器直写。下面是一段可用的代码示例把 D0~D7 接到连续 GPIO 上用GPIO.out_w1tc清零、GPIO.out_w1ts置位#include driver/gpio.h #define LCD_RS_GPIO GPIO_NUM_4 #define LCD_WR_GPIO GPIO_NUM_5 #define LCD_CS_GPIO GPIO_NUM_7 #define LCD_RST_GPIO GPIO_NUM_8 // D0~D7 接到 GPIO12~GPIO19 #define LCD_DATA_BASE GPIO_NUM_12 void lcd_gpio_init(void) { gpio_config_t io_cfg { .mode GPIO_MODE_OUTPUT, .intr_type GPIO_INTR_DISABLE, .pull_down_en GPIO_PULLDOWN_DISABLE, .pull_up_en GPIO_PULLUP_DISABLE, }; // 批量配置控制脚和数据脚 uint64_t mask (1ULL LCD_RS_GPIO) | (1ULL LCD_WR_GPIO) | (1ULL LCD_CS_GPIO) | (1ULL LCD_RST_GPIO); for (int i 0; i 8; i) { mask | (1ULL (LCD_DATA_BASE i)); } io_cfg.pin_bit_mask mask; gpio_config(io_cfg); // 默认拉高 gpio_set_level(LCD_CS_GPIO, 1); gpio_set_level(LCD_WR_GPIO, 1); gpio_set_level(LCD_RS_GPIO, 0); } void lcd_write_byte(uint8_t val, bool is_cmd) { // 1. 设置 RS命令0数据1 gpio_set_level(LCD_RS_GPIO, is_cmd ? 0 : 1); // 2. 数据写到并口寄存器直写 GPIO.out_w1tc (uint32_t)0xFF (LCD_DATA_BASE - 0); // 先清零 GPIO.out_w1ts ((uint32_t)val) (LCD_DATA_BASE - 0); // 再写数据 // 3. WR 产生下降沿数据被锁存 gpio_set_level(LCD_WR_GPIO, 0); // 这里做极小延时或者直接靠指令间隔 asm volatile(nop; nop; nop;); gpio_set_level(LCD_WR_GPIO, 1); }这里有两点提醒。一是LCD_DATA_BASE - 0这个写法看起来有点别扭实际意思是数据线从 GPIO12 开始左移相应位数如果你想从别的 GPIO 开始直接替换这里的基准即可但要求 8 根数据线连续这样一次性写寄存器才有效。二是WR低电平的保持时间要根据控制器手册来SED1335 系的写周期一般有最小脉宽要求如果屏不锁存数据先把低电平延时加长试试。如果你走 ESP-IDF 路线这套 GPIO 宏同样可用只是把gpio_config换成更底层的方式配置。IDF 下还能用 ESP32 的 I2S 并行模式做高速刷新但那是另一个话题先不展开。3.4 FPGA 端显示控制器与双缓冲实现FPGA 侧的显示控制器核心是一个 SED1335 兼容的时序生成状态机。ESP32 通过 SPI 发来写显存请求状态机负责把显存中的数据按 8080 时序送到 LCD 总线上。下面是简化版 Verilog 状态机框架重点看写时序的四个状态module lcd_8080_controller ( input wire clk, // 50MHz input wire start_write, // 写请求脉冲 input wire is_cmd, // 1命令0数据 input wire [7:0] din, // 待发送字节 output reg [7:0] lcd_data, output reg lcd_wr_n, output reg lcd_rs, output reg busy ); localparam IDLE 2d0; localparam SETUP 2d1; localparam PULSE_L 2d2; localparam PULSE_H 2d3; reg [1:0] state; always (posedge clk) begin case (state) IDLE: begin if (start_write) begin lcd_data din; lcd_rs is_cmd ? 1b0 : 1b1; busy 1b1; state SETUP; end end SETUP: begin lcd_wr_n 1b0; // WR 拉低 state PULSE_L; end PULSE_L: begin // 保持低电平若干周期满足建立时间要求 state PULSE_H; end PULSE_H: begin lcd_wr_n 1b1; // WR 拉高数据锁存 busy 1b0; state IDLE; end endcase end endmodule实际工程中PULSE_L状态不能只停一拍否则 WR 低电平时间可能不足。建议用计数器延展比如 50MHz 时钟下一个周期是 20ns若控制器要求 WR 低电平不低于 120nsPULSE_L至少要计数 6 拍。这个参数以你手上的控制器数据手册为准不同批次略有差异。双口 RAM 显存是这个模块的关键。我用 Xilinx 原语或者高云 IP 例化一个 3840×8 的双口 RAM端口 A 接 SPI 从机写接口端口 B 接显示控制器读接口。显示控制器把读出的字节按位展开送到 D0~D7同时产生 A0 和 WR 信号。这样 ESP32 往端口 A 写数据屏幕会自动从端口 B 刷出来两边互不干扰。双缓冲是防止画面撕裂的进阶做法。把显存容量扩大一倍两个 3840 字节的缓冲区轮流使用。ESP32 写当前缓冲区FPGA 显示另一个缓冲区写完通过一条切换指令让两边角色互换。这样用户永远不会看到半幅新画面和半幅旧画面叠加的撕裂效果。代价是 RAM 多占 3.75KB在 FPGA 里非常便宜强烈建议做。4. 点亮、测试、排查调试经验实录4.1 上电不显示按这个顺序查屏幕完全不亮或者只有背光亮、区域全黑这是最常见的故障。我一般按电压—复位—写时序—命令参数的顺序排查。先量屏的供电电压看看 VLCD 有没有接对。CYW240128 这类屏的对比度电压很关键如果 VLCD 悬空或者电压不对即使数据和时序全对屏幕也可能全黑或全白。有些模组需要外接可调电阻分压调对比度是很正常的检查项。再查复位。用逻辑分析仪或者示波器抓 RST 引脚确认上电后有没有一个低脉冲低电平时间够不够。SED1335 系的复位电路如果太简单上电瞬间信号不稳定控制器可能没有完成复位后续所有命令都不会生效。然后抓写时序。把 WR、A0、CS 三根线挂到示波器上向屏发送一条空命令看看 WR 低电平宽度够不够CS 是不是在整个写周期内保持有效数据线在 WR 上升沿前有没有建立好。这个步骤能定位到命令根本没被控制器接收的问题。最后检查命令参数。如果前面都正常还是黑屏大概率是初始化参数和屏不匹配。找个逻辑分析仪把初始化的命令流完整抓下来和厂商例程逐字节对比看是不是中间传错了一个参数。我自己就遇到过代码里多写了一个 0x00导致显示区地址配置错乱整屏不亮排查了整整半天。4.2 花屏、乱码、撕裂常见原因与对策屏幕上出现乱码或花屏原因通常集中在三块。第一块是显存地址组织不匹配。SED1335 系控制器的显存并不是线性的行列一对一映射它内部有文本显示区、图形显示区、字符生成区等多个区域显示起始地址和每一行的偏移决定了像素在屏幕上的位置。初始化时如果这些参数配置不对比如扫描行数、字符宽度设置错了就会出现画面错位、左右分裂、上下颠倒等怪异现象。这种情况先别改代码仔细对着数据手册的 SYSTEM SET 和 SCROLL 参数逐项确认。第二块是数据线接反。D0~D7 如果有一根或几根接反屏幕上会出现像素错乱但整体有规律的花屏。可以写一个对角线填充测试程序把屏上从左到右、从上到下每隔 8 个点画一个点如果花屏呈现规律性偏移就说明数据位序有误。这种情况下除了检查接线还要确认 MCU 侧是高位先发还是低位先发两边必须一致。第三块是刷新过程中的撕裂。当 ESP32 或 FPGA 一边更新显存一边又在扫描读出同一段显存屏幕上可能同时出现新旧两帧画面。前面提到的双缓冲可以彻底解决这个问题如果暂时不改硬件也可以采用更新期间禁止扫描输出的同步机制但这样会有闪烁属于临时方案。4.3 常见问题速查表现象可能原因排查/解决办法屏幕全黑背光亮VLCD 电压异常查对比度电压和外围电阻屏幕全黑背光不亮背光供电/背光电流限制查 LED 供电回路不亮但初始化代码与例程一致复位时序、CS 电平示波器抓 RST、WR、A0 波形花屏、画面错位显存地址参数配置错误对照手册核对 SYSTEM SET/SCROLL有规律乱码数据位序、数据线接反对角线填充测试定位画面快速闪烁刷新与写显存冲突引入双缓冲或同步机制显示淡、看不清对比度电压偏低调节 VLCD 分压初始化偶尔失败上电时序不稳定增大复位低电平时间延时加长最后再分享一点体会这套系统跑通之后我最大的感受是屏厂例程从来不是拿来就能用的但也不是没用的。CYW240128 这类带控制器的工业屏最大的价值在于控制器内置显存和扫描逻辑外部只需要提供正确的命令序列和写时序。真正的工程量往往不在点亮一块屏而在于把它接进一个完整的链路里。ESP32 负责业务逻辑和网络FPGA 负责数据搬运和显示刷新两块代码边界清晰各司其职调起来就顺很多。如果你接下来也想做类似的方案我的建议是先把4 个底层函数 初始化序列这个最小框架搭出来用 GPIO 模拟点亮屏幕再去优化刷新方案最后再考虑双缓冲、异构通信这些进阶功能。每一层验证通过再往上叠比一口气写完整个系统再联调要省事得多。这个内容后续还可以往 OTA 固件升级、远程显示协议甚至 Micro-ROS 节点上报方向发展但那是下一步的事了先把眼前的屏点亮再说。