STM32 I²C驱动HD44780字符LCD的轻量级嵌入式库

1. 项目概述

WattBob_TextLCD 是一套专为 WattBob I 开发板设计的字符型 LCD 显示驱动库，面向 16×2（非 16×32，此处原文存在明显笔误；WattBob I 板实际搭载的是标准 HD44780 兼容的 16 字符 × 2 行字符液晶模块）字符 LCD。该库通过 I²C 总线与 LCD 模块通信，显著降低主控 GPIO 占用，简化硬件连接，并提供简洁、可重入、线程安全的 C 接口，适用于裸机系统及实时操作系统（如 FreeRTOS）环境。

WattBob I 是一款基于 STM32F103C8T6（“Blue Pill”核心）的低成本嵌入式教学与原型开发板，其 LCD 接口采用 PCF8574T I²C 扩展芯片作为并行转串行桥接器。PCF8574T 将 MCU 的 I²C 信号转换为 HD44780 所需的 4 位或 8 位并行控制时序（本库默认使用更节省引脚的 4 位模式），并驱动 LCD 的 RS、RW、E 及数据线 D4–D7。整个显示子系统构成典型的“MCU → I²C → PCF8574T → HD44780 LCD”三级架构。

该库的设计哲学是极简、可靠、可移植：不依赖特定 HAL 库版本，仅需标准<stdint.h>、<stdbool.h>及底层 I²C 驱动函数；所有 API 均为同步阻塞调用，但内部已预置足够长的时序延时（基于HAL_Delay()或用户自定义lcd_delay_ms()），确保在不同主频下均能稳定触发 HD44780 的建立/保持时间要求；所有函数均无静态局部变量，天然支持多任务环境下的并发调用。

2. 硬件接口与电气特性

2.1 WattBob I LCD 接口拓扑

WattBob I 板上 LCD 模块通过以下方式连接：

关键工程考量：PCF8574T 的P0–P7引脚为开漏输出，需外部上拉（WattBob I 板已在 I²C 总线上配置 4.7kΩ 上拉电阻）。RW引脚被硬件硬接至 GND，因此库中所有操作均为写入模式，省去读忙标志（Busy Flag）检测步骤——这是对响应速度与硬件复杂度的合理权衡，符合大多数嵌入式应用场景需求。

2.2 I²C 设备地址与数据帧格式

PCF8574T 的 7 位 I²C 地址由其A0–A2引脚电平决定。WattBob I 板将A0–A2全部接地，故设备地址为0x20（二进制0100000）。I²C 通信时，MCU 发送起始条件后，发送地址字节0x40（写方向），随后发送一个字节的“端口输出数据”，该字节的每一位直接映射到 PCF8574T 的P0–P7输出引脚电平。

例如，要向 LCD 写入一个字节的数据0x55（二进制01010101），需先设置RS=1,RW=0,E=0，再将D4–D7置为对应值，最后产生E脉冲。这在 PCF8574T 上体现为一次 I²C 写操作，数据字节为：

// Bit layout: P7 P6 P5 P4 P3 P2 P1 P0 // E D7 D6 D5 D4 RW RS SDA (but SDA/SCL are bus lines, not port pins) // Correct mapping for WattBob I: // P0 = SDA (not controlled by software) // P1 = SCL (not controlled by software) // P2 = RS // P3 = RW // P4 = E // P5 = D4 // P6 = D5 // P7 = D6 // P8 = D7 — Wait, PCF8574T has only P0-P7!

修正与澄清：PCF8574T 仅有 8 个 I/O 引脚（P0–P7），不存在 P8。WattBob I 的实际引脚映射为（依据常见原理图与库源码反推）：

因此，一个典型的“写数据字节0x55”的端口输出值计算如下（高 4 位D7-D4=0101，RS=1,RW=0,E=0初始态）：

• 初始态（E=0）：P7 P6 P5 P4 P3 P2 P1 P0 = x 0 1 0 1 0 0 1→0x49
• 设置 E=1：... 1 0 0 1→0x4B
• 延时 >450ns
• 设置 E=0：... 0 0 0 1→0x49

此即库中lcd_write_nibble()函数的核心逻辑。

3. 核心 API 接口详解

WattBob_TextLCD 库提供一组精炼的 C 函数，全部声明于wattbob_textlcd.h头文件中。所有函数均返回void，错误通过编译时断言或运行时assert()检查（需用户启用）。

3.1 初始化与基础控制

void lcd_init(void);

功能：完成 LCD 模块的完整初始化流程，包括硬件复位、功能设置（4-bit 模式、2 行显示、5×8 点阵）、显示开关控制（开启显示、关闭光标、不闪烁）及清屏。原理：HD44780 上电后需等待>40ms，然后执行一系列Function Set指令（先发 3 次0x30强制进入 8-bit 模式，再发0x20切换至 4-bit 模式），最后发0x0C（显示开、光标关、不闪烁）和0x01（清屏，耗时>1.64ms）。工程要点：lcd_init()内部调用lcd_delay_ms(50)确保上电稳定；清屏指令后强制lcd_delay_ms(2)，避免后续指令因 LCD 忙碌而丢失。

void lcd_clear(void); void lcd_home(void);

功能：lcd_clear()清空屏幕并归位光标至(0,0)；lcd_home()仅将光标归位，不擦除显示内容。实现：均通过发送对应指令字节0x01和0x02实现。注意lcd_clear()后必须延时>1.64ms，库中已内置lcd_delay_ms(2)。

3.2 光标与显示控制

void lcd_display_on(void); void lcd_display_off(void); void lcd_cursor_on(void); void lcd_cursor_off(void); void lcd_blink_on(void); void lcd_blink_off(void);

功能：分别控制显示、光标、闪烁的开关状态。指令映射：

工程实践：在低功耗应用中，lcd_display_off()可显著降低系统功耗（LCD 背光通常由P7控制，本库默认开启，用户可修改lcd_backlight()函数）。

3.3 文本输出与光标定位

void lcd_putc(char c); void lcd_puts(const char *s); void lcd_set_cursor(uint8_t col, uint8_t row);

功能：lcd_putc()输出单个 ASCII 字符；lcd_puts()输出以\0结尾的字符串；lcd_set_cursor()将光标定位到指定列（0–15）和行（0–1）。关键细节：

• lcd_putc()会自动处理换行：当光标位于第 15 列（col==15）且写入字符时，自动执行lcd_set_cursor(0, 1-row)切换到下一行首列。
• lcd_set_cursor()将行列坐标转换为 HD44780 的 DDRAM 地址。对于 2 行 LCD，地址映射为：
  • 第 0 行：0x00–0x0F（对应列 0–15）
  • 第 1 行：0x40–0x4F（对应列 0–15） 因此，lcd_set_cursor(col, row)计算地址为row ? (0x40 + col) : col，再通过指令0x80 | address发送。

代码示例：

// 在第1行第5列显示 "Temp: 25C" lcd_set_cursor(5, 1); lcd_puts("Temp: 25C");

3.4 自定义字符（CGROM 编程）

void lcd_create_char(uint8_t location, const uint8_t charmap[]);

功能：在 LCD 的 CGRAM（Character Generator RAM）中创建一个自定义字符（8×5 点阵），location为 0–7 的索引，charmap是指向 8 字节数组的指针，每字节代表字符的一行（bit7–bit0 对应从左到右的 8 个点，但 LCD 仅显示最左 5 位）。原理：HD44780 提供 64 字节 CGRAM，可存储 8 个 5×8 字符。lcd_create_char()先发送Set CGRAM Address指令（0x40 | (location << 3)），再连续写入 8 字节点阵数据。工程示例：定义一个“度”符号（°）：

const uint8_t degree_symbol[8] = { 0b00000000, 0b00000000, 0b00011000, 0b00010100, 0b00010100, 0b00001000, 0b00000000, 0b00000000 }; lcd_create_char(0, degree_symbol); lcd_putc(0); // 显示自定义字符

4. 底层 I²C 驱动与延时机制

4.1 I²C 通信抽象层

库本身不实现 I²C 物理层，而是依赖用户提供的两个回调函数，定义在wattbob_textlcd.c中：

extern bool lcd_i2c_write(uint8_t dev_addr, uint8_t *data, uint8_t len); extern void lcd_delay_ms(uint32_t ms);

• lcd_i2c_write()：封装了完整的 I²C 写事务，参数为设备地址（0x20）、待发送数据缓冲区指针及长度（恒为 1）。用户需在此函数中调用其平台对应的 I²C API，例如：

  • STM32 HAL 库：

    bool lcd_i2c_write(uint8_t dev_addr, uint8_t *data, uint8_t len) { return HAL_I2C_Master_Transmit(&hi2c1, dev_addr << 1, data, len, 100) == HAL_OK; }

  • STM32 LL 库：

    bool lcd_i2c_write(uint8_t dev_addr, uint8_t *data, uint8_t len) { LL_I2C_HandleTransfer(I2C1, dev_addr, LL_I2C_ADDRSLAVE_7BIT, len, LL_I2C_MODE_AUTOEND, LL_I2C_GENERATE_START_WRITE); while (LL_I2C_IsActiveFlag_TXIS(I2C1) == RESET); LL_I2C_TransmitData8(I2C1, *data); while (LL_I2C_IsActiveFlag_TC(I2C1) == RESET); return true; }

• lcd_delay_ms()：提供毫秒级精确延时，用于满足 HD44780 的时序要求（如指令执行时间、E 脉冲宽度）。在 FreeRTOS 环境中，应使用vTaskDelay()；在裸机中，可基于 SysTick 或普通循环实现。

4.2 关键时序保障

HD44780 对时序极为敏感，库中关键延时点如下表所示：

lcd_delay_us()通常通过循环实现，其精度取决于系统主频。例如，在 72MHz STM32 上，一个空循环约 12ns，for(volatile int i=0; i<4; i++);可提供约 50ns 延时。

5. FreeRTOS 集成与多任务安全

WattBob_TextLCD 库的函数本身是可重入的，但在多任务环境下，若多个任务同时调用lcd_puts()，可能导致输出内容交错（如任务 A 输出 "Hello"，任务 B 输出 "World"，最终屏幕显示 "HeWollrllod"）。为保证原子性，需引入互斥信号量（Mutex）。

5.1 创建 LCD 互斥信号量

SemaphoreHandle_t lcd_mutex; void lcd_init_rtos(void) { lcd_init(); // 先完成硬件初始化 lcd_mutex = xSemaphoreCreateMutex(); configASSERT(lcd_mutex); }

5.2 线程安全的封装函数

bool lcd_puts_safe(const char *s) { if (xSemaphoreTake(lcd_mutex, portMAX_DELAY) == pdTRUE) { lcd_puts(s); xSemaphoreGive(lcd_mutex); return true; } return false; } void lcd_printf_safe(const char *fmt, ...) { static char buf[32]; va_list args; va_start(args, fmt); vsnprintf(buf, sizeof(buf), fmt, args); va_end(args); lcd_puts_safe(buf); }

使用示例：

void vTaskLCD1(void *pvParameters) { for(;;) { lcd_printf_safe("Temp: %d.%d C", temp_int, temp_dec); vTaskDelay(1000); } } void vTaskLCD2(void *pvParameters) { for(;;) { lcd_printf_safe("Hum: %d%%", humidity); vTaskDelay(2000); } }

此方案确保了 LCD 输出的完整性，是嵌入式多任务系统中的标准实践。

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

6.1 屏幕无显示、全黑或全白

• 全黑：检查VO对比度电位器是否调至过低（VO接近VDD），顺时针旋转增大对比度。
• 全白（方块）：对比度过高（VO接近GND）或RS/RW/E信号异常。用逻辑分析仪抓取 I²C 波形，确认地址0x20是否有数据交互。
• 无任何反应：首先验证 I²C 通信。用万用表测SDA/SCL对地电压，正常应为~1.8V（上拉至 3.3V 的一半，因 PCF8574T 输入高阻）。若为0V，检查上拉电阻是否虚焊；若为3.3V，检查 MCU I²C 引脚是否配置为开漏模式。

6.2 字符错乱、乱码或位置偏移

• 乱码：确认lcd_init()已正确调用，且未在初始化前调用任何lcd_putc()。HD44780 未初始化时 DDRAM 地址指针处于不确定状态。
• 位置偏移：检查lcd_set_cursor()中行列计算是否正确。WattBob I 的第二行地址为0x40，而非0xC0（后者为 4 行 LCD 的第三行）。
• 部分字符缺失：检查字符串是否以\0结尾，lcd_puts()会一直输出直到遇到\0。

6.3 I²C 通信失败（lcd_i2c_write()返回 false）

• NACK：用逻辑分析仪确认 PCF8574T 是否响应地址0x20。若无 ACK，检查A0-A2接线、PCF8574T 供电（VDD/VSS）、焊接质量。
• SCL/SDA 被拉死：检查是否有其他设备挂载在同一 I²C 总线上并发生冲突，或 MCU 引脚配置错误（如配置为推挽而非开漏）。

7. 扩展应用：与传感器数据融合显示

WattBob_TextLCD 的典型应用场景是作为嵌入式系统的本地人机界面（HMI）。以下是一个整合 DHT22 温湿度传感器的完整示例（基于 STM32CubeIDE + HAL）：

#include "wattbob_textlcd.h" #include "dht22.h" // 假设已有 DHT22 驱动 float temperature = 0.0f; float humidity = 0.0f; void vTaskSensorRead(void *pvParameters) { for(;;) { if (dht22_read_data(&temperature, &humidity) == DHT_OK) { // 更新全局变量 } vTaskDelay(2000); } } void vTaskLCDDisplay(void *pvParameters) { char line1[17], line2[17]; for(;;) { snprintf(line1, sizeof(line1), "Temp: %.1f%cC", temperature, 0); snprintf(line2, sizeof(line2), "Humi: %.1f%% ", humidity); lcd_set_cursor(0, 0); lcd_puts(line1); lcd_set_cursor(0, 1); lcd_puts(line2); vTaskDelay(500); } } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); // 初始化 I2C1 MX_TIM2_Init(); // 若使用 TIM2 作为 HAL_Delay 基础 lcd_init_rtos(); // 初始化 LCD 及互斥量 xTaskCreate(vTaskSensorRead, "Sensor", 128, NULL, 1, NULL); xTaskCreate(vTaskLCDDisplay, "LCD", 128, NULL, 1, NULL); vTaskStartScheduler(); while(1); }

此例展示了如何将 WattBob_TextLCD 无缝集成到现代嵌入式软件架构中，实现数据采集、处理与显示的闭环。

8. 性能与资源占用分析

在 STM32F103C8T6（72MHz）平台上，WattBob_TextLCD 的资源占用如下：

该库在资源受限的 Cortex-M3 微控制器上表现出色，其设计充分体现了嵌入式开发中“用时间换空间、用确定性换灵活性”的经典权衡思想。