用STM32CubeMX和HAL库复刻蓝桥杯第八届省赛电梯调度系统（附完整工程）

基于STM32CubeMX与HAL库的电梯调度系统开发实战在嵌入式开发领域蓝桥杯竞赛一直是检验学习者实战能力的重要舞台。第八届省赛的电梯调度系统题目以其综合性强的特点成为许多嵌入式学习者进阶路上的关键挑战。本文将从一个全新的视角系统性地介绍如何利用STM32CubeMX和HAL库构建一个完整的电梯控制系统。不同于简单的代码复现我们将重点解析模块化设计思想、HAL库编程范式以及状态机实现技巧帮助读者掌握嵌入式系统开发的精髓。1. 开发环境搭建与工程初始化1.1 工具链配置要点开始项目前确保已安装以下开发工具STM32CubeMXv6.0或更高版本Keil MDK-ARM建议使用5.25以上版本STM32F1xx HAL库与开发板匹配的版本提示建议在CubeMX中勾选Generate peripheral initialization as a pair of .c/.h files选项这将使外设配置更清晰。配置时钟树时需特别注意// 典型时钟配置STM32F103系列 RCC_OscInitTypeDef RCC_OscInitStruct {0}; RCC_OscInitStruct.OscillatorType RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL RCC_PLL_MUL9; HAL_RCC_OscConfig(RCC_OscInitStruct);1.2 外设初始化策略根据电梯系统需求需要配置以下外设外设类型功能用途配置要点GPIO按键输入/LED输出设置上拉输入模式输出推挽模式TIMPWM生成/定时器配置ARR和PSC值使PWM频率为1kHzRTC实时时钟启用日历功能配置异步预分频器USART调试输出波特率1152008N1模式在CubeMX中完成配置后建议使用代码生成功能时选择Generate peripheral initialization as a pair of .c/.h files这将使工程结构更清晰。2. 系统架构设计与核心模块实现2.1 状态机模型构建电梯系统的核心是状态机设计典型状态包括空闲状态等待用户输入运行状态执行上下行运动停靠状态到达目标楼层后的处理状态转换逻辑可通过枚举实现typedef enum { ELEVATOR_IDLE, ELEVATOR_UP, ELEVATOR_DOWN, ELEVATOR_STOP } ElevatorState; // 全局状态变量 volatile ElevatorState g_elevatorState ELEVATOR_IDLE;2.2 按键扫描与去抖处理采用状态机方式实现按键检测比简单延时更可靠void Key_Scan(void) { static uint8_t keyState[4] {0}; const uint16_t debounceTime 10; // 10ms防抖时间 for(int i0; i4; i) { uint8_t currentState HAL_GPIO_ReadPin(keyPorts[i], keyPins[i]); if(currentState ! keyState[i]) { if(keyDebounceCount[i] debounceTime) { keyState[i] currentState; if(currentState 0) { // 按键按下 HandleKeyPress(i1); // 处理1-4楼按键 } } } else { keyDebounceCount[i] 0; } } }2.3 调度算法实现电梯调度采用SCAN算法电梯扫描算法的简化版基本规则记录所有请求的目标楼层当前方向上的请求优先响应到达最高/最低请求后反向运行关键数据结构typedef struct { uint8_t targetFloor; uint8_t direction; // 1上行, 2下行 } FloorRequest; FloorRequest g_requests[MAX_REQUESTS]; uint8_t g_requestCount 0;3. 关键功能实现细节3.1 运动控制与PWM生成电梯电机控制通过PWM实现CubeMX配置TIM为PWM模式后// 启动上行PWM void Elevator_StartUp(void) { HAL_TIM_PWM_Start(htim4, TIM_CHANNEL_1); __HAL_TIM_SET_COMPARE(htim4, TIM_CHANNEL_1, 500); // 50%占空比 g_elevatorState ELEVATOR_UP; } // 停止PWM输出 void Elevator_Stop(void) { HAL_TIM_PWM_Stop(htim4, TIM_CHANNEL_1); g_elevatorState ELEVATOR_STOP; }3.2 楼层显示与LED指示采用位带操作实现高效LED控制// LED宏定义基于STM32F103 #define LED1_PIN GPIO_PIN_0 #define LED1_PORT GPIOB #define LED1_ON() (LED1_PORT-BSRR (uint32_t)LED1_PIN 16) #define LED1_OFF() (LED1_PORT-BSRR LED1_PIN) // 楼层LED显示函数 void ShowFloorLED(uint8_t floor) { // 先关闭所有楼层LED LED1_OFF(); LED2_OFF(); LED3_OFF(); LED4_OFF(); // 根据当前楼层点亮对应LED switch(floor) { case 1: LED1_ON(); break; case 2: LED2_ON(); break; case 3: LED3_ON(); break; case 4: LED4_ON(); break; } }3.3 RTC集成与时间管理RTC配置要点在CubeMX中启用RTC时钟源通常选择LSE配置日历格式和初始时间实现时间显示更新时间获取示例void UpdateDisplayTime(void) { RTC_TimeTypeDef sTime {0}; RTC_DateTypeDef sDate {0}; char timeStr[20]; HAL_RTC_GetTime(hrtc, sTime, RTC_FORMAT_BIN); HAL_RTC_GetDate(hrtc, sDate, RTC_FORMAT_BIN); sprintf(timeStr, %02d:%02d:%02d, sTime.Hours, sTime.Minutes, sTime.Seconds); LCD_DisplayString(LINE_TIME, timeStr); }4. 系统优化与调试技巧4.1 内存优化策略嵌入式系统资源有限需特别注意使用const修饰常量数据合理规划全局变量与局部变量避免动态内存分配检查栈使用情况// 在启动文件(startup_stm32f1xx.s)中调整Stack_Size Stack_Size EQU 0x00000400 ; 1KB栈空间 Heap_Size EQU 0x00000200 ; 512B堆空间4.2 调试输出配置利用串口输出调试信息void Debug_Print(const char *format, ...) { char buffer[128]; va_list args; va_start(args, format); vsnprintf(buffer, sizeof(buffer), format, args); va_end(args); HAL_UART_Transmit(huart1, (uint8_t*)buffer, strlen(buffer), HAL_MAX_DELAY); }4.3 常见问题解决方案开发中可能遇到的问题及对策问题现象可能原因解决方案按键无响应GPIO模式配置错误检查CubeMX中是否设置为上拉输入PWM无输出定时器配置错误验证ARR和PSC值检查时钟使能RTC时间不准LSE未起振更换晶振或调整负载电容系统卡死栈溢出增大栈空间减少局部变量在项目开发过程中保持代码的模块化和良好的注释习惯至关重要。每个功能模块应有明确的输入输出定义这不仅能提高代码可读性也便于后续维护和功能扩展。