简介面向STM32开发者的ST7701S液晶驱动源码与固件资源包用于在STM32平台上完成HSD5.0系列FWVGA屏幕的读ID、OTP配置及显示控制适合嵌入式驱动开发、LCD适配调试等场景。压缩包共287个文件总大小约5.72MB内容以h/c源码、axf/hex可执行与烧录文件、uvproj/uvopt工程配置为主另含bak备份、map映射、htm报告等辅助文件前两者用于阅读和编译驱动源码固件文件可直接烧录验证工程文件便于在Keil等环境中还原项目目录中同时保留了多份AXF/备份便于对比。目前已有568人学习下载。通过该包可以跟踪ST7701S驱动从GPIO配置、时钟初始化到显示时序控制、帧缓冲管理的完整链路理解OTP读取与屏幕ID校验流程参考已有AXF备份快速对比不同LCD配置对显示效果的影响源码层级清晰适合作为STM32显示驱动项目的起步模板。1. 读一次 ID 返回 888888值得在点亮屏幕前先停下来HSD5.0-7701S 这类驱动方案的模组包.rar里通常同时放着规格书、初始化序列和读 ID 工具。比起直接照抄初始化数组然后祈祷出图我拿到屏的第一件事是先把 0x04 寄存器读回来它决定了我有没有拿错屏、模组有没有被烧录过、以及 I2C 回路通不通。ST7701S 的 ID 寄存器在 OTP 上电加载之后才有意义读回 888888 这个值看着像一串乱码实际上是三条不同故障路径的汇合点——空片、地址错误、时序错位都长这样。这篇文章把读 ID 和 OTP 的关系讲清楚给一套 STM32 上可复现的代码再用一张排查表收掉 888888 这个现象。2. ST7701S 读 ID 的链路0x04 寄存器、OTP 自动加载与 888888 的来源2.1 读 ID 与读 OTP 为什么是同一件事ST7701S 的寄存器映射里0x04 被用作 ID 读出寄存器常见的实现是上电后芯片内部从 OTPOne-Time Programmable一次性可编程把产品配置搬到工作寄存器里0x04 的内容也在这个加载过程中被更新。逻辑上能分成三个状态出厂空片OTP 区没有任何内容加载前后寄存器都保持 ROM 复位默认值这时读 0x04 会得到一个“固定但无意义”的字节对。屏厂已烧录OTP 里存了厂商 ID、版本号以及刷新率/伽马等初始化参数上电后 0x04 读到的是产品真实 ID。加载失败电源爬升太慢、IOVCC 与 VCI 上电顺序不符合要求、或者复位被外部拉死OTP 数据没搬完0x04 读回来的就是半路值。读 ID 本质上是“低成本验证 OTP 是否加载成功”的手段。单独的 ID 寄存器取值很窄但配上 OTP dump 就能判断屏体来源。很多模组资料里会把 OTP 地址范围和使用说明放在一个单独的文档里常见的是 0xB0 段附近的映射区具体地址以你手上那份规格书的 SFR map 为准。这里有个常被忽略的操作读 0x04 之前最好先做一次软复位MIPI 命令 0x01并等待至少 120 ms。软复位会把内部状态机拉回已知位置OTP 重新加载一次避免前面调试时残留的异常状态影响读出值。硬复位引脚同理RESX 拉低再拉高低电平保持时间一般要求 5 us 以上。读出来的两个字节怎么解释不同批次模组定义不完全一样但基本都是“上电后由 OTP 加载的只读组合”。我一般不建议直接拿这两个字节和网上的通用表硬对因为模组厂可以烧写自定义内容0x88 0x88 也可能就是某一批屏的合法 ID。正确的做法是打开 rar 包里的出厂配置文件或者烧录工具导出的 dump看上面标的产品 ID 是多少再决定读到的值该不该报警。2.2 三种读回通道ST7701S 提供不止一条读回通道模组厂通常只引出一两条通道引脚是否需要 MIPI 先初始化适用场景I2CSCL / SDA不需要最常用模拟 GPIO 也能读SPISCK / SDI / SDO不需要4 线接线速率更高MIPI 读回DSI 双向数据需要模组没引出调试引脚时I2C 通道是绝大多数联调的首选。ST7701S 的 I2C 从机地址与硬件引脚 SS 的电平绑定常见默认是 SS 拉低时写地址 0x7E、读地址 0x7FSS 拉高则换一组地址具体数值必须看屏厂规格书。SPI 通道与 I2C 不能同时启用因为引脚复用——主板设计上如果既引出了 I2C 又引出了 SPI要先确认模组有没有选择焊盘别两个通道都向它发命令。至于 MIPI 读回STM32 侧只有带 DSI 外设的型号如 STM32F469 等才能原生产出 DSI 读命令大部分项目是 MCU MIPI 桥接芯片的方案桥接芯片通常不转发读回数据所以这种场景下老老实实从 I2C 测试点读。2.3 888888 的常见身份空片默认值把 888888 拆开看三个字节都是 0x88连续三个相同值本身就是个信号。I2C 在线路故障时常见的是 0xFF总线释放读回高或 0x00被拉死0x88 更像芯片内部真实存在的复位默认值——也就是说总线通了、地址也对了但 OTP 没内容或者没加载成功。这个判断在项目上是有价值的它把问题从“电气连接”直接推到“OTP 状态”省掉一轮示波器排查。另一个产生 0x88 的路径是主机多发了时钟。模拟 I2C 如果第 9 个 ACK 时钟之后又继续拉 SCL数据位会被整体左移一位读回来的字节就可能是 0x88 或 0x44 这类“每个字节里都带一个 0”的形态。区分方法很简单降速到 100 kHz 再读如果 0x88 变回正常值说明是时序问题如果还是 0x88那就是芯片状态问题。OTP 烧录过的屏读 ID 通常一次就能得到预期值没烧录的白牌空片读 0x04 就会长时间停留在 0x88。判断 OTP 是否真为空可以用 rar 包里的烧录工具执行一次“读 OTP”操作工具能正常读出全 0xFF 或全 0x00再结合 0x04 的 0x88基本可以确定是空片。3. STM32 上读 ST7701S ID 的最小实现GPIO 模拟 I2C 与串口打印3.1 引脚规划与 GPIO 初始化STM32 与 ST7701S 之间最常见的连接方式是 MCU 通过 RGB/MIPI 输出图像SCL/SDA 走两根普通 GPIO。模拟 I2C 的好处是不占用硬件外设、引脚随意选、失败时波形完全可控读个 ID 不需要复杂状态机。下面代码按 HAL 库来写标准库改起来也差不多重点是引脚模式和延时节奏。#define LCD_SCL_GPIO_Port GPIOB #define LCD_SCL_Pin GPIO_PIN_6 #define LCD_SDA_GPIO_Port GPIOB #define LCD_SDA_Pin GPIO_PIN_7 void lcd_id_gpio_init(void) { GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Pin LCD_SCL_Pin | LCD_SDA_Pin; gpio.Mode GPIO_MODE_OUTPUT_OD; // 开漏输出 gpio.Pull GPIO_PULLUP; // 使能内部上拉 gpio.Speed GPIO_SPEED_FREQ_LOW; // 降低翻转速率减少过冲 HAL_GPIO_Init(LCD_SCL_GPIO_Port, gpio); }选开漏输出而不是推挽是为了接近真实 I2C 的电平行为。开漏加上拉电阻后总线空闲时被拉到高低电平由主机主动拉下这样即使从机想拉低 SDA 响应 ACK两者也不会打架。内部上拉在大部分屏上够用如果线长超过 10 cm或者模组端已经外挂了上拉建议外部再并一颗 2.2 kΩ 到 4.7 kΩ 的上拉否则下降沿会变缓通信速率上不去。3.2 模拟 I2C 的字节级收发I2C 的读流程看起来绕先发写地址和寄存器号然后重启再发读地址最后连收两个字节。ST7701S 的 0x04 寄存器是两字节长度第一步操作不能省否则芯片不知道你要读哪个寄存器。static void i2c_delay(void) { volatile uint32_t i 200; // 72MHz 下约 1.5us实测 ~300kHz while (i--); } static void i2c_start(void) { SDA_HIGH(); SCL_HIGH(); i2c_delay(); SDA_LOW(); i2c_delay(); SCL_LOW(); i2c_delay(); } static void i2c_stop(void) { SCL_LOW(); SDA_LOW(); i2c_delay(); SCL_HIGH(); i2c_delay(); SDA_HIGH(); i2c_delay(); } static int i2c_send_byte(uint8_t data) { uint8_t i; for (i 0; i 8; i) { if (data 0x80) SDA_HIGH(); else SDA_LOW(); data 1; i2c_delay(); SCL_HIGH(); i2c_delay(); SCL_LOW(); i2c_delay(); } SDA_HIGH(); // 释放 SDA 给从机 i2c_delay(); SCL_HIGH(); i2c_delay(); // 第 9 个时钟读 ACK if (SDA_READ()) { SCL_LOW(); return -1; } // SDA 仍高 NACK SCL_LOW(); i2c_delay(); return 0; } static uint8_t i2c_recv_byte(uint8_t ack) { uint8_t i, data 0; SDA_HIGH(); // 主机释放总线由从机驱动 for (i 0; i 8; i) { data 1; SCL_HIGH(); i2c_delay(); if (SDA_READ()) data | 0x01; SCL_LOW(); i2c_delay(); } if (ack) SDA_LOW(); else SDA_HIGH(); // ACK拉低NACK释放 SCL_HIGH(); i2c_delay(); SCL_LOW(); i2c_delay(); SDA_HIGH(); return data; }延时函数决定总线速率。i2c_delay 里循环次数是 200 时实际 SCL 频率在 300 kHz 上下主频越高越要注意别冲过 400 kHz。ST7701S 的 I2C 一般按 400 kHz 设计留裕量更稳妥。排查阶段我通常把循环调到 500把速率压到 100 kHz 以下等 ID 稳定后再逐步提上去。3.3 读 0x04 并串口打印uint8_t lcd_read_id(uint8_t *buf, uint8_t len) { if (lcd_i2c_read_reg(LCD_REG_ID, buf, len) ! 0) { return 0; } return 1; } int main(void) { uint8_t id[2]; HAL_Init(); SystemClock_Config(); uart_init(); // 重定向 printf 到串口 lcd_id_gpio_init(); HAL_Delay(50); // 等待 IOVCC 稳定 for (int i 0; i 3; i) { if (lcd_read_id(id, 2)) { printf(ID[%d]: 0x%02X 0x%02X\r\n, i, id[0], id[1]); } else { printf(ID[%d]: read fail\r\n, i); } HAL_Delay(10); // 两次读之间留出总线恢复时间 } while (1); }连续读三次而不是读一次是因为 OTP 加载期间总线如果被上位机工具打扰过第一次读出的状态往往不准。三次结果一致才有资格说这个 ID 是可信的。串口打印的内容我会同时包含读失败告警后面批量验证屏体时靠这条 log 就能区分“读不到”和“ID 不符”。读 ID 的初始化顺序和常规点屏开发不一样不需要先初始化 MIPI/RGB 时序甚至不需要打开背光。GPIO 初始化完成后直接读即可前提是 VCI 和 IOVCC 已经上电。这样做的好处是即使屏幕初始化序列写得不对ID 也能作为“屏体活着”的独立证据。3.4 SPI 通道的差异点如果屏厂模组引的是 SPI 调试口方法基本一致但有两处不同。第一ST7701S 在 SPI 模式下字节序和命令长度往往和 I2C 不完全相同读寄存器通常还是“命令字节 读数据”的结构但 CS 是每字节拉高再拉低一次还是整段保持低电平要以规格书的时序图为准。第二SPI 半双工时 SDO 和 SDI 可能并作一根线主机读完命令后要把 MOSI 切到输入模式再继续拉时钟切换时机不对第一个字节就会读到命令自身的高 7 位。// SPI 半双工读的关键切换发完命令立刻切输入 LCD_CS_LOW(); spi_write_byte(0x04); // 或规格书规定的读命令 lcd_gpio_mosi_input(); // 切方向 uint8_t hi spi_read_byte(); // 拉 8 个时钟取高字节 uint8_t lo spi_read_byte(); // 低字节 LCD_CS_HIGH();这个通道在产线测试工具里很常见自研代码时低成本方案是 GPIO 模拟 SPI速率放低到 1 MHz 以下避免 MISO 建立时间不够。多数情况下 I2C 已经够用SPI 通道只有当模组没接 SCL/SDA 引脚时才必须走。4. 读回 888888 的排错路径从 ACK、速率到 OTP 状态逐项排查4.1 第一步看 ACK地址写对了没有读 ID 失败先不要怀疑芯片先用一个最简单的程序只发地址字节看 ACK 回不回。模拟 I2C 里 ACK 检测是最容易写错的地方第 9 个时钟前必须把 SDA 设成输入方向或开漏输出后写 1否则引脚输出模式一直钳住电平从机拉不低主机永远看到 NACK。ST7701S 的 I2C 地址不是固定值。SS 引脚的电平决定了器件地址的高位常见配对是 0x7E/0x7F写/读对应一组换一套屏可能变成另一组数值跟屏厂确认是最直接的。我在代码里把地址单独放宏定义就是为了换模组时只改一行。确认 ACK 时的判断标准发送完写地址0x7E后如果第 9 个时钟 SDA 为低说明从机在线且地址正确如果是高电平先把地址换成另一组再试。两组都 NACK才进入硬件排查。4.2 第二步看波形速率与上拉的交互ACK 正常但读回 0x88优先怀疑时钟和数据建立时间。STM32 的 GPIO 翻转很快SCL 上升沿太陡配合长走线会产生振铃从机在边沿采到错误电平。示波器看几个点SCL 高电平时间是否大于 600 ns、SDA 在 SCL 上升沿前是否已稳定、NACK/ACK 位是否清晰。如果 SCL 频率已经低于 100 kHz 还是 0x88才考虑芯片侧原因。另一个容易忽略的是 SDA 被其他外设占用。有些模组把 SDA 和 MIPI 双向数据线复用到同一个焊盘初始化 DSI PHY 之后SDA 被 PHY 拉走模拟 GPIO 怎么读都是乱数。因此读 ID 的代码放在 MIPI 初始化之前跑一次如果初始化后台 ID 变了说明引脚冲突。4.3 第三步看 OTP把 rar 包里的校验清单翻出来屏厂随资料包给的内容五花八门有给烧录工具 exe 的有给初始化数组 .c 的也有给一份 .hex 或 .txt 的 OTP dump。读 ID 之前先找这份 dump里面通常标明了“产品 ID 0xXXXX”。用串口读回的 0x88 0x88 和 dump 里的 ID 比一下不一致就进入 OTP 层面的判断。OTP 是一次性器件读是安全的写要慎重。我见过有人把烧录工具连上屏后随手点了“写入”结果整批模组配置被改写、刷新率对不上的事故。验证 OTP 的正确姿势是只读 dump不做写入确认空片后联系屏厂补烧或换货。4.4 888888 排查速查表现象优先怀疑验证方法地址发不出去SDA 一直高上拉缺失 / 引脚占用量 SDA 静态电平是否被拉高有 ACK读回全 0xFF速率太快或时序建立不足降速到 50~100 kHz有 ACK读回 0x88 0x88OTP 空片或未加载读 OTP dump 对比初始化 MIPI 后 ID 变乱引脚复用冲突在 MIPI 初始化前读三次读结果不一致电源或复位毛刺示波器抓 RESX 与 IOVCC 上升沿这张表的顺序也是排查的顺序先确认电气再看时序最后查 OTP。实际项目里因为 SCL/SDA 没接上拉导致的 0x88和空片导致的 0x88处理方式完全不同前者改硬件后者换屏体分清楚能省掉一整个下午。5. 把读 ID/OTP 封装成开机自检白屏问题就少一半5.1 封装原则读 ID 代码不要每次都从头写我一般做成一开机就执行的静态自检函数上电后 50 ms 延时、连续读三次、与屏厂 ID 表比对失败时点亮一颗 LED 或通过串口输出错误码。这样做的价值在于屏幕点不亮时系统能区分“屏没通”和“初始化序列不对”调试方向完全不同。有两点要注意第一自检函数只做读操作任何情况下都不要尝试向 OTP 写数据第二读 ID 的失败信息要保留原始字节值而不是只存一个 pass/fail因为后期换屏体供应商时同一个 0x88 背后对应的批次问题可能不一样。5.2 自检代码示例typedef enum { LCD_ID_OK 0, LCD_ID_I2C_ERR 1, // ACK 失败 LCD_ID_NOT_MATCH 2, // 读回值与清单不符 LCD_ID_READ3_ERR 3 // 三次读结果不一致 } lcd_id_status_t; lcd_id_status_t lcd_id_selfcheck(void) { uint8_t id[2]; uint8_t ok_cnt 0; HAL_Delay(50); // 等 IOVCC 稳定 for (uint8_t i 0; i 3; i) { if (!lcd_read_id(id, 2)) return LCD_ID_I2C_ERR; if (id[0] LCD_ID_EXPECT_HI id[1] LCD_ID_EXPECT_LO) ok_cnt; HAL_Delay(10); } if (ok_cnt 3) return LCD_ID_OK; return LCD_ID_READ3_ERR; }这个函数的返回值和初始化序列解耦主流程只在LCD_ID_OK时才继续发初始化代码否则打印错误码并停留在待机循环。量产时还可以把错误码映射到蜂鸣器节奏产线工人不需要看串口就知道哪片屏有问题。5.3 验证 OTP 的最后一招如果三种通道都试过还是 888888最后可以用示波器抓 MIPI LP 命令确认 DSI 通道本身是否正常——但这属于换屏前的最后一步。更快的办法是换一片已知良品模组同一套代码下 ID 变成预期值就基本锁死是模组 OTP 问题可以拿着读回的 0x88 和明细表找屏厂了。我在项目上通常把这一步写进验收 checklist每批屏到货先抽 5 片读 ID不做任何初始化直接判断来料状态。这个习惯能让你在批量产线问题爆发之前就发现异常批次等白屏堆在产线再回头查 ID代价就是整条线的停线工时。本文还有配套的精品资源点击获取