1. 项目概述用STM32 HAL库点亮你的I2C LCD如果你手头有一块STM32开发板比如性价比很高的STM32 Black Pill又恰好想用它来驱动一个带I2C接口的LCD屏显示点自定义信息那么这个教程就是为你准备的。我最近在做一个需要本地显示状态的小项目正好用上了这套组合。网上资料虽然多但很多要么是标准库的老教程要么步骤跳跃太大对新手不友好。今天我就把从零开始在STM32CubeIDE里用HAL库驱动一块16x2 I2C LCD的完整过程包括那些容易踩坑的细节从头到尾捋一遍。简单来说我们要做的是让STM32通过I2C总线跟一块集成了PCF8574或类似I2C转接芯片的LCD屏“对话”。I2C的好处显而易见只需要两根线SDA数据线和SCL时钟线就能搞定通信比起传统的8位或4位并行接口大大节省了宝贵的GPIO引脚布线也清爽很多。STM32的HAL库把底层硬件操作封装成了一个个清晰的函数我们不用去深究寄存器怎么配置焦点可以放在应用逻辑上。整个过程会涉及STM32CubeIDE的项目创建、图形化引脚和时钟配置、HAL库函数调用以及最后用STM32CubeProgrammer烧录程序。无论你是刚接触STM32的新手还是想快速验证一个显示方案跟着步骤走都能在半小时内看到屏幕上跳出“Hello World”。2. 硬件与软件环境准备动手之前得先把“家伙事儿”备齐。硬件部分的核心是主控板和显示模块。2.1 硬件清单与连接主控制器STM32 Black Pill (基于STM32F401CCU6或STM32F411CEU6)。这是一款非常流行的迷你开发板核心是ARM Cortex-M4性能足够而且自带USB接口方便调试和供电。你手头如果是其他STM32系列开发板如Blue Pill-F103 Nucleo系列原理也完全相通只是具体引脚编号需要调整。显示模块16x2 I2C LCD屏。市面上常见的1602液晶屏本身是并行接口但卖家通常会配一个蓝色的I2C转接板焊在背面。这个转接板的核心是一颗PCF8574T或兼容芯片它是一个I2C到8位GPIO的扩展器正是它把STM32的I2C命令“翻译”成LCD能懂的并行信号。购买时注意确认一下转接板的I2C地址通常默认是0x27也有可能是0x3F背面有个可调电阻用于调节屏幕对比度。连接线若干杜邦线母对母。供电与调试USB-C数据线一根用于给Black Pill供电和后续的程序烧录。连接电路时务必在断电状态下操作。I2C LCD模块一般有四根引脚GND- 连接STM32的任意GND引脚。VCC- 连接STM32的3.3V输出引脚。这里是个关键点虽然有些模块标称支持5V但STM32 Black Pill的GPIO电平是3.3V的。为了保险起见强烈建议统一使用3.3V供电避免电平不匹配导致通信失败或损坏芯片。SDA- 连接STM32的I2C数据引脚。对于Black Pill我们通常使用PB9这是一个复用的I2C1_SDA引脚。SCL- 连接STM32的I2C时钟引脚。对应地连接PB8I2C1_SCL。注意不同型号STM32的I2C引脚可能不同务必查阅你所用板子的原理图或引脚定义图。Black Pill的PB8/PB9是I2C1的默认复用功能非常方便。2.2 软件工具安装软件方面我们需要ST官方的一套“组合拳”STM32CubeIDE这是集成了STM32CubeMX配置工具和Eclipse IDE的开发环境。它允许我们通过图形化界面配置引脚、时钟、外设然后自动生成HAL库初始化代码极大提升了开发效率。从ST官网下载安装即可它跨Windows、Linux、macOS平台。STM32CubeProgrammer这是一个独立的程序烧录工具。当我们用STM32CubeIDE编译好代码后可以通过它把生成的二进制文件下载到开发板中。同样从ST官网下载。确保这两个软件都已正确安装。STM32CubeIDE内部其实也集成了烧录功能但使用STM32CubeProgrammer通过USB进行DFUDevice Firmware Upgrade模式烧录对于Black Pill这类没有板载ST-Link的板子来说是一种非常通用且可靠的方式。3. STM32CubeIDE项目创建与基础配置打开STM32CubeIDE我们开始创建项目。这个过程主要是通过点击和选择让IDE为我们搭建好代码框架。3.1 创建新项目与选择板卡点击File - New - STM32 Project。这会弹出芯片选择器。在Commercial Part Number搜索栏里输入你的芯片型号比如“STM32F401CC”或“STM32F411CE”。在搜索结果中双击正确的型号项目创建向导就启动了。我更推荐另一种方式在Board Selector标签页下直接搜索“Black Pill”。如果官方或社区有对应的板级支持包这里会显示出来它可能已经帮你预设好了一些基础配置如外部晶振。不过即使没有手动配置也丝毫不复杂。3.2 图形化引脚配置Pinout Configuration项目创建后会进入图形化配置界面。中间是芯片的引脚图我们可以在这里进行关键配置。启用I2C1外设在左侧分类中找到Connectivity点击展开找到I2C1。将它的模式Mode从Disable改为I2C。此时你会看到中间的芯片引脚图上PB8和PB9自动被高亮并标注为I2C1_SCL和I2C1_SDA。这就是图形化配置的便利之处它自动完成了引脚复用功能Alternate Function的映射。配置高速外部时钟HSE为了让系统时钟更精准我们需要使用外部晶振。Black Pill板载了一个8MHz或25MHz具体看版本的晶振。在左侧System Core下点击RCCReset and Clock Control。在右侧的High Speed Clock (HSE)选项里选择Crystal/Ceramic Resonator。这告诉芯片我们使用了外部晶振作为高速时钟源。3.3 时钟树Clock Configuration配置详解点击顶部的Clock Configuration标签页这里看起来有点复杂但配置一次就能明白。我们的目标是生成一个稳定的系统时钟SYSCLK比如对于STM32F401我们可以设定到84MHz。在时钟树图中找到HSE输入旁边通常显示你板载晶振的频率如8MHz。找到PLL Source Mux选择HSE作为锁相环PLL的时钟源。配置PLL倍频参数。以8MHz HSE为例目标84MHz SYSCLK我们需要将PLL的倍频系数N设置为84同时确保PLLM预分频根据芯片手册设置为合适的值例如对于F4系列HSE先经过PLLM分频再进入PLLN倍频。通常在图形界面直接输入目标频率84MHzCubeIDE会自动计算并填充绿色框内的参数如果参数可行框会变成绿色。一个常见配置是PLLM 8 PLLN 336 PLLP 4。这样计算HSE (8MHz) / PLLM(8) 1MHz-1MHz * PLLN(336) 336MHz-336MHz / PLLP(4) 84MHz (SYSCLK)。将System Clock Mux的来源选择为PLLCLK。检查APB1和APB2总线时钟。I2C1挂载在APB1总线下要确保APB1的时钟PCLK1不超过其最大额定值对于F401是42MHz。系统时钟84MHz经过APB1预分频器通常默认是2分频后得到42MHz这是合规的。配置完成后按CtrlS保存。此时CubeIDE会自动生成初始化代码。它会根据你的配置在main.c文件里生成SystemClock_Config()函数以及MX_I2C1_Init()函数。这些生成的代码质量很高我们一般不需要手动修改。4. I2C LCD驱动代码的编写与解析图形化配置完成后我们切换到代码视角。在项目资源管理器Project Explorer中打开Core/Src/main.c文件。我们的主要工作将集中在/* USER CODE BEGIN */和/* USER CODE END */这对注释之间这样当你在CubeIDE里重新生成代码时自己写的代码不会被覆盖。4.1 理解I2C LCD的通信协议在写代码前必须明白我们不是在直接驱动LCD而是在通过I2C命令控制那个PCF8574T转接芯片。PCF8574T有8个IO口P0-P7它被映射到LCD的引脚上。通常的接法是P0 - RS (寄存器选择)P1 - RW (读写控制通常接地只写)P2 - E (使能信号)P3 - 背光控制P4-P7 - DB4-DB7 (LCD的4位数据线)因此我们发送的每一个字节8位其每一位都对应着LCD屏的一个控制或数据引脚的电平高低。我们需要按照LCD1602的4位初始化序列和读写时序通过组合这些位构造出正确的命令字节再通过HAL库的I2C发送函数发给PCF8574T即发给LCD模块的I2C地址。4.2 编写底层驱动函数我们首先需要定义几个基础宏和函数。在main.c文件开头的/* USER CODE BEGIN PV */区域私有变量定义区定义LCD的I2C地址/* USER CODE BEGIN PV */ #define LCD_I2C_ADDR (0x27 1) // 0x27是模块默认地址左移1位是因为HAL库的7位地址需要左移 /* USER CODE END PV */注意HAL库的I2C函数期望的地址参数是7位地址左移1位后的值即8位地址。所以0x27要左移一位变成0x4E。如果你的模块是0x3F则定义为(0x3F 1)。接下来在/* USER CODE BEGIN 0 */区域函数实现区我们编写最核心的发送函数和几个辅助函数/* USER CODE BEGIN 0 */ // 向LCD发送一个字节4位模式分两次发送 void LCD_Send(uint8_t data, uint8_t mode) { uint8_t high_nibble, low_nibble; uint8_t data_enable, data_low; // 将8位数据拆分成高4位和低4位 high_nibble data 0xF0; low_nibble (data 4) 0xF0; // 组合高4位数据、模式位(RS)和使能位(E) // 假设背光控制位P3常开即0x08模式位RS由参数传入 data_enable high_nibble | mode | 0x0C; // 高4位 RS E1, Backlight1 data_low high_nibble | mode | 0x08; // 高4位 RS E0, Backlight1 // 通过I2C发送 HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_enable, 1, 100); HAL_Delay(1); // 短暂延时模拟使能脉冲 HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_low, 1, 100); // 如果是命令如清屏、移动光标需要更长延时 if(mode 0) HAL_Delay(2); // 发送低4位过程同上 data_enable low_nibble | mode | 0x0C; data_low low_nibble | mode | 0x08; HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_enable, 1, 100); HAL_Delay(1); HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_low, 1, 100); if(mode 0) HAL_Delay(2); } // 发送命令RS0 void LCD_Cmd(uint8_t cmd) { LCD_Send(cmd, 0); } // 发送数据RS1 void LCD_Data(uint8_t data) { LCD_Send(data, 1); // 第二个参数1代表RS1数据模式 } // LCD初始化序列 void LCD_Init(void) { HAL_Delay(50); // 等待LCD上电稳定 // 4位初始化序列开始 LCD_Send(0x30, 0); // 尝试设置为8位模式实际以4位操作 HAL_Delay(5); LCD_Send(0x30, 0); HAL_Delay(1); LCD_Send(0x30, 0); HAL_Delay(1); LCD_Send(0x20, 0); // 切换到4位模式 HAL_Delay(1); // 以下为标准4位模式初始化命令 LCD_Cmd(0x28); // 功能设置4位数据2行显示5x8点阵 HAL_Delay(1); LCD_Cmd(0x0C); // 显示控制开显示关光标不闪烁 HAL_Delay(1); LCD_Cmd(0x06); // 输入模式地址指针递增显示不移位 HAL_Delay(1); LCD_Cmd(0x01); // 清屏 HAL_Delay(2); // 清屏命令需要较长延时 } // 设置光标位置 void LCD_SetCursor(uint8_t row, uint8_t col) { uint8_t address; // 第一行起始地址0x80第二行起始地址0xC0 if(row 0) { address 0x80 col; } else { address 0xC0 col; } LCD_Cmd(address); } // 打印字符串 void LCD_PrintStr(char *str) { while(*str) { LCD_Data(*str); } } /* USER CODE END 0 */4.3 在主函数中调用现在我们可以在main()函数中的/* USER CODE BEGIN 2 */区域外设初始化完成后主循环开始前进行初始化和显示/* USER CODE BEGIN 2 */ LCD_Init(); // 初始化LCD HAL_Delay(100); // 额外等待初始化完全稳定 LCD_Cmd(0x01); // 清屏 HAL_Delay(2); LCD_SetCursor(0, 0); // 设置光标到第一行开头 LCD_PrintStr(Hello, STM32!); // 打印字符串 LCD_SetCursor(1, 0); // 设置光标到第二行开头 LCD_PrintStr(I2C LCD Test OK); /* USER CODE END 2 */然后在/* USER CODE BEGIN WHILE */之后的无限循环while (1)里你可以添加一些动态效果比如滚动显示、显示变量值等。5. 代码编译、烧录与调试代码写好后接下来就是把它放到板子上运行。5.1 项目编译在STM32CubeIDE中点击工具栏上的“锤子”图标Build或者按CtrlB进行编译。下方的“Console”控制台会输出编译信息。如果一切顺利最后会看到Build Finished并且没有错误Errors为0。警告Warnings可能会有一些只要不是关于未使用变量的一般可以暂时忽略。5.2 连接板卡进入DFU模式STM32 Black Pill没有板载ST-Link我们需要通过USB口利用其内置的DFU引导程序来烧录。操作步骤如下确保开发板没有通过USB连接电脑。找到板子上的“BOOT0”跳线帽或按钮。对于Black Pill通常有一个标着“BOOT0”的按钮或者一对焊盘需要短接。先按住“BOOT0”按钮不放然后再将USB线连接到电脑。此时板子上的电源灯会亮但用户程序不会运行。在电脑的设备管理器中你会看到一个新的设备可能叫“STM32 BOOTLOADER”或者出现在“通用串行总线设备”下。这表明板子已进入DFU模式。此时可以松开“BOOT0”按钮。5.3 使用STM32CubeProgrammer烧录打开STM32CubeProgrammer软件。在连接方式Connectivity中选择USB。端口Port应该会自动识别出来。点击右上角的“Connect”按钮。如果连接成功下方日志区域会显示设备信息和连接成功的信息。点击“Open file”按钮导航到你的STM32CubeIDE项目文件夹。路径通常是项目目录/Debug/如果你用的是Debug配置编译。选择扩展名为.elf的文件例如project_name.elf。.elf文件包含调试信息.bin或.hex是纯二进制文件这里用.elf即可。在左侧菜单栏点击“Erasing and Programming”。在“File path”栏确认是你刚选择的.elf文件。确保“Start automatic mode”选项被勾选。这个选项会在编程完成后自动复位并运行程序非常方便。点击“Start Programming”按钮。进度条会开始走动烧录过程很快几秒钟即可完成。烧录成功后日志会显示“Programming Complete”。此时你可以点击“Disconnect”然后直接拔掉USB线。5.4 上电运行与验证将板子彻底断电拔掉USB线。然后正常地将USB线插入板子这次不要按BOOT0按钮。板子将运行刚刚烧录的程序。你应该能看到LCD屏幕亮起并显示“Hello, STM32!”和“I2C LCD Test OK”两行字。如果屏幕没有显示或者显示乱码首先检查背光是否亮起调节蓝色转接板上的电位器。如果背光亮但无字符很可能是I2C通信问题或初始化时序不对。6. 常见问题排查与实战技巧在实际操作中你可能会遇到一些问题。这里我总结几个最常见的坑和解决办法。6.1 屏幕无任何显示背光也不亮检查供电用万用表测量LCD模块VCC和GND之间的电压确认是3.3V。如果电压为0或极低检查杜邦线连接是否牢固STM32的3.3V引脚是否正常输出。检查I2C地址这是最常见的问题。你的模块I2C地址可能不是0x27。有一个简单的Arduino扫描程序可以帮你找出地址但用STM32也可以。你可以写一个简单的I2C扫描函数在初始化后轮询可能的地址0x20到0x27以及0x38到0x3F等看哪个地址有ACK响应。修改LCD_I2C_ADDR宏定义即可。检查接线再三确认SDA和SCL是否接反。确认连接到了正确的I2C外设引脚我们用的是I2C1。6.2 屏幕有背光但显示乱码或方块调整对比度立即调节蓝色转接板上的那个蓝色可调电阻电位器。这是调节LCD驱动电压Vo的直接影响显示清晰度。慢慢旋转直到字符清晰出现。检查初始化时序和延时LCD1602对初始化时序有严格要求特别是上电后的等待时间和命令之间的延时。我代码中的HAL_Delay()值是比较保守的如果屏幕质量好可以适当减小但如果出现乱码尝试增大这些延时特别是LCD_Init()函数开头和清屏命令后的延时。检查4位/8位模式确保你的初始化序列严格按照4位模式进行。我提供的序列是经过验证的。乱码很可能是最初切换到4位模式的命令0x20发送时机或次数不对。6.3 I2C通信失败HAL函数返回错误上拉电阻I2C总线需要上拉电阻通常4.7kΩ到10kΩ才能稳定工作。幸运的是STM32的I2C引脚可以配置为内部上拉或下拉。在CubeMX配置I2C1时除了设置模式为I2C还应检查这两个GPIO的设置。在Pinout Configuration界面点击具体的引脚PB8或PB9在右侧的GPIO Settings中将GPIO Pull-up/Pull-down设置为Pull-up。这能有效改善通信稳定性。时钟速度在CubeMX的I2C参数设置里有一个时钟速度Clock Speed的配置。对于这种低速外设建议先设置为100kHz标准模式。如果通信不稳定可以尝试降到50kHz。过快的速度可能导致通信失败。逻辑分析仪抓包如果条件允许用逻辑分析仪连接SDA和SCL线可以直观地看到I2C通信的波形、地址、数据和ACK信号是排查硬件和时序问题的终极利器。6.4 关于延时函数的注意事项代码中大量使用了HAL_Delay()它依赖于SysTick定时器。请确保你的系统时钟SYSCLK配置正确并且HAL_Init()被正常调用CubeIDE生成的代码会自动处理。HAL_Delay()的单位是毫秒。如果发现延时严重不准请回头检查时钟树配置。6.5 提升代码健壮性在实际项目中直接使用HAL_I2C_Master_Transmit而不检查返回值是有风险的。更好的做法是HAL_StatusTypeDef status; status HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data, 1, 100); if (status ! HAL_OK) { // 处理错误比如重试几次或者设置错误标志位 Error_Handler(); }加入错误处理能让你的程序在异常情况下如线被碰掉有更明确的行为而不是完全死掉。最后当你成功点亮屏幕后可以尝试更丰富的功能比如显示自定义字符需要向CGRAM写入字模、让内容滚动、或者结合传感器数据显示实时数值。这个I2C LCD驱动框架是一个很好的起点理解了底层字节的拼接与发送原理你就能驾驭任何基于类似转接芯片的显示模块了。
STM32 HAL库驱动I2C LCD屏：从零实现1602液晶显示
1. 项目概述用STM32 HAL库点亮你的I2C LCD如果你手头有一块STM32开发板比如性价比很高的STM32 Black Pill又恰好想用它来驱动一个带I2C接口的LCD屏显示点自定义信息那么这个教程就是为你准备的。我最近在做一个需要本地显示状态的小项目正好用上了这套组合。网上资料虽然多但很多要么是标准库的老教程要么步骤跳跃太大对新手不友好。今天我就把从零开始在STM32CubeIDE里用HAL库驱动一块16x2 I2C LCD的完整过程包括那些容易踩坑的细节从头到尾捋一遍。简单来说我们要做的是让STM32通过I2C总线跟一块集成了PCF8574或类似I2C转接芯片的LCD屏“对话”。I2C的好处显而易见只需要两根线SDA数据线和SCL时钟线就能搞定通信比起传统的8位或4位并行接口大大节省了宝贵的GPIO引脚布线也清爽很多。STM32的HAL库把底层硬件操作封装成了一个个清晰的函数我们不用去深究寄存器怎么配置焦点可以放在应用逻辑上。整个过程会涉及STM32CubeIDE的项目创建、图形化引脚和时钟配置、HAL库函数调用以及最后用STM32CubeProgrammer烧录程序。无论你是刚接触STM32的新手还是想快速验证一个显示方案跟着步骤走都能在半小时内看到屏幕上跳出“Hello World”。2. 硬件与软件环境准备动手之前得先把“家伙事儿”备齐。硬件部分的核心是主控板和显示模块。2.1 硬件清单与连接主控制器STM32 Black Pill (基于STM32F401CCU6或STM32F411CEU6)。这是一款非常流行的迷你开发板核心是ARM Cortex-M4性能足够而且自带USB接口方便调试和供电。你手头如果是其他STM32系列开发板如Blue Pill-F103 Nucleo系列原理也完全相通只是具体引脚编号需要调整。显示模块16x2 I2C LCD屏。市面上常见的1602液晶屏本身是并行接口但卖家通常会配一个蓝色的I2C转接板焊在背面。这个转接板的核心是一颗PCF8574T或兼容芯片它是一个I2C到8位GPIO的扩展器正是它把STM32的I2C命令“翻译”成LCD能懂的并行信号。购买时注意确认一下转接板的I2C地址通常默认是0x27也有可能是0x3F背面有个可调电阻用于调节屏幕对比度。连接线若干杜邦线母对母。供电与调试USB-C数据线一根用于给Black Pill供电和后续的程序烧录。连接电路时务必在断电状态下操作。I2C LCD模块一般有四根引脚GND- 连接STM32的任意GND引脚。VCC- 连接STM32的3.3V输出引脚。这里是个关键点虽然有些模块标称支持5V但STM32 Black Pill的GPIO电平是3.3V的。为了保险起见强烈建议统一使用3.3V供电避免电平不匹配导致通信失败或损坏芯片。SDA- 连接STM32的I2C数据引脚。对于Black Pill我们通常使用PB9这是一个复用的I2C1_SDA引脚。SCL- 连接STM32的I2C时钟引脚。对应地连接PB8I2C1_SCL。注意不同型号STM32的I2C引脚可能不同务必查阅你所用板子的原理图或引脚定义图。Black Pill的PB8/PB9是I2C1的默认复用功能非常方便。2.2 软件工具安装软件方面我们需要ST官方的一套“组合拳”STM32CubeIDE这是集成了STM32CubeMX配置工具和Eclipse IDE的开发环境。它允许我们通过图形化界面配置引脚、时钟、外设然后自动生成HAL库初始化代码极大提升了开发效率。从ST官网下载安装即可它跨Windows、Linux、macOS平台。STM32CubeProgrammer这是一个独立的程序烧录工具。当我们用STM32CubeIDE编译好代码后可以通过它把生成的二进制文件下载到开发板中。同样从ST官网下载。确保这两个软件都已正确安装。STM32CubeIDE内部其实也集成了烧录功能但使用STM32CubeProgrammer通过USB进行DFUDevice Firmware Upgrade模式烧录对于Black Pill这类没有板载ST-Link的板子来说是一种非常通用且可靠的方式。3. STM32CubeIDE项目创建与基础配置打开STM32CubeIDE我们开始创建项目。这个过程主要是通过点击和选择让IDE为我们搭建好代码框架。3.1 创建新项目与选择板卡点击File - New - STM32 Project。这会弹出芯片选择器。在Commercial Part Number搜索栏里输入你的芯片型号比如“STM32F401CC”或“STM32F411CE”。在搜索结果中双击正确的型号项目创建向导就启动了。我更推荐另一种方式在Board Selector标签页下直接搜索“Black Pill”。如果官方或社区有对应的板级支持包这里会显示出来它可能已经帮你预设好了一些基础配置如外部晶振。不过即使没有手动配置也丝毫不复杂。3.2 图形化引脚配置Pinout Configuration项目创建后会进入图形化配置界面。中间是芯片的引脚图我们可以在这里进行关键配置。启用I2C1外设在左侧分类中找到Connectivity点击展开找到I2C1。将它的模式Mode从Disable改为I2C。此时你会看到中间的芯片引脚图上PB8和PB9自动被高亮并标注为I2C1_SCL和I2C1_SDA。这就是图形化配置的便利之处它自动完成了引脚复用功能Alternate Function的映射。配置高速外部时钟HSE为了让系统时钟更精准我们需要使用外部晶振。Black Pill板载了一个8MHz或25MHz具体看版本的晶振。在左侧System Core下点击RCCReset and Clock Control。在右侧的High Speed Clock (HSE)选项里选择Crystal/Ceramic Resonator。这告诉芯片我们使用了外部晶振作为高速时钟源。3.3 时钟树Clock Configuration配置详解点击顶部的Clock Configuration标签页这里看起来有点复杂但配置一次就能明白。我们的目标是生成一个稳定的系统时钟SYSCLK比如对于STM32F401我们可以设定到84MHz。在时钟树图中找到HSE输入旁边通常显示你板载晶振的频率如8MHz。找到PLL Source Mux选择HSE作为锁相环PLL的时钟源。配置PLL倍频参数。以8MHz HSE为例目标84MHz SYSCLK我们需要将PLL的倍频系数N设置为84同时确保PLLM预分频根据芯片手册设置为合适的值例如对于F4系列HSE先经过PLLM分频再进入PLLN倍频。通常在图形界面直接输入目标频率84MHzCubeIDE会自动计算并填充绿色框内的参数如果参数可行框会变成绿色。一个常见配置是PLLM 8 PLLN 336 PLLP 4。这样计算HSE (8MHz) / PLLM(8) 1MHz-1MHz * PLLN(336) 336MHz-336MHz / PLLP(4) 84MHz (SYSCLK)。将System Clock Mux的来源选择为PLLCLK。检查APB1和APB2总线时钟。I2C1挂载在APB1总线下要确保APB1的时钟PCLK1不超过其最大额定值对于F401是42MHz。系统时钟84MHz经过APB1预分频器通常默认是2分频后得到42MHz这是合规的。配置完成后按CtrlS保存。此时CubeIDE会自动生成初始化代码。它会根据你的配置在main.c文件里生成SystemClock_Config()函数以及MX_I2C1_Init()函数。这些生成的代码质量很高我们一般不需要手动修改。4. I2C LCD驱动代码的编写与解析图形化配置完成后我们切换到代码视角。在项目资源管理器Project Explorer中打开Core/Src/main.c文件。我们的主要工作将集中在/* USER CODE BEGIN */和/* USER CODE END */这对注释之间这样当你在CubeIDE里重新生成代码时自己写的代码不会被覆盖。4.1 理解I2C LCD的通信协议在写代码前必须明白我们不是在直接驱动LCD而是在通过I2C命令控制那个PCF8574T转接芯片。PCF8574T有8个IO口P0-P7它被映射到LCD的引脚上。通常的接法是P0 - RS (寄存器选择)P1 - RW (读写控制通常接地只写)P2 - E (使能信号)P3 - 背光控制P4-P7 - DB4-DB7 (LCD的4位数据线)因此我们发送的每一个字节8位其每一位都对应着LCD屏的一个控制或数据引脚的电平高低。我们需要按照LCD1602的4位初始化序列和读写时序通过组合这些位构造出正确的命令字节再通过HAL库的I2C发送函数发给PCF8574T即发给LCD模块的I2C地址。4.2 编写底层驱动函数我们首先需要定义几个基础宏和函数。在main.c文件开头的/* USER CODE BEGIN PV */区域私有变量定义区定义LCD的I2C地址/* USER CODE BEGIN PV */ #define LCD_I2C_ADDR (0x27 1) // 0x27是模块默认地址左移1位是因为HAL库的7位地址需要左移 /* USER CODE END PV */注意HAL库的I2C函数期望的地址参数是7位地址左移1位后的值即8位地址。所以0x27要左移一位变成0x4E。如果你的模块是0x3F则定义为(0x3F 1)。接下来在/* USER CODE BEGIN 0 */区域函数实现区我们编写最核心的发送函数和几个辅助函数/* USER CODE BEGIN 0 */ // 向LCD发送一个字节4位模式分两次发送 void LCD_Send(uint8_t data, uint8_t mode) { uint8_t high_nibble, low_nibble; uint8_t data_enable, data_low; // 将8位数据拆分成高4位和低4位 high_nibble data 0xF0; low_nibble (data 4) 0xF0; // 组合高4位数据、模式位(RS)和使能位(E) // 假设背光控制位P3常开即0x08模式位RS由参数传入 data_enable high_nibble | mode | 0x0C; // 高4位 RS E1, Backlight1 data_low high_nibble | mode | 0x08; // 高4位 RS E0, Backlight1 // 通过I2C发送 HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_enable, 1, 100); HAL_Delay(1); // 短暂延时模拟使能脉冲 HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_low, 1, 100); // 如果是命令如清屏、移动光标需要更长延时 if(mode 0) HAL_Delay(2); // 发送低4位过程同上 data_enable low_nibble | mode | 0x0C; data_low low_nibble | mode | 0x08; HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_enable, 1, 100); HAL_Delay(1); HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data_low, 1, 100); if(mode 0) HAL_Delay(2); } // 发送命令RS0 void LCD_Cmd(uint8_t cmd) { LCD_Send(cmd, 0); } // 发送数据RS1 void LCD_Data(uint8_t data) { LCD_Send(data, 1); // 第二个参数1代表RS1数据模式 } // LCD初始化序列 void LCD_Init(void) { HAL_Delay(50); // 等待LCD上电稳定 // 4位初始化序列开始 LCD_Send(0x30, 0); // 尝试设置为8位模式实际以4位操作 HAL_Delay(5); LCD_Send(0x30, 0); HAL_Delay(1); LCD_Send(0x30, 0); HAL_Delay(1); LCD_Send(0x20, 0); // 切换到4位模式 HAL_Delay(1); // 以下为标准4位模式初始化命令 LCD_Cmd(0x28); // 功能设置4位数据2行显示5x8点阵 HAL_Delay(1); LCD_Cmd(0x0C); // 显示控制开显示关光标不闪烁 HAL_Delay(1); LCD_Cmd(0x06); // 输入模式地址指针递增显示不移位 HAL_Delay(1); LCD_Cmd(0x01); // 清屏 HAL_Delay(2); // 清屏命令需要较长延时 } // 设置光标位置 void LCD_SetCursor(uint8_t row, uint8_t col) { uint8_t address; // 第一行起始地址0x80第二行起始地址0xC0 if(row 0) { address 0x80 col; } else { address 0xC0 col; } LCD_Cmd(address); } // 打印字符串 void LCD_PrintStr(char *str) { while(*str) { LCD_Data(*str); } } /* USER CODE END 0 */4.3 在主函数中调用现在我们可以在main()函数中的/* USER CODE BEGIN 2 */区域外设初始化完成后主循环开始前进行初始化和显示/* USER CODE BEGIN 2 */ LCD_Init(); // 初始化LCD HAL_Delay(100); // 额外等待初始化完全稳定 LCD_Cmd(0x01); // 清屏 HAL_Delay(2); LCD_SetCursor(0, 0); // 设置光标到第一行开头 LCD_PrintStr(Hello, STM32!); // 打印字符串 LCD_SetCursor(1, 0); // 设置光标到第二行开头 LCD_PrintStr(I2C LCD Test OK); /* USER CODE END 2 */然后在/* USER CODE BEGIN WHILE */之后的无限循环while (1)里你可以添加一些动态效果比如滚动显示、显示变量值等。5. 代码编译、烧录与调试代码写好后接下来就是把它放到板子上运行。5.1 项目编译在STM32CubeIDE中点击工具栏上的“锤子”图标Build或者按CtrlB进行编译。下方的“Console”控制台会输出编译信息。如果一切顺利最后会看到Build Finished并且没有错误Errors为0。警告Warnings可能会有一些只要不是关于未使用变量的一般可以暂时忽略。5.2 连接板卡进入DFU模式STM32 Black Pill没有板载ST-Link我们需要通过USB口利用其内置的DFU引导程序来烧录。操作步骤如下确保开发板没有通过USB连接电脑。找到板子上的“BOOT0”跳线帽或按钮。对于Black Pill通常有一个标着“BOOT0”的按钮或者一对焊盘需要短接。先按住“BOOT0”按钮不放然后再将USB线连接到电脑。此时板子上的电源灯会亮但用户程序不会运行。在电脑的设备管理器中你会看到一个新的设备可能叫“STM32 BOOTLOADER”或者出现在“通用串行总线设备”下。这表明板子已进入DFU模式。此时可以松开“BOOT0”按钮。5.3 使用STM32CubeProgrammer烧录打开STM32CubeProgrammer软件。在连接方式Connectivity中选择USB。端口Port应该会自动识别出来。点击右上角的“Connect”按钮。如果连接成功下方日志区域会显示设备信息和连接成功的信息。点击“Open file”按钮导航到你的STM32CubeIDE项目文件夹。路径通常是项目目录/Debug/如果你用的是Debug配置编译。选择扩展名为.elf的文件例如project_name.elf。.elf文件包含调试信息.bin或.hex是纯二进制文件这里用.elf即可。在左侧菜单栏点击“Erasing and Programming”。在“File path”栏确认是你刚选择的.elf文件。确保“Start automatic mode”选项被勾选。这个选项会在编程完成后自动复位并运行程序非常方便。点击“Start Programming”按钮。进度条会开始走动烧录过程很快几秒钟即可完成。烧录成功后日志会显示“Programming Complete”。此时你可以点击“Disconnect”然后直接拔掉USB线。5.4 上电运行与验证将板子彻底断电拔掉USB线。然后正常地将USB线插入板子这次不要按BOOT0按钮。板子将运行刚刚烧录的程序。你应该能看到LCD屏幕亮起并显示“Hello, STM32!”和“I2C LCD Test OK”两行字。如果屏幕没有显示或者显示乱码首先检查背光是否亮起调节蓝色转接板上的电位器。如果背光亮但无字符很可能是I2C通信问题或初始化时序不对。6. 常见问题排查与实战技巧在实际操作中你可能会遇到一些问题。这里我总结几个最常见的坑和解决办法。6.1 屏幕无任何显示背光也不亮检查供电用万用表测量LCD模块VCC和GND之间的电压确认是3.3V。如果电压为0或极低检查杜邦线连接是否牢固STM32的3.3V引脚是否正常输出。检查I2C地址这是最常见的问题。你的模块I2C地址可能不是0x27。有一个简单的Arduino扫描程序可以帮你找出地址但用STM32也可以。你可以写一个简单的I2C扫描函数在初始化后轮询可能的地址0x20到0x27以及0x38到0x3F等看哪个地址有ACK响应。修改LCD_I2C_ADDR宏定义即可。检查接线再三确认SDA和SCL是否接反。确认连接到了正确的I2C外设引脚我们用的是I2C1。6.2 屏幕有背光但显示乱码或方块调整对比度立即调节蓝色转接板上的那个蓝色可调电阻电位器。这是调节LCD驱动电压Vo的直接影响显示清晰度。慢慢旋转直到字符清晰出现。检查初始化时序和延时LCD1602对初始化时序有严格要求特别是上电后的等待时间和命令之间的延时。我代码中的HAL_Delay()值是比较保守的如果屏幕质量好可以适当减小但如果出现乱码尝试增大这些延时特别是LCD_Init()函数开头和清屏命令后的延时。检查4位/8位模式确保你的初始化序列严格按照4位模式进行。我提供的序列是经过验证的。乱码很可能是最初切换到4位模式的命令0x20发送时机或次数不对。6.3 I2C通信失败HAL函数返回错误上拉电阻I2C总线需要上拉电阻通常4.7kΩ到10kΩ才能稳定工作。幸运的是STM32的I2C引脚可以配置为内部上拉或下拉。在CubeMX配置I2C1时除了设置模式为I2C还应检查这两个GPIO的设置。在Pinout Configuration界面点击具体的引脚PB8或PB9在右侧的GPIO Settings中将GPIO Pull-up/Pull-down设置为Pull-up。这能有效改善通信稳定性。时钟速度在CubeMX的I2C参数设置里有一个时钟速度Clock Speed的配置。对于这种低速外设建议先设置为100kHz标准模式。如果通信不稳定可以尝试降到50kHz。过快的速度可能导致通信失败。逻辑分析仪抓包如果条件允许用逻辑分析仪连接SDA和SCL线可以直观地看到I2C通信的波形、地址、数据和ACK信号是排查硬件和时序问题的终极利器。6.4 关于延时函数的注意事项代码中大量使用了HAL_Delay()它依赖于SysTick定时器。请确保你的系统时钟SYSCLK配置正确并且HAL_Init()被正常调用CubeIDE生成的代码会自动处理。HAL_Delay()的单位是毫秒。如果发现延时严重不准请回头检查时钟树配置。6.5 提升代码健壮性在实际项目中直接使用HAL_I2C_Master_Transmit而不检查返回值是有风险的。更好的做法是HAL_StatusTypeDef status; status HAL_I2C_Master_Transmit(hi2c1, LCD_I2C_ADDR, data, 1, 100); if (status ! HAL_OK) { // 处理错误比如重试几次或者设置错误标志位 Error_Handler(); }加入错误处理能让你的程序在异常情况下如线被碰掉有更明确的行为而不是完全死掉。最后当你成功点亮屏幕后可以尝试更丰富的功能比如显示自定义字符需要向CGRAM写入字模、让内容滚动、或者结合传感器数据显示实时数值。这个I2C LCD驱动框架是一个很好的起点理解了底层字节的拼接与发送原理你就能驾驭任何基于类似转接芯片的显示模块了。
