从零玩转ST7565R驱动12864 COG屏：硬件连接与代码实战全解析
第一次拿到ST7565R驱动的12864 COG液晶屏时，面对密密麻麻的引脚和晦涩的数据手册，相信不少开发者都会感到无从下手。这种单色COG（Chip On Glass）液晶屏因其低功耗、高对比度的特性，在工业仪表、便携设备中广泛应用，但驱动开发却暗藏不少"坑点"。本文将用最直白的语言，带你从引脚定义到字符显示，完整走通整个开发流程。
1. 硬件准备：读懂引脚与电路设计
ST7565R驱动的12864屏幕通常有20个引脚，但实际常用核心引脚不超过10个。先来看几个关键引脚的定义：
| 引脚编号 | 名称 | 作用描述 | 接法注意事项 |
|---|---|---|---|
| 1 | VSS | 电源地 | 必须稳定接地 |
| 2 | VDD | 逻辑电源(3.3V) | 需加0.1μF去耦电容 |
| 4 | RS/A0 | 数据/命令选择 | 低电平命令，高电平数据 |
| 5 | R/W | 读写选择(串口模式下通常接地) | 并口模式需连接 |
| 6 | E/SCLK | 使能/时钟信号 | 根据模式选择接法 |
| 15 | RESET | 复位信号 | 需10kΩ上拉电阻 |
| 17 | CS | 片选信号 | 低电平有效 |
硬件设计常见坑点：RESET引脚必须通过上拉电阻连接VDD，否则可能出现初始化失败；CS引脚即使不用也建议接地，避免浮空导致异常。
模式选择电阻是另一个容易忽略的关键点。在模块背面通常会有两个焊盘（标记为PSB）：
- 焊接PSB到VSS：选择SPI串行模式
- 焊接PSB到VDD：选择6800并行模式
对于大多数现代MCU项目，推荐使用SPI模式，可以节省IO资源。以下是典型的SPI模式连接方案：
// STM32硬件SPI连接示例 LCD_SCLK -> PA5 (SPI1_SCK) LCD_SDA -> PA7 (SPI1_MOSI) LCD_A0 -> PB0 (GPIO) LCD_RESET -> PB1 (GPIO) LCD_CS -> GND (常使能)2. 驱动初始化：时序与寄存器配置
ST7565R的初始化流程需要严格按照数据手册的时序进行。以下是基于STM32 HAL库的核心初始化代码：
void LCD_Init(void) { // 硬件复位序列 HAL_GPIO_WritePin(LCD_RESET_GPIO, LCD_RESET_PIN, GPIO_PIN_RESET); HAL_Delay(50); HAL_GPIO_WritePin(LCD_RESET_GPIO, LCD_RESET_PIN, GPIO_PIN_SET); HAL_Delay(50); // 发送初始化命令序列 LCD_WriteCmd(0xE2); // 系统复位 LCD_WriteCmd(0xA3); // 偏置设置(1/7 bias) LCD_WriteCmd(0xA0); // 段方向正常 LCD_WriteCmd(0xC8); // 输出方向反向 LCD_WriteCmd(0x25); // 内部电阻比率 LCD_WriteCmd(0x81); // 电子音量设置 LCD_WriteCmd(0x18); // 音量值(对比度) LCD_WriteCmd(0x2F); // 电源控制 LCD_WriteCmd(0x40); // 显示起始行设为0 LCD_WriteCmd(0xAF); // 开启显示 }调试技巧：如果屏幕出现全亮或全暗，首先检查对比度设置(0x81命令后的参数)，建议初始值设为0x18，再根据实际效果微调。
驱动层需要实现两个基础函数：写命令和写数据。以下是基于STM32硬件SPI的实现：
void LCD_WriteCmd(uint8_t cmd) { HAL_GPIO_WritePin(LCD_A0_GPIO, LCD_A0_PIN, GPIO_PIN_RESET); // 命令模式 HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); } void LCD_WriteData(uint8_t data) { HAL_GPIO_WritePin(LCD_A0_GPIO, LCD_A0_PIN, GPIO_PIN_SET); // 数据模式 HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); }3. 显示控制：从像素到字符
ST7565R的显存结构比较特殊：132x65的分辨率被分为8页（Page），每页132列，每列8位对应垂直方向的8个像素。这意味着：
- 每个字节控制同一列的8个垂直像素
- 页地址范围0xB0~0xB7
- 列地址范围0x00~0x83
清屏函数的实现需要理解这种结构：
void LCD_Clear(void) { for(uint8_t page=0; page<8; page++) { LCD_WriteCmd(0xB0 | page); // 设置页地址 LCD_WriteCmd(0x10); // 列地址高4位 LCD_WriteCmd(0x00); // 列地址低4位 for(uint8_t col=0; col<132; col++) { LCD_WriteData(0x00); // 清除所有像素 } } }显示ASCII字符需要先定义字模。以下是5x7点阵字模的示例定义和显示函数：
// 简化的ASCII字模(只包含部分字符) const uint8_t Font5x7[] = { 0x00,0x00,0x00,0x00,0x00, // 空格 0x00,0x00,0x5F,0x00,0x00, // ! 0x00,0x07,0x00,0x07,0x00, // " // 更多字符定义... }; void LCD_PutChar(uint8_t x, uint8_t page, char c) { if(c < 32 || c > 127) c = ' '; // 非法字符处理 LCD_WriteCmd(0xB0 | page); // 设置页 LCD_WriteCmd(0x10 | (x>>4)); // 列地址高4位 LCD_WriteCmd(x & 0x0F); // 列地址低4位 const uint8_t *pChar = &Font5x7[(c-32)*5]; for(uint8_t i=0; i<5; i++) { LCD_WriteData(pChar[i]); } LCD_WriteData(0x00); // 字符间间隔 }4. 高级技巧与性能优化
显存局部刷新可以大幅提升刷新效率。例如只更新特定区域：
void LCD_UpdateArea(uint8_t x1, uint8_t x2, uint8_t page1, uint8_t page2) { for(uint8_t page=page1; page<=page2; page++) { LCD_WriteCmd(0xB0 | page); LCD_WriteCmd(0x10 | (x1>>4)); LCD_WriteCmd(x1 & 0x0F); for(uint8_t x=x1; x<=x2; x++) { LCD_WriteData(frameBuffer[page][x]); } } }自定义图形绘制需要处理位操作。以下是画线算法的实现片段：
void LCD_DrawLine(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1) { 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_SetPixel(x0, y0); if(x0==x1 && y0==y1) break; e2 = 2*err; if(e2 >= dy) { err += dy; x0 += sx; } if(e2 <= dx) { err += dx; y0 += sy; } } }SPI速度优化对刷新率影响显著。在STM32中可调整预分频：
hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_8; // 提升到9MHz5. 常见问题排查指南
遇到显示异常时，可以按照以下步骤排查：
电源问题检查
- 测量VDD电压是否稳定在3.3V±10%
- 检查所有接地引脚是否可靠连接
信号完整性验证
- 用逻辑分析仪抓取SPI波形
- 确认CS、A0、RESET等控制信号时序
初始化流程确认
- 复位脉冲宽度是否>1ms
- 对比度设置值是否合适(建议0x10~0x30)
显存操作验证
- 尝试全屏填充0xFF/0x00测试显存读写
- 检查列地址是否超出0x83范围
典型故障现象1：屏幕有反应但显示乱码 → 大概率是SPI相位/极性设置错误，尝试调整CPOL/CPHA参数。
最后分享一个实际项目中的经验：在低温环境下，ST7565R的响应速度会变慢，此时需要将复位脉冲延长到100ms以上，并在初始化后增加50ms延时，否则可能出现初始化不完全的情况。
