【花雕学编程】Arduino动手做（199）---ESP32 LCD12864屏之使用 U8g2 库 实现单行文本横向滚动

37款传感器与模块的提法，在网络上广泛流传，其实Arduino能够兼容的传感器模块肯定是不止37种的。鉴于本人手头积累了一些传感器和执行器模块，依照实践出真知（一定要动手做）的理念，以学习和交流为目的，这里准备逐一动手试试多做实验，不管成功与否，都会记录下来——小小的进步或是搞不掂的问题，希望能够抛砖引玉。

【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验一百九十九：蓝屏LCD12864液晶屏 带中文字库 带背光12864-5V 并口串口

显示器 12864 蓝底白字 - 3.3V
这是一个带 LED 背光的带框型 LCD 图形 128x64。ST7920 控制器型 LCD，具有简单的命令界面。该显示器利用非官方的 12864 Arduino 库和 ST7920 芯片，使其成为几乎所有 Arduino 板项目的绝佳选择。LCD 在蓝色 LED 背光背景上提供白色文本，其引脚支持并行和串行接口。它在 3.3V 下工作，并集成了对比度调整软件控制。

实验模块接线示意图

【Arduino】168种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验一百九十九：蓝屏LCD12864液晶屏 带中文字库 带背光12864-5V 并口串口
项目之三：ESP32 LCD12864屏之使用 U8g2 库 实现单行文本横向滚动

实验开源代码

/*
  【Arduino】168种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验一百九十九：蓝屏LCD12864液晶屏 带中文字库 带背光12864-5V 并口串口
  项目之三：ESP32 LCD12864屏之使用 U8g2 库 实现单行文本横向滚动
*/

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

// 使用软件 SPI 适配 ESP32
U8G2_ST7920_128X64_F_SW_SPI u8g2(U8G2_R0, /* Clock=*/ 18, /* Data=*/ 23, /* CS=*/ 16, /* Reset=*/ 17);

int textX;  // **滚动文本的 X 坐标**
const char *message = "Scrolling Text";  // **滚动文本**

void setup() {
    Serial.begin(115200);
    Serial.println("初始化 ST7920...");
    
    u8g2.begin();
    u8g2.setPowerSave(0);  // **确保屏幕不休眠**
    u8g2.setContrast(20); // **提高对比度**
    u8g2.setDisplayRotation(U8G2_R2);  // **旋转 180 度**
    
    // **初始化文本 X 坐标**
    textX = u8g2.getDisplayWidth();

    Serial.println("初始化完成");
}

void loop() {
    u8g2.setFont(u8g2_font_ncenB14_tr);
    
    u8g2.firstPage();
    do {
        u8g2.setCursor(textX, 38);
        u8g2.print(message);
    } while (u8g2.nextPage());

    textX -= 2;  // **增加步长**
    
    if (textX < -u8g2.getUTF8Width(message)) {
        textX = u8g2.getDisplayWidth();
    }

    delay(10);  // **更快的滚动速度**
}

代码解读
这段代码实现了 ST7920 LCD 显示单行文本滚动，核心逻辑如下：

1. 初始化屏幕
   ✅ u8g2.begin(); → 启动 ST7920
   ✅ u8g2.setPowerSave(0); → 确保屏幕不会休眠
   ✅ u8g2.setContrast(200); → 调整对比度，确保文字清晰
   ✅ textX = u8g2.getDisplayWidth(); → 初始化文本起始位置，从屏幕右侧进入

2. 文本滚动
   ✅ setCursor(textX, 30); → 设置文本位置
   ✅ print(message); → 打印文本
   ✅ textX–; → 每次左移 1 像素，实现滚动
   ✅ if (textX < -u8g2.getUTF8Width(message)) textX = u8g2.getDisplayWidth(); → 如果文本完全离开屏幕，重置位置，从右侧重新滚入

3. 画面刷新
   ✅ firstPage(); do { … } while (nextPage()); → 逐步绘制文本，避免闪烁
   ✅ delay(50); → 控制滚动速度，可以调整让滚动更快或更慢

这个代码可以让 ST7920 显示流畅的滚动文本。

实验场景图 动态图