尧图网页设计 
简介这份资源面向嵌入式Linux显示驱动开发者提供ST7701/ST7701S液晶控制器的C/C驱动程序及配套资料帮助开发者将屏幕快速集成到MTK、展讯等硬件平台。压缩包共6个文件、约5.3MB以3份PDF规格与应用笔记、2份C语言驱动源码和1份db文件为主PDF涵盖控制器寄存器与时序说明C文件对应不同平台的移植示例便于对照硬件手册理解初始化、数据传输、屏幕控制与电源管理流程。资源同时涉及设备树配置、帧缓冲子系统注册及交叉编译移植要点可作为驱动调试与平台适配的参考。目前已有2173人学习下载适合需要快速上手ST7701S显示方案、排查时序与接口问题的中高级开发者参考使用。1. ST7701 驱动到底在驱动什么从一块 480×854 屏说起手里拿到一块 2.8 寸到 4 寸的 TFT 小屏FPC 排线一插背光亮了但屏幕全白或者花屏这是很多人第一次碰 ST7701 的真实场景。ST7701 / ST7701S 是一颗 MIPI DSI 接口的显示驱动 IC常见于 480×854、480×800、720×1280 这类竖屏模组负责把主控送来的 MIPI 数据流翻译成面板能识别的行列扫描时序。它和那些 SPI 小屏最大的区别在于初始化不是发几条命令就完事而是一长串厂商私有寄存器序列写错一条就可能黑屏、偏色或者只亮一半。这篇讲的就是用 C/C 把 ST7701 驱动跑起来这件事从 MIPI DSI 链路怎么建、初始化序列怎么组织、参数怎么调到花屏和黑屏怎么排查。适合正在用 STM32、ESP32-P4、全志、瑞芯微这类带 DSI 控制器的平台点屏的嵌入式工程师也适合从 SPI 屏转过来、第一次碰 MIPI 的人。读完你应该能自己把一块陌生 ST7701 模组点亮而不是只能照抄别人给的初始化数组。2. ST7701 驱动分层DSI 主机、面板时序和初始化序列各管什么2.1 先分清三层职责别把问题混在一起ST7701 点不亮九成的人第一反应是初始化序列不对但实际链路里至少有三层每层出问题的现象完全不同混在一起查就是玄学。第一层是 MIPI DSI 主机控制器它由你的 SoC 或 MCU 提供负责 D-PHY 电气层、时钟 lane、数据 lane 的建立以及 DSI 协议包的收发。这一层没通你连 ST7701 的 ID 都读不到屏幕大概率全黑无背光反应。第二层是面板时序参数包括像素时钟、HFP/HBP/HSA、VFP/VBP/VSA、有效分辨率和 lane 速率。这一层错了典型现象是图像整体偏移、边缘有彩条、画面抖动或者只显示一部分。第三层才是 ST7701 内部的初始化寄存器序列通过 DSI 的 DCS 短包/长包写进去配置电源、伽马、VCOM、面板方向、像素格式等。这一层错了现象是花屏、偏色、上下颠倒、只亮半边。提示排查顺序永远是先确认 DSI 链路通再确认时序对最后才怀疑初始化序列。反过来查会浪费大量时间。2.2 MIPI DSI 链路建立的最小步骤以常见的 Linux DRM 面板驱动或裸机 DSI 控制器为例链路建立的核心动作是固定的。下面是一段裸机风格的伪代码展示 DSI 主机初始化的骨架具体寄存器名按你平台的 HAL 替换。/* dsi_host_init: 建立 DSI 主机链路参数来自面板规格书 */ int dsi_host_init(dsi_host_t *host, const panel_timing_t *t) { /* 1. 配置 D-PHYlane 数、每 lane 速率(Mbps)、时钟模式 */ dphy_set_lanes(host, t-lane_num); /* ST7701 常见 1 或 2 lane */ dphy_set_bitrate(host, t-lane_mbps); /* 由像素时钟和 bpp 反推 */ dphy_set_clock_mode(host, DPHY_CLK_CONTINUOUS); /* 2. 配置 DSI 控制器虚拟通道、像素格式、视频/命令模式 */ dsi_set_virtual_channel(host, 0); dsi_set_pixel_format(host, DSI_FMT_RGB888); /* 与 ST7701 的 COLMOD 对应 */ dsi_set_mode(host, DSI_MODE_VIDEO_SYNC_PULSE); /* 3. 下发时序参数 */ dsi_set_timing(host, t-hsa, t-hbp, t-hfp, t-vsa, t-vbp, t-vfp, t-width, t-height); /* 4. 使能 D-PHY 和 DSI 控制器 */ dphy_power_on(host); dsi_controller_enable(host); return 0; }逻辑说明这段代码的顺序不能乱。D-PHY 必须先于 DSI 控制器使能否则控制器发出的包没有物理层承载。lane_mbps是最容易算错的参数它由像素时钟、bpp 和 lane 数共同决定公式是lane_mbps pixclk * bpp / lane_num再留 20% 左右余量。参数说明lane_num看模组 FPC 上时钟 lane 之外有几对数据线ST7701 模组常见 1 lane 或 2 laneDSI_MODE_VIDEO_SYNC_PULSE是视频模式下的同步脉冲方式如果面板规格书写的是 sync event 模式这里要改。2.3 初始化序列怎么组织才可维护ST7701 的初始化序列动辄上百条寄存器写直接堆一个巨大的数组是能跑但改一个参数要数半天。我一般把它组织成命令 参数 延时的结构体数组用循环下发这样换模组时只改数据不改逻辑。/* 一条初始化命令cmd 为 DCS 命令data 为参数len 为参数长度delay_ms 为后续延时 */ typedef struct { uint8_t cmd; uint8_t data[16]; uint8_t len; uint16_t delay_ms; } st7701_init_cmd_t; /* 节选进入命令模式后写关键寄存器完整序列按模组规格书补全 */ static const st7701_init_cmd_t st7701_init_seq[] { {0xFF, {0x77, 0x01, 0x00, 0x00, 0x10}, 5, 0}, /* 解锁厂商命令页 */ {0xC0, {0x3B, 0x00}, 2, 0}, /* 电源控制 */ {0xC1, {0x0D, 0x02}, 2, 0}, /* 电源控制 */ {0xC2, {0x31, 0x05}, 2, 0}, /* 电源控制 */ {0x3A, {0x55}, 1, 0}, /* COLMOD: RGB565 */ {0x11, {0}, 0, 120}, /* Sleep Out必须延时 */ {0x29, {0}, 0, 20}, /* Display On */ }; void st7701_send_seq(dsi_host_t *host, const st7701_init_cmd_t *seq, int n) { for (int i 0; i n; i) { dsi_dcs_write(host, seq[i].cmd, seq[i].data, seq[i].len); if (seq[i].delay_ms) delay_ms(seq[i].delay_ms); /* 0x11 后必须等 120ms 再发 0x29 */ } }逻辑说明0xFF那条是解锁厂商命令页ST7701 很多寄存器藏在厂商页里不先解锁后面全白写。0x11Sleep Out和0x29Display On之间的延时是硬性要求规格书一般写 120ms短了会出现亮一下又黑。参数说明0x3A的 COLMOD 值要和 DSI 主机的像素格式严格对应RGB565 是 0x55RGB888 是 0x77两边不一致会直接花屏。data数组长度按实际参数改别照抄 16。3. 用 C/C 把 ST7701 驱动跑起来从时序计算到点屏3.1 时序参数怎么从规格书算出来面板规格书一般给的是典型值但你要把它换算成 DSI 控制器能用的参数。以一块 480×854、2 lane、RGB888 的 ST7701 模组为例规格书给的典型像素时钟是 27MHz那么参数含义典型值计算依据pixclk像素时钟27 MHz规格书典型值lane_mbps每 lane 速率约 324 Mbps27M × 24bpp ÷ 2 lane × 1.0hsa水平同步有效10规格书hbp水平后沿20规格书hfp水平前沿20规格书vsa垂直同步有效2规格书vbp垂直后沿8规格书vfp垂直前沿20规格书lane 速率算出来是 324Mbps但实际配置要留余量我一般设到 350~400Mbps因为 D-PHY 在临界速率下容易出误码表现为偶发花屏。注意 hsahbphfp 加上有效宽度就是一行总像素数这个值乘以帧率再乘以 bpp 应该和 lane 速率对得上对不上说明哪个参数抄错了。3.2 一份可复现的点屏主流程把前面的链路初始化和序列下发串起来主流程大致是这样。这段代码是平台无关的骨架你把它接到自己的 DSI HAL 上就能跑。int st7701_panel_probe(void) { panel_timing_t t { .width 480, .height 854, .lane_num 2, .lane_mbps 350, .hsa 10, .hbp 20, .hfp 20, .vsa 2, .vbp 8, .vfp 20, }; /* 1. 上电先给 VDDI/VDD再给 AVDD最后放 RESET */ panel_power_on(); panel_reset_low(); delay_ms(10); panel_reset_high(); delay_ms(120); /* 复位后必须等规格书要求 */ /* 2. 建 DSI 链路 */ if (dsi_host_init(g_host, t) ! 0) return -1; /* 3. 下发初始化序列 */ st7701_send_seq(g_host, st7701_init_seq, sizeof(st7701_init_seq)/sizeof(st7701_init_seq[0])); /* 4. 读回 ID 验证链路可选但强烈建议 */ uint8_t id[3] {0}; if (dsi_dcs_read(g_host, 0x04, id, 3) 0) { /* ST7701 的 ID 一般能读到非 0 值读不到说明链路有问题 */ } return 0; }逻辑说明上电顺序里 VDDI 和 AVDD 的先后不能反反了可能触发 IC 内部上电复位异常现象是怎么都不亮。复位后的 120ms 延时是规格书硬性要求省掉会随机失败。第 4 步读 ID 是很多人忽略的验证手段能读到 ID 说明 DSI 双向链路都通了读不到就别往下查初始化序列了先查物理层。参数说明lane_mbps和时序参数按 3.1 的表填panel_power_on和panel_reset_*按你板子的 GPIO 实现。3.3 视频模式和命令模式怎么选ST7701 支持视频模式和命令模式两种。视频模式是主控持续刷数据适合播放视频、动画命令模式是主控按需写显存适合静态界面、低功耗场景。选错模式的现象是视频模式下画面正常但功耗高命令模式下如果没做 TE 同步会撕裂。我一般默认用视频模式因为调试简单时序对了就出图。命令模式要额外接 TE 信号线还要处理 tearing effect除非功耗敏感否则不折腾。切换模式时注意 DSI 控制器的配置要跟着改DSI_MODE_VIDEO_SYNC_PULSE和DSI_MODE_CMD是两套配置不能只改一个地方。4. ST7701 驱动避坑花屏、黑屏、偏色的排查清单4.1 现象全黑无背光读 ID 失败原因DSI 物理层没通。常见是 lane 数配错、lane 速率超范围、D-PHY 时钟模式不对或者 FPC 没插紧。也有可能是上电顺序错了IC 根本没起来。解决先用示波器量时钟 lane 有没有波形没有就是 D-PHY 没使能。有波形但读不到 ID把 lane 速率降到规格书典型值再试排除速率临界问题。再确认lane_num和 FPC 实际数据线对数一致1 lane 的模组配成 2 lane 是读不到东西的。4.2 现象背光亮但全白或全黑有 ID原因初始化序列没下发成功或者0x11/0x29的延时不够。也可能是 COLMOD 和 DSI 像素格式不匹配。解决在0x11后加长延时到 150ms 试。确认0x3A的值和 DSI 主机像素格式一致。如果序列里有厂商页解锁0xFF确认它在下发其他寄存器之前。用逻辑分析仪抓 DSI 包看命令有没有真的发出去。4.3 现象花屏、彩条、画面偏移原因时序参数不对或者 lane 速率和像素时钟不匹配。边缘彩条通常是 hbp/hfp 不对整体偏移是 hsa 或 vsa 不对随机花屏是 lane 速率余量不够。解决按 3.1 的表重新核对每个时序参数确保 hsahbphfpwidth 和 lane 速率算出来的总带宽对得上。lane 速率往上加 10%~20% 试。如果只有边缘有问题微调 hbp/hfp每次改 2~4 个像素看变化。4.4 现象颜色偏、红蓝反、伽马不对原因COLMOD 像素格式和实际数据排列不一致或者伽马寄存器没按模组调。红蓝反是 RGB/BGR 顺序问题。解决先确认0x3A的 COLMOD 值RGB565 是 0x55RGB888 是 0x77。红蓝反的话检查 DSI 控制器的 RGB 顺序配置有些平台有单独的 BGR 位。伽马偏就按模组规格书重新写伽马表别用别的模组的。4.5 现象偶发闪屏、随机黑一下原因电源不稳或者 lane 速率临界。ST7701 对 AVDD 纹波敏感电源设计不好会偶发复位。解决量 AVDD 纹波超过 50mV 就要加滤波。lane 速率降一档试如果降了就好说明是余量问题。检查复位脚有没有干扰必要时加 RC 滤波。5. 进阶把 ST7701 驱动做成可复用面板驱动真正做产品时你不会只点一块屏。把 ST7701 驱动抽象成面板描述 通用下发逻辑换模组只改描述数据这是省后悔药的做法。核心是把时序、初始化序列、电源时序都抽成结构体驱动逻辑只认结构体。typedef struct { const char *name; panel_timing_t timing; const st7701_init_cmd_t *init_seq; int init_seq_len; void (*power_on)(void); void (*reset)(void); } st7701_panel_desc_t; /* 换模组时只新增一个 desc不动驱动逻辑 */ static const st7701_panel_desc_t panel_480x854 { .name st7701_480x854, .timing {480, 854, 2, 350, 10, 20, 20, 2, 8, 20}, .init_seq st7701_init_seq, .init_seq_len sizeof(st7701_init_seq)/sizeof(st7701_init_seq[0]), .power_on panel_power_on, .reset panel_reset, };验证方法上我习惯做两件事一是读 ID 确认链路二是写一个纯色测试图红、绿、蓝、白、黑各一屏五屏都正常基本说明时序和颜色都对。纯色测试能快速暴露偏色和局部花屏比放一张复杂图片直观得多。参数边界要记牢lane 速率不要超过 D-PHY 规格上限ST7701 一般支持到 1Gbps 左右但模组 FPC 走线会限制实际可用值像素时钟不要超过规格书最大值超了会随机花屏0x11后的延时宁长勿短。这些边界踩过一次就记住了。我自己的习惯是每点一块新屏先把时序和初始化序列单独存一份配置文件点亮的参数原样保留下次遇到同型号直接复用遇到问题也能快速回退到已知可用版本。ST7701 这类 MIPI 屏调试没有捷径但把分层理清、把参数算对、把验证做足基本都能一次点亮。希望帮到你。本文还有配套的精品资源点击获取 ST7701驱动开发实战：MIPI DSI点屏、初始化序列与花屏排查
简介这份资源面向嵌入式Linux显示驱动开发者提供ST7701/ST7701S液晶控制器的C/C驱动程序及配套资料帮助开发者将屏幕快速集成到MTK、展讯等硬件平台。压缩包共6个文件、约5.3MB以3份PDF规格与应用笔记、2份C语言驱动源码和1份db文件为主PDF涵盖控制器寄存器与时序说明C文件对应不同平台的移植示例便于对照硬件手册理解初始化、数据传输、屏幕控制与电源管理流程。资源同时涉及设备树配置、帧缓冲子系统注册及交叉编译移植要点可作为驱动调试与平台适配的参考。目前已有2173人学习下载适合需要快速上手ST7701S显示方案、排查时序与接口问题的中高级开发者参考使用。1. ST7701 驱动到底在驱动什么从一块 480×854 屏说起手里拿到一块 2.8 寸到 4 寸的 TFT 小屏FPC 排线一插背光亮了但屏幕全白或者花屏这是很多人第一次碰 ST7701 的真实场景。ST7701 / ST7701S 是一颗 MIPI DSI 接口的显示驱动 IC常见于 480×854、480×800、720×1280 这类竖屏模组负责把主控送来的 MIPI 数据流翻译成面板能识别的行列扫描时序。它和那些 SPI 小屏最大的区别在于初始化不是发几条命令就完事而是一长串厂商私有寄存器序列写错一条就可能黑屏、偏色或者只亮一半。这篇讲的就是用 C/C 把 ST7701 驱动跑起来这件事从 MIPI DSI 链路怎么建、初始化序列怎么组织、参数怎么调到花屏和黑屏怎么排查。适合正在用 STM32、ESP32-P4、全志、瑞芯微这类带 DSI 控制器的平台点屏的嵌入式工程师也适合从 SPI 屏转过来、第一次碰 MIPI 的人。读完你应该能自己把一块陌生 ST7701 模组点亮而不是只能照抄别人给的初始化数组。2. ST7701 驱动分层DSI 主机、面板时序和初始化序列各管什么2.1 先分清三层职责别把问题混在一起ST7701 点不亮九成的人第一反应是初始化序列不对但实际链路里至少有三层每层出问题的现象完全不同混在一起查就是玄学。第一层是 MIPI DSI 主机控制器它由你的 SoC 或 MCU 提供负责 D-PHY 电气层、时钟 lane、数据 lane 的建立以及 DSI 协议包的收发。这一层没通你连 ST7701 的 ID 都读不到屏幕大概率全黑无背光反应。第二层是面板时序参数包括像素时钟、HFP/HBP/HSA、VFP/VBP/VSA、有效分辨率和 lane 速率。这一层错了典型现象是图像整体偏移、边缘有彩条、画面抖动或者只显示一部分。第三层才是 ST7701 内部的初始化寄存器序列通过 DSI 的 DCS 短包/长包写进去配置电源、伽马、VCOM、面板方向、像素格式等。这一层错了现象是花屏、偏色、上下颠倒、只亮半边。提示排查顺序永远是先确认 DSI 链路通再确认时序对最后才怀疑初始化序列。反过来查会浪费大量时间。2.2 MIPI DSI 链路建立的最小步骤以常见的 Linux DRM 面板驱动或裸机 DSI 控制器为例链路建立的核心动作是固定的。下面是一段裸机风格的伪代码展示 DSI 主机初始化的骨架具体寄存器名按你平台的 HAL 替换。/* dsi_host_init: 建立 DSI 主机链路参数来自面板规格书 */ int dsi_host_init(dsi_host_t *host, const panel_timing_t *t) { /* 1. 配置 D-PHYlane 数、每 lane 速率(Mbps)、时钟模式 */ dphy_set_lanes(host, t-lane_num); /* ST7701 常见 1 或 2 lane */ dphy_set_bitrate(host, t-lane_mbps); /* 由像素时钟和 bpp 反推 */ dphy_set_clock_mode(host, DPHY_CLK_CONTINUOUS); /* 2. 配置 DSI 控制器虚拟通道、像素格式、视频/命令模式 */ dsi_set_virtual_channel(host, 0); dsi_set_pixel_format(host, DSI_FMT_RGB888); /* 与 ST7701 的 COLMOD 对应 */ dsi_set_mode(host, DSI_MODE_VIDEO_SYNC_PULSE); /* 3. 下发时序参数 */ dsi_set_timing(host, t-hsa, t-hbp, t-hfp, t-vsa, t-vbp, t-vfp, t-width, t-height); /* 4. 使能 D-PHY 和 DSI 控制器 */ dphy_power_on(host); dsi_controller_enable(host); return 0; }逻辑说明这段代码的顺序不能乱。D-PHY 必须先于 DSI 控制器使能否则控制器发出的包没有物理层承载。lane_mbps是最容易算错的参数它由像素时钟、bpp 和 lane 数共同决定公式是lane_mbps pixclk * bpp / lane_num再留 20% 左右余量。参数说明lane_num看模组 FPC 上时钟 lane 之外有几对数据线ST7701 模组常见 1 lane 或 2 laneDSI_MODE_VIDEO_SYNC_PULSE是视频模式下的同步脉冲方式如果面板规格书写的是 sync event 模式这里要改。2.3 初始化序列怎么组织才可维护ST7701 的初始化序列动辄上百条寄存器写直接堆一个巨大的数组是能跑但改一个参数要数半天。我一般把它组织成命令 参数 延时的结构体数组用循环下发这样换模组时只改数据不改逻辑。/* 一条初始化命令cmd 为 DCS 命令data 为参数len 为参数长度delay_ms 为后续延时 */ typedef struct { uint8_t cmd; uint8_t data[16]; uint8_t len; uint16_t delay_ms; } st7701_init_cmd_t; /* 节选进入命令模式后写关键寄存器完整序列按模组规格书补全 */ static const st7701_init_cmd_t st7701_init_seq[] { {0xFF, {0x77, 0x01, 0x00, 0x00, 0x10}, 5, 0}, /* 解锁厂商命令页 */ {0xC0, {0x3B, 0x00}, 2, 0}, /* 电源控制 */ {0xC1, {0x0D, 0x02}, 2, 0}, /* 电源控制 */ {0xC2, {0x31, 0x05}, 2, 0}, /* 电源控制 */ {0x3A, {0x55}, 1, 0}, /* COLMOD: RGB565 */ {0x11, {0}, 0, 120}, /* Sleep Out必须延时 */ {0x29, {0}, 0, 20}, /* Display On */ }; void st7701_send_seq(dsi_host_t *host, const st7701_init_cmd_t *seq, int n) { for (int i 0; i n; i) { dsi_dcs_write(host, seq[i].cmd, seq[i].data, seq[i].len); if (seq[i].delay_ms) delay_ms(seq[i].delay_ms); /* 0x11 后必须等 120ms 再发 0x29 */ } }逻辑说明0xFF那条是解锁厂商命令页ST7701 很多寄存器藏在厂商页里不先解锁后面全白写。0x11Sleep Out和0x29Display On之间的延时是硬性要求规格书一般写 120ms短了会出现亮一下又黑。参数说明0x3A的 COLMOD 值要和 DSI 主机的像素格式严格对应RGB565 是 0x55RGB888 是 0x77两边不一致会直接花屏。data数组长度按实际参数改别照抄 16。3. 用 C/C 把 ST7701 驱动跑起来从时序计算到点屏3.1 时序参数怎么从规格书算出来面板规格书一般给的是典型值但你要把它换算成 DSI 控制器能用的参数。以一块 480×854、2 lane、RGB888 的 ST7701 模组为例规格书给的典型像素时钟是 27MHz那么参数含义典型值计算依据pixclk像素时钟27 MHz规格书典型值lane_mbps每 lane 速率约 324 Mbps27M × 24bpp ÷ 2 lane × 1.0hsa水平同步有效10规格书hbp水平后沿20规格书hfp水平前沿20规格书vsa垂直同步有效2规格书vbp垂直后沿8规格书vfp垂直前沿20规格书lane 速率算出来是 324Mbps但实际配置要留余量我一般设到 350~400Mbps因为 D-PHY 在临界速率下容易出误码表现为偶发花屏。注意 hsahbphfp 加上有效宽度就是一行总像素数这个值乘以帧率再乘以 bpp 应该和 lane 速率对得上对不上说明哪个参数抄错了。3.2 一份可复现的点屏主流程把前面的链路初始化和序列下发串起来主流程大致是这样。这段代码是平台无关的骨架你把它接到自己的 DSI HAL 上就能跑。int st7701_panel_probe(void) { panel_timing_t t { .width 480, .height 854, .lane_num 2, .lane_mbps 350, .hsa 10, .hbp 20, .hfp 20, .vsa 2, .vbp 8, .vfp 20, }; /* 1. 上电先给 VDDI/VDD再给 AVDD最后放 RESET */ panel_power_on(); panel_reset_low(); delay_ms(10); panel_reset_high(); delay_ms(120); /* 复位后必须等规格书要求 */ /* 2. 建 DSI 链路 */ if (dsi_host_init(g_host, t) ! 0) return -1; /* 3. 下发初始化序列 */ st7701_send_seq(g_host, st7701_init_seq, sizeof(st7701_init_seq)/sizeof(st7701_init_seq[0])); /* 4. 读回 ID 验证链路可选但强烈建议 */ uint8_t id[3] {0}; if (dsi_dcs_read(g_host, 0x04, id, 3) 0) { /* ST7701 的 ID 一般能读到非 0 值读不到说明链路有问题 */ } return 0; }逻辑说明上电顺序里 VDDI 和 AVDD 的先后不能反反了可能触发 IC 内部上电复位异常现象是怎么都不亮。复位后的 120ms 延时是规格书硬性要求省掉会随机失败。第 4 步读 ID 是很多人忽略的验证手段能读到 ID 说明 DSI 双向链路都通了读不到就别往下查初始化序列了先查物理层。参数说明lane_mbps和时序参数按 3.1 的表填panel_power_on和panel_reset_*按你板子的 GPIO 实现。3.3 视频模式和命令模式怎么选ST7701 支持视频模式和命令模式两种。视频模式是主控持续刷数据适合播放视频、动画命令模式是主控按需写显存适合静态界面、低功耗场景。选错模式的现象是视频模式下画面正常但功耗高命令模式下如果没做 TE 同步会撕裂。我一般默认用视频模式因为调试简单时序对了就出图。命令模式要额外接 TE 信号线还要处理 tearing effect除非功耗敏感否则不折腾。切换模式时注意 DSI 控制器的配置要跟着改DSI_MODE_VIDEO_SYNC_PULSE和DSI_MODE_CMD是两套配置不能只改一个地方。4. ST7701 驱动避坑花屏、黑屏、偏色的排查清单4.1 现象全黑无背光读 ID 失败原因DSI 物理层没通。常见是 lane 数配错、lane 速率超范围、D-PHY 时钟模式不对或者 FPC 没插紧。也有可能是上电顺序错了IC 根本没起来。解决先用示波器量时钟 lane 有没有波形没有就是 D-PHY 没使能。有波形但读不到 ID把 lane 速率降到规格书典型值再试排除速率临界问题。再确认lane_num和 FPC 实际数据线对数一致1 lane 的模组配成 2 lane 是读不到东西的。4.2 现象背光亮但全白或全黑有 ID原因初始化序列没下发成功或者0x11/0x29的延时不够。也可能是 COLMOD 和 DSI 像素格式不匹配。解决在0x11后加长延时到 150ms 试。确认0x3A的值和 DSI 主机像素格式一致。如果序列里有厂商页解锁0xFF确认它在下发其他寄存器之前。用逻辑分析仪抓 DSI 包看命令有没有真的发出去。4.3 现象花屏、彩条、画面偏移原因时序参数不对或者 lane 速率和像素时钟不匹配。边缘彩条通常是 hbp/hfp 不对整体偏移是 hsa 或 vsa 不对随机花屏是 lane 速率余量不够。解决按 3.1 的表重新核对每个时序参数确保 hsahbphfpwidth 和 lane 速率算出来的总带宽对得上。lane 速率往上加 10%~20% 试。如果只有边缘有问题微调 hbp/hfp每次改 2~4 个像素看变化。4.4 现象颜色偏、红蓝反、伽马不对原因COLMOD 像素格式和实际数据排列不一致或者伽马寄存器没按模组调。红蓝反是 RGB/BGR 顺序问题。解决先确认0x3A的 COLMOD 值RGB565 是 0x55RGB888 是 0x77。红蓝反的话检查 DSI 控制器的 RGB 顺序配置有些平台有单独的 BGR 位。伽马偏就按模组规格书重新写伽马表别用别的模组的。4.5 现象偶发闪屏、随机黑一下原因电源不稳或者 lane 速率临界。ST7701 对 AVDD 纹波敏感电源设计不好会偶发复位。解决量 AVDD 纹波超过 50mV 就要加滤波。lane 速率降一档试如果降了就好说明是余量问题。检查复位脚有没有干扰必要时加 RC 滤波。5. 进阶把 ST7701 驱动做成可复用面板驱动真正做产品时你不会只点一块屏。把 ST7701 驱动抽象成面板描述 通用下发逻辑换模组只改描述数据这是省后悔药的做法。核心是把时序、初始化序列、电源时序都抽成结构体驱动逻辑只认结构体。typedef struct { const char *name; panel_timing_t timing; const st7701_init_cmd_t *init_seq; int init_seq_len; void (*power_on)(void); void (*reset)(void); } st7701_panel_desc_t; /* 换模组时只新增一个 desc不动驱动逻辑 */ static const st7701_panel_desc_t panel_480x854 { .name st7701_480x854, .timing {480, 854, 2, 350, 10, 20, 20, 2, 8, 20}, .init_seq st7701_init_seq, .init_seq_len sizeof(st7701_init_seq)/sizeof(st7701_init_seq[0]), .power_on panel_power_on, .reset panel_reset, };验证方法上我习惯做两件事一是读 ID 确认链路二是写一个纯色测试图红、绿、蓝、白、黑各一屏五屏都正常基本说明时序和颜色都对。纯色测试能快速暴露偏色和局部花屏比放一张复杂图片直观得多。参数边界要记牢lane 速率不要超过 D-PHY 规格上限ST7701 一般支持到 1Gbps 左右但模组 FPC 走线会限制实际可用值像素时钟不要超过规格书最大值超了会随机花屏0x11后的延时宁长勿短。这些边界踩过一次就记住了。我自己的习惯是每点一块新屏先把时序和初始化序列单独存一份配置文件点亮的参数原样保留下次遇到同型号直接复用遇到问题也能快速回退到已知可用版本。ST7701 这类 MIPI 屏调试没有捷径但把分层理清、把参数算对、把验证做足基本都能一次点亮。希望帮到你。本文还有配套的精品资源点击获取