U8g2项目：ESP32通过硬件SPI驱动ST7920 128x64液晶屏实战指南

硬件连接与原理

ST7920控制器驱动的128x64点阵液晶屏是一种常见的显示设备，在嵌入式项目中广泛应用。当使用ESP32微控制器时，通过硬件SPI接口可以显著提高通信效率。

ESP32的VSPI硬件SPI接口默认引脚分配为：

• GPIO 23 (SCLK) - 连接显示屏的E/SCLK引脚
• GPIO 18 (MOSI) - 连接显示屏的SID/MOSI引脚
• GPIO 5 (CS) - 连接显示屏的RS/CS引脚

需要注意的是，ESP32开发板上GND和5V引脚位置相邻，接线时务必确认连接的是GND而非5V，否则会导致显示屏闪烁等异常现象。

软件配置要点

使用U8g2库驱动ST7920显示屏时，需要注意以下几个关键配置点：

1. SPI初始化：必须显式调用SPI.begin()方法初始化SPI总线，指定正确的引脚映射。

2. 时钟频率设置：ST7920对SPI时钟频率较为敏感，建议设置为500kHz以下以避免显示异常。

3. U8g2对象创建：需要选择正确的构造函数，指定硬件SPI模式和片选引脚。

完整示例代码解析

#include <Arduino.h>
#include <U8g2lib.h>
#include <SPI.h>

// 创建U8g2对象，指定硬件SPI和CS引脚
U8G2_ST7920_128X64_F_HW_SPI u8g2(U8G2_R0, /* CS=*/ 5);

void setup(void) {
  // 初始化SPI总线，指定MOSI、MISO、SCLK和CS引脚
  // 注意：MISO(-1)表示不使用MISO
  SPI.begin(18, -1, 23, 5);
  
  // 初始化显示屏
  u8g2.begin();
  
  // 设置SPI总线时钟频率为500kHz
  u8g2.setBusClock(500000);
}

void loop(void) {
  static uint8_t counter = 0;
  char counterStr[3];
  
  // 将计数器转换为2位数字字符串
  snprintf(counterStr, sizeof(counterStr), "%02d", counter);
  
  // 开始绘制页面
  u8g2.firstPage();
  do {
    // 设置大号字体
    u8g2.setFont(u8g2_font_logisoso62_tn);
    // 在指定位置绘制文本
    u8g2.drawStr(50, 63, counterStr);
  } while (u8g2.nextPage());
  
  // 计数器递增
  counter = (counter + 1) % 60;
  delay(1000);
}

常见问题与解决方案

1. 显示屏闪烁或不稳定：

   • 检查电源连接，确保GND正确连接
   • 降低SPI时钟频率
   • 检查接线是否牢固

2. 无显示或显示异常：

   • 确认SPI引脚映射正确
   • 检查CS引脚是否选择正确
   • 确保U8g2库选择了正确的显示屏型号

3. 显示内容错位：

   • 调整drawStr函数的坐标参数
   • 检查字体大小是否适合显示区域

性能优化建议

1. 对于需要快速刷新的应用，可以尝试逐步提高SPI时钟频率，找到显示屏能稳定工作的最高频率。

2. 使用双缓冲技术可以减少显示闪烁，但会占用更多内存。

3. 对于静态内容，可以只在内容变化时刷新显示，减少不必要的重绘操作。

通过以上配置和优化，ESP32可以稳定高效地驱动ST7920 128x64液晶显示屏，为嵌入式项目提供可靠的显示解决方案。