简介基于STM32的洗衣机控制工程源码面向嵌入式初学者与开发者完整展示了从底层驱动到应用逻辑的实现过程。压缩包共92个文件包含41个.h头文件、40个.c源文件以及Keil工程文件(.uvprojx/.uvoptx)、启动文件(.s)和列表文件等整体仅358KB麻雀虽小但结构完整。代码覆盖STM32F10x标准外设库的常用外设如定时器PWM电机调速、ADC水位检测、按键与红外遥控、LCD12864显示、蜂鸣器与LED指示等并配有delay/usart/sys基础模块便于直接移植或二次开发。通过分析工程目录和源码逻辑可以学习嵌入式C语言分层设计、中断服务程序编写、状态机调度及电源与安全保护策略。目前已有351人学习浏览适合课程设计、毕业设计或智能家电控制进阶练习。1. 这份洗衣机源码包先别急着编译拿到“基于STM32的洗衣机源代码.zip”这类工程包多数人第一反应是打开 Keil 点 Build看到 0 Error 就以为看懂了。但打开目录结构会发现这个工程不是随便拼出来的演示代码CORE 里放着 core_cm3.c 和 startup_stm32f10x_md.sUSRE 目录下有完整的外设驱动分组 SYSTEM 和 HARDWAREHARDWARE 里从 BEEP、LCD12864、BUTTON 到 SHUI、MOTOR、PWM 一应俱全。也就是说这是一个把按键输入、红外遥控、水位检测、电机调速、显示与提示全部串起来的完整控制固件。适合两类人一是课程设计或毕业设计选型 STM32F103 做家电控制的想抄一套规范的外设组织方式二是在做嵌入式产品 prototyping、需要参考前人对状态机和外设语义怎么划分的。洗衣机控制本身没有复杂算法真正的难点在于多个外设事件在时间轴上交错发生时如何保证状态切换不丢步、不误动作——这个工程恰好把答案摊开在了你面前。2. 工程骨架与启动流程先从 CORE 和 SYSTEM 读懂固件的“地基”2.1 启动文件选型对容量和中断向量的影响工程里出现的是 startup_stm32f10x_md.s这是中等密度Medium-densitySTM32F103 的启动文件对应 Flash 容量在 64KB 到 128KB 区间的型号典型芯片就是 STM32F103RBT6 或 C8T6。启动文件做的事并不神秘设置初始堆栈指针、调用 SystemInit 配置时钟、然后跳转到 main。但 md 这个后缀直接决定了中断向量表的长度如果你把工程移植到高密度HD芯片上比如 STM32F103ZET6却不替换启动文件和对应头文件中断向量错位会导致定时器或串口中断完全跑飞这在 stm32 开发环境切换时是很隐蔽的坑。常见的做法是直接从标准外设库的模板工程里复制对应型号的启动文件而不是手改向量表。; startup_stm32f10x_md.s 关键段示意 Stack_Size EQU 0x00000400 AREA STACK, NOINIT, READWRITE, ALIGN3 Stack_Mem SPACE Stack_Size __initial_sp AREA RESET, DATA, READONLY __Vectors DCD __initial_sp ; 栈顶地址 DCD Reset_Handler ; 复位向量 DCD NMI_Handler DCD HardFault_Handler ; ... 其余中断向量按手册顺序排列向量表不是随意排列的每一项都必须与 Cortex-M3 内核手册以及 STM32F103 参考手册的中断号顺序严格一致。启动文件里Stack_Size EQU 0x400定义了 1KB 栈空间如果你的程序里在中断回调函数中声明了大数组这个值不够会导致栈溢出现象往往是程序偶发跑飞但HardFault_Handler里却看不到有效信息。我一般会直接改成 0x1000用 4KB 栈给 LCD 缓冲区这类局部变量留余量代价只是 RAM 开销略微增加。2.2 SystemInit 与时钟树的配置逻辑USRE目录下的 system_stm32f10x.c 负责在进入 main 之前把系统时钟初始化好。标准外设库默认的宏定义是SYSCLK_FREQ_72MHz也就是 8MHz 外部晶振经过 PLL 倍频到 72MHz这是 STM32F103 的最高主频。但要注意如果板子上实际焊接的是 12MHz 晶振而没有修改HSE_VALUE这个宏串口波特率会整体偏移现象是能收到乱码、调试器时序错乱。判断是否踩了这类坑最直接的办法是在 main 开头读取RCC_GetClocksFreq返回的结构体。/* 在 main 初始化阶段打印当前时钟频率 */ RCC_ClocksTypeDef rcc_clocks; RCC_GetClocksFreq(rcc_clocks); printf(SYSCLK: %d Hz, HCLK: %d Hz, PCLK1: %d Hz\r\n, rcc_clocks.SYSCLK_Frequency, rcc_clocks.HCLK_Frequency, rcc_clocks.PCLK1_Frequency);代码背后的逻辑是SystemInit函数中通过RCC-CFGR和RCC-CR寄存器直接把时钟源切换到了 PLL所以你在main里看到的SystemInit()调用其实是启动文件在跳转前就已经执行过的。PCLK1 默认被分频为 36MHz这直接决定了 TIM2 等 APB1 总线上的定时器时钟基准洗衣机的节拍定时如果在这里配置错了后面所有延时和 PWM 频率都会跟着错。标准外设库在stm32f10x.h里还有assert_param参数检查宏调试阶段建议保持开启发布固件时再定义USE_FULL_ASSERT为 0 关闭否则每个外设函数调用都会多出参数合法性判断的指令开销。2.3 标准外设库 vs HAL 库这个工程为什么选前者工程里出现STM32F10x_FWLib目录内部按inc/src分开组织这确认了它用的是早期标准外设库Standard Peripheral Library而不是后来主推的 HAL 库。两者最大差别在于标准外设库把寄存器操作封装成XXX_Init、XXX_Cmd这类函数流程直观适合学习HAL 库引入句柄和回调机制同一套代码可以跨系列复用但中间层厚调试时跳进库源码容易迷路。对洗衣机这种外设固定、逻辑相对固定的应用标准外设库的代码密度和可读性其实是更优的选择。你在移植时如果发现网上教程用的是HAL_GPIO_WritePin不要直接照抄因为这两个库的 API 体系完全不兼容混用标准外设库头文件和 HAL 库源文件的结果就是编译报一堆未定义标识符。这个选择也影响后续调试标准外设库的.c文件数量多但函数短非常方便用 Keil 的Go To Definition逐个跳转检查寄存器配置。3. 用户交互层按键、红外、LCD12864 与蜂鸣器如何协同3.1 BUTTON 与 KEY 的分工差异工程里同时出现BUTTON和KEY两个目录这看起来像是重复实际上是两种输入设备BUTTON管理独立功能键如电源键、启动/暂停键KEY管理的是一组矩阵键盘或拨盘选择器用于选择洗涤模式。独立按键最常用的做法是 GPIO 上拉输入加软件消抖检测到低电平后延时 10ms 再确认确认是低电平才视为有效按下。矩阵键盘则需要靠行线和列线的分时扫描来识别键位代码上就是逐行拉低、读列线状态一旦检测到哪一列被拉低行列交叉点就是闭合按键。两者在中断使用上也不同独立按键可以接到 EXTI 外部中断而矩阵键盘更适合用定时器周期扫描因为它天然就是要轮询的。/* 独立按键消抖扫描典型代码 */ #define BUTTON_GPIO_PORT GPIOA #define BUTTON_GPIO_PIN GPIO_Pin_0 uint8_t Button_Scan(void) { static uint8_t key_buf 0; uint8_t current GPIO_ReadInputDataBit(BUTTON_GPIO_PORT, BUTTON_GPIO_PIN); /* 移位寄存器消抖连续多次读到0才认为按下 */ key_buf (key_buf 1) | current; if ((key_buf 0x07) 0x00) { return KEY_PRESSED; } return KEY_RELEASED; }这段扫描逻辑的巧妙之处在于不用 delay 阻塞等待而是用移位寄存器保留最近 3 次采样结果。只要按键在 3 个采样周期内都读到低电平就判定为稳定按下天然过滤了机械抖动。GPIO_ReadInputDataBit读取的是输入数据寄存器 IDR不是输出寄存器 ODR这是很多初学者混淆的地方——如果配置成推挽输出后再去读引脚状态读回来的永远是 ODR 里的值而不是真实的电平。把这个扫描函数放到 5ms 的定时器中断里调用整个系统的按键响应延迟不会超过 15ms体感上是“按下立刻就有反应”同时 CPU 不需要在 while 循环里原地等待消抖。3.2 LCD12864 的并口时序与显存管理LCD12864 在工程中由 HARDWARE 目录下的 LCD12864 模块驱动这类屏常见控制芯片是 ST7920支持 8 位并口和串口两种模式。工程里既然单独建了目录用的多半是 8 位并口RS数据/命令选择、RW读/写、EN使能各占一个 GPIODB0-DB7 占 8 个 GPIO。写命令和写数据的时序差异只在于 RS 电平的高低核心时序是拉低 EN、设置 RS/RW、在数据线上放数据、拉高 EN 保持一段时间、再拉低 EN。整个过程其实就是 ST7920 手册里那个写周期时序图。工程源码里一般会提供LCD12864_WriteCmd和LCD12864_WriteData两个基础函数上层显示菜单、水位进度条、错误代码都通过这两个函数拼出来。/* LCD12864 写命令基础函数 */ void LCD12864_WriteCmd(uint8_t cmd) { LCD12864_RS_LOW(); /* 命令模式 */ LCD12864_RW_LOW(); /* 写方向 */ LCD12864_EN_LOW(); GPIO_Write(GPIOC, cmd); /* 数据线接在GPIOC */ delay_us(1); LCD12864_EN_HIGH(); delay_us(2); LCD12864_EN_LOW(); }GPIO_Write(GPIOC, cmd)是标准外设库提供的一次性写 16 位端口函数它会把低 8 位数据放到 PC0-PC7 上所以硬件连线时必须保证这 8 根数据线按顺序接到同一个 GPIO 端口的连续引脚。如果 PCB 上数据线接得比较乱——比如 DB0 接到 PA3、DB1 接到 PA7——就不能用GPIO_Write一把梭只能逐位GPIO_WriteBit拼装扫描速度会下降但稳定性没问题。表扬一下这个工程把 LCD12864 单独拆成一个模块的做法后续要换 OLED 或者 1602只需要重写这个模块的接口函数上层菜单逻辑完全不用动。3.3 红外遥控与蜂鸣器的配合反馈一定要即时Hongwai模块负责红外接收常见接收头是 HS0038B解调后的信号直接输出到 STM32 的输入捕获引脚。NEC 协议每条帧包含引导码、地址码、数据码和取反码STM32 侧一般用定时器的输入捕获模式测量脉冲宽度高电平 900us低电平 450us 是逻辑 0高电平 900us低电平 1.7ms 是逻辑 1。把这个模块放进洗衣机的意义在于人在远处可以遥控启动或暂停不用弯腰去按面板按键。但遥控触发的东西比如急停如果没有任何反馈用户无从判断是否生效所以工程里把 BEEP 蜂鸣器和红外绑定在同一个事件分支里。/* 红外遥控键值处理每次有效按键都伴随蜂鸣器反馈 */ void Hongwai_HandleKey(uint8_t key_code) { switch (key_code) { case IR_CODE_START: WashingMachine_Start(); BEEP_Tone(800, 50); /* 蜂鸣器响50ms */ break; case IR_CODE_PAUSE: WashingMachine_Pause(); BEEP_Tone(400, 100); break; default: break; } }蜂鸣器响的频率和时长本身也是信息启动音调高且短促暂停音调低且略长。用户即使不盯着屏幕也能通过声音判断指令是否被正确解析。这个细节在课程设计里可能被当成“锦上添花”但真实家电产品里声音反馈是必选项——洗衣机运行时的音乐、故障时的蜂鸣都是在用声音建立人和机器的沟通协议。BEEP 模块封装的是 PWM 输出控制如果是无源蜂鸣器必须给一定频率的方波才能发声有源蜂鸣器直接给高电平就行这个差异在前者需要占用一个定时器通道后者只占一个普通 GPIO工程代码里如果看到TIM_SetCompare相关调用说明用的就是无源蜂鸣器加 PWM 驱动。4. 洗涤控制核心水位检测、电机 PWM 调速与状态机调度4.1 SHUI 水位传感器的两种接入语义SHUI模块负责水位检测洗衣机里常见两种方案一种是开关量水位传感器水位到达指定高度后内部干簧管或霍尔元件动作输出电平跳变STM32 通过 GPIO 读取电平就能判断“水够了没”另一种是气压式传感器加 ADC 采样输出模拟电压随水位连续变化这样能精确控制进水到任意位置。从工程内SHUI目录和整体代码规模看开关量的可能性更大。开关量的好处是逻辑简单、可靠性高缺点是只能停在固定水位档位。/* 开关量水位检测读取水位开关状态 */ uint8_t SHUI_IsLevelReached(void) { if (GPIO_ReadInputDataBit(SHUI_GPIO_PORT, SHUI_GPIO_PIN) WATER_LEVEL_HIGH) { return 1; } return 0; }WATER_LEVEL_HIGH这个宏在shui.h里定义它表示外部电路是“高电平代表水位到位”还是“低电平代表水位到位”。不同厂家的水位开关输出极性不同有些是到位拉低有些是到位拉高拿到代码后第一件事就是查这个宏的默认值是否跟你的硬件一致。如果极性反了洗衣机进满水后 MCU 仍判断“水位不足”进水阀会一直开着溢水事故就是这么来的。除了电平极性还要注意水位开关有没有上拉或下拉电阻STM32 内部虽然可以配置上拉/下拉但外部加上 10kΩ 电阻能让信号更稳定尤其是在进水阀启动瞬间、电机干扰最大的时候。4.2 TIM2 的节拍作用与系统心跳TIM2在工程里承担的不只是延时功能更核心的角色是系统心跳。典型配置是让 TIM2 产生 1ms 中断在中断里累加一个tick_ms全局变量再基于它派生出按键扫描周期、LED 闪烁周期、洗涤倒计时、脱水剩余时间等所有软件定时。这样做的好处是所有时间基准统一、无阻塞等待主循环可以自由地在各状态间跳转而不担心“卡死在某段延时里”。/* TIM2 配置为 1ms 中断节拍 */ void TIM2_Init(void) { TIM_TimeBaseInitTypeDef TIM_InitStruct; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); TIM_InitStruct.TIM_Prescaler 36000 - 1; /* 36MHz / 36000 1kHz */ TIM_InitStruct.TIM_Period 1000 - 1; /* 1kHz / 1000 1Hz中断 */ TIM_InitStruct.TIM_ClockDivision TIM_CKD_DIV1; TIM_InitStruct.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_InitStruct); TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE); TIM_Cmd(TIM2, ENABLE); }预分频器 36000 减 1 是因为 STM32 的定时器计数是从 0 开始的实际分频系数是 36000。PCLK1 固定 36MHz 时36MHz/360001kHz也就是计数器每秒数 1000 个脉冲自动重装载值 1000-1 意味着每数 1000 下产生一次更新事件正好 1ms。如果系统时钟回路有改动这套参数必然要跟着重算否则所有软件定时会整体漂移。在stm32f10x_it.c的TIM2_IRQHandler里标准的动作是检测更新中断标志、清除标志、累加tick_ms然后调用周期性任务函数。4.3 MOTOR 与 PWM电机调速和换向的实现方式MOTOR目录与PWM目录通常是一起出现的PWM负责产生可调占空比的方波MOTOR负责电机使能、方向控制和刹车。工程里常见的方案是PWM 由高级定时器 TIM1 或通用定时器 TIM3 的某个通道输出而方向控制依赖两个 GPIO 接电机驱动芯片如 L298N 或 BTS7960通过 IN1/IN2 的电平组合决定电机正转、反转还是刹停。洗涤和脱水对电机的需求不同洗涤时要反复正反转转速低、力矩大脱水时单向高速旋转要求 PWM 占空比打到接近 100%。/* 电机换向与调速控制函数 */ void MOTOR_SetSpeed(uint8_t direction, uint16_t duty) { if (duty 1000) { duty 1000; /* 占空比上限保护 */ } switch (direction) { case MOTOR_FORWARD: MOTOR_IN1_HIGH(); MOTOR_IN2_LOW(); break; case MOTOR_REVERSE: MOTOR_IN1_LOW(); MOTOR_IN2_HIGH(); break; case MOTOR_STOP: MOTOR_IN1_LOW(); MOTOR_IN2_LOW(); /* 自由停车电机靠惯性滑行 */ break; } TIM_SetCompare1(MOTOR_PWM_TIM, duty); }TIM_SetCompare1设置的是通道 1 的比较值它跟定时器自动重装载值TIM_Period的比例就是实际输出的占空比。如果定时器周期设置为 1000那比较值 700 就是 70% 占空比。需要注意MOTOR_STOP分支里 IN1/IN2 同时拉低是“自由停车”电机靠摩擦和负载自然减速而如果两个引脚同时拉高则是“刹车制动”电机立刻停止转动。洗衣机脱水结束时需要用刹车方式快速停住否则惯性会让内筒继续旋转好一阵子用户在开门时可能被带动的水流甩到。方向切换之间最好加一点死区延时——正转切换到反转时先让电机自由停车 200ms 再反转不然瞬间反向电流冲击可能烧驱动管这是电机驱动电路设计里最常见的坑。4.4 洗涤流程状态机不要让 if-else 堆出宇宙洗衣机控制本质是一个有限状态机。状态集合大概是待机 → 进水 → 洗涤 → 排水 → 脱水 → 结束外加暂停和故障两个旁路状态。工程里如果用大量if嵌套判断“当前处于什么阶段、下一步该干什么”代码会迅速膨胀到不可维护。合理的做法是把状态用枚举变量表示在switch-case里按状态处理事件则放在统一的入口函数里派发。typedef enum { STATE_IDLE, STATE_FILL, STATE_WASH, STATE_DRAIN, STATE_SPIN, STATE_DONE, STATE_FAULT } WashState_t; static WashState_t current_state STATE_IDLE; void WashingMachine_Tick(void) { switch (current_state) { case STATE_FILL: if (SHUI_IsLevelReached()) { MOTOR_SetSpeed(MOTOR_FORWARD, WASH_SPEED_DUTY); current_state STATE_WASH; } break; case STATE_WASH: /* 通过 tick_ms 计数实现正反转交替 */ if (get_tick_ms() - wash_start_ms WASH_REVERSE_INTERVAL_MS) { MOTOR_SetSpeed(MOTOR_REVERSE, WASH_SPEED_DUTY); wash_start_ms get_tick_ms(); } break; case STATE_DRAIN: /* 排水阀打开等待排空 */ break; default: break; } }这个函数每 1ms 被 TIM2 中断调用一次get_tick_ms()返回系统当前毫秒数与wash_start_ms的差值就是区间长度。状态机的好处是任何时刻系统都明确知道自己处于哪个阶段外设动作与阶段绑定。异常处理逻辑也变得更清晰——比如排水阶段发现水位没有下降可以直接跳入STATE_FAULT而不是在多重 if 嵌套里寻找是哪一层出了问题。脱水和排水共用同一个水泵电机时状态切换还要关注电机驱动板是否支持双向控制不支持的话只能用两个继电器切换这在MOTOR模块的初始化注释里一般会写明。5. 中断、看门狗与低功耗让洗衣机连续跑上十年不失控5.1 stm32f10x_it.c 中的中断优先级分配stm32f10x_it.c是所有中断处理函数的集中地工程跑起来后这里就是系统的“神经中枢”。洗衣机场景里至少有三个中断会同时活跃TIM2 的 1ms 节拍、串口接收中断如果接了调试模块、以及按键或红外触发的 EXTI 外部中断。中断优先级规划设计不好就会出现“红外按键按下没反应但程序没死”这类诡异现象。Cortex-M3 内核支组优先级和子优先级STM32F103 通过NVIC_PriorityGroupConfig来分组。常见做法是采用NVIC_PriorityGroup_2高 2 位是抢占优先级低 2 位是子优先级。/* 中断优先级配置示例 */ NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); NVIC_InitTypeDef nvic_config; nvic_config.NVIC_IRQChannel TIM2_IRQn; nvic_config.NVIC_IRQChannelPreemptionPriority 0; /* 最高抢占优先级 */ nvic_config.NVIC_IRQChannelSubPriority 0; nvic_config.NVIC_IRQChannelCmd ENABLE; NVIC_Init(nvic_config); nvic_config.NVIC_IRQChannel USART1_IRQn; nvic_config.NVIC_IRQChannelPreemptionPriority 1; nvic_config.NVIC_IRQChannelSubPriority 0; NVIC_Init(nvic_config);TIM2 的抢占优先级设为 0 最高是为了保证系统节拍的抖动尽可能小——如果节拍被其他中断延迟所有基于它的软件定时和状态机都会产生时间漂移。串口调试中断优先级低一档因为串口数据丢失一帧不影响设备安全而节拍乱了整个控制逻辑就乱了。红外和按键的中断优先级再低一级或干脆用轮询都没问题。一组经验法则时间关键型中断抢占优先级最高通信中断其次非安全相关的低速事件最后。5.2 独立看门狗与窗口看门狗的取舍洗衣机的使用环境相对恶劣电网波动、电机启停浪涌、潮湿空气都可能造成 MCU 程序跑飞。IWDG独立看门狗是最常用的保命手段——它由 LSI 低速内部时钟驱动一旦启动就无法用软件停止必须在规定时间内“喂狗”否则强制复位。但喂狗的位置不能放在主循环末尾就完事因为如果某个外设初始化卡死主循环可能永远执行不到末尾。正确的做法是在状态机的主 Tick 函数末尾喂狗这样只要系统心跳还在跳就说明核心调度没有死锁。/* 独立看门狗初始化与喂狗 */ void IWDG_Init(void) { IWDG_WriteAccessCmd(IWDG_WriteAccess_Enable); IWDG_SetPrescaler(IWDG_Prescaler_64); /* 分频64 */ IWDG_SetReload(4095); /* 约1秒超时 */ IWDG_ReloadCounter(); IWDG_Enable(); } void WashingMachine_Tick(void) { /* 状态机核心逻辑 */ // ... IWDG_ReloadCounter(); /* 喂狗 */ }IWDG_SetPrescaler(IWDG_Prescaler_64)加IWDG_SetReload(4095)的组合在 LSI 约 40kHz 下能算出接近 1 秒的超时窗口。这里有一个反直觉的经验复位不是越频繁越好。如果看门狗超时设置得太短比如 100ms一旦某个中断长时间关中断执行代码看门狗会误复位而且这个复位是周期性的现象像是“设备反复重启”。超时时间要大于系统最长的一条完整任务链路耗时同时小于用户能接受的无响应时间洗衣机场景下 500ms 到 1s 是合理区间。注意调试时如果开了 IWDG遇到断点停下来CPU 停住不再喂狗几秒后芯片就会复位这让在线调试变得很痛苦。工程里一般用宏开关控制是否启动看门狗调试阶段把它关掉发布前再打开。5.3 低功耗与掉电保护不能只靠主芯片省电洗衣机不是电池设备不需要深度睡眠但电源管理仍然要做待机时关闭不必要的外设时钟、LED 熄灯、LCD 关闭背光让系统待机功耗降到 mA 级。工程里通过RCC_APB2PeriphClockCmd和RCC_APB1PeriphClockCmd按需开启外设时钟这是标准外设库实现低功耗的基础手段。真正要重点关注的是掉电保护洗涤过程中如果断电重新上电后洗衣机应该恢复到一个安全状态而不是继续执行之前的转动指令。常见做法是在 Flash 里保存当前状态机和运行阶段上电初始化时读取这个标志决定是回到待机还是回到上次的排水阶段。这个细节工程里未必实现了但这是从课程设计走向产品化的关键一步。6. 验证三板斧与移植到自有板卡的调试技巧拿到这个工程不要直接拿去烧录——先做三件事。第一用 ST-Link 或者 J-Link 连接目标板打开 Keil 的 Debug 模式在LCD12864_Init和MOTOR_SetSpeed这两处打上断点确认初始化顺序和外围电路没有冲突。第二把 USART1 重定向 printf 到串口助手波特率设 115200在状态机每个分支切换处打印一行状态日志比如[FILL] - [WASH]。第三用示波器或逻辑分析仪抓 PWM 输出脚验证占空比是否随TIM_SetCompare1的调用实时变化——如果没有波形优先检查定时器的 GPIO 复用功能配置是否开启。移植到自己的板卡时第一件事就是对照原理图逐一核对工程里的 GPIO 宏定义stm32f10x.h里的引脚映射表是查错的重要依据初始化串口时开启的是RCC_APB2Periph_USART1还是RCC_APB1Periph_USART2对应的时钟总线完全不同写错直接进HardFault。如果下载时报Error: No STM32 Target Found先在 Keil 的 Settings 里检查 SWD 模式下是否识别到芯片 ID识别不到就按住复位键再点下载用这个“时序错位法”绕过目标芯片的读保护判断。固件最终发布前用 ST-Link Utility 打开读保护 Level 1防止他人直接从芯片 Flash 里把源代码倒出来——这对产品化阶段的固件保护是最后一层也是最直接的护栏。串口调试和 PWM 波形观测都验证通过后再装上真实水位传感器和电机以 3 分钟一个周期的节奏连续跑 20 次统计有没有卡死、误停和通信错误这个压力测试数据比任何代码评审都更能说明问题。本文还有配套的精品资源点击获取 
长河君 · 2026/9/16 15:02:00 · 阅读 1.2k STM32洗衣机源码工程解析：从外设驱动到状态机设计
简介基于STM32的洗衣机控制工程源码面向嵌入式初学者与开发者完整展示了从底层驱动到应用逻辑的实现过程。压缩包共92个文件包含41个.h头文件、40个.c源文件以及Keil工程文件(.uvprojx/.uvoptx)、启动文件(.s)和列表文件等整体仅358KB麻雀虽小但结构完整。代码覆盖STM32F10x标准外设库的常用外设如定时器PWM电机调速、ADC水位检测、按键与红外遥控、LCD12864显示、蜂鸣器与LED指示等并配有delay/usart/sys基础模块便于直接移植或二次开发。通过分析工程目录和源码逻辑可以学习嵌入式C语言分层设计、中断服务程序编写、状态机调度及电源与安全保护策略。目前已有351人学习浏览适合课程设计、毕业设计或智能家电控制进阶练习。1. 这份洗衣机源码包先别急着编译拿到“基于STM32的洗衣机源代码.zip”这类工程包多数人第一反应是打开 Keil 点 Build看到 0 Error 就以为看懂了。但打开目录结构会发现这个工程不是随便拼出来的演示代码CORE 里放着 core_cm3.c 和 startup_stm32f10x_md.sUSRE 目录下有完整的外设驱动分组 SYSTEM 和 HARDWAREHARDWARE 里从 BEEP、LCD12864、BUTTON 到 SHUI、MOTOR、PWM 一应俱全。也就是说这是一个把按键输入、红外遥控、水位检测、电机调速、显示与提示全部串起来的完整控制固件。适合两类人一是课程设计或毕业设计选型 STM32F103 做家电控制的想抄一套规范的外设组织方式二是在做嵌入式产品 prototyping、需要参考前人对状态机和外设语义怎么划分的。洗衣机控制本身没有复杂算法真正的难点在于多个外设事件在时间轴上交错发生时如何保证状态切换不丢步、不误动作——这个工程恰好把答案摊开在了你面前。2. 工程骨架与启动流程先从 CORE 和 SYSTEM 读懂固件的“地基”2.1 启动文件选型对容量和中断向量的影响工程里出现的是 startup_stm32f10x_md.s这是中等密度Medium-densitySTM32F103 的启动文件对应 Flash 容量在 64KB 到 128KB 区间的型号典型芯片就是 STM32F103RBT6 或 C8T6。启动文件做的事并不神秘设置初始堆栈指针、调用 SystemInit 配置时钟、然后跳转到 main。但 md 这个后缀直接决定了中断向量表的长度如果你把工程移植到高密度HD芯片上比如 STM32F103ZET6却不替换启动文件和对应头文件中断向量错位会导致定时器或串口中断完全跑飞这在 stm32 开发环境切换时是很隐蔽的坑。常见的做法是直接从标准外设库的模板工程里复制对应型号的启动文件而不是手改向量表。; startup_stm32f10x_md.s 关键段示意 Stack_Size EQU 0x00000400 AREA STACK, NOINIT, READWRITE, ALIGN3 Stack_Mem SPACE Stack_Size __initial_sp AREA RESET, DATA, READONLY __Vectors DCD __initial_sp ; 栈顶地址 DCD Reset_Handler ; 复位向量 DCD NMI_Handler DCD HardFault_Handler ; ... 其余中断向量按手册顺序排列向量表不是随意排列的每一项都必须与 Cortex-M3 内核手册以及 STM32F103 参考手册的中断号顺序严格一致。启动文件里Stack_Size EQU 0x400定义了 1KB 栈空间如果你的程序里在中断回调函数中声明了大数组这个值不够会导致栈溢出现象往往是程序偶发跑飞但HardFault_Handler里却看不到有效信息。我一般会直接改成 0x1000用 4KB 栈给 LCD 缓冲区这类局部变量留余量代价只是 RAM 开销略微增加。2.2 SystemInit 与时钟树的配置逻辑USRE目录下的 system_stm32f10x.c 负责在进入 main 之前把系统时钟初始化好。标准外设库默认的宏定义是SYSCLK_FREQ_72MHz也就是 8MHz 外部晶振经过 PLL 倍频到 72MHz这是 STM32F103 的最高主频。但要注意如果板子上实际焊接的是 12MHz 晶振而没有修改HSE_VALUE这个宏串口波特率会整体偏移现象是能收到乱码、调试器时序错乱。判断是否踩了这类坑最直接的办法是在 main 开头读取RCC_GetClocksFreq返回的结构体。/* 在 main 初始化阶段打印当前时钟频率 */ RCC_ClocksTypeDef rcc_clocks; RCC_GetClocksFreq(rcc_clocks); printf(SYSCLK: %d Hz, HCLK: %d Hz, PCLK1: %d Hz\r\n, rcc_clocks.SYSCLK_Frequency, rcc_clocks.HCLK_Frequency, rcc_clocks.PCLK1_Frequency);代码背后的逻辑是SystemInit函数中通过RCC-CFGR和RCC-CR寄存器直接把时钟源切换到了 PLL所以你在main里看到的SystemInit()调用其实是启动文件在跳转前就已经执行过的。PCLK1 默认被分频为 36MHz这直接决定了 TIM2 等 APB1 总线上的定时器时钟基准洗衣机的节拍定时如果在这里配置错了后面所有延时和 PWM 频率都会跟着错。标准外设库在stm32f10x.h里还有assert_param参数检查宏调试阶段建议保持开启发布固件时再定义USE_FULL_ASSERT为 0 关闭否则每个外设函数调用都会多出参数合法性判断的指令开销。2.3 标准外设库 vs HAL 库这个工程为什么选前者工程里出现STM32F10x_FWLib目录内部按inc/src分开组织这确认了它用的是早期标准外设库Standard Peripheral Library而不是后来主推的 HAL 库。两者最大差别在于标准外设库把寄存器操作封装成XXX_Init、XXX_Cmd这类函数流程直观适合学习HAL 库引入句柄和回调机制同一套代码可以跨系列复用但中间层厚调试时跳进库源码容易迷路。对洗衣机这种外设固定、逻辑相对固定的应用标准外设库的代码密度和可读性其实是更优的选择。你在移植时如果发现网上教程用的是HAL_GPIO_WritePin不要直接照抄因为这两个库的 API 体系完全不兼容混用标准外设库头文件和 HAL 库源文件的结果就是编译报一堆未定义标识符。这个选择也影响后续调试标准外设库的.c文件数量多但函数短非常方便用 Keil 的Go To Definition逐个跳转检查寄存器配置。3. 用户交互层按键、红外、LCD12864 与蜂鸣器如何协同3.1 BUTTON 与 KEY 的分工差异工程里同时出现BUTTON和KEY两个目录这看起来像是重复实际上是两种输入设备BUTTON管理独立功能键如电源键、启动/暂停键KEY管理的是一组矩阵键盘或拨盘选择器用于选择洗涤模式。独立按键最常用的做法是 GPIO 上拉输入加软件消抖检测到低电平后延时 10ms 再确认确认是低电平才视为有效按下。矩阵键盘则需要靠行线和列线的分时扫描来识别键位代码上就是逐行拉低、读列线状态一旦检测到哪一列被拉低行列交叉点就是闭合按键。两者在中断使用上也不同独立按键可以接到 EXTI 外部中断而矩阵键盘更适合用定时器周期扫描因为它天然就是要轮询的。/* 独立按键消抖扫描典型代码 */ #define BUTTON_GPIO_PORT GPIOA #define BUTTON_GPIO_PIN GPIO_Pin_0 uint8_t Button_Scan(void) { static uint8_t key_buf 0; uint8_t current GPIO_ReadInputDataBit(BUTTON_GPIO_PORT, BUTTON_GPIO_PIN); /* 移位寄存器消抖连续多次读到0才认为按下 */ key_buf (key_buf 1) | current; if ((key_buf 0x07) 0x00) { return KEY_PRESSED; } return KEY_RELEASED; }这段扫描逻辑的巧妙之处在于不用 delay 阻塞等待而是用移位寄存器保留最近 3 次采样结果。只要按键在 3 个采样周期内都读到低电平就判定为稳定按下天然过滤了机械抖动。GPIO_ReadInputDataBit读取的是输入数据寄存器 IDR不是输出寄存器 ODR这是很多初学者混淆的地方——如果配置成推挽输出后再去读引脚状态读回来的永远是 ODR 里的值而不是真实的电平。把这个扫描函数放到 5ms 的定时器中断里调用整个系统的按键响应延迟不会超过 15ms体感上是“按下立刻就有反应”同时 CPU 不需要在 while 循环里原地等待消抖。3.2 LCD12864 的并口时序与显存管理LCD12864 在工程中由 HARDWARE 目录下的 LCD12864 模块驱动这类屏常见控制芯片是 ST7920支持 8 位并口和串口两种模式。工程里既然单独建了目录用的多半是 8 位并口RS数据/命令选择、RW读/写、EN使能各占一个 GPIODB0-DB7 占 8 个 GPIO。写命令和写数据的时序差异只在于 RS 电平的高低核心时序是拉低 EN、设置 RS/RW、在数据线上放数据、拉高 EN 保持一段时间、再拉低 EN。整个过程其实就是 ST7920 手册里那个写周期时序图。工程源码里一般会提供LCD12864_WriteCmd和LCD12864_WriteData两个基础函数上层显示菜单、水位进度条、错误代码都通过这两个函数拼出来。/* LCD12864 写命令基础函数 */ void LCD12864_WriteCmd(uint8_t cmd) { LCD12864_RS_LOW(); /* 命令模式 */ LCD12864_RW_LOW(); /* 写方向 */ LCD12864_EN_LOW(); GPIO_Write(GPIOC, cmd); /* 数据线接在GPIOC */ delay_us(1); LCD12864_EN_HIGH(); delay_us(2); LCD12864_EN_LOW(); }GPIO_Write(GPIOC, cmd)是标准外设库提供的一次性写 16 位端口函数它会把低 8 位数据放到 PC0-PC7 上所以硬件连线时必须保证这 8 根数据线按顺序接到同一个 GPIO 端口的连续引脚。如果 PCB 上数据线接得比较乱——比如 DB0 接到 PA3、DB1 接到 PA7——就不能用GPIO_Write一把梭只能逐位GPIO_WriteBit拼装扫描速度会下降但稳定性没问题。表扬一下这个工程把 LCD12864 单独拆成一个模块的做法后续要换 OLED 或者 1602只需要重写这个模块的接口函数上层菜单逻辑完全不用动。3.3 红外遥控与蜂鸣器的配合反馈一定要即时Hongwai模块负责红外接收常见接收头是 HS0038B解调后的信号直接输出到 STM32 的输入捕获引脚。NEC 协议每条帧包含引导码、地址码、数据码和取反码STM32 侧一般用定时器的输入捕获模式测量脉冲宽度高电平 900us低电平 450us 是逻辑 0高电平 900us低电平 1.7ms 是逻辑 1。把这个模块放进洗衣机的意义在于人在远处可以遥控启动或暂停不用弯腰去按面板按键。但遥控触发的东西比如急停如果没有任何反馈用户无从判断是否生效所以工程里把 BEEP 蜂鸣器和红外绑定在同一个事件分支里。/* 红外遥控键值处理每次有效按键都伴随蜂鸣器反馈 */ void Hongwai_HandleKey(uint8_t key_code) { switch (key_code) { case IR_CODE_START: WashingMachine_Start(); BEEP_Tone(800, 50); /* 蜂鸣器响50ms */ break; case IR_CODE_PAUSE: WashingMachine_Pause(); BEEP_Tone(400, 100); break; default: break; } }蜂鸣器响的频率和时长本身也是信息启动音调高且短促暂停音调低且略长。用户即使不盯着屏幕也能通过声音判断指令是否被正确解析。这个细节在课程设计里可能被当成“锦上添花”但真实家电产品里声音反馈是必选项——洗衣机运行时的音乐、故障时的蜂鸣都是在用声音建立人和机器的沟通协议。BEEP 模块封装的是 PWM 输出控制如果是无源蜂鸣器必须给一定频率的方波才能发声有源蜂鸣器直接给高电平就行这个差异在前者需要占用一个定时器通道后者只占一个普通 GPIO工程代码里如果看到TIM_SetCompare相关调用说明用的就是无源蜂鸣器加 PWM 驱动。4. 洗涤控制核心水位检测、电机 PWM 调速与状态机调度4.1 SHUI 水位传感器的两种接入语义SHUI模块负责水位检测洗衣机里常见两种方案一种是开关量水位传感器水位到达指定高度后内部干簧管或霍尔元件动作输出电平跳变STM32 通过 GPIO 读取电平就能判断“水够了没”另一种是气压式传感器加 ADC 采样输出模拟电压随水位连续变化这样能精确控制进水到任意位置。从工程内SHUI目录和整体代码规模看开关量的可能性更大。开关量的好处是逻辑简单、可靠性高缺点是只能停在固定水位档位。/* 开关量水位检测读取水位开关状态 */ uint8_t SHUI_IsLevelReached(void) { if (GPIO_ReadInputDataBit(SHUI_GPIO_PORT, SHUI_GPIO_PIN) WATER_LEVEL_HIGH) { return 1; } return 0; }WATER_LEVEL_HIGH这个宏在shui.h里定义它表示外部电路是“高电平代表水位到位”还是“低电平代表水位到位”。不同厂家的水位开关输出极性不同有些是到位拉低有些是到位拉高拿到代码后第一件事就是查这个宏的默认值是否跟你的硬件一致。如果极性反了洗衣机进满水后 MCU 仍判断“水位不足”进水阀会一直开着溢水事故就是这么来的。除了电平极性还要注意水位开关有没有上拉或下拉电阻STM32 内部虽然可以配置上拉/下拉但外部加上 10kΩ 电阻能让信号更稳定尤其是在进水阀启动瞬间、电机干扰最大的时候。4.2 TIM2 的节拍作用与系统心跳TIM2在工程里承担的不只是延时功能更核心的角色是系统心跳。典型配置是让 TIM2 产生 1ms 中断在中断里累加一个tick_ms全局变量再基于它派生出按键扫描周期、LED 闪烁周期、洗涤倒计时、脱水剩余时间等所有软件定时。这样做的好处是所有时间基准统一、无阻塞等待主循环可以自由地在各状态间跳转而不担心“卡死在某段延时里”。/* TIM2 配置为 1ms 中断节拍 */ void TIM2_Init(void) { TIM_TimeBaseInitTypeDef TIM_InitStruct; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); TIM_InitStruct.TIM_Prescaler 36000 - 1; /* 36MHz / 36000 1kHz */ TIM_InitStruct.TIM_Period 1000 - 1; /* 1kHz / 1000 1Hz中断 */ TIM_InitStruct.TIM_ClockDivision TIM_CKD_DIV1; TIM_InitStruct.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_InitStruct); TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE); TIM_Cmd(TIM2, ENABLE); }预分频器 36000 减 1 是因为 STM32 的定时器计数是从 0 开始的实际分频系数是 36000。PCLK1 固定 36MHz 时36MHz/360001kHz也就是计数器每秒数 1000 个脉冲自动重装载值 1000-1 意味着每数 1000 下产生一次更新事件正好 1ms。如果系统时钟回路有改动这套参数必然要跟着重算否则所有软件定时会整体漂移。在stm32f10x_it.c的TIM2_IRQHandler里标准的动作是检测更新中断标志、清除标志、累加tick_ms然后调用周期性任务函数。4.3 MOTOR 与 PWM电机调速和换向的实现方式MOTOR目录与PWM目录通常是一起出现的PWM负责产生可调占空比的方波MOTOR负责电机使能、方向控制和刹车。工程里常见的方案是PWM 由高级定时器 TIM1 或通用定时器 TIM3 的某个通道输出而方向控制依赖两个 GPIO 接电机驱动芯片如 L298N 或 BTS7960通过 IN1/IN2 的电平组合决定电机正转、反转还是刹停。洗涤和脱水对电机的需求不同洗涤时要反复正反转转速低、力矩大脱水时单向高速旋转要求 PWM 占空比打到接近 100%。/* 电机换向与调速控制函数 */ void MOTOR_SetSpeed(uint8_t direction, uint16_t duty) { if (duty 1000) { duty 1000; /* 占空比上限保护 */ } switch (direction) { case MOTOR_FORWARD: MOTOR_IN1_HIGH(); MOTOR_IN2_LOW(); break; case MOTOR_REVERSE: MOTOR_IN1_LOW(); MOTOR_IN2_HIGH(); break; case MOTOR_STOP: MOTOR_IN1_LOW(); MOTOR_IN2_LOW(); /* 自由停车电机靠惯性滑行 */ break; } TIM_SetCompare1(MOTOR_PWM_TIM, duty); }TIM_SetCompare1设置的是通道 1 的比较值它跟定时器自动重装载值TIM_Period的比例就是实际输出的占空比。如果定时器周期设置为 1000那比较值 700 就是 70% 占空比。需要注意MOTOR_STOP分支里 IN1/IN2 同时拉低是“自由停车”电机靠摩擦和负载自然减速而如果两个引脚同时拉高则是“刹车制动”电机立刻停止转动。洗衣机脱水结束时需要用刹车方式快速停住否则惯性会让内筒继续旋转好一阵子用户在开门时可能被带动的水流甩到。方向切换之间最好加一点死区延时——正转切换到反转时先让电机自由停车 200ms 再反转不然瞬间反向电流冲击可能烧驱动管这是电机驱动电路设计里最常见的坑。4.4 洗涤流程状态机不要让 if-else 堆出宇宙洗衣机控制本质是一个有限状态机。状态集合大概是待机 → 进水 → 洗涤 → 排水 → 脱水 → 结束外加暂停和故障两个旁路状态。工程里如果用大量if嵌套判断“当前处于什么阶段、下一步该干什么”代码会迅速膨胀到不可维护。合理的做法是把状态用枚举变量表示在switch-case里按状态处理事件则放在统一的入口函数里派发。typedef enum { STATE_IDLE, STATE_FILL, STATE_WASH, STATE_DRAIN, STATE_SPIN, STATE_DONE, STATE_FAULT } WashState_t; static WashState_t current_state STATE_IDLE; void WashingMachine_Tick(void) { switch (current_state) { case STATE_FILL: if (SHUI_IsLevelReached()) { MOTOR_SetSpeed(MOTOR_FORWARD, WASH_SPEED_DUTY); current_state STATE_WASH; } break; case STATE_WASH: /* 通过 tick_ms 计数实现正反转交替 */ if (get_tick_ms() - wash_start_ms WASH_REVERSE_INTERVAL_MS) { MOTOR_SetSpeed(MOTOR_REVERSE, WASH_SPEED_DUTY); wash_start_ms get_tick_ms(); } break; case STATE_DRAIN: /* 排水阀打开等待排空 */ break; default: break; } }这个函数每 1ms 被 TIM2 中断调用一次get_tick_ms()返回系统当前毫秒数与wash_start_ms的差值就是区间长度。状态机的好处是任何时刻系统都明确知道自己处于哪个阶段外设动作与阶段绑定。异常处理逻辑也变得更清晰——比如排水阶段发现水位没有下降可以直接跳入STATE_FAULT而不是在多重 if 嵌套里寻找是哪一层出了问题。脱水和排水共用同一个水泵电机时状态切换还要关注电机驱动板是否支持双向控制不支持的话只能用两个继电器切换这在MOTOR模块的初始化注释里一般会写明。5. 中断、看门狗与低功耗让洗衣机连续跑上十年不失控5.1 stm32f10x_it.c 中的中断优先级分配stm32f10x_it.c是所有中断处理函数的集中地工程跑起来后这里就是系统的“神经中枢”。洗衣机场景里至少有三个中断会同时活跃TIM2 的 1ms 节拍、串口接收中断如果接了调试模块、以及按键或红外触发的 EXTI 外部中断。中断优先级规划设计不好就会出现“红外按键按下没反应但程序没死”这类诡异现象。Cortex-M3 内核支组优先级和子优先级STM32F103 通过NVIC_PriorityGroupConfig来分组。常见做法是采用NVIC_PriorityGroup_2高 2 位是抢占优先级低 2 位是子优先级。/* 中断优先级配置示例 */ NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); NVIC_InitTypeDef nvic_config; nvic_config.NVIC_IRQChannel TIM2_IRQn; nvic_config.NVIC_IRQChannelPreemptionPriority 0; /* 最高抢占优先级 */ nvic_config.NVIC_IRQChannelSubPriority 0; nvic_config.NVIC_IRQChannelCmd ENABLE; NVIC_Init(nvic_config); nvic_config.NVIC_IRQChannel USART1_IRQn; nvic_config.NVIC_IRQChannelPreemptionPriority 1; nvic_config.NVIC_IRQChannelSubPriority 0; NVIC_Init(nvic_config);TIM2 的抢占优先级设为 0 最高是为了保证系统节拍的抖动尽可能小——如果节拍被其他中断延迟所有基于它的软件定时和状态机都会产生时间漂移。串口调试中断优先级低一档因为串口数据丢失一帧不影响设备安全而节拍乱了整个控制逻辑就乱了。红外和按键的中断优先级再低一级或干脆用轮询都没问题。一组经验法则时间关键型中断抢占优先级最高通信中断其次非安全相关的低速事件最后。5.2 独立看门狗与窗口看门狗的取舍洗衣机的使用环境相对恶劣电网波动、电机启停浪涌、潮湿空气都可能造成 MCU 程序跑飞。IWDG独立看门狗是最常用的保命手段——它由 LSI 低速内部时钟驱动一旦启动就无法用软件停止必须在规定时间内“喂狗”否则强制复位。但喂狗的位置不能放在主循环末尾就完事因为如果某个外设初始化卡死主循环可能永远执行不到末尾。正确的做法是在状态机的主 Tick 函数末尾喂狗这样只要系统心跳还在跳就说明核心调度没有死锁。/* 独立看门狗初始化与喂狗 */ void IWDG_Init(void) { IWDG_WriteAccessCmd(IWDG_WriteAccess_Enable); IWDG_SetPrescaler(IWDG_Prescaler_64); /* 分频64 */ IWDG_SetReload(4095); /* 约1秒超时 */ IWDG_ReloadCounter(); IWDG_Enable(); } void WashingMachine_Tick(void) { /* 状态机核心逻辑 */ // ... IWDG_ReloadCounter(); /* 喂狗 */ }IWDG_SetPrescaler(IWDG_Prescaler_64)加IWDG_SetReload(4095)的组合在 LSI 约 40kHz 下能算出接近 1 秒的超时窗口。这里有一个反直觉的经验复位不是越频繁越好。如果看门狗超时设置得太短比如 100ms一旦某个中断长时间关中断执行代码看门狗会误复位而且这个复位是周期性的现象像是“设备反复重启”。超时时间要大于系统最长的一条完整任务链路耗时同时小于用户能接受的无响应时间洗衣机场景下 500ms 到 1s 是合理区间。注意调试时如果开了 IWDG遇到断点停下来CPU 停住不再喂狗几秒后芯片就会复位这让在线调试变得很痛苦。工程里一般用宏开关控制是否启动看门狗调试阶段把它关掉发布前再打开。5.3 低功耗与掉电保护不能只靠主芯片省电洗衣机不是电池设备不需要深度睡眠但电源管理仍然要做待机时关闭不必要的外设时钟、LED 熄灯、LCD 关闭背光让系统待机功耗降到 mA 级。工程里通过RCC_APB2PeriphClockCmd和RCC_APB1PeriphClockCmd按需开启外设时钟这是标准外设库实现低功耗的基础手段。真正要重点关注的是掉电保护洗涤过程中如果断电重新上电后洗衣机应该恢复到一个安全状态而不是继续执行之前的转动指令。常见做法是在 Flash 里保存当前状态机和运行阶段上电初始化时读取这个标志决定是回到待机还是回到上次的排水阶段。这个细节工程里未必实现了但这是从课程设计走向产品化的关键一步。6. 验证三板斧与移植到自有板卡的调试技巧拿到这个工程不要直接拿去烧录——先做三件事。第一用 ST-Link 或者 J-Link 连接目标板打开 Keil 的 Debug 模式在LCD12864_Init和MOTOR_SetSpeed这两处打上断点确认初始化顺序和外围电路没有冲突。第二把 USART1 重定向 printf 到串口助手波特率设 115200在状态机每个分支切换处打印一行状态日志比如[FILL] - [WASH]。第三用示波器或逻辑分析仪抓 PWM 输出脚验证占空比是否随TIM_SetCompare1的调用实时变化——如果没有波形优先检查定时器的 GPIO 复用功能配置是否开启。移植到自己的板卡时第一件事就是对照原理图逐一核对工程里的 GPIO 宏定义stm32f10x.h里的引脚映射表是查错的重要依据初始化串口时开启的是RCC_APB2Periph_USART1还是RCC_APB1Periph_USART2对应的时钟总线完全不同写错直接进HardFault。如果下载时报Error: No STM32 Target Found先在 Keil 的 Settings 里检查 SWD 模式下是否识别到芯片 ID识别不到就按住复位键再点下载用这个“时序错位法”绕过目标芯片的读保护判断。固件最终发布前用 ST-Link Utility 打开读保护 Level 1防止他人直接从芯片 Flash 里把源代码倒出来——这对产品化阶段的固件保护是最后一层也是最直接的护栏。串口调试和 PWM 波形观测都验证通过后再装上真实水位传感器和电机以 3 分钟一个周期的节奏连续跑 20 次统计有没有卡死、误停和通信错误这个压力测试数据比任何代码评审都更能说明问题。本文还有配套的精品资源点击获取