简介：这是一套基于STM32的共享充电宝项目完整资源，专为期末大作业、课程设计场景打造，面向STM32入门及进阶学习者，解决选题难、代码框架不清晰、报告撰写耗时等常见痛点。资源包含可运行的工程源码与配套报告PPT，代码内注释详细，模块化设计便于理解借还流程、状态机切换、外设驱动等核心逻辑，新手也能快速上手。包体共171个文件，以.h/.c源文件、Keil工程文件（.uvprojx）、烧录文件（.hex）及演示文稿（.pptx）为主，辅以少量配置文件与图表，整体压缩包约13.9MB，目录层级直观，便于按需查阅。项目中涉及STM32定时器、串口、Flash读写等基础外设应用，并覆盖共享充电宝的充电仓管理、借出/归还状态处理等实用功能，可直接作为高分开题或答辩素材。目前已有100人学习下载，适合希望短时间完成高质量课程设计、同时提升嵌入式实践能力的学生参考。
1. 从一套期末大作业看共享充电宝的单片机实现
共享充电宝的柜机拆开外壳，核心逻辑其实比很多人想得简单：检测充电宝是否在槽、开锁、计时、上报状态。用 STM32F1 系列做这套控制，绕不开定时器、串口、时钟树这几个外设。这套基于 STM32 的共享充电宝项目源码，文件名里能看到 stm32f1xx_hal_tim.c、stm32f1xx_hal_uart.c、stm32f1xx_hal_rcc.c 这类 HAL 库文件，说明它是在标准 STM32 开发环境（Keil MDK + STM32CubeMX 初始化）下写的，外设驱动该有的都有，注释也完整，新手读起来不吃力，老手直接抽外设驱动模块也不费劲。
它适合两类人：一类是做课程设计或期末大作业、需要一份能跑通的完整工程做参考；另一类是刚接触 STM32 HAL 库、想知道定时器、串口、DMA、RCC 时钟这些外设怎么配合实现一个真实业务场景的工程师。下面按文件清单展开，把每个 HAL 模块在这个项目里的作用、配置思路和常见坑一次说清楚。
2. 时钟树与 Flash：RCC 和 FLASH 外设决定了系统能不能跑稳
2.1 RCC 时钟配置在共享充电宝项目里的意义
stm32f1xx_hal_rcc.c 和 stm32f1xx_hal_rcc_ex.c 负责的是整个系统的时钟源头。共享充电宝柜机的 MCU 要同时跑串口通信、定时器计时、外部状态检测，外设时钟如果配错，最典型的现象就是串口波特率漂移、定时器计数不准。F1 系列默认是 HSI 8MHz 启动，但绝大多数项目在实际部署时会切换到 HSE 外部晶振，再通过 PLL 倍频到 72MHz 系统主频。看这个项目的源码工程，时钟配置走的是标准 HSE + PLL 路径，SystemClock_Config() 里能看到 RCC_OscInitTypeDef 和 RCC_ClkInitTypeDef 两个结构体的赋值。
RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; 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); RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2);这段代码把 8MHz 外部晶振通过 PLL 9 倍频得到 72MHz 系统时钟，APB1 分频到 36MHz，APB2 保持 72MHz。逻辑不复杂，但注意 HAL_RCC_ClockConfig 的第二个参数 FLASH_LATENCY_2，这直接和 Flash 等待周期挂钩。F1 在 72MHz 主频下必须配 2 个等待周期，否则 Flash 读取速度跟不上 CPU，程序会出现随机死机、神秘重启。很多共享充电宝项目在低温环境或电池供电不稳时出问题，排查到最后往往是这里没配对。
2.2 FLASH 外设在掉电保护里的角色
stm32f1xx_hal_flash.c 和 stm32f1xx_hal_flash_ex.c 这个项目的存在不只是为了 Flash 等待周期。共享充电宝有一个隐藏刚需：断电时要把当前租借状态存下来。用户还了充电宝、柜机刚开锁、记录还没上报，这时候突然断电，如果没有掉电保存机制，重启后状态就乱了。常见做法是把租借状态、槽位号、时间戳写进 Flash 的某个扇区，用 HAL_FLASH_Program 按半字写入，读的时候直接按地址读。
uint32_t addr = 0x08080000; // 末扇区，放用户数据 HAL_FLASH_Unlock(); __disable_irq(); FLASH_EraseInitTypeDef erase = {0}; erase.TypeErase = FLASH_TYPEERASE_SECTORS; erase.Sector = 11; // F103ZET6 最后一扇区 erase.NbSectors = 1; uint32_t err = 0; HAL_FLASHEx_Erase(&erase, &err); HAL_FLASH_Program(FLASH_TYPEPROGRAM_HALFWORD, addr, state); HAL_FLASH_Lock(); __enable_irq();注意这里先关了全局中断再擦写，因为 Flash 擦写期间 CPU 取指会被阻塞，中断服务函数如果恰好在这个窗口触发，轻则响应延迟，重则总线错误。写入数据建议用状态结构体打包，校验用和校验或者 CRC16，读出来先验一遍再决定是否信任。HAL_FLASHEx_Erase 里 Sector 的编号要根据具体型号查手册，F103ZET6 是 12 个扇区，编号 0 到 11，选最后一个存用户数据最安全。
3. TIM 定时器：PWM 输出、计时与按键消抖的多面手
3.1 stm32f1xx_hal_tim.c 里藏着哪些计时逻辑
共享充电宝需要两类时间处理：一是租借计时的分钟级累计，二是状态指示灯、蜂鸣器这类需要 PWM 或者精确延时的短周期控制。stm32f1xx_hal_tim.c 和 stm32f1xx_hal_tim_ex.c 负责的就是这些。F1 的 TIM 分成基本定时器（TIM6/7）、通用定时器（TIM2/3/4/5）和高级定时器（TIM1/8）。这个项目里最有用的其实是 TIM2 这种 32 位定时器，因为 32 位计数器在 1kHz 分频下可以跑很久不溢出，适合做租借计时基准。
TIM_HandleTypeDef htim2; htim2.Instance = TIM2; htim2.Init.Prescaler = 7200 - 1; // 72MHz / 7200 = 10kHz htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 10000 - 1; // 10kHz / 10000 = 1Hz htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_Base_Init(&htim2); HAL_TIM_Base_Start_IT(&htim2);这段把 TIM2 配成了 1Hz 中断，Prescaler 从 0 开始计所以要减 1，Period 同理。1Hz 中断里维护一个 volatile 标志位，主循环里检查这个标志做秒计数累加，而不是直接在中断里写业务逻辑。中断里做复杂运算会导致定时器事件堆积，影响其他外设的响应，这是新手最容易犯的错。
3.2 PWM 输出控制指示灯和电机锁
共享充电宝的槽位状态灯，用 PWM 调亮度比 GPIO 翻转的体验好得多。高级定时器 TIM1 可以输出多路互补 PWM，但这项目里用通用定时器 TIM3 输出四路独立 PWM 就足够了。每路通道对应一个槽位灯，占空比随租借状态变化：空闲常亮低亮度，使用中呼吸效果，归还时闪烁几次确认。
TIM_OC_InitTypeDef sConfigOC = {0}; sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 500; // 占空比 500/1000 = 50% sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);Pulse 的值域范围取决于 TIM3 的 Period 配置，如果 Period 配成了 1000，那 Pulse 就是千分比的占空比。用 HAL_TIM_PWM_Start 而不是 HAL_TIM_PWM_Start_IT，因为 PWM 输出不需要中断，占空比更新直接改 CCPR 寄存器就行。实际项目里呼吸灯效果可以开 TIM3 更新中断，在中断里递增或递减 Pulse 值，但要注意加上边界判断和步进值控制，不然会出现灯闪到最亮后直接跳变的问题。
3.3 输入捕获检测充电宝在位状态
充电宝在位检测通常有两个方案：一个是霍尔传感器输出高低电平，另一个是电流检测电阻上的电压变化。如果是脉冲式的信号（比如电机锁到位信号），可以用 TIM 的输入捕获模式测脉宽来判断状态。stm32f1xx_hal_tim_ex.c 里的霍尔传感器接口模式在这里不常用，但输入捕获功能很实用。
TIM_IC_InitTypeDef sConfigIC = {0}; sConfigIC.Channel = TIM_CHANNEL_1; sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; sConfigIC.ICPrescaler = TIM_ICPSC_DIV1; sConfigIC.ICFilter = 0x0F; // 数字滤波，抗抖动 HAL_TIM_IC_ConfigChannel(&htim4, &sConfigIC, TIM_CHANNEL_1); HAL_TIM_IC_Start_IT(&htim4, TIM_CHANNEL_1);ICFilter 设成 0x0F 是 15 个采样周期的滤波，能滤掉机械触点的弹跳干扰。输入捕获中断里拿两次捕获值做差，就能算出脉冲宽度，判断电机锁有没有动作到位。这种检测方式比单纯读 GPIO 可靠，因为 GPIO 读到的高电平可能是毛刺，而脉宽测量对干扰有天然容忍度。
4. UART 串口链路：从调试打印到通信协议
4.1 串口在共享充电宝项目里的双重身份
stm32f1xx_hal_uart.c 在共享充电宝里有两条链路：一条是调试串口，打印系统状态方便开发期排查；另一条是业务串口，和上位机或者 4G 模块通信。调试串口和业务串口最好分开用不同的 USART，因为混在一起调试日志会污染业务数据帧。项目里通常 USART1 做调试，USART2 或 USART3 做业务。两种场景的初始化配置是一样的，区别在于中断处理函数里对数据做什么处理。
UART_HandleTypeDef huart2; huart2.Instance = USART2; huart2.Init.BaudRate = 115200; huart2.Init.WordLength = UART_WORDLENGTH_8B; huart2.Init.StopBits = UART_STOPBITS_1; huart2.Init.Parity = UART_PARITY_NONE; huart2.Init.Mode = UART_MODE_TX_RX; huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE; huart2.Init.OverSampling = UART_OVERSAMPLING_16; HAL_UART_Init(&huart2);波特率 115200 是通用选择，8 位数据位、1 位停止位、无校验，这是串口通信的默认配置。假如和 4G 模块通信，要仔细看模块手册，有些模块默认波特率是 9600，上电后要发 AT 指令切换，不匹配的话收到的全是乱码。OverSampling 保持 16 倍过采样就行，7 倍过采样能提高波特率上限，但噪声容限会下降，F1 在 115200 这个速率下完全没必要。
4.2 数据帧解析，别用裸的 HAL_UART_Receive
新手拿到 HAL 库第一件事就是调 HAL_UART_Receive 阻塞接收，这在共享充电宝这种业务里是行不通的。上位机下发一条指令可能拆成几段到达，也可能一次到达好几条，阻塞接收要么卡死，要么丢帧。正确做法是开启接收中断或 DMA，把字节收进环形缓冲区，然后按帧协议解析。
#define RX_BUF_SIZE 128 uint8_t rx_buf[RX_BUF_SIZE]; uint8_t frame[64]; uint8_t frame_len = 0; uint8_t frame_ready = 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart->Instance == USART2) { // 收一个字节进协议解析器 protocol_push_byte(rx_buf[0]); HAL_UART_Receive_IT(&huart2, rx_buf, 1); } }每次只接收 1 个字节，接收完把字节交给协议解析器，然后立刻重新开启接收。这个处理方式简单且不容易出问题。协议解析器内部做状态机判断：帧头、长度、数据、校验、帧尾，全部满足才置 frame_ready 标志，主循环检测到标志后处理完整帧。校验方式用累加和就行，帧长度短，CRC16 也不是不行，但累加和在这个场景的可靠性完全够。
4.3 HAL_UART_Transmit 的阻塞陷阱
调试串口打印的时候要注意 HAL_UART_Transmit 是阻塞发送，如果对方不读或者线路有问题，函数会一直卡到超时。共享充电宝用户扫了码，柜机要回传状态再开锁，整个链路发送节奏很紧凑，调试打印如果卡住会影响业务。开发期调试可以随便用阻塞发送，正式逻辑里建议改用 HAL_UART_Transmit_IT 或者直接用 DMA 发送。尤其注意，阻塞发送时 CPU 空等，这时候如果有开锁信号进来，中断能响应但主循环跑不到处理逻辑，表现为「收到指令但动作延迟」。
5. DMA 搬运数据与高级调试技巧
5.1 串口 DMA 接收，让 CPU 从字节搬运中解放
stm32f1xx_hal_dma.c 在共享充电宝项目里的典型场景是串口 DMA 收发和 ADC 采样数据搬运。共享充电宝柜机的通信特点是数据包不定长，交互不频繁，DMA 收发在低速率下优势不明显，但能显著降低 CPU 占用。开启 DMA 接收后，数据到达直接进内存，只有一帧接收完成才触发空闲中断或 DMA 传输完成中断。模块源码里如果把 DMA 和 UART 配合使用，配置顺序有讲究：先初始化 DMA，再初始化 UART，最后调用 HAL_UART_Receive_DMA 启动接收。
HAL_UART_Receive_DMA(&huart2, dma_rx_buf, RX_BUF_LEN);接收进了环形缓冲区后，用 __HAL_UART_GET_FLAG(&huart2, UART_FLAG_IDLE) 判断空闲帧。空闲中断是判断不定长数据帧结束的最有效手段，比定时器超时判断省资源。数据帧收完了，主循环从头开始找帧头、解析、处理，处理完把读指针复位。这个方案比单字节中断效率高很多，而且数据不会因为中断服务函数处理不过来而丢失。
5.2 共享充电宝里容易被忽视的 ADC 与 DMA 联动
充电宝柜机里有个隐藏需求：电量监测和充电电流采样。用 STM32 的 ADC 配合 DMA 做连续采样，可以在不停 CPU 的情况下拿到一组样本，再做滤波处理得到稳定值。DMA 搬完一轮数据触发中断，中断里做均值滤波，把结果更新到全局变量。项目和源码注解没有直接提到这部分，但 stm32f1xx_hal_dma.c 的存在暗示工程里数据搬运类功能是有设计的。接个分压电阻采样锂电池电压，配一个简单的百分比换算表，就能在 LCD 或状态灯上显示剩余电量。
5.3 调试技巧，如何快速定位是硬件问题还是软件问题
这个项目配套了报告 PPT，开发过程中排错思路也值得按这套流程走一遍：程序跑飞了，先看 RCC 时钟初始化是否正常，用逻辑分析仪测 MCO 引脚输出的主时钟频率；串口乱码，先排除波特率误差，拿示波器量 TX 引脚的波形，数一下一个 bit 的时间宽度；定时器不准，确认 APB1 分频系数和定时器 Prescaler 的乘积，拿秒表校一遍。还有一个实用的老办法：串口打印关键变量的值，共享充电宝状态切换的每个分支都打日志，外设层看寄存器值、业务层看状态机跳转，基本能定位九成问题。
这套 STM32 共享充电宝项目源码的最有价值的点在于，它不是单个外设的 demo，而是把 RCC、FLASH、TIM、UART、DMA 串成了完整业务闭环。把 HAL 库这几个核心模块的代码过一遍，从文件里还原出时钟怎么配、定时器怎么起、串口怎么通信、数据怎么搬运，能比看十篇教程更接近真实项目里 STM32 的工作方式。
本文还有配套的精品资源，点击获取
