hal库LCD1602代码

### 使用HAL库驱动LCD1602显示屏的代码示例

为了实现STM32通过HAL库控制LCD1602显示字符，可以按照以下方式编写初始化和显示函数。此方法利用I2C接口连接到LCD1602模块。

#### 初始化配置
首先，在`main.c`文件顶部包含必要的头文件并定义全局变量：

#include "stm32f1xx_hal.h"
#include "lcd1602_i2c.h"

// 定义 I2C 接口句柄
extern I2C_HandleTypeDef hi2c1;

接着设置I2C通信参数以及调用LCD1602初始化函数：

void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_I2C1_Init(void);

int main(void){
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_I2C1_Init();

    // 初始化 LCD1602 显示屏
    LCD1602_Init(&hi2c1); 

    while (1){
        // 主循环体保持为空即可
    }
}

#### 编写LCD1602操作函数
创建一个新的源文件`lcd1602_i2c.c`用于封装具体的操作逻辑，并在对应的头文件中声明这些功能。以下是部分核心代码片段：

#define SLAVE_ADDRESS_LCD 0x27 << 1     /* 设备地址 */

/* 发送命令给LCD */
void LCD_WriteCommand(I2C_HandleTypeDef *hi2c, uint8_t cmd){
    uint8_t data[2];
    data[0] = 0x00;                    /* RS=0 表明这是指令而非数据 */
    data[1] = cmd;

    HAL_I2C_Master_Transmit(hi2c, SLAVE_ADDRESS_LCD, data, 2, HAL_MAX_DELAY);
}

/* 向LCD发送单个字符 */
void LCD_WriteData(I2C_HandleTypeDef *hi2c, char dat){
    uint8_t data[2];
    data[0] = 0x40;                   /* RS=1 表明这是要显示的数据 */
    data[1] = dat;

    HAL_I2C_Master_Transmit(hi2c, SLAVE_ADDRESS_LCD, data, 2, HAL_MAX_DELAY);
}

/* 设置光标的行列位置 */
void LCD_SetCursor(I2C_HandleTypeDef *hi2c,uint8_t row,uint8_t col){
    switch(row){
      case 0:
          LCD_WriteCommand(hi2c,0x80 + col);
          break;
      case 1:
          LCD_WriteCommand(hi2c,0xC0 + col);
          break;
    }
}

/* 打印字符串至指定坐标处 */
void LCD_PrintString(I2C_HandleTypeDef *hi2c,uint8_t row,uint8_t col,char* str){
    int i=0;
    
    LCD_SetCursor(hi2c,row,col);
    while(str[i]!='\0'){
       LCD_WriteData(hi2c,str[i++]);
    }
}

最后可以在主程序里调用上述API来完成特定的任务，比如打印消息[^1]:

int main(void){
    ...
    LCD_PrintString(&hi2c1, 0, 0, "Hello");
    LCD_PrintString(&hi2c1, 1, 0, "STM32");

    while (1){}
}