1. 项目背景与核心价值：为什么从Edison的LCD Cursor开始

如果你手头还有一块吃灰多年的Intel Edison开发板，并且恰好有一个兼容的LCD扩展板，那么今天这个内容就是为你准备的。我最近在整理旧项目资料时，翻出了当年Intel为Edison推出的一系列官方Arduino样例代码。其中有一个名为“Cursor”的LCD显示示例，它演示了如何在1602或2004这类字符型LCD屏幕上控制光标位置、显示自定义字符等基础但至关重要的操作。虽然Edison平台本身已逐渐淡出主流视野，但这类基于I2C或并口的字符LCD驱动原理，以及Arduino IDE下的编程思想，至今在STM32、ESP32乃至国产MCU的开发中依然通用。

这个“Cursor”样例的价值，远不止于让Edison的屏幕亮起来。它本质上是一个嵌入式人机交互（HMI）的入门基石。无论是STM32H750用DMA驱动SPI接口的LCD，还是ESP32驱动OLED，其核心逻辑——初始化、清屏、设置坐标、写入数据——都是相通的。通过剖析这个简单的样例，我们能透彻理解“光标（Cursor）”在显示控制中的角色，它不仅仅是那个闪烁的下划线，更是控制显示位置、实现动态效果（如滚动字幕、菜单选择）的关键抽象层。理解了它，你就能举一反三，去应对更复杂的图形库（如LVGL、U8g2）或是驱动断码屏、段码屏。

对于初学者，这是一个绝佳的起点，能避开底层硬件时序的复杂细节，快速在屏幕上看到反馈，获得成就感。对于有经验的开发者，重温这种“原始”的驱动方式，有助于厘清高级图形库封装之下的本质，尤其是在调试类似“STM32H750 DMA驱动SPI LCD花屏”等问题时，回归基础往往能发现症结所在。接下来，我将带你完整复现这个项目，并深入每一个技术细节，分享我在多种平台上移植类似代码时积累的实战经验。

2. 硬件准备与环境搭建：不只是连接线那么简单

在开始写代码之前，正确的硬件连接和软件环境是成功的一半。很多人项目卡壳，问题都出在这一步。

2.1 硬件清单与连接要点

你需要准备以下硬件：

1. Intel Edison开发板（及配套的Arduino扩展板）。
2. 一个字符型LCD模块。最常见的是基于HD44780控制器的16x2（1602）或20x4（2004）屏幕。强烈建议使用带I2C接口转换板的版本，它能将并口简化为两根信号线（SDA, SCL），极大节省Edison宝贵的GPIO资源。这也是官方样例推荐的方式。
3. 杜邦线若干。

连接方式（以I2C LCD为例）：

• LCD I2C模块的VCC->Edison Arduino扩展板的5V引脚。
• LCD I2C模块的GND->Edison Arduino扩展板的GND引脚。
• LCD I2C模块的SDA->Edison Arduino扩展板的引脚A4（在Arduino引脚定义中，A4即I2C数据线）。
• LCD I2C模块的SCL->Edison Arduino扩展板的引脚A5（I2C时钟线）。

注意：这里有一个极易出错的点。Edison的Arduino扩展板上有两排引脚，务必确认你连接的是标有“A4”、“A5”的模拟输入引脚，它们兼任了I2C功能。直接连接到数字引脚（如D4, D5）是无法通信的。

如果你的LCD是标准的16针并口，则需要连接多达7根线（RS, EN, D4, D5, D6, D7, 背光），接线复杂且易错。因此，我强烈推荐使用I2C模块，这是提升成功率和整洁度的关键。

2.2 软件环境：Arduino IDE的配置与坑位

虽然现在有更现代的编辑器如Cursor（巧合，同名不同物）或VS Code+PlatformIO，但为了最原汁原味地复现官方样例，我们使用Arduino IDE。

1. 安装Arduino IDE：前往官网下载安装。版本1.8.x或2.0+均可，但需注意对Edison的支持。
2. 添加Edison开发板支持：这是最核心也最容易失败的一步。Intel已停止维护，传统的“开发板管理器”添加URL方式可能失效。
   • 可靠方法：手动安装。在网上搜索“Intel Edison Arduino Board Support Package”，找到包含edison文件夹的硬件包（通常是一个.zip或.tar.gz文件）。
   • 将其解压，整个edison文件夹复制到Arduino IDE的hardware目录下（如果不存在则创建）。路径通常像：C:\Users\[你的用户名]\Documents\Arduino\hardware\或~/Arduino/hardware/。
   • 重启Arduino IDE，在“工具”->“开发板”菜单中应该能看到“Intel Edison”。
3. 安装LCD驱动库：对于I2C LCD，你需要LiquidCrystal_I2C库。在Arduino IDE中，点击“项目”->“加载库”->“管理库”，搜索“LiquidCrystal I2C”，选择由Frank de Brabander等维护的版本进行安装。
4. 选择正确的端口：用USB线连接Edison到电脑。在“工具”->“端口”中，选择对应的串口（在Windows设备管理器中通常显示为“Intel Edison Virtual Com Port”）。

实操心得：手动安装BSP（板支持包）时，经常遇到编译错误，提示缺少某个系统头文件。这通常是因为Edison的BSP依赖特定版本的Arduino IDE或系统工具链。一个解决办法是寻找社区维护的、兼容新版本IDE的BSP包。如果实在搞不定，另一个思路是理解代码逻辑后，将其移植到PlatformIO环境下，选择“Intel Edison”平台，这往往更省心。PlatformIO的库管理也更强大。

3. 代码深度解析：从“Hello, World!”到光标魔法

官方“Cursor”样例的代码不长，但每一行都值得推敲。我们不仅看它做了什么，更要明白为什么这么做。

3.1 库的包含与对象初始化

#include <Wire.h> #include <LiquidCrystal_I2C.h> // 设置LCD的I2C地址、显示列数和行数。常见的I2C地址是0x27或0x3F。 LiquidCrystal_I2C lcd(0x27, 16, 2); // 这里以16列2行的LCD为例

• #include <Wire.h>：这是Arduino的I2C通信库。即使你使用LiquidCrystal_I2C库，底层仍需Wire.h来驱动硬件I2C。
• LiquidCrystal_I2C lcd(...)：实例化一个LCD对象。这里埋着一个大坑：I2C地址。0x27和0x3F是最常见的，但你的模块可能是别的地址（如0x20）。如果地址不对，屏幕不会有任何反应。如何确定？可以使用一个简单的I2C扫描程序（Arduino IDE示例中有Wire库的scanner样例）来探测。

3.2setup()函数：初始化的艺术

void setup() { lcd.init(); // 初始化LCD lcd.backlight(); // 打开背光 lcd.print("Hello, World!"); // 初始显示 delay(1000); }

• lcd.init()：这个函数完成了与LCD控制器（HD44780）的“握手”。它发送一系列特定的命令序列，将LCD设置为预设的显示模式（如4位或8位数据接口、显示行数、字体等）。对于I2C模块，库函数帮我们处理了所有底层时序。
• lcd.backlight()：控制背光。有些库将背光控制集成在初始化中，有些则需要单独调用。如果屏幕亮但无字符，检查背光是否开启。
• lcd.print()：这是最常用的函数，用于在当前光标位置输出字符串。注意，初始化后光标默认在左上角（第0行，第0列）。

3.3loop()函数：光标操作的实战演示

这里是样例的核心，演示了光标的多种操作：

void loop() { // 1. 关闭显示，再打开，制造闪烁效果 lcd.noDisplay(); delay(500); lcd.display(); delay(500); // 2. 关闭光标（不显示下划线） lcd.noCursor(); delay(500); // 打开光标（显示下划线） lcd.cursor(); delay(500); // 3. 关闭闪烁的光标块 lcd.noBlink(); delay(500); // 打开光标闪烁（块状闪烁） lcd.blink(); delay(500); // 4. 自动滚动模式下的打印 lcd.clear(); // 清屏，光标归位 lcd.print("Autoscroll: ON"); lcd.setCursor(0, 1); // 将光标移动到第二行行首 lcd.autoscroll(); // 开启自动滚动模式 for (int i = 0; i < 10; i++) { lcd.print(i); delay(300); } // 在自动滚动模式下，新字符会从右侧挤入，整体向左滚动 lcd.noAutoscroll(); // 关闭自动滚动 delay(1000); lcd.clear(); // 5. 从左到右和从右到左的文本打印 lcd.clear(); lcd.print("Left to Right"); delay(1000); lcd.clear(); lcd.rightToLeft(); // 设置文本方向为从右到左 lcd.setCursor(15, 0); // 将光标移动到第一行最右侧 lcd.print("Right to Left"); delay(1000); lcd.leftToRight(); // 恢复默认的从左到右 delay(1000); }

关键原理与避坑指南：

1. 显示、光标、闪烁的控制：display()/noDisplay()控制整个屏幕的显示开关。cursor()/noCursor()控制下划线光标的显示。blink()/noBlink()控制光标位置的字符是否以块状闪烁。这三者是独立的。常见误解是以为blink()是让光标闪烁，其实是让光标处的字符闪烁。想要一个不闪烁的下划线光标，应lcd.cursor(); lcd.noBlink();。

2. 自动滚动（Autoscroll）：这是一个极易混淆的功能。当autoscroll()开启后，每次写入一个字符，屏幕上已有的所有字符都会向左（或向右，取决于文本方向）移动一格。新字符总是出现在光标当前位置，然后光标位置不变（相对于屏幕）。这非常适合实现从右向左的跑马灯效果。但如果你只是想在新位置打印，一定要先noAutoscroll()，然后用setCursor()定位。

3. 文本方向与光标移动：leftToRight()是默认模式，打印后光标向右移动。rightToLeft()模式下，打印后光标向左移动。这影响了print()和write()行为。特别注意：setCursor()的坐标永远是绝对的，不受文本方向影响。坐标(0,0)永远是左上角。

4. 清屏（clear）的副作用：lcd.clear()不仅清空屏幕，还会将光标重置回左上角(0,0)。这在循环中如果忘记重新定位光标，会导致后续内容总是覆盖第一行。

4. 超越样例：自定义字符与高级光标应用

官方样例展示了基础操作，但要让LCD真正“活”起来，还需要以下两项技能。

4.1 创建与显示自定义字符

HD44780控制器允许用户定义最多8个5x8像素的自定义字符（CGRAM）。这对于显示温度单位“℃”、特殊符号或简单图标非常有用。

// 定义自定义字符数据。每个字符是一个8字节数组，每个字节代表一行（5个像素）。 byte degreeSymbol[8] = { B00110, B01001, B01001, B00110, B00000, B00000, B00000, B00000 }; void setup() { lcd.init(); lcd.backlight(); // 将自定义字符数据写入CGRAM的0号位置 lcd.createChar(0, degreeSymbol); } void loop() { lcd.clear(); lcd.print("Temp: 25"); lcd.write(0); // 写入0号自定义字符，即显示“°” lcd.print("C"); delay(2000); }

• createChar(num, data)：num是0-7，代表CGRAM中的位置；data是8字节的数组。
• write(num)：用于显示自定义字符。注意，这里用的是write，不是print。print用于输出ASCII字符和字符串。

注意事项：自定义字符定义后，只要不掉电或执行clear()（某些库实现中clear会重置CGRAM，但通常不会），它会一直保存在控制器内存中。但为了代码健壮性，建议在setup()中定义。

4.2 实现交互式菜单：光标作为选择器

这是光标最经典的应用。我们可以用光标来高亮当前选中的菜单项。

int menuIndex = 0; // 当前选中的菜单项索引 String menuItems[] = {"Start", "Settings", "Info", "Exit"}; int totalItems = 4; void displayMenu() { lcd.clear(); lcd.print(">"); // 在行首打印一个选择标记 lcd.print(menuItems[menuIndex]); // 打印当前选中项 // 如果有第二行，可以显示下一项作为预览 if (menuIndex + 1 < totalItems) { lcd.setCursor(0, 1); lcd.print(" "); lcd.print(menuItems[menuIndex + 1]); } } void loop() { // 假设通过一个按钮来切换选项 if (buttonPressed()) { // 伪代码，需连接按钮并实现去抖 menuIndex = (menuIndex + 1) % totalItems; displayMenu(); delay(300); // 简单防抖 } // 另一个按钮用于确认选择 if (confirmButtonPressed()) { executeMenuItem(menuIndex); } }

这个例子展示了如何将抽象的光标位置，转化为可视化的“>”符号，从而构建用户界面。更高级的做法可以配合lcd.cursor()和lcd.blink()，让光标直接在菜单文字下闪烁，体验更佳。

5. 移植到其他平台：STM32与ESP32的注意事项

理解了Edison上基于Arduino库的驱动，移植到STM32（如H750）或ESP32就有了扎实的基础。核心逻辑不变，变的是底层硬件抽象层（HAL）。

5.1 对于STM32（以HAL库为例）

你不再使用LiquidCrystal_I2C库，而是需要：

1. 配置I2C或SPI外设：在CubeMX中启用对应的I2C或SPI，并配置好引脚、时钟速度（I2C通常用100kHz或400kHz）。
2. 实现底层发送函数：你需要编写函数来通过HAL库发送命令和数据给LCD。这本质上就是实现LiquidCrystal_I2C库中的send()、write4bits()等私有函数。
3. 复制高层逻辑：将lcd.init(),lcd.print(),lcd.setCursor()等函数的逻辑（即它们发送的命令序列）移植到你的STM32工程中。HD44780的命令集是标准的，所以这部分代码几乎可以照搬。

关于STM32H750 DMA驱动SPI LCD的问题：如果你用的是SPI接口的LCD（常见于彩屏或OLED），并启用DMA，常遇到“花屏”、“数据错位”。问题根源往往在于：

• 时序问题：SPI时钟频率过高，LCD控制器来不及响应。尝试降低SPI波特率。
• DMA传输完成中断（TC）与数据就绪：在DMA传输完成后，需要等待一小段时间（根据LCD数据手册）再发送下一条命令或进行其他操作，否则数据可能被覆盖。确保在DMA传输回调函数中或之后添加足够的延迟或状态检查。
• 数据对齐：确保发送的数据格式（8位/16位）与LCD控制器期望的格式一致。

5.2 对于ESP32（使用Arduino框架）

这反而是最简单的，因为ESP32在Arduino框架下兼容性很好。

1. 在PlatformIO或Arduino IDE中，为ESP32开发板安装同样的LiquidCrystal_I2C库。
2. 修改I2C引脚定义。ESP32的默认I2C引脚是GPIO 21 (SDA)和GPIO 22 (SCL)，但你可以自定义：

   #include <Wire.h> #define I2C_SDA 21 #define I2C_SCL 22 Wire.begin(I2C_SDA, I2C_SCL); // 在setup()中调用

3. 剩下的代码，包括LiquidCrystal_I2C对象的初始化和使用，与Edison版本完全一致。这就是抽象层带来的好处。

6. 调试技巧与常见问题排查

即使代码看起来正确，屏幕也可能一片空白。以下是系统的排查思路：

1. 屏幕完全不亮（无背光）：

   • 检查电源和GND连接是否牢固。用万用表测量VCC和GND之间是否有5V电压。
   • 检查背光引脚。有些LCD的背光需要单独供电（通过一个限流电阻接VCC），有些则由I2C模块上的跳线或芯片控制。确认lcd.backlight()函数是否被正确调用。

2. 屏幕亮但无任何字符显示（全黑方块或空白）：

   • I2C地址错误：这是头号嫌疑犯。运行I2C扫描程序确认地址。
   • 对比度问题：字符型LCD通常有一个VO（对比度调节）引脚，需要接一个可调电阻到GND来调节对比度。如果对比度调得太低或太高，都可能看不到字符。尝试调节该电阻。
   • 初始化失败：可能是I2C通信不稳定。尝试降低I2C时钟频率（在Wire.begin()后调用Wire.setClock(100000)设为100kHz）。
   • 库不兼容：有些LiquidCrystal_I2C库版本针对特定的I2C转接芯片（如PCF8574）。确认你使用的库支持你的模块芯片。

3. 显示乱码或错位：

   • 初始化序列不完整或错误：确保lcd.init()被成功执行。有时电源不稳会导致初始化失败，可以在setup()中增加delay(100)后再初始化。
   • 数据/命令发送错误：检查底层发送函数是否正确区分了命令（Command）和数据（Data）模式。HD44780通过RS引脚区分两者。
   • 自定义字符冲突：如果你定义了自定义字符，但显示不对，检查字符数据数组的格式是否正确（8行，每行5个像素，高位在前）。

4. 光标行为异常：

   • 确认你调用的是lcd.cursor()而不是lcd.blink()，或者反之。
   • 在调用setCursor()后立即打印，确保没有其他代码意外移动了光标。
   • 检查是否意外进入了“自动滚动”模式。

一个实用的调试方法：简化测试。写一个最简单的程序，只做初始化、开背光、在(0,0)位置打印一个字符“A”。如果这个能成功，再逐步添加复杂功能，能快速定位问题阶段。

回顾整个从Intel Edison官方样例出发的旅程，我们不仅复活了一块旧硬件，更重要的是拆解了字符LCD显示的核心机制——光标控制。这套基于HD44780的命令体系，是嵌入式显示领域的通用语言。无论你未来面对的是STM32复杂的DMA-SPI驱动问题，还是想在ESP32上快速做一个菜单原型，今天打下的基础都会让你事半功倍。硬件在变，平台在变，但解决问题的思路和底层协议往往相通。下次当你遇到显示问题时，不妨先问问自己：我的“光标”现在在哪？它应该在哪？