用STM32 HAL库给1.54寸屏（ST7789V）做个小项目：手把手打造一个温湿度曲线显示仪

STM32 HAL库实战打造高精度温湿度曲线显示仪在嵌入式开发领域能够将传感器数据直观可视化是一个极具实用价值的技能。今天我们将使用STM32 HAL库和1.54寸ST7789V驱动屏幕从零开始构建一个功能完整的温湿度曲线显示仪。这个项目不仅涵盖了SPI通信、I2C接口使用、定时器配置等核心嵌入式技术还会教你如何设计简洁高效的GUI界面。1. 硬件准备与工程配置1.1 硬件选型与连接我们需要以下核心硬件组件主控芯片STM32F030C6T8性价比高资源充足显示屏1.54寸TFT LCD240×240分辨率ST7789V驱动传感器SHT30温湿度传感器I2C接口高精度其他USB转TTL模块用于调试输出硬件连接方式如下表所示模块STM32引脚连接方式TFT LCDSPI1全双工模式SHT30I2C1标准模式调试串口USART1异步通信1.2 STM32CubeMX工程配置在CubeMX中我们需要进行以下关键配置// 时钟树配置 System Clock: 48MHz APB1 Prescaler: 1 APB2 Prescaler: 1 // SPI1配置 Mode: Full-Duplex Master Prescaler: DIV8 (6MHz SPI时钟) Data Size: 8-bit First Bit: MSB First CPOL: Low CPHA: 1 Edge // I2C1配置 Mode: I2C Speed: Standard Mode (100kHz)重要提示务必启用SPI和I2C的中断并为SPI配置DMA通道以提高传输效率。虽然ST7789V驱动对速度要求不高但DMA可以显著降低CPU负载。1.3 基础外设初始化完成CubeMX配置后生成代码并添加以下初始化函数void SystemClock_Config(void) { // CubeMX自动生成的时钟配置 // 确保系统时钟正确设置为48MHz } void MX_GPIO_Init(void) { // 屏幕控制引脚初始化 __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitTypeDef GPIO_InitStruct {0}; // LCD_RST, LCD_DC, LCD_CS引脚配置 GPIO_InitStruct.Pin LCD_RST_Pin|LCD_DC_Pin|LCD_CS_Pin; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOA, GPIO_InitStruct); // 背光控制 GPIO_InitStruct.Pin LCD_LEDA_Pin; HAL_GPIO_Init(LCD_LEDA_GPIO_Port, GPIO_InitStruct); }2. ST7789V屏幕驱动开发2.1 底层通信接口实现ST7789V控制器支持SPI接口通信我们需要实现基本的读写函数void LCD_Writ_Bus(uint8_t data) { CS_L; // 片选使能 HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); CS_H; // 片选禁用 } void LCD_WR_CMD(uint8_t cmd) { DC_L; // 命令模式 LCD_Writ_Bus(cmd); DC_H; // 数据模式 } void LCD_WR_DATA8(uint8_t data) { LCD_Writ_Bus(data); } void LCD_WR_DATA16(uint16_t data) { LCD_WR_DATA8(data 8); LCD_WR_DATA8(data 0xFF); }2.2 屏幕初始化序列ST7789V需要特定的初始化序列才能正常工作void LCD_Init(void) { // 硬件复位 RST_L; HAL_Delay(100); RST_H; HAL_Delay(100); // 背光开启 LEDA_H; HAL_Delay(100); // 发送初始化命令序列 LCD_WR_CMD(0x11); // Sleep out HAL_Delay(120); LCD_WR_CMD(0x36); // Memory Data Access Control LCD_WR_DATA8(0x00); // RGB顺序正常扫描方向 LCD_WR_CMD(0x3A); // Interface Pixel Format LCD_WR_DATA8(0x05); // 16-bit/pixel // 更多初始化命令... // 省略部分配置命令 LCD_WR_CMD(0x29); // Display on }2.3 高级绘图功能实现为了绘制温湿度曲线我们需要实现一些基础绘图函数// 设置显示区域 void LCD_Address_Set(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WR_CMD(0x2A); // 列地址设置 LCD_WR_DATA16(x1); LCD_WR_DATA16(x2); LCD_WR_CMD(0x2B); // 行地址设置 LCD_WR_DATA16(y1); LCD_WR_DATA16(y2); LCD_WR_CMD(0x2C); // 存储器写 } // 清屏函数 void LCD_Clear(uint16_t Color) { uint16_t i, j; LCD_Address_Set(0, 0, LCD_W-1, LCD_H-1); for(i 0; i LCD_W; i) { for(j 0; j LCD_H; j) { LCD_WR_DATA16(Color); } } } // 画线算法Bresenham算法 void LCD_DrawLine(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color) { int dx abs(x2 - x1), sx x1 x2 ? 1 : -1; int dy -abs(y2 - y1), sy y1 y2 ? 1 : -1; int err dx dy, e2; while(1) { LCD_DrawPoint(x1, y1, color); if(x1 x2 y1 y2) break; e2 2 * err; if(e2 dy) { err dy; x1 sx; } if(e2 dx) { err dx; y1 sy; } } }3. SHT30温湿度传感器驱动3.1 I2C通信基础SHT30通过I2C接口通信标准地址为0x447位地址。我们需要实现基本的I2C读写函数#define SHT30_ADDR 0x44 1 HAL_StatusTypeDef SHT30_WriteCmd(uint16_t cmd) { uint8_t data[2] {cmd 8, cmd 0xFF}; return HAL_I2C_Master_Transmit(hi2c1, SHT30_ADDR, data, 2, HAL_MAX_DELAY); } HAL_StatusTypeDef SHT30_ReadData(uint8_t *data, uint16_t len) { return HAL_I2C_Master_Receive(hi2c1, SHT30_ADDR, data, len, HAL_MAX_DELAY); }3.2 数据采集与处理SHT30提供高精度模式和中精度模式两种测量选项typedef struct { float temperature; float humidity; } SHT30_Data; HAL_StatusTypeDef SHT30_ReadTempHumidity(SHT30_Data *result) { uint8_t data[6]; // 发送高精度测量命令 if(SHT30_WriteCmd(0x2400) ! HAL_OK) return HAL_ERROR; // 等待测量完成 HAL_Delay(20); // 读取6字节数据 if(SHT30_ReadData(data, 6) ! HAL_OK) return HAL_ERROR; // 数据转换 uint16_t tempRaw (data[0] 8) | data[1]; uint16_t humiRaw (data[3] 8) | data[4]; // 转换为实际值 result-temperature -45 175 * (float)tempRaw / 65535.0f; result-humidity 100 * (float)humiRaw / 65535.0f; return HAL_OK; }数据校验SHT30每个数据包都带有CRC校验码实际应用中应该实现校验功能uint8_t SHT30_CheckCRC(uint8_t data[], uint8_t len) { uint8_t crc 0xFF; for(uint8_t i 0; i len; i) { crc ^ data[i]; for(uint8_t bit 0; bit 8; bit) { if(crc 0x80) crc (crc 1) ^ 0x31; else crc 1; } } return crc; }4. 温湿度曲线显示系统设计4.1 数据结构与缓冲区管理为了实现流畅的曲线显示我们需要合理设计数据存储结构#define HISTORY_SIZE 240 // 对应屏幕宽度 typedef struct { float tempHistory[HISTORY_SIZE]; float humiHistory[HISTORY_SIZE]; uint16_t index; uint16_t count; } EnvData; void EnvData_Init(EnvData *data) { memset(data, 0, sizeof(EnvData)); >void DrawCurve(EnvData *data, uint16_t color, uint16_t bgColor, uint16_t yOffset, float scale) { static uint16_t lastX 0, lastY 0; static uint8_t firstPoint 1; // 清空曲线区域 LCD_Fill(0, yOffset, 240, yOffset 100, bgColor); // 绘制坐标轴 LCD_DrawLine(0, yOffset 50, 240, yOffset 50, GRAY); // 绘制曲线 uint16_t startIdx (data-index ->#define SAMPLE_INTERVAL_MS 1000 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { static uint32_t lastSampleTime 0; uint32_t currentTime HAL_GetTick(); if(currentTime - lastSampleTime SAMPLE_INTERVAL_MS) { SHT30_Data sensorData; if(SHT30_ReadTempHumidity(sensorData) HAL_OK) { // 更新数据缓冲区 EnvData_AddSample(envData, sensorData.temperature, sensorData.humidity); // 更新显示 DrawCurve(envData, RED, BLACK, 60, 2.0f); // 温度曲线 DrawCurve(envData, BLUE, BLACK, 160, 2.0f); // 湿度曲线 // 显示当前值 char str[20]; sprintf(str, Temp:%.1fC, sensorData.temperature); LCD_ShowString(10, 10, str, WHITE, BLACK, 16, 0); sprintf(str, Humi:%.1f%%, sensorData.humidity); LCD_ShowString(10, 30, str, WHITE, BLACK, 16, 0); } lastSampleTime currentTime; } }5. 高级GUI功能实现5.1 电池电量指示器为增加实用性我们可以添加一个电池电量指示器void DrawBattery(uint16_t x, uint16_t y, uint8_t level, uint16_t color) { // 电池主体 LCD_DrawRectangle(x, y, x 20, y 10, color); // 电池正极 LCD_DrawRectangle(x 20, y 3, x 22, y 7, color); // 电量指示 if(level 0) LCD_Fill(x 2, y 2, x 6, y 8, color); if(level 1) LCD_Fill(x 7, y 2, x 11, y 8, color); if(level 2) LCD_Fill(x 12, y 2, x 16, y 8, color); }5.2 多页面界面设计实现简单的多页面切换功能typedef enum { SCREEN_MAIN, SCREEN_SETTINGS, SCREEN_HISTORY } ScreenType; void DrawMainScreen(void) { LCD_Clear(BLACK); // 绘制标题 LCD_ShowString(80, 5, Env Monitor, WHITE, BLACK, 16, 0); // 绘制分隔线 LCD_DrawLine(0, 25, 240, 25, WHITE); // 绘制电池 DrawBattery(220, 5, 3, GREEN); } void DrawSettingsScreen(void) { LCD_Clear(BLACK); LCD_ShowString(80, 5, Settings, WHITE, BLACK, 16, 0); LCD_DrawLine(0, 25, 240, 25, WHITE); // 设置选项 LCD_ShowString(20, 40, 1. Sample Interval, WHITE, BLACK, 16, 0); LCD_ShowString(20, 70, 2. Curve Scale, WHITE, BLACK, 16, 0); LCD_ShowString(20, 100, 3. Backlight, WHITE, BLACK, 16, 0); } void SwitchScreen(ScreenType screen) { currentScreen screen; switch(screen) { case SCREEN_MAIN: DrawMainScreen(); break; case SCREEN_SETTINGS: DrawSettingsScreen(); break; default: DrawMainScreen(); } }5.3 用户交互实现通过按钮实现简单的用户交互void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin BUTTON_Pin) { static uint32_t lastPressTime 0; uint32_t currentTime HAL_GetTick(); // 消抖处理 if(currentTime - lastPressTime 200) { if(currentScreen SCREEN_MAIN) { SwitchScreen(SCREEN_SETTINGS); } else { SwitchScreen(SCREEN_MAIN); } lastPressTime currentTime; } } }6. 系统优化与进阶功能6.1 低功耗优化策略对于电池供电的应用我们可以实现以下优化void EnterLowPowerMode(void) { // 降低屏幕亮度 HAL_GPIO_WritePin(LCD_LEDA_GPIO_Port, LCD_LEDA_Pin, GPIO_PIN_RESET); // 降低CPU频率 __HAL_RCC_PLL_CONFIG(RCC_PLL_NONE); SystemCoreClockUpdate(); // 配置传感器为低功耗模式 SHT30_WriteCmd(0x2B32); // SHT30低功耗模式命令 } void ExitLowPowerMode(void) { // 恢复CPU频率 __HAL_RCC_PLL_CONFIG(RCC_PLL_48MHZ); SystemCoreClockUpdate(); // 恢复屏幕亮度 HAL_GPIO_WritePin(LCD_LEDA_GPIO_Port, LCD_LEDA_Pin, GPIO_PIN_SET); // 恢复传感器正常模式 SHT30_WriteCmd(0x2400); }6.2 数据持久化存储使用STM32内部Flash或外部EEPROM存储历史数据#define FLASH_PAGE_SIZE 1024 #define FLASH_DATA_ADDR 0x0801F800 // 使用最后一页Flash void SaveEnvData(EnvData *data) { HAL_FLASH_Unlock(); FLASH_EraseInitTypeDef erase; erase.TypeErase FLASH_TYPEERASE_PAGES; erase.PageAddress FLASH_DATA_ADDR; erase.NbPages 1; uint32_t error; HAL_FLASHEx_Erase(erase, error); uint32_t *src (uint32_t*)data; for(uint16_t i 0; i sizeof(EnvData)/4; i) { HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, FLASH_DATA_ADDR i*4, src[i]); } HAL_FLASH_Lock(); } void LoadEnvData(EnvData *data) { uint32_t *dst (uint32_t*)data; uint32_t *src (uint32_t*)FLASH_DATA_ADDR; for(uint16_t i 0; i sizeof(EnvData)/4; i) { dst[i] src[i]; } }6.3 无线数据传输扩展通过串口或无线模块实现数据远程传输void SendEnvData(EnvData *data, UART_HandleTypeDef *huart) { char buffer[128]; uint16_t startIdx (data-index ->// 使用DMA加速SPI传输 void LCD_Writ_Bus_DMA(uint8_t data) { CS_L; HAL_SPI_Transmit_DMA(hspi1, data, 1); while(hspi1.State HAL_SPI_STATE_BUSY_TX); CS_H; } // 批量传输优化 void LCD_Fill_Fast(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color) { uint8_t buffer[2] {color 8, color 0xFF}; uint32_t pixelCount (x2 - x1 1) * (y2 - y1 1); LCD_Address_Set(x1, y1, x2, y2); CS_L; DC_H; for(uint32_t i 0; i pixelCount; i) { HAL_SPI_Transmit_DMA(hspi1, buffer, 2); while(hspi1.State HAL_SPI_STATE_BUSY_TX); } CS_H; }7.3 扩展功能建议完成基础功能后可以考虑添加以下高级功能历史数据回顾存储多天数据并通过界面查看历史趋势报警功能当温湿度超过设定阈值时触发视觉或声音报警自动调节根据环境条件自动控制连接的设备如加湿器OTA升级通过无线方式更新固件多语言支持实现界面语言的动态切换