1. 项目缘起为什么是0.71英寸LCD最近在做一个需要超小尺寸显示界面的嵌入式项目找了一圈市面上的显示屏要么太大要么功耗太高要么接口复杂。最后一块0.71英寸的LCD模块进入了我的视线。你可能觉得这么小的屏幕能干什么显示个图标都费劲吧。但恰恰是这种“极致的小”让它在一些特定场景下成了不可替代的“神器”。比如可穿戴设备智能戒指、微型耳机仓、微型仪器仪表、作为大型设备的辅助状态指示屏或者是一些极客DIY项目里需要在不显眼的地方塞进一个信息窗口。0.71英寸对角线长度大约18毫米比一枚一元硬币的直径还要小一点。在这个尺寸下如何驱动它、能显示什么内容、实际效果如何就成了非常具体且有趣的技术问题。这块屏通常分辨率是128x128或128x160RGB排列采用SPI或I2C接口功耗极低。市面上常见的驱动芯片有ST7735S、ST7789V等。我手头这块就是基于ST7735S的128x128分辨率SPI屏。接下来我就从硬件连接到软件驱动再到实际应用中的那些“坑”和技巧完整地复盘一遍。2. 硬件连接与电源设计的门道拿到模块第一步肯定是把它接起来。别看它小连接上的讲究一点不少。2.1 引脚定义与核心连接大多数0.71英寸LCD模块的引脚都大同小异以我用的这款为例共有8个引脚有些是7个少一个背光控制VCC电源正极通常是3.3V。这里第一个坑就来了一定要确认模块的供电电压。虽然很多标称3.3V但有些老版本或特定驱动芯片的模块可能兼容5V输入内部有LDO而有些则非常娇贵5V上去立刻冒烟。最稳妥的方法是查阅具体模块的数据手册如果没有就用3.3V。GND电源地。SCL/SCLKSPI时钟线。SDA/MOSISPI主设备输出、从设备输入数据线。RES/RST复位引脚低电平有效。这是必须连接的引脚很多初始化失败的问题都源于复位时序不对或根本没接。DC/RS数据/命令选择引脚。这是SPI屏区别于I2C屏的关键。高电平时SPI总线上传的是要显示的像素数据低电平时传的是命令如设置扫描方向、开显示等。CS片选引脚低电平有效。BLK背光控制通常高电平点亮。有些模块背光直接接VCC那就常亮。连接微控制器以常见的STM32F103C8T6为例VCC - 3.3VGND - GNDSCLK - PA5 (SPI1 CLK)MOSI - PA7 (SPI1 MOSI)RES - PA0 (任意GPIO)DC - PA1 (任意GPIO)CS - PA4 (SPI1 NSS) 或 任意GPIO如果软件控制片选BLK - PA2 (任意GPIO)注意RES、DC、CS、BLK这些控制引脚强烈建议不要直接悬空或上拉到不合适的电平。最好由MCU的GPIO直接驱动确保上电瞬间和运行中的状态可控。2.2 电源与去耦的细节模块虽小但对电源纹波比较敏感。在驱动芯片全速刷新屏幕时电流会有瞬间波动。如果电源不稳可能导致显示花屏、横线或局部乱码。必加滤波电容在模块的VCC和GND引脚之间尽可能靠近引脚焊接一个10uF的钽电容或电解电容再并联一个0.1uF的陶瓷电容。10uF负责应对低频电流波动0.1uF负责滤除高频噪声。这个步骤能解决一大半莫名其妙的显示干扰问题。背光限流背光LED通常也是直接接在VCC上。如果模块本身没有限流电阻你需要在外围电路上串联一个电阻。阻值需要计算R (VCC - Vf_led) / I_led。假设VCC3.3VLED正向电压Vf2.8V期望电流I10mA则R(3.3-2.8)/0.0150欧姆。选择一个接近的标准值如51欧姆。不加限流电阻背光可能过亮、发热甚至早衰。3. 驱动软件从底层SPI到图形库硬件连好了接下来就是让屏幕亮起来并显示内容。这个过程可以分为三层硬件SPI驱动、LCD驱动芯片命令层、以及应用层的图形绘制。3.1 SPI配置与速率选择对于STM32使用硬件SPI能极大减轻CPU负担。配置要点模式SPI模式0或模式3。ST7735S通常使用模式0CPOL0 CPHA0。这意味着时钟空闲时为低电平数据在时钟的第一个边沿上升沿采样。数据大小8位。速率这是第二个容易踩坑的地方。初始化和传输数据可以用不同的速率。初始化时尤其是发复位序列和一系列配置命令时建议用较低的速率比如小于10MHz。因为上电后驱动芯片内部振荡器还没稳定高速通信容易失败。初始化完成后再切换到高速进行刷图。我通常这样设置// 初始化阶段 hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_32; // 约2.25MHz (72MHz/32) HAL_SPI_Init(hspi1); LCD_Init(); // 自定义的初始化函数 // 初始化完成后切换到高速 hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_8; // 约9MHz HAL_SPI_Init(hspi1);片选(CS)管理如果硬件SPI的NSS引脚被其他设备占用或者想更灵活控制可以把CS当成普通GPIO在传输前后手动拉低和拉高。每次传输命令或数据前拉低CS传输完成后拉高。3.2 驱动芯片命令层封装这是与LCD模块对话的核心。你需要根据ST7735S的数据手册编写发送命令和发送数据的函数。void LCD_WriteCommand(uint8_t cmd) { LCD_DC_CMD(); // 设置DC引脚为低电平表示命令 HAL_SPI_Transmit(hspi1, cmd, 1, HAL_MAX_DELAY); } void LCD_WriteData(uint8_t dat) { LCD_DC_DATA(); // 设置DC引脚为高电平表示数据 HAL_SPI_Transmit(hspi1, dat, 1, HAL_MAX_DELAY); } void LCD_WriteData_Burst(uint16_t *pData, uint32_t len) { LCD_DC_DATA(); // 注意SPI传输通常以8位为单位但像素数据是16位RGB565 // 需要将16位数据拆分成两个8位连续发送 HAL_SPI_Transmit(hspi1, (uint8_t*)pData, len * 2, HAL_MAX_DELAY); }然后就是一系列初始化命令序列。这个序列很长包括退出睡眠模式、设置颜色格式、内存访问控制、帧率控制等等。这里藏着第三个大坑初始化序列可能因屏幕批次、厂商不同而有细微差别。网上找到的代码不一定完全适用。最可靠的方法是找卖家索取具体的初始化代码或者根据数据手册的“典型初始化流程”自己调试。如果初始化后屏幕全白、全黑或有规律条纹多半是初始化命令不对。一个关键命令是CASET和RASET设置列地址和行地址以及RAMWR写内存。在局部刷新时正确设置窗口范围能显著提高效率。3.3 图形绘制基础与“内存屏”概念对于128x128的分辨率如果每个像素用16位色RGB565那么整屏缓冲区需要128 * 128 * 2 32768字节即32KB。这对于一些RAM较小的MCU比如只有20KB RAM的STM32F103来说是负担不起的。因此通常采用“直接写屏”模式即计算好要画的内容直接通过SPI流式发送到屏幕的GRAM中。但这会带来一个问题任何图形的改变都需要重新计算并发送整个变化的区域对于动态界面SPI总线会非常忙碌。因此诞生了一个折中方案在MCU内部开辟一个小于全屏的缓冲区比如只缓冲一行或一个字符区域的数据组装好后再一次性发送。这可以避免频繁地设置窗口地址提升部分场景下的效率。绘制基本图形点、线、矩形、圆的算法是基础。例如画线用Bresenham算法画圆用中点圆算法。这些算法需要自己实现或移植。对于文字显示需要字库。由于屏幕小通常使用点阵字库比如12x12 16x16。可以将字库以数组形式存储在代码区Flash或外部Flash中。4. 性能优化与显示效果调校当基础显示功能实现后你会发现刷新速度慢、颜色不对、有残影等问题。这时就需要深入调优。4.1 SPI全双工与DMA加速默认的HAL_SPI_Transmit是阻塞式的CPU要等待整个传输完成。刷新一整屏32768字节数据即使SPI时钟9MHz理论时间也要约29ms加上命令开销实际可能超过30ms帧率只有30多帧。但这已经阻塞CPU 30ms期间无法处理其他任务。优化方案1使用DMA直接存储器访问。让DMA控制器自动将内存中的数据搬运到SPI的发送数据寄存器CPU在此期间可以被释放出来处理其他事情。// 配置SPI的TX DMA流 // 在显示函数中 HAL_SPI_Transmit_DMA(hspi1, (uint8_t*)frame_buffer, BUFFER_SIZE); // 然后等待DMA传输完成中断或回调函数使用DMA后CPU占用率几乎降为0刷屏时间就只受限于SPI时钟速度。优化方案2提高SPI时钟。在确保信号质量导线不长干扰小的前提下可以尝试将SPI时钟提高到MCU SPI外设支持的最高分频。STM32F103的SPI1在PCLK2为72MHz时最高可达36MHz。但要注意屏幕驱动芯片有最高时钟限制ST7735S通常支持到15MHz写和10MHz读。盲目提高可能导致数据错误。我一般保守地设置在15-18MHz左右已经比之前快了一倍。4.2 颜色管理与Gamma校正你可能会发现屏幕上显示的颜色和你在代码里设定的RGB565值看起来有偏差。比如纯红色(0xF800)看起来有点发橙。这涉及到两个问题驱动芯片的颜色格式ST7735S支持多种颜色格式如RGB565、RGB444等。你发送的数据格式必须和芯片内部设置的格式一致。初始化命令COLMOD就是用来设置这个的。务必确保你发送的16位数据格式与COLMOD命令匹配。Gamma校正LCD屏幕的亮度响应通常不是线性的。低灰度时电压变化对亮度影响大高灰度时影响小。为了让人眼感知到的亮度变化是均匀的需要对输出数据进行非线性校正Gamma校正。ST7735S提供了一系列Gamma校正命令GMCTRP1,GMCTRN1等里面是一组预设的校正值。通常直接应用数据手册或示例代码中的Gamma校正序列就能获得更准确、更柔和的色彩过渡。如果颜色感觉“生硬”或“断层”可以尝试调整这些Gamma值。4.3 解决残影与闪烁残影即图像切换后上一幅图的痕迹还隐约可见。这主要是由于液晶分子的扭转和恢复需要时间。ST7735S有一个FRMCTR1帧率控制命令可以调整帧速率。适当降低帧率有时反而能减轻残影因为给了液晶分子更充分的响应时间。但帧率太低会导致动画卡顿需要权衡。闪烁可能是由于电源纹波也可能是软件问题。如果是在绘制过程中屏幕局部闪烁检查一下你的绘制逻辑是否在每次局部更新时都先正确设置了窗口CASET/RASET然后发送RAMWR再发送数据错误的窗口设置可能导致数据写到了非预期的区域造成显示混乱视觉上像闪烁。另一个高级技巧是使用局部刷新。如果界面上只有一小部分区域如一个数字需要更新那么只刷新这一小块区域而不是全屏。这需要你精确管理屏幕上每个元素的区域。例如一个数字从“1”变成“2”你只需要计算这两个数字图形的差异区域然后只更新这个差异区域。这能极大减少数据量和刷新时间从而降低整体功耗和视觉闪烁感。5. 实战应用构建一个微型信息显示器理论说了这么多我们把它用起来。假设我们要做一个显示时间、温度和电量的微型状态显示器。5.1 界面布局与内存管理128x128的屏幕空间极其宝贵。我们需要精心规划顶部20像素显示标题如“Status”用12号字体。中间区域80像素高用于显示大号的时间数字如32像素高的字体或主要的温度数据。底部28像素显示电量图标和百分比以及一些状态图标。由于没有全屏缓冲区我们需要一个“脏矩形”机制。为屏幕上每个可能变化的区域定义一个结构体包含其坐标和是否需要更新的标志。typedef struct { uint16_t x; uint16_t y; uint16_t width; uint16_t height; bool is_dirty; } display_region_t; display_region_t region_time {10, 30, 108, 32, false}; display_region_t region_battery {90, 100, 30, 20, false};当时间需要更新时region_time.is_dirty true。在主循环中定期检查所有区域如果is_dirty为真则调用对应的绘制函数更新该区域更新完成后将标志置为false。5.2 字体与图标处理为了节省Flash空间我们只提取需要的字符和图标。例如时间显示只需要数字0-9和冒号“:”。我们可以制作一个精简的字库数组。图标如电池、WiFi信号可以用位图数组表示每个像素1位单色或16位彩色。网上有很多在线工具可以将小图片转换成C语言数组。绘制图标时注意颜色深度。如果你的图标是单色的但屏幕是16位色你需要一个颜色查找表将图标的1位数据映射到前景色和背景色。5.3 低功耗策略0.71英寸屏本身功耗很低全亮时几个mA但在电池供电设备中每一微安都值得计较。动态背光控制环境光暗时可以降低背光亮度通过PWM控制BLK引脚或直接关闭背光。睡眠模式ST7735S有睡眠命令SLPIN。当长时间不需要显示时发送此命令芯片进入低功耗睡眠模式电流可以降到微安级。需要显示时再发送唤醒命令SLPOUT。注意从睡眠中唤醒后通常需要重新初始化一部分寄存器或者直接发送完整的初始化序列最保险。降低刷新率如果显示的是静态或缓慢变化的信息可以大幅降低刷新频率。比如每秒只更新一次时间。在不需要刷新的时候让MCU和SPI都进入低功耗状态。6. 调试过程中遇到的典型问题与解决方案实际开发不可能一帆风顺下面是我踩过的一些坑和解决办法。6.1 屏幕初始化后无任何显示白屏或黑屏这是最常见的问题。排查步骤查电源和背光用万用表测量VCC和GND引脚电压是否为稳定的3.3V背光引脚BLK电压是否被拉高如果可控最简单的方法用手电筒斜着照屏幕看能否看到非常暗的图案。如果能说明屏幕有显示但背光没亮。查复位时序复位引脚RES的时序非常关键。正确的顺序是上电后保持RES为低电平至少10ms然后拉高再延迟至少120ms等待内部振荡稳定再进行初始化命令序列。很多驱动库的LCD_Init函数开头就包含了这个硬件复位过程确保你的代码执行了它。查SPI通信用逻辑分析仪或示波器抓取SPI总线SCLK, MOSI的波形。看初始化命令序列是否被正确发出。重点检查第一个命令SWRESET软件复位是否发出。没有逻辑分析仪的话可以尝试将SPI速率降到很低比如100kHz并逐个命令发送在每个命令后加长延时用最笨的方法排除通信速度问题。查初始化序列这是最可能的原因。不同厂家、不同批次的屏幕初始化序列可能有细微差别。特别是那些用于调节电压、Gamma、功率控制的参数。尝试换一个来源的初始化代码比如Adafruit的ST7735库、Arduino的TFT_eSPI库中的配置或者仔细核对数据手册中的推荐序列。6.2 显示颜色异常或花屏颜色格式不匹配确认你发送的像素数据格式RGB565还是其他与通过COLMOD命令设置的格式完全一致。RGB565是0b1015-6-5如果你的数据是别的格式颜色肯定会错乱。数据位序问题SPI是MSB最高位先发送。但RGB565的16位数据中是先发送高8位还是低8位这需要看驱动芯片的要求。ST7735S通常是先发高8位。如果你把字节顺序弄反了颜色就会完全不对。尝试交换发送的两个字节顺序。内存访问控制MADCTL设置错误这个命令控制显示旋转、镜像和颜色顺序BGR/RGB。如果你设置了镜像或旋转但送数据的顺序没变就会花屏。更常见的是RGB顺序。ST7735S默认可能是BGR顺序。这意味着你发送的RGB565数据中的R和B分量会被交换。如果你发现红色和蓝色反了在初始化时修改MADCTL命令中的RGB位或者在你的代码里交换R和B分量。电源噪声回到硬件检查电源滤波电容是否焊接良好尽量靠近模块引脚。可以用示波器观察VCC上的纹波。6.3 刷新速度慢动画卡顿SPI时钟太低检查SPI初始化代码中的分频系数在屏幕允许范围内尽量提高。没有使用DMA如果CPU被SPI传输阻塞其他任务如读取传感器、处理逻辑就会被耽误感觉整体卡顿。启用DMA是质变。无效的全屏刷新检查你的代码逻辑是否在只有局部变化时也执行了全屏刷新引入“脏矩形”机制只更新需要更新的区域。复杂的图形绘制在MCU上实时计算抗锯齿的圆或斜线非常耗时。对于静态或很少变化的复杂图形可以预先计算好位图存在Flash里显示时直接发送位图数据。6.4 长时间运行后显示异常或死机看门狗复位如果SPI传输是阻塞式的且刷新一屏时间超过看门狗超时时间会导致系统复位。优化刷新速度或调整看门狗超时时间。堆栈溢出绘制函数或显示驱动中使用了较大的局部数组可能导致栈溢出。将大数组定义为静态变量或全局变量。电磁干扰EMI在电机、继电器等强干扰源附近SPI信号可能被干扰。尝试缩短连接线使用双绞线或在信号线上串联小电阻如22欧姆并并联到地的小电容如10pF以改善信号完整性。经过这一整套从硬件到软件从原理到调试的梳理这块小小的0.71英寸LCD模块就不再是一个黑盒了。你可以精准地控制它的每一个像素让它在你手中发挥出最大的价值。无论是作为产品中的一个低调的指示器还是作为一个极客玩具的核心显示部件它都能以极低的成本和功耗提供可靠的信息输出。最关键的是通过啃下这块小屏幕你掌握的这套显示驱动、优化和调试的方法论可以无缝迁移到更大、更复杂的显示设备上。