【花雕学编程】Arduino动手做（199）---单行文本横向滚动

【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 显示流畅的滚动文本。

实验场景图  动态图