树莓派上Waveshare LCD1602显示屏文本左移滚动实现问题

核心原理 #

LCD1602的文本滚动分两种实现逻辑：

• 整体显示移位：通过硬件命令让整个显示屏内容左移，但会同时移动两行内容。
• 单行独立滚动：因硬件限制，LCD1602本身不支持单行单独移位，需手动维护每行的文本缓冲区，每次左移一位后重新写入对应行。

基于现有RGB1602库的实现步骤 #

1. 确认库中关键命令常量 #

你提供的RGB1602.py已包含滚动相关命令：

LCD_DISPLAY_SHIFT = 0x18
LCD_MOVE_LEFT = 0x00
LCD_MOVE_RIGHT = 0x04

调用lcd.command(LCD_DISPLAY_SHIFT | LCD_MOVE_LEFT)可实现整体左移，但会同时影响两行。若需单行独立滚动，使用以下方法。

2. 单行滚动实现代码 #

通过维护文本缓冲区，手动刷新单行内容实现滚动：

import time
from RGB1602 import RGB1602

# 初始化显示屏
lcd = RGB1602(16, 2)
lcd.set_rgb(0, 255, 0)  # 设置RGB背光颜色

def scroll_single_line(line, text, delay=0.3):
    """
    单行文本左移滚动
    :param line: 目标行（0或1）
    :param text: 要滚动的长文本
    :param delay: 每次滚动的间隔时间（秒）
    """
    # 文本长度≤16时直接显示，无需滚动
    if len(text) <= 16:
        lcd.set_cursor(0, line)
        lcd.print(text.ljust(16))
        return
    
    # 循环滚动文本片段
    while True:
        for i in range(len(text) - 15):
            display_segment = text[i:i+16]
            lcd.set_cursor(0, line)
            lcd.print(display_segment.ljust(16))  # 用空格填充剩余位置避免残留字符
            time.sleep(delay)

# 测试单行滚动
scroll_single_line(0, "Hello, this is a long text for LCD1602 scroll test!", 0.2)

3. 解决边缘字符无法左移的问题 #

若使用整体移位命令无效，检查库中command方法的I2C发送逻辑，确保命令正确传递到LCD。整体移位仅移动显示窗口，不改变DDRRAM地址，若需新字符从右侧进入，需在移位后向DDRRAM对应位置写入字符；单行滚动更推荐用上述缓冲区方法，逻辑更灵活且可控。

4. 树莓派/Pico适配注意事项 #

• 树莓派：确保I2C接口已启用（通过raspi-config开启），用i2cdetect -y 1查询LCD的I2C地址（默认0x27或0x3F），与库中配置一致。
• Pico：需修改库中I2C初始化代码，替换树莓派的smbus为machine.I2C，并适配Pico的I2C引脚（如GP0/GP1）。

内容的提问来源于stack exchange，提问作者Omar Ebrahim