1. 项目缘起与价值为什么我们需要一个“实例大全”刚接触单片机那会儿我最大的困扰不是看不懂寄存器也不是搞不清中断优先级而是面对一个空白的工程文件脑子里一片空白。我知道怎么点灯也知道怎么让蜂鸣器响但当我真正想做一个“有点用”的小东西比如一个能显示温度还能设置闹钟的简易时钟时就卡壳了。该从哪里开始各个模块怎么组合代码结构怎么安排才不乱我相信这是很多单片机初学者甚至一些已经工作一两年的朋友都遇到过的问题。我们缺的不是零散的知识点而是将这些知识点串联起来解决实际问题的“项目感”。这就是“单片机编程实例400例”这个想法最初诞生的原因。它不是一个简单的代码仓库而是一个试图构建从“点灯”到“做项目”的桥梁的尝试。市面上很多教程和书籍要么过于理论化离实际应用太远要么就是一个个孤立的、功能单一的Demo缺乏系统性和递进性。我的目标是整理出一套覆盖基础操作、外设驱动、通信协议、算法应用乃至小型综合项目的实例集合让学习者能像查字典一样找到自己当前需要的那个“零件”并理解如何将它“安装”到自己的“机器”上。这个系列计划从1到100例聚焦于最经典、应用最广泛的51单片机如STC89C52和STM32以STM32F103系列为主平台。选择它们是因为其生态完善、资料海量是绝大多数人入门和进阶的首选。每个实例都将包含完整的工程文件、清晰的代码注释、必要的原理图说明以及最重要的——实现思路的拆解。我不会只给你代码让你复制粘贴我会告诉你我为什么这么写过程中遇到了哪些坑以及这个代码块还能用在哪些地方。2. 实例体系规划从“零件”到“机器”的进阶之路为了让大家对前100个实例有一个全局的认识我将其分为了几个大的阶段。这就像学木工你先得熟悉锯子、刨子、凿子这些工具基础外设然后学习如何做榫卯通信与协议最后才能打造一件家具综合项目。2.1 第一阶段基础外设驱动与“人机交互”实例1-30这个阶段的目标是“让单片机动起来并能和它对话”。所有复杂的系统都建立在最基础的输入输出之上。核心内容GPIO的极致玩法不止于点灯和按键扫描。我们会深入探讨按键消抖的多种硬件与软件方案、矩阵键盘的扫描与编码、LED数码管的静态与动态驱动原理为什么动态扫描能省IO口扫描频率多少合适、以及用GPIO模拟简单时序如模拟I2C、单总线。中断系统实战外部中断是响应异步事件的关键。我们将通过按键中断唤醒休眠、旋转编码器计数、红外遥控接收等例子彻底理解中断的配置、优先级和嵌套并分享如何避免中断服务函数过于冗长导致的系统响应异常。定时器/计数器应用这是单片机的“心脏”。实例将覆盖精准延时、PWM波形生成控制LED亮度、电机速度、输入捕获测量脉冲宽度、频率、以及定时器中断构建简单任务调度器的思路。人机接口入门驱动字符型LCD1602/12864实现自定义字符显示驱动OLED屏幕学习位图显示和简单GUI配合按键和旋转编码器实现菜单系统。这里会重点讲液晶的初始化序列为什么那么长以及如何编写一个易于移植的显示驱动层。注意很多新手在驱动LCD1602时照着时序图写代码还是点不亮大概率是初始化指令的顺序或延时不对或者是总线接口4位/8位模式设置错误。我会在实例中给出示波器抓取的时序对比图让你直观地看到“对的时序”和“错的时序”到底差在哪。2.2 第二阶段通信协议与数据交换实例31-60单片机很少孤军奋战它需要和传感器、存储芯片、其他单片机甚至电脑通信。这个阶段我们学习单片机的“语言”。核心内容UART串口通信从最基础的字节收发到不定长数据帧的接收与解析如何设计帧头、帧尾、校验和再到使用串口中断环形缓冲区实现高效、不丢数据的通信。我们还会实践通过串口与PC通信实现命令行调试界面CLI。I2C总线协议驱动EEPROM如AT24C02学习读写操作驱动温湿度传感器如SHT30学习读取数据。重点剖析I2C的起始信号、停止信号、应答信号的软件模拟细节以及如何应对从设备无响应或总线冲突的情况。SPI总线协议驱动FLASH芯片如W25Q64进行大容量数据存储驱动OLED屏幕部分型号采用SPI接口体验高速刷屏。对比SPI与I2C在速率、硬件复杂度、应用场景上的差异。单总线协议以经典的DS18B20温度传感器为例学习严格的时序要求并实现单总线上挂载多个传感器的ROM搜索算法。ADC/DAC数据转换学习STM32的ADC多通道扫描、DMA传输实现电压采集。使用DAC或PWM滤波电路模拟生成特定波形。这里会引入参考电压的重要性以及如何提高ADC精度软件滤波、硬件滤波。2.3 第三阶段复杂外设与算法初探实例61-85掌握了通信就可以接入更复杂的模块并尝试一些简单的算法处理。核心内容高级定时器应用深入STM32的高级定时器实现互补带死区的PWM输出用于电机驱动、逆变器编码器接口模式用于直接读取伺服电机位置。实时时钟RTC学习STM32内部RTC或外置DS1302/RTC芯片的使用实现日历、闹钟、定时唤醒功能。重点讲解后备电池域的概念和RTC寄存器的初始化陷阱。文件系统与存储管理在STM32上移植FatFs文件系统配合SD卡或SPI FLASH实现文件的创建、读取、写入。例如将传感器数据以CSV格式写入文件方便PC分析。这是将单片机应用从“玩具”升级到“工具”的关键一步。简单算法实现滤波算法一阶滞后滤波、中位值平均滤波用于处理传感器数据噪声。PID控制原理通过一个直流电机速度控制或水温控制的例子直观理解比例、积分、微分三个参数的作用并给出参数整定的简易方法。状态机编程用状态机重构一个复杂的按键菜单系统或通信协议解析流程使程序逻辑清晰易于维护。2.4 第四阶段小型综合项目实战实例86-100将前三个阶段的知识熔于一炉完成几个有实际功能的小项目。规划项目示例智能温湿度监测器SHT30采集数据OLED显示超过阈值蜂鸣器报警数据通过串口发送至上位机并可按时间存储到SD卡。简易示波器/逻辑分析仪利用STM32的ADC高速采样和LCD显示实现一个低频信号的波形显示。涉及触发、时基、电压量程等概念。蓝牙/WIFI遥控智能小车通过手机APP遥控实现超声波避障、红外循迹、实时速度测量编码器等功能。涉及多传感器数据融合和简单的运动控制。基于PWM的LED调光台灯使用旋转编码器调节亮度触摸开关控制支持多种灯光模式如呼吸灯。CAN总线数据转发器学习汽车电子中常用的CAN总线实现一个将CAN报文解析并转发到串口的上位机调试工具。3. 实例详解以“STM32F103的ADC多通道DMA采集”为例实例55光说规划太抽象我们拿一个具体的、有代表性的实例来拆解一下我的内容组织方式。这个实例属于第二阶段和第三阶段的交界涉及ADC、DMA和定时器非常经典。3.1 需求与方案选择为什么用DMA假设我们需要同时采集电池电压通道1和电流传感器输出通道2并以1kHz的频率每秒1000次更新。如果用传统的查询或中断方式每次转换完成都会触发CPU介入频繁的中断会大量消耗CPU资源影响主程序运行。更糟糕的是如果处理不及时还可能丢失数据。DMA直接存储器访问就是为了解决这个问题而生。它像一个“数据搬运工”可以在外设ADC和内存数组之间直接传输数据完全不需要CPU参与。配置好后ADC按照定时器的节奏自动转换DMA自动把结果存到数组里CPU只需要在数组存满一半或全部时去处理这批数据即可效率极高。方案确定使用STM32的ADC1规则通道组启用扫描模式和连续转换模式。使用一个通用定时器如TIM2的TRGO事件来触发ADC转换这样采样频率极其精准。使用DMA循环模式将ADC转换结果持续搬运到一个双缓冲乒乓缓冲数组中。3.2 硬件连接与CubeMX配置硬件连接电池电压分压后接入PA1ADC1通道1。电流传感器输出接入PA2ADC1通道2。确保模拟地AGND和数字地DGND单点连接良好模拟电源干净稳定。CubeMX关键配置步骤省略基础工程创建ADC1配置模式Independent mode。规则通道添加Channel 1和Channel 2设置采样时间如239.5 Cycles根据信号频率和精度需求调整。扫描转换模式Enabled。连续转换模式Enabled。间断模式Disabled。外部触发转换源Timer 2 Trigger Out event。DMA连续请求Enabled。TIM2配置时钟源Internal Clock。分频PSC和重载值ARR计算假设系统时钟72MHz要产生1kHz的触发频率。设置PSC71ARR999。则定时器频率 72MHz / (711) / (9991) 1000Hz。触发事件选择TRGOUpdate Event。DMA配置添加DMA1 Channel1对应ADC1。模式Circular循环模式。数据宽度外设和内存都设为WordADC结果是12位存在32位数据寄存器中按字传输方便。内存地址自增Enabled。外设地址不自增Disabled。3.3 核心代码实现与注释CubeMX生成代码后我们需要编写用户代码。// 定义双缓冲数组 #define ADC_BUFFER_SIZE 1024 // 每个缓冲区大小 uint32_t adc_buffer[2][ADC_BUFFER_SIZE]; // 双缓冲 volatile uint8_t current_buffer 0; // 当前DMA正在写入的缓冲区索引 volatile uint8_t buffer_ready 0; // 缓冲区就绪标志 // 在main函数初始化后启动 HAL_ADC_Start_DMA(hadc1, (uint32_t*)adc_buffer, ADC_BUFFER_SIZE * 2); // 注意这里传输长度是总长度 HAL_TIM_Base_Start(htim2); // DMA传输完成一半和全部完成的中断回调函数 void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc) { // 传输完成一半意味着前一半缓冲区adc_buffer[current_buffer^1]已满可以处理 buffer_ready 1; current_buffer ^ 1; // 切换当前缓冲区索引 } void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { // 传输全部完成意味着后一半缓冲区也满了同样可以处理 // 在实际应用中通常只使用半传输完成中断来形成“乒乓”操作避免处理速度跟不上。 // 这里为了演示也设置标志。但更推荐只用半传输中断。 buffer_ready 1; } // 在主循环中处理数据 while (1) { if (buffer_ready) { buffer_ready 0; uint32_t *buffer_to_process adc_buffer[current_buffer ^ 1]; // 处理非当前写入的缓冲区 // 处理数据计算平均值、转换电压值等 uint32_t sum_ch1 0, sum_ch2 0; for (int i 0; i ADC_BUFFER_SIZE; i 2) { // 注意两个通道交替存储 sum_ch1 buffer_to_process[i]; // 通道1的数据 sum_ch2 buffer_to_process[i1]; // 通道2的数据 } float avg_voltage_ch1 (sum_ch1 / (ADC_BUFFER_SIZE / 2.0f)) * 3.3f / 4095.0f; // 假设参考电压3.3V12位ADC float avg_voltage_ch2 (sum_ch2 / (ADC_BUFFER_SIZE / 2.0f)) * 3.3f / 4095.0f; // 根据传感器特性将电压转换为实际物理量如电流值 // ... 你的转换代码 ... // 可以在这里将结果发送到显示屏、串口或进行其他控制 printf(Ch1: %.2fV, Ch2: %.2fV\r\n, avg_voltage_ch1, avg_voltage_ch2); } // 主循环可以执行其他任务ADC采集完全由DMA在后台进行 HAL_Delay(10); }3.4 避坑指南与调试心得数据对齐问题ADC结果寄存器是32位的但数据只有低12位或16位有效。使用DMA传输时如果设置的数据宽度是Half Word16位要确保你的接收数组是uint16_t类型并且地址对齐。使用Word32位可以避免对齐烦恼但浪费一点内存。我的建议是统一用uint32_t数组和Word传输简单可靠。缓冲区大小与中断频率ADC_BUFFER_SIZE的大小需要权衡。太大数据处理延迟高太小中断过于频繁增加CPU开销。一般让缓冲区能存储几十到几百毫秒的数据为宜。例如1kHz采样率缓冲区512个点每个通道256个则半缓冲区满中断频率为 1000 / (512/2) 3.9Hz对CPU压力很小。DMA循环模式与指针管理在HAL_ADC_Start_DMA函数中传入的缓冲区长度是总长度两个通道*缓冲区大小。在中断回调函数中通过current_buffer索引来管理哪个缓冲区正在被写入哪个可以被安全读取这是实现“乒乓缓冲”的关键能有效防止数据处理线程和DMA写入线程冲突。参考电压稳定度这是影响ADC精度的命门。如果系统中有电机等大功率器件一定要确保模拟部分的供电VDDA和参考电压VREF干净。可以在VDDA和地之间并联一个10uF钽电容和一个0.1uF陶瓷电容并尽量让走线短而粗。调试技巧如果发现数据全为0或固定值首先检查ADC和DMA的时钟是否使能。GPIO是否配置为模拟输入模式。定时器是否真的启动了并产生了触发信号。可以用示波器看定时器输出引脚或者进入调试模式查看定时器计数寄存器是否在变化。DMA传输地址是否正确。可以在DMA传输完成中断里设置断点查看目标数组内存是否被更新。4. 实例的通用性与移植思考这个ADCDMA定时器的框架具有极高的通用性。一旦你掌握了它你可以轻松地将其应用到其他需要高速、连续、多通道采集的场景比如音频信号采集提高采样率结合DMA的双缓冲实现实时音频处理的前端。多路传感器同步监测同时采集光照、温度、压力等多个传感器数据。电机电流采样用于FOC磁场定向控制算法中的相电流反馈。移植到其他单片机平台如GD32、AT32时思路完全一致只是寄存器名称和库函数接口有所不同。你需要关注目标芯片的ADC是否支持扫描模式、DMA请求。定时器的触发输出TRGO功能如何配置。目标开发环境的DMA配置API。通过这个详细的拆解我希望传达的是每一个实例都不应是一个孤立的代码片段。它应该像一块乐高积木有标准的接口设计思路和明确的用途应用场景可以被灵活地拼接到你自己的创意项目中。在接下来的实例分享中我都会沿用这种“需求分析-方案选型-实战配置-代码解读-避坑总结-扩展思考”的结构确保大家既能复制成功更能理解原理最终达到自主创新的目的。前100例只是一个开始它们将为你构建一个坚实的单片机应用知识框架让你在面对更复杂的项目时能够从容地分解问题、组合方案。