手把手教你用联盛德W806的SPI驱动ST7567屏：从点亮到显示中文的完整流程

联盛德W806驱动ST7567液晶屏实战指南：从硬件连接到中文显示

在嵌入式开发领域，液晶显示模块的人机交互功能至关重要。联盛德W806作为一款国产RISC-V架构的物联网芯片，搭配ST7567驱动的128x64点阵LCD，能够为各类嵌入式设备提供经济高效的显示解决方案。本文将完整呈现从硬件连接到中文显示的全流程，特别针对初学者容易遇到的"有背光无显示"、"图像错位"等问题提供解决方案。

1. 硬件准备与连接

1.1 认识核心组件

联盛德W806开发板采用平头哥CK804内核，主频可达240MHz，内置硬件SPI控制器，非常适合驱动显示模块。ST7567液晶屏具有以下特性：

• 128x64分辨率单色显示
• 支持4线SPI接口（最高10MHz时钟）
• 内置DC-DC升压电路（4x/5x可选）
• 工作电压：2.4V-3.3V
• 温度范围：-30℃~85℃

1.2 引脚连接方案

ST7567模块通常采用16pin FPC排线接口，实际使用中需要连接的信号线如下表所示：

提示：背光LED建议串联1-5KΩ限流电阻，若直接连接3.3V可能导致电流过大。

1.3 硬件SPI配置

W806的硬件SPI需在WM-SDK中进行如下初始化：

void SPI_Init(void) { SPI_InitTypeDef SPI_InitStructure; GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.Pin = ST7567_CS_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Pull = GPIO_Pull_Up; GPIO_Init(ST7567_CS_PORT, &GPIO_InitStructure); GPIO_InitStructure.Pin = ST7567_DC_PIN; GPIO_Init(ST7567_DC_PORT, &GPIO_InitStructure); SPI_InitStructure.SPI_Direction = SPI_Direction_1Line_Tx; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4; SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_Init(SPI1, &SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }

2. ST7567驱动实现

2.1 关键寄存器配置

ST7567有22条指令，其中以下几个对显示效果影响最大：

1. 电源控制寄存器（0x28）

   • VB：升压电路使能
   • VR：电压调节器使能
   • VF：电压跟随器使能

2. 电子音量控制（0x81）

   • 调节对比度，范围0x00-0x3F
   • 典型值：0x20-0x30

3. 升压倍数选择（0xF8）

   • 0x00：4倍升压
   • 0x01：5倍升压

2.2 初始化序列优化

正确的初始化序列是驱动成功的关键，以下是经过验证的配置：

void ST7567_Init(void) { ST7567_Reset(); // 硬件复位 ST7567_WriteCommand(ST7567_POWER_CONTROL | 0x07); // 开启所有电源电路 ST7567_WriteCommand(ST7567_SET_EV); // 设置电子音量模式 ST7567_WriteCommand(0x20); // 对比度值(0x00-0x3F) ST7567_WriteCommand(ST7567_BIAS_1_9); // 1/9偏置比 ST7567_WriteCommand(ST7567_SEG_DIRECTION_REVERSE); // X方向翻转 ST7567_WriteCommand(ST7567_COM_DIRECTION_NORMAL); // Y方向正常 ST7567_WriteCommand(ST7567_REGULATION_RATIO | 0x4); // 5.0倍调节比 ST7567_WriteCommand(ST7567_DISPLAY_ON); // 开启显示 ST7567_WriteCommand(ST7567_SET_START_LINE | 0x00); // 起始行=0 ST7567_Clear(); // 清屏 }

2.3 常见问题排查

1. 有背光无显示

   • 检查电源控制寄存器（0x28）是否三个位都置1
   • 验证对比度值是否在合理范围（建议0x20-0x30）
   • 确认RESET引脚已完成复位操作

2. 显示内容错位

   • 检查SEG方向设置（0xA0/0xA1）
   • 确认列地址设置正确（0x10 + 0x00组合）
   • 验证显存偏移量处理是否正确

3. 显示闪烁或残影

   • 降低SPI时钟频率（尝试1MHz以下）
   • 增加写入后的延时（至少100μs）
   • 检查电源稳定性（建议增加10μF滤波电容）

3. 图形与文字显示实现

3.1 基本绘图函数

基于像素点的基本绘图函数是实现复杂图形的基础：

// 画点函数 void ST7567_DrawPixel(uint16_t x, uint16_t y, uint8_t color) { if(x >= ST7567_WIDTH || y >= ST7567_HEIGHT) return; uint16_t addr = ST7567_X_OFFSET + x + (y/8)*(ST7567_WIDTH+ST7567_SEG_EXPAND); if(color) { ST7567_Buffer[addr] |= (1 << (y%8)); } else { ST7567_Buffer[addr] &= ~(1 << (y%8)); } } // 画线函数（Bresenham算法） void ST7567_DrawLine(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint8_t color) { int16_t dx = abs(x1-x0), sx = x0<x1 ? 1 : -1; int16_t dy = -abs(y1-y0), sy = y0<y1 ? 1 : -1; int16_t err = dx+dy, e2; while(1){ ST7567_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; } } }

3.2 西文字符显示

采用位图字体时，需要预先定义字体结构体：

typedef struct { const uint8_t width; // 字符宽度（像素） const uint8_t height; // 字符高度（像素） const uint16_t *data; // 字符位图数据指针 } FontDef; // 6x12字体示例 static const uint16_t Font6x12[] = { /* 'A' */ 0x0F00, 0x1F80, 0x39C0, 0x30C0, 0x30C0, 0x3FC0, 0x3FC0, 0x30C0, 0x30C0, 0x30C0 }; FontDef Font_6x12 = {6, 12, Font6x12}; void ST7567_PutChar(char ch, FontDef *font, uint8_t color) { uint16_t idx = (ch - 32) * font->height; for(uint8_t y=0; y<font->height; y++){ uint16_t line = font->data[idx+y]; for(uint8_t x=0; x<font->width; x++){ if(line & (1<<(15-x))) { ST7567_DrawPixel(x_pos+x, y_pos+y, color); } } } }

3.3 中文显示方案

实现中文显示主要有两种方案：

1. 全字库方案

   • 优点：显示灵活，支持任意汉字
   • 缺点：占用大量Flash空间（一个16x16汉字需32字节）

2. 部分字库方案

   • 只包含项目需要的汉字
   • 采用GB2312编码索引
   • 适合显示固定内容

以下是部分字库的实现示例：

// 汉字字模结构体 typedef struct { char code[3]; // GB2312编码 const uint8_t data[32]; // 16x16点阵数据 } ChineseChar; // 示例："中"、"文"两个字 const ChineseChar ChineseLib[] = { {"中", {0x01,0x00,0x01,0x00,0x21,0x08,0x3F,0xFC, 0x21,0x08,0x21,0x08,0x21,0x08,0x3F,0xF8, 0x21,0x08,0x21,0x08,0x21,0x08,0x3F,0xF8, 0x21,0x08,0x01,0x00,0x01,0x00,0x01,0x00}}, {"文", {0x00,0x00,0x1F,0xF0,0x10,0x10,0x10,0x10, 0x10,0x10,0x1F,0xF0,0x01,0x00,0x01,0x00, 0x7F,0xFC,0x01,0x00,0x02,0x80,0x02,0x80, 0x04,0x40,0x08,0x20,0x10,0x10,0x20,0x08}} }; void ST7567_PutChinese(uint16_t x, uint16_t y, const char *str, uint8_t color) { for(int i=0; i<sizeof(ChineseLib)/sizeof(ChineseChar); i++){ if(memcmp(ChineseLib[i].code, str, 2) == 0){ for(uint8_t row=0; row<16; row++){ for(uint8_t col=0; col<2; col++){ uint8_t byte = ChineseLib[i].data[row*2 + col]; for(uint8_t bit=0; bit<8; bit++){ if(byte & (0x80>>bit)){ ST7567_DrawPixel(x+col*8+bit, y+row, color); } } } } break; } } }

4. 性能优化与高级应用

4.1 双缓冲技术

为减少屏幕闪烁，可采用双缓冲机制：

uint8_t ST7567_Buffer1[1024]; // 前台缓冲 uint8_t ST7567_Buffer2[1024]; // 后台缓冲 uint8_t *ST7567_ActiveBuffer = ST7567_Buffer1; void ST7567_SwapBuffer(void) { if(ST7567_ActiveBuffer == ST7567_Buffer1){ ST7567_ActiveBuffer = ST7567_Buffer2; } else { ST7567_ActiveBuffer = ST7567_Buffer1; } ST7567_UpdateScreen(); // 将前台缓冲内容刷新到屏幕 } // 所有绘图操作都在后台缓冲进行 void User_DrawTask(void) { // 在后台缓冲绘制 ST7567_ActiveBuffer = ST7567_Buffer2; ST7567_Clear(); ST7567_DrawString("双缓冲测试", &Font_6x12, 1); // 切换缓冲 ST7567_SwapBuffer(); }

4.2 局部刷新优化

对于静态界面，可以只刷新变化的部分：

typedef struct { uint8_t x1, y1; // 区域左上角 uint8_t x2, y2; // 区域右下角 } DirtyArea; DirtyArea dirty = {127, 63, 0, 0}; // 初始化为无效区域 void ST7567_MarkDirty(uint8_t x, uint8_t y) { if(x < dirty.x1) dirty.x1 = x; if(y < dirty.y1) dirty.y1 = y; if(x > dirty.x2) dirty.x2 = x; if(y > dirty.y2) dirty.y2 = y; } void ST7567_UpdateDirtyArea(void) { for(uint8_t page=dirty.y1/8; page<=dirty.y2/8; page++){ ST7567_WriteCommand(ST7567_SET_PAGE_ADDRESS | page); ST7567_WriteCommand(ST7567_SET_COLUMN_ADDRESS_MSB | (dirty.x1 >> 4)); ST7567_WriteCommand(ST7567_SET_COLUMN_ADDRESS_LSB | (dirty.x1 & 0xF)); for(uint8_t col=dirty.x1; col<=dirty.x2; col++){ uint16_t addr = col + page*(ST7567_WIDTH+ST7567_SEG_EXPAND); ST7567_WriteData(ST7567_ActiveBuffer[addr]); } } // 重置脏区域 dirty.x1 = 127; dirty.y1 = 63; dirty.x2 = 0; dirty.y2 = 0; }

4.3 动态效果实现

结合定时器可以实现流畅的动画效果：

// 文本横向滚动 void ST7567_ScrollText(const char *str, FontDef *font, uint8_t speed) { uint16_t len = strlen(str) * (font->width + 1); for(int offset=0; offset<len; offset++){ ST7567_Clear(); int x_pos = -offset; for(int i=0; i<strlen(str); i++){ if(str[i] & 0x80){ // 中文字符 ST7567_PutChinese(x_pos, 0, &str[i], 1); x_pos += 16; i++; } else { // ASCII字符 ST7567_PutChar(str[i], font, 1); x_pos += font->width + 1; } } ST7567_UpdateScreen(); HAL_Delay(speed); } } // 进度条动画 void ST7567_ProgressBar(uint8_t x, uint8_t y, uint8_t width, uint8_t height, uint8_t percent) { // 边框 ST7567_DrawRect(x, y, width, height, 1); // 填充 uint8_t fill_width = (width-2) * percent / 100; ST7567_DrawRect(x+1, y+1, fill_width, height-2, 1); // 百分比文字 char text[5]; sprintf(text, "%d%%", percent); ST7567_Puts(text, &Font_6x12, 1); ST7567_UpdateScreen(); }

在实际项目中，ST7567液晶屏的刷新率约8-10FPS，适合显示静态内容或简单动画。对于需要快速刷新的场景，建议考虑OLED显示屏替代方案。