1. 项目概述1.83英寸LCD模块的入门与精要最近在捣鼓一个小玩意儿一块1.83英寸的LCD模块。这尺寸听起来不大但在嵌入式开发、智能穿戴或者DIY仪表盘项目里它可是个“黄金尺寸”——足够显示几行关键信息又不会占用太多宝贵的PCB空间和电量。我猜你点进来要么是手头正好有这么一块屏不知道如何下手要么是在为你的下一个创意项目物色一个合适的显示方案。无论是哪种情况这篇文章就是为你准备的。这块1.83寸屏通常指的是对角线长度分辨率常见的有128x160、132x176或者更高一些的。它不像手机屏那么复杂驱动接口多半是SPI或者并口比如8080或6800时序这意味着你可以用一颗普通的单片机比如STM32、ESP32甚至Arduino轻松点亮它。但“点亮”只是第一步如何让它稳定、高效地工作显示流畅的动画或实时数据这里面有不少门道。接下来我会结合我实际驱动这类小屏的经验从硬件连接到软件驱动从底层刷屏到上层应用把每个环节的细节、踩过的坑和优化技巧都捋清楚。2. 核心硬件解析与接口选择2.1 模块引脚定义与电源设计拿到一块1.83寸LCD模块第一步不是急着写代码而是看引脚。通常模块会引出10到20个引脚不等。最关键的有这几类电源引脚VCC, GND, LED/LED-这是最容易出问题的地方。模块的VCC电压范围一定要看清常见的是3.3V也有5V或宽电压的。绝对不要想当然地接5V否则可能瞬间冒烟。背光LED一般单独供电可以通过一个限流电阻连接到MCU的GPIO或专门的背光驱动芯片方便进行亮度调节或开关控制。控制引脚CS, RESET, DC/RSCS片选SPI接口必备用于在多个SPI设备中选择当前要通信的LCD。RESET复位硬件复位引脚。很多驱动不稳定的问题可以通过在初始化时给一个正确的复位序列来解决。我的经验是即使代码里有软件复位命令硬件复位引脚也最好接到MCU的GPIO上进行上电后的强制复位这能解决90%的“上电花屏”或“初始化失败”问题。DC/RS数据/命令选择这个引脚至关重要。它告诉驱动器你接下来发送的一个字节是命令如设置显示区域、睡眠模式还是数据实际的像素颜色。SPI接口下通常DC0为命令DC1为数据。数据通信引脚这取决于接口类型。SPI接口SCK时钟 MOSI主机输出从机输入即数据线 有的屏支持MISO用于读屏状态但很少用。SPI的优势是引脚少接线简单非常适合MCU引脚紧张的项目。并行接口如8080D0-D7或D0-D15数据总线 RD读使能 WR写使能。并行接口速度远高于SPI适合刷屏数据量大或要求高帧率的场景。注意务必找到你手中模块的具体数据手册Datasheet。不同厂商、不同驱动芯片如ST7735S, ILI9341, HX8357等的初始化序列、命令集可能有细微差别。网上找的例程不能完全照搬。2.2 SPI与并行接口的深度抉择选择SPI还是并行不是一个随意的决定它直接关系到你项目的性能和复杂度。SPI接口优点引脚占用极少通常3-4根数据线控制线布线简单驱动程序相对通用。缺点带宽受限。即使使用STM32的高速SPI几十MHz传输一屏128x160x16位色即RGB565格式每个像素2字节的数据也需要128*160*2 / 速度的时间。计算一下在40MHz SPI下刷一整屏也需要大约1ms这还没算命令开销。对于频繁全屏更新的动画帧率会受限。适用场景数据显示更新不频繁如传感器读数、状态指示、MCU引脚资源紧张、项目对功耗敏感SPI通常更省电的情况。并行接口以8080为例优点速度极快。通过8位或16位数据总线一次性写入一个字节或一个字两个字节配合写使能信号吞吐量巨大。刷屏速度可以是SPI的十倍甚至几十倍。缺点占用大量GPIO至少82根布线复杂对MCU的IO速度有一定要求。适用场景需要显示流畅视频、复杂UI动画、或者屏幕本身分辨率较高的项目。如何选择对于1.83寸这种小屏如果只是显示文本和简单图形SPI绰绰有余。但如果你的项目是做一个迷你游戏机或者需要平滑的菜单滚动那么并行接口带来的流畅体验是值得你多花些引脚和精力的。我个人的经验是在STM32F1这类资源有限的芯片上用SPI驱动小屏是性价比最高的方案而在STM32F4/H7或者ESP32这类性能较强的芯片上可以优先考虑并行接口以释放全部潜力。3. 底层驱动编写与DMA优化策略3.1 驱动芯片初始化序列的奥秘驱动LCD本质上是和屏上的驱动芯片Driver IC对话。初始化序列就是一串按照特定顺序发送的命令和参数用来配置驱动芯片的工作模式。这些命令通常包括软件复位发送复位命令如0x01有时需要延迟几十毫秒。退出睡眠模式0x11。设置像素格式告诉芯片你将要发送的数据是16位色RGB565还是18位色RGB666。我们常用RGB5650x05或0x55命令具体看芯片。设置显示区域X, Y坐标范围这是最关键的一步。通过命令如0x2A, 0x2B设置你要写入的矩形区域之后连续发送的像素数据就会自动填充这个区域。设置不正确会导致显示错位、花屏。打开显示0x29。一个常见的坑是初始化时序延迟。数据手册里经常要求命令之间有几毫秒到几十毫秒的延迟。在MCU上我们常用HAL_Delay()或简单的循环等待。但要注意有些屏的复位引脚需要保持低电平足够长的时间如10ms。最稳妥的做法是将硬件复位拉低GPIO、软件复位命令、以及命令间的延迟都严格按照数据手册里最保守的时间值来设置。宁可多等几毫秒也不要因为时序太紧导致初始化失败。3.2 基于STM32的SPIDMA刷屏实战对于STM32用户使用SPI配合DMA直接存储器访问来刷屏是解放CPU、提高效率的黄金法则。CPU只需要设置好要传输的数据块和目的地启动DMA就可以去处理其他任务等DMA传输完成产生中断再通知CPU。配置步骤初始化SPI在CubeMX中将SPI配置为主机全双工模式设置合适的波特率预分频Prescaler。对于刷屏速度当然是越快越好但要确保在PCB布线长度下信号质量稳定。通常先尝试18MHz或36MHz。初始化DMA为SPI的TX发送通道添加一个DMA流Stream。模式选择“Normal”单次传输或“Circular”循环传输适用于双缓冲机制。数据宽度通常与SPI数据宽度匹配8位或16位。编写刷屏函数// 假设已定义好 SPI_HandleTypeDef hspi1, DMA_HandleTypeDef hdma_spi1_tx // 以及控制引脚LCD_CS_Pin, LCD_DC_Pin void LCD_WriteData_DMA(uint8_t *data, uint32_t size) { LCD_CS_LOW(); // 选中LCD LCD_DC_HIGH(); // 设置为数据模式 // 确保上一次DMA传输已完成 while (HAL_DMA_GetState(hdma_spi1_tx) HAL_DMA_STATE_BUSY); // 启动DMA传输 HAL_SPI_Transmit_DMA(hspi1, data, size); // 注意此时函数立即返回传输在后台进行。 // 需要等待传输完成中断或查询状态才能进行下一步如拉高CS。 }处理DMA传输完成中断在DMA或SPI的传输完成中断回调函数中拉高CS片选信号表示本次数据传输结束。void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { LCD_CS_HIGH(); // 传输完成取消片选 // 可以在这里设置一个标志位通知主循环一帧数据已发送完毕 } }DMA刷屏的核心技巧——设置显示窗口刷屏不是每次都从左上角(0,0)刷到右下角。高效的做法是在发送像素数据前先用命令设置一个显示窗口Window。例如你只需要更新屏幕中间的一块区域void LCD_SetWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { LCD_WriteCommand(0x2A); // 列地址设置命令 LCD_WriteData(x0 8); LCD_WriteData(x0 0xFF); LCD_WriteData(x1 8); LCD_WriteData(x1 0xFF); LCD_WriteCommand(0x2B); // 行地址设置命令 LCD_WriteData(y0 8); LCD_WriteData(y0 0xFF); LCD_WriteData(y1 8); LCD_WriteData(y1 0xFF); LCD_WriteCommand(0x2C); // 内存写入命令接下来发送的都是像素数据 }设置好窗口后再启动DMA发送这个矩形区域对应的像素数据缓冲区。这样驱动芯片就知道数据该放在哪里避免了每次都要计算全局坐标。3.3 内存管理与帧缓冲区策略刷屏数据从哪里来你需要一个在内存中的“画布”即帧缓冲区Frame Buffer。全缓冲Full Framebuffer在MCU的RAM中开辟一个和屏幕分辨率一样大的数组。例如对于128x160 RGB565屏幕需要128 * 160 * 2 40,960字节即40KB。你在内存中在这个数组上作画画点、画线、写字画完之后一次性将这个数组通过DMA发送到LCD。优点是逻辑简单避免闪屏缺点是占用大量RAM对于只有几十KB RAM的MCU如STM32F103可能无法承受。部分缓冲Partial Framebuffer或直接绘制Direct Draw不分配全屏缓冲区只分配一小块缓冲区或者根本不分配直接计算像素颜色并立即通过SPI发送。例如要画一条水平线就循环计算每个像素的颜色并发送。或者分配一个“行缓冲区”一次渲染一行再发送。这极大地节省了RAM但编程逻辑复杂且因为绘制和发送是交替进行的如果绘制计算太慢会影响刷屏速度可能导致撕裂Tearing。我的选择建议如果MCU的RAM足够比如STM32F4有192KBSTM32H750更是有1MB强烈建议使用全缓冲。开发体验会好很多你可以使用现成的GUI库如LVGL, u8g2它们都基于全缓冲。如果RAM紧张可以尝试使用MCU的外部RAM如SDRAM来作为帧缓冲但这会引入额外的复杂度和延迟。对于1.83寸小屏在STM32G系列或ESP32上全缓冲通常是可行的。4. 高级应用与性能优化实战4.1 集成LVGL图形库构建用户界面当你有了稳定的底层驱动提供画点、填充矩形等基本函数和帧缓冲区后就可以引入LVGL这类开源图形库来构建复杂的用户界面了。LVGL是一个用C编写的、资源消耗低、功能强大的嵌入式GUI库非常适合在单片机上运行。集成步骤简述移植显示驱动实现LVGL要求的disp_flush回调函数。这个函数的作用是当LVGL在它的内部缓冲区完成一个区域的绘制后会调用这个函数你需要将这个区域的数据复制或发送到你的实际LCD上。void my_disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p) { // 1. 设置LCD的显示窗口为 area-x1, area-y1, area-x2, area-y2 LCD_SetWindow(area-x1, area-y1, area-x2, area-y2); // 2. 计算要传输的数据量 uint32_t size (area-x2 - area-x1 1) * (area-y2 - area-y1 1); // 3. 启动DMA将 color_p 指向的缓冲区数据发送到LCD LCD_WriteData_DMA((uint8_t*)color_p, size * 2); // RGB565是2字节每像素 // 4. 通知LVGL刷新完成在DMA完成中断里调用 // lv_disp_flush_ready(disp_drv); }注意lv_disp_flush_ready必须在数据确实已发送到LCD之后调用通常放在DMA传输完成中断回调里。配置输入设备如果需要如果你的屏是触摸屏还需要移植触摸驱动实现touchpad_read回调函数将坐标信息反馈给LVGL。初始化并创建UI在主循环中定期调用lv_timer_handler()和lv_task_handler()然后你就可以用LVGL丰富的控件按钮、标签、图表等来创建界面了。使用LVGL的优势它处理了所有的脏矩形渲染只更新屏幕上发生变化的部分极大地提高了效率。你不再需要手动管理哪里该刷新只需要关注UI逻辑本身。4.2 解决SPI DMA驱动中的典型问题在热词里看到了“stm32h750 dma 驱动 spi lcd 问题”这确实是个高频痛点。结合我的踩坑经历常见问题有显示错位或花屏原因最常见的是显示窗口设置错误或者DMA传输的数据量计算错误。排查首先确保初始化序列完全正确。然后写一个简单的测试函数用DMA发送一个固定颜色比如全红色的缓冲区填充全屏。如果显示正常说明底层驱动和DMA是好的问题出在LVGL的disp_flush函数或你的绘图逻辑上。如果仍然花屏检查SPI时钟极性CPOL和相位CPHA是否与LCD驱动芯片要求的一致通常是Mode 0或Mode 3。检查DMA传输的数据宽度8位/16位是否与SPI数据宽度匹配。DMA传输不启动或只传输一部分原因DMA或SPI外设时钟未使能DMA缓冲区地址或长度设置错误在DMA传输完成前就修改了缓冲区内容SPI的NSS硬件片选信号模式冲突如果用了硬件NSS建议配置为软件控制。排查使用调试器在启动DMA后查看SPI的SR状态寄存器和DMA相关寄存器的状态。确保HAL_SPI_Transmit_DMA调用后DMA的通道是使能的。一个关键技巧在启动DMA传输前先将CS拉低并确保DC引脚电平正确然后再启动DMA。传输完成的回调里再拉高CS。屏幕闪烁或撕裂原因LVGL的lv_disp_flush_ready调用时机不对。如果在启动DMA后立即调用而此时DMA可能还在传输中LVGL会认为该区域已刷新完毕可能会立即开始绘制下一帧导致同时读写帧缓冲区造成撕裂。解决必须在DMA传输完成中断HAL_SPI_TxCpltCallback中调用lv_disp_flush_ready。这是保证帧同步的关键。性能瓶颈现象UI动画卡顿。优化提高SPI时钟在保证信号完整性的前提下尽量提高SPI波特率。使用双缓冲LVGL支持双缓冲。分配两个显示缓冲区A和B。当LVGL在缓冲区A绘制时DMA可以从缓冲区B读取数据发送到LCD反之亦然。这几乎可以完全消除因等待DMA传输而导致的CPU停滞。但这需要两倍的缓冲区内存。优化LVGL刷新区域确保你的UI设计不会导致全屏频繁刷新。LVGL的脏矩形机制本身已经很高效。5. 项目拓展与进阶思路驱动一块1.83寸LCD并显示内容只是一个起点。基于这个稳定的显示基础你可以做很多有趣的事情制作便携式仪表结合传感器温湿度、气压、陀螺仪实时将数据以仪表盘或波形图的形式显示在屏幕上。嵌入式游戏机利用SPI屏和几个按键复刻一些经典的小游戏如贪吃蛇、俄罗斯方块。这会对你的动画处理和游戏逻辑编程能力是个很好的锻炼。智能家居中控屏通过ESP32的Wi-Fi连接网络显示天气、时间控制家里的智能设备。LVGL可以做出非常美观的交互界面。二次开发与调试显示器将屏幕作为你另一个主项目的调试信息输出终端比串口助手更直观。最后关于屏幕选购的一个小建议购买模块时除了关注尺寸和分辨率一定要问清楚驱动芯片型号和接口类型并索取数据手册。最好选择商家提供示例程序最好是STM32或Arduino的的模块这能为你节省大量的初始调试时间。有些模块甚至已经焊好了触摸屏通常是电阻式或电容式这对于做交互项目来说更是如虎添翼。