STM32项目实战：为中景园ST7789屏幕编写一个轻量级图形库（基于HAL+SPI）-深圳市維司達科技有限公司

STM32项目实战：为中景园ST7789屏幕构建轻量级图形库（HAL+SPI架构）

在嵌入式设备上实现图形界面一直是开发者面临的挑战之一。中景园的ST7789屏幕以其高性价比和丰富色彩表现，成为许多STM32项目的首选显示方案。本文将带你从底层驱动出发，逐步构建一个专为小型嵌入式系统优化的轻量级图形库。

1. 图形库架构设计

1.1 基础绘制功能封装

在已有SPI驱动基础上，我们需要建立抽象层来封装基本图形元素。核心结构体应包含以下要素：

typedef struct { uint16_t width; uint16_t height; uint8_t rotation; void (*draw_pixel)(uint16_t x, uint16_t y, uint16_t color); void (*fill_rect)(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color); } LCD_Canvas;

关键绘制函数实现要点：

画点函数需处理屏幕旋转逻辑：

void LCD_DrawPixel(uint16_t x, uint16_t y, uint16_t color) { if(rotation == 1) { uint16_t tmp = x; x = y; y = LCD_HEIGHT - 1 - tmp; } LCD_SetWindow(x, y, x, y); LCD_WriteData16(color); }

直线算法推荐使用Bresenham优化版本：

void LCD_DrawLine(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color) { int dx = abs(x1-x0), sx = x0<x1 ? 1 : -1; int dy = -abs(y1-y0), sy = y0<y1 ? 1 : -1; int err = dx+dy, e2; while(1){ LCD_DrawPixel(x0,y0,color); if(x0==x1 && y0==y1) break; e2 = 2*err; if(e2 >= dy) { err += dy; x0 += sx; } if(e2 <= dx) { err += dx; y0 += sy; } } }

1.2 字体渲染方案对比

方案类型	存储需求	渲染速度	适用场景
位图字体	高	快	固定字号系统
矢量字体	低	慢	多分辨率需求
抗锯齿字体	极高	较慢	高质量显示

推荐采用位图字体结合动态缓存方案：

typedef struct { const uint8_t *table; // 字模数据指针 uint16_t first_char; // 起始ASCII码 uint16_t char_count; // 包含字符数 uint8_t char_width; // 字符宽度 uint8_t char_height; // 字符高度 } FontDef;

2. 帧缓冲管理策略

2.1 全缓冲与局部刷新对比

全缓冲方案：

优点：避免屏幕撕裂，动画流畅
缺点：需要172×320×2=110KB RAM（STM32H750可承受）

局部刷新方案实现要点：

typedef struct { uint16_t x1, y1; // 区域左上角 uint16_t x2, y2; // 区域右下角 uint8_t *buffer; // 局部缓冲区 } DirtyRegion; void LCD_UpdateRegion(DirtyRegion *region) { LCD_SetWindow(region->x1, region->y1, region->x2, region->y2); HAL_SPI_Transmit(&hspi1, region->buffer, (region->x2-region->x1+1)*(region->y2-region->y1+1)*2, HAL_MAX_DELAY); }

2.2 双缓冲技术实现

在STM32H750上可充分利用DTCM内存实现零等待访问：

// 在链接脚本中分配DTCM内存段 MEMORY { DTCM (xrw) : ORIGIN = 0x20000000, LENGTH = 128K } // 应用层声明 __attribute__((section(".dtcm"))) static uint16_t frame_buffer[2][LCD_HEIGHT][LCD_WIDTH];

注意：使用DMA2D加速填充操作时，需确保缓冲区32字节对齐：__attribute__((aligned(32))) uint16_t buffer[...];

3. 高级图形功能实现

3.1 透明混合算法

实现alpha混合需要权衡性能与效果：

uint16_t AlphaBlend(uint16_t fg, uint16_t bg, uint8_t alpha) { uint32_t fg_r = (fg >> 11) & 0x1F; uint32_t fg_g = (fg >> 5) & 0x3F; uint32_t fg_b = fg & 0x1F; uint32_t bg_r = (bg >> 11) & 0x1F; uint32_t bg_g = (bg >> 5) & 0x3F; uint32_t bg_b = bg & 0x1F; uint16_t r = ((fg_r * alpha + bg_r * (255-alpha)) / 255); uint16_t g = ((fg_g * alpha + bg_g * (255-alpha)) / 255); uint16_t b = ((fg_b * alpha + bg_b * (255-alpha)) / 255); return (r << 11) | (g << 5) | b; }

3.2 触摸输入集成

将触摸事件与图形元素关联：

typedef struct { uint16_t x, y; uint16_t width, height; void (*on_touch)(void); } UI_Element; void UI_ProcessTouch(uint16_t x, uint16_t y) { for(int i=0; i<element_count; i++) { if(x >= elements[i].x && x < elements[i].x + elements[i].width && y >= elements[i].y && y < elements[i].y + elements[i].height) { elements[i].on_touch(); break; } } }

4. 多页面管理系统

4.1 页面栈设计

#define MAX_PAGE_DEPTH 5 typedef struct { void (*load)(void); void (*unload)(void); void (*update)(void); void (*draw)(void); } Page; Page page_stack[MAX_PAGE_DEPTH]; int8_t current_page = -1; void PushPage(Page new_page) { if(current_page >= MAX_PAGE_DEPTH-1) return; if(current_page >= 0) page_stack[current_page].unload(); current_page++; page_stack[current_page] = new_page; new_page.load(); }

4.2 转场动画优化

使用硬件加速实现流畅过渡：

void SlideTransition(Page new_page, int8_t direction) { // 方向: 0=左,1=右,2=上,3=下 uint16_t offset = 0; uint16_t speed = 5; // 捕获当前帧 LCD_CaptureFrame(page_stack[current_page].frame_buffer); // 加载新页面但不显示 new_page.load(); new_page.draw(); LCD_CaptureFrame(new_page.frame_buffer); // 执行动画 while(offset < LCD_WIDTH) { LCD_BlitPartial(page_stack[current_page].frame_buffer, direction==1 ? offset : 0, direction==3 ? offset : 0, LCD_WIDTH - (direction%2 ? offset : 0), LCD_HEIGHT - (direction>1 ? offset : 0)); LCD_BlitPartial(new_page.frame_buffer, direction==0 ? LCD_WIDTH-offset : 0, direction==2 ? LCD_HEIGHT-offset : 0, direction%2 ? offset : LCD_WIDTH, direction>1 ? offset : LCD_HEIGHT); offset += speed; HAL_Delay(16); // ~60fps } PushPage(new_page); }

5. 性能优化技巧

5.1 SPI传输优化

关键配置参数对比：

参数	推荐值	说明
SPI时钟	30-45MHz	超过50MHz可能导致信号失真
DMA阈值	32字节	小数据用中断模式更高效
数据位宽	16bit	减少传输次数
FIFO级别	1/4满	平衡响应速度与内存占用

启用DMA传输的典型配置：

void LCD_TransmitDMA(uint16_t *data, uint32_t size) { // 等待上次传输完成 while(hspi1.hdmatx->State != HAL_DMA_STATE_READY); // 配置DMA hdma_spi1_tx.Instance->CR &= ~DMA_SxCR_EN; hdma_spi1_tx.Instance->NDTR = size; hdma_spi1_tx.Instance->PAR = (uint32_t)&hspi1.Instance->DR; hdma_spi1_tx.Instance->M0AR = (uint32_t)data; hdma_spi1_tx.Instance->CR |= DMA_SxCR_EN; // 启动SPI传输 __HAL_SPI_ENABLE(&hspi1); SET_BIT(hspi1.Instance->CR2, SPI_CR2_TXDMAEN); }

5.2 屏幕刷新策略

不同场景下的刷新方案选择：

静态界面：仅更新变化区域（<5%屏幕面积）
动态仪表：60Hz局部刷新（20-30%屏幕面积）
全屏动画：30Hz全缓冲刷新

实现智能刷新决策：

void LCD_SmartUpdate(void) { static uint32_t last_update = 0; uint32_t now = HAL_GetTick(); if(now - last_update < 16) return; // 60Hz限制 if(dirty_region_count == 0) return; if(calculate_dirty_area() > LCD_AREA*0.3) { // 大面积更新使用全刷 LCD_UpdateFull(); } else { // 小面积使用局部更新 for(int i=0; i<dirty_region_count; i++) { LCD_UpdateRegion(&dirty_regions[i]); } } last_update = now; dirty_region_count = 0; }

在STM32H743上实测性能数据：