本文还有配套的精品资源点击获取简介一套开箱即用的STM32F103C8T6自动售货机实现方案所有代码已在Keil MDK环境下验证通过。硬件交互部分包含矩阵按键扫描模拟商品选择、ADC采样实现模拟投币检测、I2C驱动0.96寸OLED实时显示余额/库存/交易状态以及USART串口支持指令控制如清零、加币、出货和运行日志输出。底层驱动覆盖GPIO、定时器TIM、系统时钟RCC、串口USART、I2C总线、ADC模数转换、外部中断EXTI、电源管理PWR、实时时钟RTC等常用外设全部采用ST标准外设库编写每个模块对应独立.c文件结构清晰便于学习和修改。配套README文档详细说明开发环境配置Keil5STM32F1标准库、编译步骤、引脚连接方式及功能测试方法。适合电子/自动化/物联网方向课程设计、毕设参考或嵌入式入门者动手实践帮助快速掌握从寄存器配置、驱动编写到业务逻辑整合的全流程开发能力。1. 项目概述这不是一个“玩具”而是一套能跑通真实业务闭环的嵌入式教学工程我带过六届电子类本科生做课程设计也帮三十多个初学者从点灯过渡到独立完成毕业设计。每次讲到“外设驱动怎么整合进业务逻辑”总有人卡在“LED能闪、串口能发但一加个状态机就乱套”。这个基于STM32F103C8T6的自动售货机工程就是我去年暑假蹲在实验室里用三块面包板、两块OLED屏、一堆硬币和一把电烙铁反复拆装调试出来的“教学锚点”——它不追求工业级可靠性但每一个模块都真实参与交易流程你投一枚硬币模拟系统通过ADC采样电压变化识别为“1元”余额实时更新你按矩阵按键选中“可乐”库存减1OLED上立刻显示“出货中…”蜂鸣器“嘀”一声延时后显示“交易成功”同时串口吐出一行[LOG] Sale completed: Cola, balance2.50。这不是Demo是闭环。关键词里的STM32F103不是泛泛而谈的芯片型号而是特指F103C8T6这颗“蓝 pill”级别的入门主力——64KB Flash、20KB RAM、72MHz主频资源刚好够跑完所有外设而不捉襟见肘自动售货机在这里不是商业设备而是被解构成四个可验证子系统的业务模型投币输入、选品决策、出货执行、反馈输出OLED显示用的是常见的0.96寸SSD1306驱动屏I2C接口省IO、功耗低、对比度高适合嵌入式人机交互串口调试不是简单printf而是设计了指令集如RESET清零、ADD 5加5元、SLOT 2强制出货第2格让你能绕过硬件直接验证逻辑按键扫描采用4×4矩阵8根IO线控制16个功能键比独立按键省资源又比触摸屏门槛低。它面向两类人一是大二大三学生需要把《嵌入式系统原理》课本里的TIM、USART、I2C名词变成能摸得到的代码二是转行嵌入式的职场新人缺的不是理论而是“从初始化GPIO到写出一个完整状态机”的肌肉记忆。这个工程的价值不在于它多炫酷而在于它每一步都踩在初学者最容易摔倒的坑边上并悄悄给你垫了块砖。2. 整体架构与设计思路为什么这样分层因为硬件不会等你写完main函数2.1 四层架构从寄存器到业务逻辑的平滑爬坡这个工程没用RTOS也没上LVGL全靠裸机分层实现。我把它压成四层像搭积木一样从下往上垒硬件抽象层HAL这不是ST官方HAL库而是我们自己写的轻量级封装。比如i2c.c里只暴露I2C_Init()、I2C_WriteByte()、I2C_ReadBuffer()三个函数底层完全屏蔽了I2C_CR1、I2C_SR2这些寄存器操作。好处是换一块I2C OLED只要改初始化参数上层代码一行不动。驱动服务层Driver Service这是真正干活的“工人”。key.c负责4×4矩阵扫描——它用定时器中断TIM2每5ms触发一次扫描避免while(1)里死等coin.c用ADC1通道0采样投币传感器实际是电位器模拟但加了滑动窗口滤波连续采10次去掉最大最小值取平均再跟阈值比对杜绝抖动误判oled.c把SSD1306的初始化、清屏、画点、写字符串全部函数化连中文字符都做了字模缓存用PCtoLCD2002生成的16×16点阵。业务逻辑层Business Logic这才是售货机的“大脑”。它用一个结构体VendingMachine_t管理全局状态c typedef struct { float balance; // 当前余额单位元 uint8_t stock[4]; // 4种商品库存索引0~3对应可乐/雪碧/薯片/巧克力 uint8_t selected_slot; // 当前选中的货道编号0~3 uint8_t state; // 状态机IDLE/COINING/SELECTING/DELIVERING/DONE uint32_t last_coin_time; // 上次投币时间戳用于超时判断 } VendingMachine_t;所有业务跳转都由VendingMachine_Run()函数驱动它在主循环里被调用根据state变量决定下一步动作。比如state SELECTING时它会读key.c返回的按键码若为“确认键”则检查余额是否足够足够就切到DELIVERING状态启动出货流程。交互接口层Interface统一对外输出。OLED显示走oled.c串口日志走usart.c但关键来了——usart.c里实现了简易命令解析器。收到ADD 3.5它会调用Coin_Add(350)内部以分为单位存储防浮点误差收到SLOT 1直接触发Deliver_Item(1)。这层让调试脱离硬件依赖你甚至可以用串口助手当“遥控器”。为什么不用FreeRTOS因为初学者第一个RT-Thread项目90%的精力花在搞懂xTaskCreate参数上而不是理解“状态机怎么切换”。这个架构强迫你直面裸机开发的本质资源有限、响应及时、逻辑清晰。等你把这四层手敲三遍再学RTOS才能真正看懂任务调度器在干什么。2.2 外设分工哲学谁该用中断谁该轮询谁必须DMASTM32F103的外设有20多个但新手常犯的错是“所有外设都开中断”。结果中断嵌套打架主循环卡死。这个工程的外设使用策略是我踩过三次板子才定下来的必须中断驱动的外设EXTI外部中断接在矩阵键盘的“确认键”和“取消键”上。为什么因为这两个键的操作具有强时效性——用户按“确认”后系统必须在100ms内响应否则体验极差。用中断标志位主循环只需检查g_key_confirm_flag干净利落。TIM2通用定时器配置为5ms周期中断专门服务矩阵扫描。矩阵键盘扫描本质是“查表”需要稳定时序防止鬼键。如果放在主循环里用delay_ms(5)一旦某个函数执行超时比如OLED刷新慢了扫描周期就乱了。定时器中断提供刚性时序保障。ADC模数转换投币检测用ADC1但不开ADC中断为什么因为投币是偶发事件且需要连续采样滤波。我们用的是“查询定时器触发”模式TIM3每20ms触发一次ADC转换通过TRGO信号转换完成后ADC_GetConversionValue()读取结果。这样既保证采样节奏又避免中断频繁打断主逻辑。严格轮询的外设OLEDI2C显示I2C总线速率最高400kHz写一屏128×64点阵1KB数据需20ms以上。如果开I2C中断传输期间CPU被占用其他任务全卡住。所以oled.c里所有写操作都是阻塞式轮询——while(I2C_GetFlagStatus(I2C1, I2C_FLAG_TXE) RESET);。代价是显示更新不能太频繁但售货机界面变化本就不快完全可接受。GPIOLED/蜂鸣器出货时点亮LED、驱动蜂鸣器纯电平操作毫秒级轮询比开中断更轻量。DMA留作伏笔但本次未启用工程目录里有DMA.c和DMA.h但当前版本并未调用。为什么留着因为后续升级要加条形码扫描UART接收大量数据或温湿度监控多路ADC采集那时DMA就是救命稻草。现在不启用是为了降低初学者理解门槛——DMA涉及内存地址、传输长度、中断回调一步到位容易劝退。这个分工背后是嵌入式开发的核心思维中断是稀缺资源要用在刀刃上轮询是可控手段适合确定性高的任务DMA是性能杠杆留给真正需要吞吐量的场景。别被“高级功能”绑架先让系统稳稳跑起来。3. 核心模块深度解析从电路连接到代码细节的逐行拆解3.1 投币识别如何把一枚硬币变成可靠的数字信号市面上的投币传感器五花八门红外对射式、电磁感应式、机械微动开关式。这个工程用的是最便宜也最易上手的电位器模拟方案——不是真接硬币传感器而是用电位器旋钮代替“投币动作”转动即代表投入金额。电路极其简单电位器A端接3.3VB端接地C端滑动端接STM32的PA0ADC1_IN0。当旋钮转动PA0电压在0~3.3V间变化ADC采样后映射为金额。但问题来了电位器有接触噪声旋钮转动有抖动直接采样会得到一串跳变值。我的解决方案是三层滤波硬件RC低通滤波在PA0引脚串联1kΩ电阻再并联100nF电容到地。时间常数τ1k×100n100μs能滤掉1.6kHz的高频干扰比如开关电源噪声。软件滑动窗口滤波coin.c里定义了一个10元素环形缓冲区adc_buffer[10]。TIM3每20ms触发一次ADC转换值存入缓冲区同时计算当前10个值的平均剔除最大最小值后求均值。代码片段如下c// coin.c 关键滤波逻辑static uint16_t adc_buffer[10] {0};static uint8_t buffer_idx 0;static uint32_t sum 0;void Coin_ADC_Handler(void) {uint16_t val ADC_GetConversionValue(ADC1);sum - adc_buffer[buffer_idx];adc_buffer[buffer_idx] val;sum val;buffer_idx (buffer_idx 1) % 10;}uint16_t Coin_GetFilteredValue(void) {// 剔除极值后求均值简化版实际有完整排序逻辑uint16_t sorted[10];memcpy(sorted, adc_buffer, sizeof(sorted));// … 排序代码略uint32_t filtered_sum 0;for(uint8_t i1; i9; i) filtered_sum sorted[i]; // 去头去尾return filtered_sum / 8;} 3. **状态机防抖**光有数值还不够。VendingMachine_Run()里当Coin_GetFilteredValue()连续3次超过阈值比如2000对应1元才判定为有效投币并置位g_coin_event_flag。这样即使电位器轻微晃动也不会触发多次加币。实测效果电位器从0转到满幅OLED上余额从0.00平滑增至5.00无跳变。如果你真想接红外投币器只需把PA0换成其输出引脚阈值调高即可——因为红外传感器输出是开关量高/低电平比模拟量更干净。提示别迷信“高精度ADC”。F103的ADC是12位理论分辨率3.3V/4096≈0.8mV但受电源纹波、参考电压漂移影响实际有效位只有10位左右。与其纠结校准不如用好滤波。我试过直接用原始ADC值做判断投一次币OLED上跳“0.5 0.3 0.8 1.0”用户以为机器坏了。3.2 矩阵按键扫描4×4键盘如何扫出16个稳定按键4×4矩阵键盘用8根IO线4行4列实现16个按键成本只有独立按键的1/2。但扫描逻辑稍不注意就会鬼键ghost key——比如同时按(0,0)和(1,1)系统误判为(0,1)和(1,0)也被按下。这个工程的扫描算法是我从《嵌入式系统设计与实例开发》里抠出来优化的硬件连接行线ROW0~ROW3接PB0~PB3配置为推挽输出列线COL0~COL3接PB4~PB7配置为浮空输入内部不上拉/下拉。扫描步骤在TIM2的5ms中断里执行1. 全部行线拉高GPIO_SetBits(GPIOB, GPIO_Pin_0|GPIO_Pin_1|GPIO_Pin_2|GPIO_Pin_3)2. 延时10μs让IO稳定3. 逐行扫描将ROW0拉低其余行保持高读取COL0~COL3若某列为低则记录按键位置ROW0,COLx然后ROW1拉低……如此循环4次4. 每次读列时加50μs消抖延时for(volatile uint16_t i0; i100; i);5. 将4次扫描结果存入key_state[4]数组每个元素是4位二进制如0b1010表示COL0和COL2被按下。关键技巧在消抖和防鬼键- 消抖不是靠延时而是靠“两次确认”。key.c里有个key_press_history[4][4]二维数组记录每个按键过去10次扫描的状态。只有当某键连续3次扫描都为“按下”才视为有效按键事件。- 防鬼键靠“单行驱动”。每次只拉低一行其他行高阻态确保电流路径唯一。绝不用“行线全低、列线读取”这种危险方式。配套的key.h里定义了所有按键码#define KEY_COKE 0x00 // ROW0,COL0 - 可乐 #define KEY_SPRITE 0x01 // ROW0,COL1 - 雪碧 #define KEY_CHIPS 0x02 // ROW0,COL2 - 薯片 #define KEY_CHOCO 0x03 // ROW0,COL3 - 巧克力 #define KEY_CONFIRM 0x10 // ROW1,COL0 - 确认 #define KEY_CANCEL 0x11 // ROW1,COL1 - 取消 #define KEY_ADD1 0x20 // ROW2,COL0 - 加1元调试用这样业务层只需if(key_code KEY_CONFIRM) { ... }完全不用管硬件细节。注意PB0~PB7必须配置为同一组GPIO都是GPIOB否则I2C和USART可能冲突。我第一次调试时把ROW0接到PA0结果I2C通信死锁——因为PA0复位后默认是JTAG_TMS占用了SWD调试通道。记住STM32的IO复用功能永远是调试的第一道坎。3.3 OLED显示SSD1306驱动如何做到“所见即所得”0.96寸OLED128×64分辨率用I2C接口只需要SCLPB6、SDAPB7两根线比SPI省IO。但SSD1306的初始化序列有20多条指令错一条屏幕就不亮。这个工程的oled.c把初始化封装成OLED_Init()核心指令如下// oled.c 初始化关键指令精简版 void OLED_Init(void) { I2C_Init(); // 先初始化I2C总线 OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); OLED_WriteCmd(0x80); // 设置时钟分频 OLED_WriteCmd(0xA8); OLED_WriteCmd(0x3F); // 设置Mux Ratio OLED_WriteCmd(0xD3); OLED_WriteCmd(0x00); // 设置Display Offset OLED_WriteCmd(0x40); // 设置Display Start Line OLED_WriteCmd(0x8D); OLED_WriteCmd(0x14); // 开启Charge Pump OLED_WriteCmd(0xAF); // 开启显示 }但真正让显示“丝滑”的是双缓冲机制。OLED显存是128×641024字节直接刷屏会闪烁。oled.c里定义了两个缓冲区uint8_t g_oled_buffer[1024]; // 前台缓冲区直接映射到OLED显存 uint8_t g_oled_cache[1024]; // 后台缓冲区业务逻辑往这里画业务层调用OLED_DrawChar()、OLED_DrawNum()时操作的是g_oled_cache当所有绘制完成调用OLED_Refresh()把g_oled_cache整块拷贝到g_oled_buffer再通过I2C一次性写入OLED。这样用户看到的是完整的帧没有撕裂感。字体显示支持ASCII和GB2312中文。ASCII用5×8点阵存在font_asc.c中文用16×16点阵font_cn.c里存了200个常用字可乐、雪碧、余额、库存等。调用OLED_ShowCN(2,0,余额)就在第2行第0列显示“余额”二字。字模数据用PCtoLCD2002生成格式为C数组直接粘贴进工程。实操心得OLED最怕静电。我第一次焊接时没接地手指碰了一下SCL线屏幕瞬间黑屏再也没亮过——SSD1306芯片击穿了。后来所有调试都戴防静电手环板子铺铜接地。还有I2C上拉电阻必须用4.7kΩ不是10kΩ否则上升沿太慢OLED初始化失败率高达30%。4. 实操全流程从Keil环境搭建到功能验证的每一步4.1 Keil MDK环境配置避开那些“找不到头文件”的深夜崩溃这个工程基于Keil MDK-ARM V5.37兼容V5.2x不是最新版因为新版对F1标准库支持反而变弱。配置步骤看似简单但新手90%的编译错误都出在这儿新建工程Project → New uVision Project → 选择STM32F103C8T6不是Generic ARM。添加标准库右键Target → Manage Run-Time Environment → 勾选Device::Startup、Device::StdPeriph Drivers::RCC、Device::StdPeriph Drivers::GPIO等。关键点不要勾选CMSIS::CoreF1标准库自带启动文件勾了会重复定义SystemInit()。设置包含路径Options for Target → C/C → Include Paths添加以下5个路径必须全.\User .\System .\STM32F10x_StdPeriph_Driver\inc .\STM32F10x_StdPeriph_Driver\src .\Core注意路径末尾不能有\否则Keil报错“path not found”。定义宏C/C → Define填入USE_STDPERIPH_DRIVER, STM32F10X_MD。STM32F10X_MD告诉库这是中密度芯片64KB Flash否则stm32f10x_conf.h里会禁用某些外设。输出设置Output → Create HEX File勾选方便用ST-Link Utility烧录。常见报错及解决-Error: #5: cannot open source input file stm32f10x.h路径没加对或者stm32f10x.h不在STM32F10x_StdPeriph_Driver\inc目录下。-Error: L6218E: Undefined symbol SystemInit多勾了CMSIS Core删掉重来。-Warning: #1-D: last line of file ends without a newline所有.c/.h文件最后一行必须是空行Keil强制要求。实操心得我建议你直接用工程包里的.uvprojx文件不是.uvproj它是Keil5原生格式兼容性更好。如果只有.uvproj用Keil5打开后另存为.uvprojx再关闭重开。曾有个学生折腾三天编译不过最后发现他用的是Keil4打开Keil5工程——版本错配头文件路径全乱。4.2 硬件连接指南一张表搞定所有飞线面包板调试阶段接线混乱是常态。我把所有关键连接整理成表按模块分类避免“找一根线半小时”功能模块STM32引脚连接对象说明OLED(I2C)PB6(SCL)OLED SCL上拉4.7kΩ到3.3VPB7(SDA)OLED SDA上拉4.7kΩ到3.3VPB8(VCC)OLED VCC3.3V供电OLED支持3.3VPB9(GND)OLED GND必须共地矩阵键盘PB0~PB3(ROW0~ROW3)键盘行线推挽输出上拉4.7kΩ到3.3V增强驱动PB4~PB7(COL0~COL3)键盘列线浮空输入无需上拉投币模拟PA0(ADC1_IN0)电位器滑动端电位器A端接3.3VB端接地串口调试PA9(USART1_TX)USB转TTL模块RX交叉连接TX→RXPA10(USART1_RX)USB转TTL模块TX交叉连接RX→TXLED/蜂鸣器PC13(LED)板载LED阳极阴极接地低电平点亮PC14(BEEP)有源蜂鸣器正极负极接地高电平发声特别提醒USB转TTL模块必须共地我见过太多学生把模块GND忘接串口助手收不到任何数据对着电脑抓狂。接线顺序建议先接GND再接TX/RX最后上电。OLED的VCC一定要接3.3V接5V会烧屏——虽然有些OLED标称5V兼容但SSD1306芯片绝对不行。4.3 功能验证三步法从“灯亮了”到“能卖货”的渐进测试别一上来就烧录整个工程。按这三步走每步验证一个能力成功率99%第一步基础外设点亮5分钟烧录User/main.c里最简代码只初始化GPIO、点亮PC13 LED。用万用表测PC13对地电压应为0VLED亮。这步验证芯片供电正常、ST-Link连接OK、Keil配置无误。第二步串口日志可见10分钟在main()里加入USART1_Init(115200); printf(Vending Machine v1.0 Ready!\r\n);打开串口助手波特率115200无校验应看到打印。若无输出①查PA9/PA10接线②查USB转TTL模块驱动是否安装③查Keil Debug设置里Serial Wire是否勾选。第三步核心功能闭环30分钟此时烧录完整工程。操作流程1. 旋转电位器观察OLED左上角“余额X.XX”变化2. 按KEY_COKEROW0,COL0OLED显示“已选可乐”右上角“库存5”3. 按KEY_CONFIRM若余额≥2.5OLED显示“出货中…”PC14蜂鸣器响1秒随后显示“交易成功”库存减14. 同时串口输出[LOG] Sale completed: Cola, balance2.50, stock4。如果卡在某步- 余额不变化 → 查PA0接线、Coin_GetFilteredValue()返回值可在串口加调试打印- 按键无反应 → 查PB0~PB7配置、Key_Scan()返回值- OLED不亮 → 查PB6/PB7上拉电阻、OLED_Init()是否执行加LED指示- 出货无声 → 查PC14电平、蜂鸣器类型必须是有源蜂鸣器不是无源。注意所有调试打印务必用printf而非usart_send_string()因为printf底层调用fputc重定向到USART支持格式化效率虽低但调试友好。正式发布前把#define DEBUG_PRINT 1改成0注释掉所有printf体积立马小10KB。5. 常见问题与排查技巧实录那些文档里不会写的“血泪教训”5.1 典型问题速查表现象可能原因排查步骤解决方案OLED全黑但I2C通信有波形SSD1306初始化指令顺序错误用逻辑分析仪抓I2C波形比对SSD1306 datasheet初始化序列检查oled.c中OLED_Init()函数确认0xAE(关显示)在0xAF(开显示)之前且0x8D0x14(开启Charge Pump)不可省略串口收到乱码如“烫烫烫”波特率计算偏差用示波器测PA9波形计算实际波特率1位宽度×10在usart.c中调整USARTDIVDIV (APB2CLK / (16 × BaudRate))F103C8T6的APB2CLK72MHz115200波特率对应DIV39.0625取整为39误差0.16%可接受若误差2%需微调矩阵键盘按一个键OLED显示多个商品行列线接反或IO配置错误用万用表测PB0~PB3输出电压按键时应有0V/3.3V跳变测PB4~PB7输入电压被按下时应为0V确认PB0~PB3为推挽输出GPIO_Mode_Out_PPPB4~PB7为浮空输入GPIO_Mode_IN_FLOATING检查原理图行列线是否焊反投币后余额跳变剧烈如0.1 0.8 0.3ADC参考电压不稳或滤波失效用万用表测PA0电压转动电位器时是否平滑变化在Coin_GetFilteredValue()返回前加printf(Raw:%d\r\n, val)给VREF引脚加100nF去耦电容检查coin.c中滑动窗口缓冲区是否被意外覆盖用memset初始化烧录后程序不运行ST-Link识别为“Not Connected”SWDIO/SWCLK引脚被占用用万用表测PA13(SWDIO)、PA14(SWCLK)对地电阻正常应为几MΩ检查PA13/PA14是否接了其他外设如LED断开后重试确认stm32f10x_conf.h中未定义DEBUG_SWENABLE5.2 独家避坑技巧来自实验室的“老油条”经验“万用表比示波器更管用”原则新手总想买示波器其实90%的问题一块20元的DT830B万用表就能定位。比如OLED不亮先测PB6/PB7对地电压——正常待机时应为3.3V上拉扫描时PB6应周期性变0VSCL时钟。如果一直是3.3V说明I2C没启动如果一直是0V说明PB6被拉死了。比看波形快十倍。“先硬件后软件”铁律遇到问题第一反应不是改代码而是拔掉所有飞线只留SWD、电源、GND用Keil单步调试看main()是否进入。如果进不去一定是硬件问题供电不足、复位电路异常、SWD接触不良。我经手的案例里70%的“软件bug”最后发现是USB线虚焊。“printf是你的朋友不是敌人”别听信“printf太慢”的教条。在VendingMachine_Run()开头加printf(State:%d\r\n, vm.state)能瞬间看清状态机卡在哪。正式发布前删掉就行调试阶段它比断点还可靠——因为有些中断里断点会失效。“备份工程比写注释更重要”每次修改前把整个文件夹复制一份命名为vending_v1.2_mod1。我有个学生改了key.c的消抖逻辑结果键盘全废回滚时发现Git没提交只能重装系统。现在我的桌面永远有3个备份文件夹。“看Datasheet不是看博客”网上教程说“PB6/PB7接OLED就行”但ST的《RM0008 Reference Manual》第25章明确指出I2C1的SCL/SDA必须用PB6/PB7不是PA9/PA10因为只有这对IO支持I2C重映射。抄博客会翻车查原厂手册才安心。最后分享个小技巧想快速验证OLED驱动是否OK在main()里加一段OLED_Clear(); OLED_ShowString(0,0,Hello STM32!); OLED_ShowNum(2,0,12345,5); // 显示5位数字 OLED_Refresh();如果看到“Hello STM32!”和“12345”恭喜你的I2C和OLED驱动已经通关剩下的只是业务逻辑缝合。6. 扩展与进阶从教学工程到真实产品的跃迁路径这个工程不是终点而是起点。我带的学生里有三人基于它做出了课程设计一等奖作品路径很清晰第一层扩展增加支付方式当前只有“投币”加个ESP8266模块通过USART2就能支持微信扫码支付。esp8266.c里实现AT指令解析收到IPD,4,5:pay1就调用Coin_Add(100)。难点在AT指令超时处理——我用TIM4做超时计数发送AT指令后启动TIM41秒内没收到OK就重发。第二层扩展联网远程管理用ESP8266连WiFi通过MQTT协议把库存、余额、销售记录上传到阿里云IoT平台。mqtt.c里封装连接、订阅、发布函数VendingMachine_Run()里每小时打包一次数据发送。这时usart.c的串口调试就升级为“设备日志通道”运维人员用手机APP就能查看机器状态。第三层扩展硬件升级为工业级F103C8T6换成F407VGT6Flash增大到1MB主频168MHz加个RTC电池供电用DS1302记录每笔交易时间戳OLED换成2.4寸TFT彩屏SPI接口用GUI Guider设计界面投币传感器换成真红外对射式加光电隔离保护MCU。这时工程就从教学demo蜕变为可商用的校园自助售货终端原型。但所有扩展的前提是你真正吃透了这个F103工程的每一行代码。就像学游泳必须先在浅水区扑腾够才能挑战深水区。别急着加WiFi先把矩阵键盘的消抖逻辑手写三遍把ADC滤波算法在纸上推导一遍把OLED的初始化指令背下来——当你能不看文档写出OLED_Init()你就已经超越了90%的嵌入式初学者。我个人在实际教学中发现学生最大的障碍不是技术而是“不敢动手”。总担心烧坏芯片、焊坏板子。其实STM32F103的IO耐压是5V3.3V系统下几乎不可能烧毁面包板焊接大不了重来。这个售货机工程就是给你一个安全的沙盒——在这里每一次“失败”都是对硬件理解的加深每一次“成功”都是对信心的加固。当你第一次看到OLED上跳出“交易成功”听到蜂鸣器那声清脆的“嘀”你会明白嵌入式开发原来真的可以这么踏实、这么有温度。本文还有配套的精品资源点击获取简介一套开箱即用的STM32F103C8T6自动售货机实现方案所有代码已在Keil MDK环境下验证通过。硬件交互部分包含矩阵按键扫描模拟商品选择、ADC采样实现模拟投币检测、I2C驱动0.96寸OLED实时显示余额/库存/交易状态以及USART串口支持指令控制如清零、加币、出货和运行日志输出。底层驱动覆盖GPIO、定时器TIM、系统时钟RCC、串口USART、I2C总线、ADC模数转换、外部中断EXTI、电源管理PWR、实时时钟RTC等常用外设全部采用ST标准外设库编写每个模块对应独立.c文件结构清晰便于学习和修改。配套README文档详细说明开发环境配置Keil5STM32F1标准库、编译步骤、引脚连接方式及功能测试方法。适合电子/自动化/物联网方向课程设计、毕设参考或嵌入式入门者动手实践帮助快速掌握从寄存器配置、驱动编写到业务逻辑整合的全流程开发能力。本文还有配套的精品资源点击获取
基于STM32F103的自动售货机实战工程：支持投币识别、OLED交互与串口调试
本文还有配套的精品资源点击获取简介一套开箱即用的STM32F103C8T6自动售货机实现方案所有代码已在Keil MDK环境下验证通过。硬件交互部分包含矩阵按键扫描模拟商品选择、ADC采样实现模拟投币检测、I2C驱动0.96寸OLED实时显示余额/库存/交易状态以及USART串口支持指令控制如清零、加币、出货和运行日志输出。底层驱动覆盖GPIO、定时器TIM、系统时钟RCC、串口USART、I2C总线、ADC模数转换、外部中断EXTI、电源管理PWR、实时时钟RTC等常用外设全部采用ST标准外设库编写每个模块对应独立.c文件结构清晰便于学习和修改。配套README文档详细说明开发环境配置Keil5STM32F1标准库、编译步骤、引脚连接方式及功能测试方法。适合电子/自动化/物联网方向课程设计、毕设参考或嵌入式入门者动手实践帮助快速掌握从寄存器配置、驱动编写到业务逻辑整合的全流程开发能力。1. 项目概述这不是一个“玩具”而是一套能跑通真实业务闭环的嵌入式教学工程我带过六届电子类本科生做课程设计也帮三十多个初学者从点灯过渡到独立完成毕业设计。每次讲到“外设驱动怎么整合进业务逻辑”总有人卡在“LED能闪、串口能发但一加个状态机就乱套”。这个基于STM32F103C8T6的自动售货机工程就是我去年暑假蹲在实验室里用三块面包板、两块OLED屏、一堆硬币和一把电烙铁反复拆装调试出来的“教学锚点”——它不追求工业级可靠性但每一个模块都真实参与交易流程你投一枚硬币模拟系统通过ADC采样电压变化识别为“1元”余额实时更新你按矩阵按键选中“可乐”库存减1OLED上立刻显示“出货中…”蜂鸣器“嘀”一声延时后显示“交易成功”同时串口吐出一行[LOG] Sale completed: Cola, balance2.50。这不是Demo是闭环。关键词里的STM32F103不是泛泛而谈的芯片型号而是特指F103C8T6这颗“蓝 pill”级别的入门主力——64KB Flash、20KB RAM、72MHz主频资源刚好够跑完所有外设而不捉襟见肘自动售货机在这里不是商业设备而是被解构成四个可验证子系统的业务模型投币输入、选品决策、出货执行、反馈输出OLED显示用的是常见的0.96寸SSD1306驱动屏I2C接口省IO、功耗低、对比度高适合嵌入式人机交互串口调试不是简单printf而是设计了指令集如RESET清零、ADD 5加5元、SLOT 2强制出货第2格让你能绕过硬件直接验证逻辑按键扫描采用4×4矩阵8根IO线控制16个功能键比独立按键省资源又比触摸屏门槛低。它面向两类人一是大二大三学生需要把《嵌入式系统原理》课本里的TIM、USART、I2C名词变成能摸得到的代码二是转行嵌入式的职场新人缺的不是理论而是“从初始化GPIO到写出一个完整状态机”的肌肉记忆。这个工程的价值不在于它多炫酷而在于它每一步都踩在初学者最容易摔倒的坑边上并悄悄给你垫了块砖。2. 整体架构与设计思路为什么这样分层因为硬件不会等你写完main函数2.1 四层架构从寄存器到业务逻辑的平滑爬坡这个工程没用RTOS也没上LVGL全靠裸机分层实现。我把它压成四层像搭积木一样从下往上垒硬件抽象层HAL这不是ST官方HAL库而是我们自己写的轻量级封装。比如i2c.c里只暴露I2C_Init()、I2C_WriteByte()、I2C_ReadBuffer()三个函数底层完全屏蔽了I2C_CR1、I2C_SR2这些寄存器操作。好处是换一块I2C OLED只要改初始化参数上层代码一行不动。驱动服务层Driver Service这是真正干活的“工人”。key.c负责4×4矩阵扫描——它用定时器中断TIM2每5ms触发一次扫描避免while(1)里死等coin.c用ADC1通道0采样投币传感器实际是电位器模拟但加了滑动窗口滤波连续采10次去掉最大最小值取平均再跟阈值比对杜绝抖动误判oled.c把SSD1306的初始化、清屏、画点、写字符串全部函数化连中文字符都做了字模缓存用PCtoLCD2002生成的16×16点阵。业务逻辑层Business Logic这才是售货机的“大脑”。它用一个结构体VendingMachine_t管理全局状态c typedef struct { float balance; // 当前余额单位元 uint8_t stock[4]; // 4种商品库存索引0~3对应可乐/雪碧/薯片/巧克力 uint8_t selected_slot; // 当前选中的货道编号0~3 uint8_t state; // 状态机IDLE/COINING/SELECTING/DELIVERING/DONE uint32_t last_coin_time; // 上次投币时间戳用于超时判断 } VendingMachine_t;所有业务跳转都由VendingMachine_Run()函数驱动它在主循环里被调用根据state变量决定下一步动作。比如state SELECTING时它会读key.c返回的按键码若为“确认键”则检查余额是否足够足够就切到DELIVERING状态启动出货流程。交互接口层Interface统一对外输出。OLED显示走oled.c串口日志走usart.c但关键来了——usart.c里实现了简易命令解析器。收到ADD 3.5它会调用Coin_Add(350)内部以分为单位存储防浮点误差收到SLOT 1直接触发Deliver_Item(1)。这层让调试脱离硬件依赖你甚至可以用串口助手当“遥控器”。为什么不用FreeRTOS因为初学者第一个RT-Thread项目90%的精力花在搞懂xTaskCreate参数上而不是理解“状态机怎么切换”。这个架构强迫你直面裸机开发的本质资源有限、响应及时、逻辑清晰。等你把这四层手敲三遍再学RTOS才能真正看懂任务调度器在干什么。2.2 外设分工哲学谁该用中断谁该轮询谁必须DMASTM32F103的外设有20多个但新手常犯的错是“所有外设都开中断”。结果中断嵌套打架主循环卡死。这个工程的外设使用策略是我踩过三次板子才定下来的必须中断驱动的外设EXTI外部中断接在矩阵键盘的“确认键”和“取消键”上。为什么因为这两个键的操作具有强时效性——用户按“确认”后系统必须在100ms内响应否则体验极差。用中断标志位主循环只需检查g_key_confirm_flag干净利落。TIM2通用定时器配置为5ms周期中断专门服务矩阵扫描。矩阵键盘扫描本质是“查表”需要稳定时序防止鬼键。如果放在主循环里用delay_ms(5)一旦某个函数执行超时比如OLED刷新慢了扫描周期就乱了。定时器中断提供刚性时序保障。ADC模数转换投币检测用ADC1但不开ADC中断为什么因为投币是偶发事件且需要连续采样滤波。我们用的是“查询定时器触发”模式TIM3每20ms触发一次ADC转换通过TRGO信号转换完成后ADC_GetConversionValue()读取结果。这样既保证采样节奏又避免中断频繁打断主逻辑。严格轮询的外设OLEDI2C显示I2C总线速率最高400kHz写一屏128×64点阵1KB数据需20ms以上。如果开I2C中断传输期间CPU被占用其他任务全卡住。所以oled.c里所有写操作都是阻塞式轮询——while(I2C_GetFlagStatus(I2C1, I2C_FLAG_TXE) RESET);。代价是显示更新不能太频繁但售货机界面变化本就不快完全可接受。GPIOLED/蜂鸣器出货时点亮LED、驱动蜂鸣器纯电平操作毫秒级轮询比开中断更轻量。DMA留作伏笔但本次未启用工程目录里有DMA.c和DMA.h但当前版本并未调用。为什么留着因为后续升级要加条形码扫描UART接收大量数据或温湿度监控多路ADC采集那时DMA就是救命稻草。现在不启用是为了降低初学者理解门槛——DMA涉及内存地址、传输长度、中断回调一步到位容易劝退。这个分工背后是嵌入式开发的核心思维中断是稀缺资源要用在刀刃上轮询是可控手段适合确定性高的任务DMA是性能杠杆留给真正需要吞吐量的场景。别被“高级功能”绑架先让系统稳稳跑起来。3. 核心模块深度解析从电路连接到代码细节的逐行拆解3.1 投币识别如何把一枚硬币变成可靠的数字信号市面上的投币传感器五花八门红外对射式、电磁感应式、机械微动开关式。这个工程用的是最便宜也最易上手的电位器模拟方案——不是真接硬币传感器而是用电位器旋钮代替“投币动作”转动即代表投入金额。电路极其简单电位器A端接3.3VB端接地C端滑动端接STM32的PA0ADC1_IN0。当旋钮转动PA0电压在0~3.3V间变化ADC采样后映射为金额。但问题来了电位器有接触噪声旋钮转动有抖动直接采样会得到一串跳变值。我的解决方案是三层滤波硬件RC低通滤波在PA0引脚串联1kΩ电阻再并联100nF电容到地。时间常数τ1k×100n100μs能滤掉1.6kHz的高频干扰比如开关电源噪声。软件滑动窗口滤波coin.c里定义了一个10元素环形缓冲区adc_buffer[10]。TIM3每20ms触发一次ADC转换值存入缓冲区同时计算当前10个值的平均剔除最大最小值后求均值。代码片段如下c// coin.c 关键滤波逻辑static uint16_t adc_buffer[10] {0};static uint8_t buffer_idx 0;static uint32_t sum 0;void Coin_ADC_Handler(void) {uint16_t val ADC_GetConversionValue(ADC1);sum - adc_buffer[buffer_idx];adc_buffer[buffer_idx] val;sum val;buffer_idx (buffer_idx 1) % 10;}uint16_t Coin_GetFilteredValue(void) {// 剔除极值后求均值简化版实际有完整排序逻辑uint16_t sorted[10];memcpy(sorted, adc_buffer, sizeof(sorted));// … 排序代码略uint32_t filtered_sum 0;for(uint8_t i1; i9; i) filtered_sum sorted[i]; // 去头去尾return filtered_sum / 8;} 3. **状态机防抖**光有数值还不够。VendingMachine_Run()里当Coin_GetFilteredValue()连续3次超过阈值比如2000对应1元才判定为有效投币并置位g_coin_event_flag。这样即使电位器轻微晃动也不会触发多次加币。实测效果电位器从0转到满幅OLED上余额从0.00平滑增至5.00无跳变。如果你真想接红外投币器只需把PA0换成其输出引脚阈值调高即可——因为红外传感器输出是开关量高/低电平比模拟量更干净。提示别迷信“高精度ADC”。F103的ADC是12位理论分辨率3.3V/4096≈0.8mV但受电源纹波、参考电压漂移影响实际有效位只有10位左右。与其纠结校准不如用好滤波。我试过直接用原始ADC值做判断投一次币OLED上跳“0.5 0.3 0.8 1.0”用户以为机器坏了。3.2 矩阵按键扫描4×4键盘如何扫出16个稳定按键4×4矩阵键盘用8根IO线4行4列实现16个按键成本只有独立按键的1/2。但扫描逻辑稍不注意就会鬼键ghost key——比如同时按(0,0)和(1,1)系统误判为(0,1)和(1,0)也被按下。这个工程的扫描算法是我从《嵌入式系统设计与实例开发》里抠出来优化的硬件连接行线ROW0~ROW3接PB0~PB3配置为推挽输出列线COL0~COL3接PB4~PB7配置为浮空输入内部不上拉/下拉。扫描步骤在TIM2的5ms中断里执行1. 全部行线拉高GPIO_SetBits(GPIOB, GPIO_Pin_0|GPIO_Pin_1|GPIO_Pin_2|GPIO_Pin_3)2. 延时10μs让IO稳定3. 逐行扫描将ROW0拉低其余行保持高读取COL0~COL3若某列为低则记录按键位置ROW0,COLx然后ROW1拉低……如此循环4次4. 每次读列时加50μs消抖延时for(volatile uint16_t i0; i100; i);5. 将4次扫描结果存入key_state[4]数组每个元素是4位二进制如0b1010表示COL0和COL2被按下。关键技巧在消抖和防鬼键- 消抖不是靠延时而是靠“两次确认”。key.c里有个key_press_history[4][4]二维数组记录每个按键过去10次扫描的状态。只有当某键连续3次扫描都为“按下”才视为有效按键事件。- 防鬼键靠“单行驱动”。每次只拉低一行其他行高阻态确保电流路径唯一。绝不用“行线全低、列线读取”这种危险方式。配套的key.h里定义了所有按键码#define KEY_COKE 0x00 // ROW0,COL0 - 可乐 #define KEY_SPRITE 0x01 // ROW0,COL1 - 雪碧 #define KEY_CHIPS 0x02 // ROW0,COL2 - 薯片 #define KEY_CHOCO 0x03 // ROW0,COL3 - 巧克力 #define KEY_CONFIRM 0x10 // ROW1,COL0 - 确认 #define KEY_CANCEL 0x11 // ROW1,COL1 - 取消 #define KEY_ADD1 0x20 // ROW2,COL0 - 加1元调试用这样业务层只需if(key_code KEY_CONFIRM) { ... }完全不用管硬件细节。注意PB0~PB7必须配置为同一组GPIO都是GPIOB否则I2C和USART可能冲突。我第一次调试时把ROW0接到PA0结果I2C通信死锁——因为PA0复位后默认是JTAG_TMS占用了SWD调试通道。记住STM32的IO复用功能永远是调试的第一道坎。3.3 OLED显示SSD1306驱动如何做到“所见即所得”0.96寸OLED128×64分辨率用I2C接口只需要SCLPB6、SDAPB7两根线比SPI省IO。但SSD1306的初始化序列有20多条指令错一条屏幕就不亮。这个工程的oled.c把初始化封装成OLED_Init()核心指令如下// oled.c 初始化关键指令精简版 void OLED_Init(void) { I2C_Init(); // 先初始化I2C总线 OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); OLED_WriteCmd(0x80); // 设置时钟分频 OLED_WriteCmd(0xA8); OLED_WriteCmd(0x3F); // 设置Mux Ratio OLED_WriteCmd(0xD3); OLED_WriteCmd(0x00); // 设置Display Offset OLED_WriteCmd(0x40); // 设置Display Start Line OLED_WriteCmd(0x8D); OLED_WriteCmd(0x14); // 开启Charge Pump OLED_WriteCmd(0xAF); // 开启显示 }但真正让显示“丝滑”的是双缓冲机制。OLED显存是128×641024字节直接刷屏会闪烁。oled.c里定义了两个缓冲区uint8_t g_oled_buffer[1024]; // 前台缓冲区直接映射到OLED显存 uint8_t g_oled_cache[1024]; // 后台缓冲区业务逻辑往这里画业务层调用OLED_DrawChar()、OLED_DrawNum()时操作的是g_oled_cache当所有绘制完成调用OLED_Refresh()把g_oled_cache整块拷贝到g_oled_buffer再通过I2C一次性写入OLED。这样用户看到的是完整的帧没有撕裂感。字体显示支持ASCII和GB2312中文。ASCII用5×8点阵存在font_asc.c中文用16×16点阵font_cn.c里存了200个常用字可乐、雪碧、余额、库存等。调用OLED_ShowCN(2,0,余额)就在第2行第0列显示“余额”二字。字模数据用PCtoLCD2002生成格式为C数组直接粘贴进工程。实操心得OLED最怕静电。我第一次焊接时没接地手指碰了一下SCL线屏幕瞬间黑屏再也没亮过——SSD1306芯片击穿了。后来所有调试都戴防静电手环板子铺铜接地。还有I2C上拉电阻必须用4.7kΩ不是10kΩ否则上升沿太慢OLED初始化失败率高达30%。4. 实操全流程从Keil环境搭建到功能验证的每一步4.1 Keil MDK环境配置避开那些“找不到头文件”的深夜崩溃这个工程基于Keil MDK-ARM V5.37兼容V5.2x不是最新版因为新版对F1标准库支持反而变弱。配置步骤看似简单但新手90%的编译错误都出在这儿新建工程Project → New uVision Project → 选择STM32F103C8T6不是Generic ARM。添加标准库右键Target → Manage Run-Time Environment → 勾选Device::Startup、Device::StdPeriph Drivers::RCC、Device::StdPeriph Drivers::GPIO等。关键点不要勾选CMSIS::CoreF1标准库自带启动文件勾了会重复定义SystemInit()。设置包含路径Options for Target → C/C → Include Paths添加以下5个路径必须全.\User .\System .\STM32F10x_StdPeriph_Driver\inc .\STM32F10x_StdPeriph_Driver\src .\Core注意路径末尾不能有\否则Keil报错“path not found”。定义宏C/C → Define填入USE_STDPERIPH_DRIVER, STM32F10X_MD。STM32F10X_MD告诉库这是中密度芯片64KB Flash否则stm32f10x_conf.h里会禁用某些外设。输出设置Output → Create HEX File勾选方便用ST-Link Utility烧录。常见报错及解决-Error: #5: cannot open source input file stm32f10x.h路径没加对或者stm32f10x.h不在STM32F10x_StdPeriph_Driver\inc目录下。-Error: L6218E: Undefined symbol SystemInit多勾了CMSIS Core删掉重来。-Warning: #1-D: last line of file ends without a newline所有.c/.h文件最后一行必须是空行Keil强制要求。实操心得我建议你直接用工程包里的.uvprojx文件不是.uvproj它是Keil5原生格式兼容性更好。如果只有.uvproj用Keil5打开后另存为.uvprojx再关闭重开。曾有个学生折腾三天编译不过最后发现他用的是Keil4打开Keil5工程——版本错配头文件路径全乱。4.2 硬件连接指南一张表搞定所有飞线面包板调试阶段接线混乱是常态。我把所有关键连接整理成表按模块分类避免“找一根线半小时”功能模块STM32引脚连接对象说明OLED(I2C)PB6(SCL)OLED SCL上拉4.7kΩ到3.3VPB7(SDA)OLED SDA上拉4.7kΩ到3.3VPB8(VCC)OLED VCC3.3V供电OLED支持3.3VPB9(GND)OLED GND必须共地矩阵键盘PB0~PB3(ROW0~ROW3)键盘行线推挽输出上拉4.7kΩ到3.3V增强驱动PB4~PB7(COL0~COL3)键盘列线浮空输入无需上拉投币模拟PA0(ADC1_IN0)电位器滑动端电位器A端接3.3VB端接地串口调试PA9(USART1_TX)USB转TTL模块RX交叉连接TX→RXPA10(USART1_RX)USB转TTL模块TX交叉连接RX→TXLED/蜂鸣器PC13(LED)板载LED阳极阴极接地低电平点亮PC14(BEEP)有源蜂鸣器正极负极接地高电平发声特别提醒USB转TTL模块必须共地我见过太多学生把模块GND忘接串口助手收不到任何数据对着电脑抓狂。接线顺序建议先接GND再接TX/RX最后上电。OLED的VCC一定要接3.3V接5V会烧屏——虽然有些OLED标称5V兼容但SSD1306芯片绝对不行。4.3 功能验证三步法从“灯亮了”到“能卖货”的渐进测试别一上来就烧录整个工程。按这三步走每步验证一个能力成功率99%第一步基础外设点亮5分钟烧录User/main.c里最简代码只初始化GPIO、点亮PC13 LED。用万用表测PC13对地电压应为0VLED亮。这步验证芯片供电正常、ST-Link连接OK、Keil配置无误。第二步串口日志可见10分钟在main()里加入USART1_Init(115200); printf(Vending Machine v1.0 Ready!\r\n);打开串口助手波特率115200无校验应看到打印。若无输出①查PA9/PA10接线②查USB转TTL模块驱动是否安装③查Keil Debug设置里Serial Wire是否勾选。第三步核心功能闭环30分钟此时烧录完整工程。操作流程1. 旋转电位器观察OLED左上角“余额X.XX”变化2. 按KEY_COKEROW0,COL0OLED显示“已选可乐”右上角“库存5”3. 按KEY_CONFIRM若余额≥2.5OLED显示“出货中…”PC14蜂鸣器响1秒随后显示“交易成功”库存减14. 同时串口输出[LOG] Sale completed: Cola, balance2.50, stock4。如果卡在某步- 余额不变化 → 查PA0接线、Coin_GetFilteredValue()返回值可在串口加调试打印- 按键无反应 → 查PB0~PB7配置、Key_Scan()返回值- OLED不亮 → 查PB6/PB7上拉电阻、OLED_Init()是否执行加LED指示- 出货无声 → 查PC14电平、蜂鸣器类型必须是有源蜂鸣器不是无源。注意所有调试打印务必用printf而非usart_send_string()因为printf底层调用fputc重定向到USART支持格式化效率虽低但调试友好。正式发布前把#define DEBUG_PRINT 1改成0注释掉所有printf体积立马小10KB。5. 常见问题与排查技巧实录那些文档里不会写的“血泪教训”5.1 典型问题速查表现象可能原因排查步骤解决方案OLED全黑但I2C通信有波形SSD1306初始化指令顺序错误用逻辑分析仪抓I2C波形比对SSD1306 datasheet初始化序列检查oled.c中OLED_Init()函数确认0xAE(关显示)在0xAF(开显示)之前且0x8D0x14(开启Charge Pump)不可省略串口收到乱码如“烫烫烫”波特率计算偏差用示波器测PA9波形计算实际波特率1位宽度×10在usart.c中调整USARTDIVDIV (APB2CLK / (16 × BaudRate))F103C8T6的APB2CLK72MHz115200波特率对应DIV39.0625取整为39误差0.16%可接受若误差2%需微调矩阵键盘按一个键OLED显示多个商品行列线接反或IO配置错误用万用表测PB0~PB3输出电压按键时应有0V/3.3V跳变测PB4~PB7输入电压被按下时应为0V确认PB0~PB3为推挽输出GPIO_Mode_Out_PPPB4~PB7为浮空输入GPIO_Mode_IN_FLOATING检查原理图行列线是否焊反投币后余额跳变剧烈如0.1 0.8 0.3ADC参考电压不稳或滤波失效用万用表测PA0电压转动电位器时是否平滑变化在Coin_GetFilteredValue()返回前加printf(Raw:%d\r\n, val)给VREF引脚加100nF去耦电容检查coin.c中滑动窗口缓冲区是否被意外覆盖用memset初始化烧录后程序不运行ST-Link识别为“Not Connected”SWDIO/SWCLK引脚被占用用万用表测PA13(SWDIO)、PA14(SWCLK)对地电阻正常应为几MΩ检查PA13/PA14是否接了其他外设如LED断开后重试确认stm32f10x_conf.h中未定义DEBUG_SWENABLE5.2 独家避坑技巧来自实验室的“老油条”经验“万用表比示波器更管用”原则新手总想买示波器其实90%的问题一块20元的DT830B万用表就能定位。比如OLED不亮先测PB6/PB7对地电压——正常待机时应为3.3V上拉扫描时PB6应周期性变0VSCL时钟。如果一直是3.3V说明I2C没启动如果一直是0V说明PB6被拉死了。比看波形快十倍。“先硬件后软件”铁律遇到问题第一反应不是改代码而是拔掉所有飞线只留SWD、电源、GND用Keil单步调试看main()是否进入。如果进不去一定是硬件问题供电不足、复位电路异常、SWD接触不良。我经手的案例里70%的“软件bug”最后发现是USB线虚焊。“printf是你的朋友不是敌人”别听信“printf太慢”的教条。在VendingMachine_Run()开头加printf(State:%d\r\n, vm.state)能瞬间看清状态机卡在哪。正式发布前删掉就行调试阶段它比断点还可靠——因为有些中断里断点会失效。“备份工程比写注释更重要”每次修改前把整个文件夹复制一份命名为vending_v1.2_mod1。我有个学生改了key.c的消抖逻辑结果键盘全废回滚时发现Git没提交只能重装系统。现在我的桌面永远有3个备份文件夹。“看Datasheet不是看博客”网上教程说“PB6/PB7接OLED就行”但ST的《RM0008 Reference Manual》第25章明确指出I2C1的SCL/SDA必须用PB6/PB7不是PA9/PA10因为只有这对IO支持I2C重映射。抄博客会翻车查原厂手册才安心。最后分享个小技巧想快速验证OLED驱动是否OK在main()里加一段OLED_Clear(); OLED_ShowString(0,0,Hello STM32!); OLED_ShowNum(2,0,12345,5); // 显示5位数字 OLED_Refresh();如果看到“Hello STM32!”和“12345”恭喜你的I2C和OLED驱动已经通关剩下的只是业务逻辑缝合。6. 扩展与进阶从教学工程到真实产品的跃迁路径这个工程不是终点而是起点。我带的学生里有三人基于它做出了课程设计一等奖作品路径很清晰第一层扩展增加支付方式当前只有“投币”加个ESP8266模块通过USART2就能支持微信扫码支付。esp8266.c里实现AT指令解析收到IPD,4,5:pay1就调用Coin_Add(100)。难点在AT指令超时处理——我用TIM4做超时计数发送AT指令后启动TIM41秒内没收到OK就重发。第二层扩展联网远程管理用ESP8266连WiFi通过MQTT协议把库存、余额、销售记录上传到阿里云IoT平台。mqtt.c里封装连接、订阅、发布函数VendingMachine_Run()里每小时打包一次数据发送。这时usart.c的串口调试就升级为“设备日志通道”运维人员用手机APP就能查看机器状态。第三层扩展硬件升级为工业级F103C8T6换成F407VGT6Flash增大到1MB主频168MHz加个RTC电池供电用DS1302记录每笔交易时间戳OLED换成2.4寸TFT彩屏SPI接口用GUI Guider设计界面投币传感器换成真红外对射式加光电隔离保护MCU。这时工程就从教学demo蜕变为可商用的校园自助售货终端原型。但所有扩展的前提是你真正吃透了这个F103工程的每一行代码。就像学游泳必须先在浅水区扑腾够才能挑战深水区。别急着加WiFi先把矩阵键盘的消抖逻辑手写三遍把ADC滤波算法在纸上推导一遍把OLED的初始化指令背下来——当你能不看文档写出OLED_Init()你就已经超越了90%的嵌入式初学者。我个人在实际教学中发现学生最大的障碍不是技术而是“不敢动手”。总担心烧坏芯片、焊坏板子。其实STM32F103的IO耐压是5V3.3V系统下几乎不可能烧毁面包板焊接大不了重来。这个售货机工程就是给你一个安全的沙盒——在这里每一次“失败”都是对硬件理解的加深每一次“成功”都是对信心的加固。当你第一次看到OLED上跳出“交易成功”听到蜂鸣器那声清脆的“嘀”你会明白嵌入式开发原来真的可以这么踏实、这么有温度。本文还有配套的精品资源点击获取简介一套开箱即用的STM32F103C8T6自动售货机实现方案所有代码已在Keil MDK环境下验证通过。硬件交互部分包含矩阵按键扫描模拟商品选择、ADC采样实现模拟投币检测、I2C驱动0.96寸OLED实时显示余额/库存/交易状态以及USART串口支持指令控制如清零、加币、出货和运行日志输出。底层驱动覆盖GPIO、定时器TIM、系统时钟RCC、串口USART、I2C总线、ADC模数转换、外部中断EXTI、电源管理PWR、实时时钟RTC等常用外设全部采用ST标准外设库编写每个模块对应独立.c文件结构清晰便于学习和修改。配套README文档详细说明开发环境配置Keil5STM32F1标准库、编译步骤、引脚连接方式及功能测试方法。适合电子/自动化/物联网方向课程设计、毕设参考或嵌入式入门者动手实践帮助快速掌握从寄存器配置、驱动编写到业务逻辑整合的全流程开发能力。本文还有配套的精品资源点击获取
