告别标准库：用STM32CubeMX+HAL库玩转蓝桥杯CT117E开发板的5个实战项目-程序员充电站

告别标准库：用STM32CubeMX+HAL库玩转蓝桥杯CT117E开发板的5个实战项目

在嵌入式开发领域，从标准库转向HAL库已成为不可逆转的趋势。对于参加蓝桥杯嵌入式赛项的选手来说，掌握HAL库开发不仅能够提升开发效率，更能适应现代嵌入式开发的潮流。本文将带你通过5个精心设计的实战项目，从呼吸灯到RTC电子钟，逐步掌握STM32G431 HAL库开发的精髓。

1. 呼吸灯：PWM与定时器的完美结合

呼吸灯作为嵌入式开发的"Hello World"，是理解HAL库工作流程的最佳起点。相比标准库繁琐的寄存器操作，HAL库通过STM32CubeMX可视化配置大大简化了开发流程。

首先打开STM32CubeMX，选择STM32G431RBT6芯片型号。在Pinout & Configuration界面中：

启用TIM1通道1的PWM输出功能（对应开发板LED1）
配置时钟树，确保APB2定时器时钟为170MHz
在TIM1配置中设置预分频器(Prescaler)为169，计数器周期(Period)为999，得到1kHz的PWM频率

生成代码后，在main.c中添加以下控制逻辑：

/* 启动PWM */ HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); while (1) { // 呼吸灯渐亮 for(uint16_t i=0; i<1000; i++) { __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, i); HAL_Delay(1); } // 呼吸灯渐暗 for(uint16_t i=1000; i>0; i--) { __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, i); HAL_Delay(1); } }

与标准库相比，HAL库的优势显而易见：

时钟配置通过图形化界面完成，无需手动计算复杂的分频系数
外设初始化代码自动生成，减少手写错误
提供统一的API接口，提高代码可移植性

提示：在蓝桥杯比赛中，合理使用HAL库可以节省大量开发时间，但要注意HAL库函数调用会带来一定的性能开销，在实时性要求高的场景需要权衡。

2. 按键控制LCD显示：GPIO与LCD驱动实战

CT117E开发板配备了2.4寸TFT-LCD和4个功能按键，这个项目将展示HAL库如何简化人机交互开发。

2.1 硬件配置

在STM32CubeMX中需要配置：

4个GPIO输入（按键B1-B4，设置为上拉输入模式）
SPI接口（用于LCD通信）
背光控制引脚

2.2 LCD驱动实现

HAL库提供了完善的SPI通信接口，相比标准库的寄存器级操作更加安全可靠：

void LCD_WriteData(uint8_t data) { HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET); HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); }

2.3 按键处理逻辑

HAL库的GPIO读取接口简洁明了：

uint8_t key_scan(void) { static uint8_t key_up = 1; if(key_up && (HAL_GPIO_ReadPin(KEY1_GPIO_Port, KEY1_Pin) == GPIO_PIN_RESET)) { HAL_Delay(10); key_up = 0; if(HAL_GPIO_ReadPin(KEY1_GPIO_Port, KEY1_Pin) == GPIO_PIN_RESET) { return KEY1_PRES; } } else if(HAL_GPIO_ReadPin(KEY1_GPIO_Port, KEY1_Pin) == GPIO_PIN_SET) { key_up = 1; } return 0; }

通过这个项目，可以明显感受到HAL库在以下方面的优势：

硬件抽象层使代码更易读和维护
内置硬件去抖动处理简化了按键检测
统一的错误处理机制提高了系统稳定性

3. ADC读取电位器：模拟信号采集的现代化实现

CT117E开发板配备了2个分压电位器，是学习ADC的理想平台。HAL库为模拟信号采集提供了更加安全和便捷的接口。

3.1 CubeMX配置要点

启用ADC1通道5（对应电位器R37）
配置连续转换模式，12位分辨率
设置合适的采样时间（推荐239.5个时钟周期）

3.2 关键代码实现

HAL库的ADC接口相比标准库更加安全可靠：

uint16_t get_adc_value(void) { ADC_ChannelConfTypeDef sConfig = {0}; sConfig.Channel = ADC_CHANNEL_5; sConfig.Rank = 1; sConfig.SamplingTime = ADC_SAMPLETIME_239CYCLES_5; HAL_ADC_ConfigChannel(&hadc1, &sConfig); HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, HAL_MAX_DELAY); return HAL_ADC_GetValue(&hadc1); }

3.3 数据处理技巧

为了提高ADC采集的稳定性，可以采用中值平均滤波：

#define SAMPLE_TIMES 5 uint16_t get_stable_adc(void) { uint16_t adc_values[SAMPLE_TIMES]; for(int i=0; i<SAMPLE_TIMES; i++) { adc_values[i] = get_adc_value(); HAL_Delay(1); } // 简单排序 for(int i=0; i<SAMPLE_TIMES-1; i++) { for(int j=i+1; j<SAMPLE_TIMES; j++) { if(adc_values[i] > adc_values[j]) { uint16_t temp = adc_values[i]; adc_values[i] = adc_values[j]; adc_values[j] = temp; } } } // 取中值 return adc_values[SAMPLE_TIMES/2]; }

HAL库的ADC模块相比标准库有以下改进：

内置校准流程，提高采集精度
提供多种转换模式（单次、连续、扫描等）
统一的错误回调机制，便于调试

4. DAC输出波形：信号生成的便捷之道

CT117E开发板的STM32G431内置2个12位DAC通道，结合HAL库可以轻松实现各种波形输出。

4.1 基础配置

在CubeMX中：

启用DAC通道1
选择触发源为定时器2（用于周期波形生成）
配置定时器2产生所需的波形频率

4.2 正弦波生成

利用HAL库可以轻松实现DAC输出：

#define PI 3.1415926f #define SAMPLE_POINTS 64 void generate_sine_wave(void) { static uint16_t sine_wave[SAMPLE_POINTS]; // 生成正弦波样本 for(int i=0; i<SAMPLE_POINTS; i++) { float angle = 2 * PI * i / SAMPLE_POINTS; sine_wave[i] = 2048 + (uint16_t)(2047 * sin(angle)); } // 启动DAC HAL_DAC_Start(&hdac1, DAC_CHANNEL_1); // 使用定时器触发DAC转换 HAL_TIM_Base_Start(&htim2); while (1) { for(int i=0; i<SAMPLE_POINTS; i++) { HAL_DAC_SetValue(&hdac1, DAC_CHANNEL_1, DAC_ALIGN_12B_R, sine_wave[i]); HAL_Delay(1); // 调整延时改变频率 } } }

4.3 波形参数控制

通过电位器可以实时调整波形参数：

void dynamic_wave_control(void) { uint16_t last_adc = 0; while (1) { uint16_t current_adc = get_stable_adc(); if(abs(current_adc - last_adc) > 20) { // 防抖处理 uint16_t freq = 10 + current_adc / 40; // 10-100Hz范围 update_timer_frequency(freq); last_adc = current_adc; } HAL_Delay(50); } }

HAL库的DAC模块优势：

简化了触发配置流程
提供多种数据对齐方式
内置噪声波和三角波生成功能

5. RTC电子钟：低功耗与实时性的平衡艺术

STM32G431的RTC模块功能强大，结合HAL库可以轻松实现精确的时钟功能。

5.1 RTC基础配置

在CubeMX中：

启用RTC时钟源（LSE或LSI）
配置日历格式和初始时间
启用RTC闹钟功能（可选）

5.2 时间显示实现

HAL库提供了简洁的RTC接口：

void display_time(void) { RTC_TimeTypeDef sTime = {0}; RTC_DateTypeDef sDate = {0}; while (1) { HAL_RTC_GetTime(&hrtc, &sTime, RTC_FORMAT_BIN); HAL_RTC_GetDate(&hrtc, &sDate, RTC_FORMAT_BIN); char time_str[20]; sprintf(time_str, "%02d:%02d:%02d", sTime.Hours, sTime.Minutes, sTime.Seconds); LCD_DisplayString(10, 10, (uint8_t *)time_str); char date_str[20]; sprintf(date_str, "20%02d-%02d-%02d", sDate.Year, sDate.Month, sDate.Date); LCD_DisplayString(10, 30, (uint8_t *)date_str); HAL_Delay(500); } }

5.3 闹钟功能实现

HAL库简化了闹钟配置：

void set_alarm(uint8_t hour, uint8_t min) { RTC_AlarmTypeDef sAlarm = {0}; sAlarm.AlarmTime.Hours = hour; sAlarm.AlarmTime.Minutes = min; sAlarm.AlarmTime.Seconds = 0; sAlarm.AlarmMask = RTC_ALARMMASK_NONE; sAlarm.AlarmSubSecondMask = RTC_ALARMSUBSECONDMASK_ALL; sAlarm.AlarmDateWeekDaySel = RTC_ALARMDATEWEEKDAYSEL_DATE; sAlarm.AlarmDateWeekDay = 1; sAlarm.Alarm = RTC_ALARM_A; HAL_RTC_SetAlarm_IT(&hrtc, &sAlarm, RTC_FORMAT_BIN); } void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc) { // 闹钟触发处理 beep_alarm(); }

HAL库的RTC模块改进：