做电子项目的朋友应该都有过这种经历想做个STM32相关的玩意第一反应不是画板写代码而是先到处搜有没有现成的参考设计。搜了半天要么是几年前的失效链接要么是只放了张截图、连工程文件都不全的半成品折腾一晚上板子还没影儿。这篇文章就是把我自己这几年攒下来的STM32参考设计查找地图整理出来重点放在国内真正能用、资源成体系的优质平台。参考设计我分成两类来看一类是硬件参考也就是原理图、PCB、BOM这些另一类是软件参考比如工程模板、外设例程、协议栈Demo。这两类资源在国内其实非常丰富只是很多人不知道去哪翻、怎么筛选。下文所有平台我都实际用过会附带一些使用心得和避坑经验适合正在做课设、准备竞赛、或者刚入行需要快速出项目的朋友参考。1. 先搞清楚一件事你找的参考设计到底要参考什么很多人一上来就搜STM32参考设计但搜出来一堆东西反而更懵。我建议动手前先花十分钟想清楚你目前卡住的环节是什么参考设计能帮你的无非是下面这三件事。1.1 最小系统不会画硬件参考解决敢不敢打板的问题STM32要跑起来至少得有电源、晶振、复位电路、BOOT设置、下载接口这五样。刚开始画板的人最容易卡在芯片第一脚怎么确认晶振负载电容选多大BOOT0和BOOT1要不要接电阻这种细节上。这些问题的标准答案其实都写在芯片数据手册和官方评估板原理图里。一份好的参考设计就是把数据手册里几十页的文字描述变成了一个实实在在能工作的电路。你照着抄一遍再对比手册看一遍比死记硬背强十倍。也正因为这样我找参考设计向来优先找有完整工程文件的而不是只有一张模糊截图的。1.2 外设驱动不熟软件参考解决不知道从哪下手的问题比如热搜词里常见的STM32如何做USB设备STM32超声波测距STM32定时器捕获测频率这类需求本质上是外设使用问题。芯片的外设寄存器多、配置项复杂直接看参考手册往往看得昏昏欲睡。而一个结构清晰的软件参考工程会把初始化、收发逻辑、中断处理拆开摆在你面前照着例程改一改比从零写快得多。1.3 工具链和环境不熟参考工程解决跑不起来的问题经常看到有人问STM32芯片包安装vscode配置STM32开发环境KEIL创建STM32工程这已经属于环境问题。如果你手头有一份完整的参考工程从打开工程到编译下载先把别人的代码跑起来再换成自己的代码学习路径就顺了。所以我一直觉得参考设计是新手最好的老师比看教程视频更直接因为它是可以动手改的东西。2. 官方渠道被严重低估STM32Cube和官网藏着最规范的参考设计不少国内开发者有个误区觉得官方资料全是英文、又抽象不如直接去论坛找。实际上ST官方给出的参考设计是最完整、最不会有坑的一套只是需要一点耐心去翻。官方资料里我最常逛的是下面这几个地方。2.1 STM32Cube扩展包里的Projects目录现成的例程宝库STM32Cube系列扩展包比如STM32CubeF1、STM32CubeF4、STM32CubeH7不仅能帮你初始化代码它还自带了大量官方评估板的工程模板。在你安装Cube软件时默认会把扩展包下载到本地比如Windows下通常在C:\Users\用户名\STM32Cube\Repository\STM32Cube_FW_F4_V1.28.0打开之后你会看到这样的目录结构Projects/STM32F429I-Discovery/Examples/每个外设一个独立例程GPIO、UART、I2C、SPI、TIM、USB全都有。Projects/STM32F429I-Discovery/Applications/更完整的应用级Demo比如USB设备、USB主机、FreeRTOS、FatFS、LwIP网络协议栈。这些例程不是那种hello world级别的玩具而是官方工程师写的配置规范、注释完整非常值得当模板。我自己做项目时遇到不熟的外设第一反应就是去扩展包里搜对应系列的例程而不是去搜索引擎上大海捞针。2.2 官网产品页里的设计资源原理图、PCB、Gerber都能下载如果你需要的是硬件参考设计直接去ST官网找对应芯片的产品页面。以STM32F407VET6为例打开产品页后在Design Resources分类下通常能找到这些关键文件资源类型文件内容用途Schematic官方评估板原理图PDF最小系统、外设参考电路PCB Layout评估板PCB源文件或Gerber布局布线参考BOM完整物料清单元件选型、封装确认CAD/EDA库芯片原理图符号和PCB封装画图时直接用减少画封装出错的可能应用笔记(AN)针对具体外设和功能的深度说明解决为什么这么接的问题官方评估板的原理图是PDF格式我用的时候习惯配合Visio或者PDF阅读器做标注把和自己设计相关的部分高亮出来。PCB Gerber文件虽然不能直接拿去做商业产品因为人家版权限制但用来学习布局非常直观比如去耦电容怎么摆、晶振走线怎么处理一眼就能看懂。2.3 应用笔记AN的检索技巧用搜索引擎的site语法直击目标ST的应用笔记Application Note是一套编号文档ANxxxx每个文档针对一个具体主题。我搜的时候不会只在ST站内慢慢翻而是用下面的办法site:st.com AN STM32F407 USB device site:st.com AN STM32 定时器 FPGA site:st.com AN STM32 low power design这样能快速定位到相关的PDF。一些经典编号值得记下来比如AN2606STM32系统启动模式配置、AN4324如何在IAR中做自定义bootloader、AN4666用DMA实现UART收发。这些文档的阅读门槛并不高核心是看它的电路图和配置表格。提示如果官网页面加载偏慢换个时段刷新或者在国内知名的嵌入式论坛搜索STM32 ANxxxx 中文版也有可能找到热心网友翻译的精读笔记。不过我自己尽量以英文原版为准因为翻译版本偶尔会有术语不一致的问题。3. 国内真正的宝藏平台立创开源广场、Gitee、老牌论坛和B站在国内找STM32参考设计绕不开这几个平台。它们各有脾气掌握正确的打开方式能帮你省下一大半找资料的时间。3.1 立创开源广场硬件开源项目最集中的地方立创开源广场OSHWHub是目前国内硬件开源项目密度最高的平台很多ST官方的板子、开发板、DIY作品都有复刻工程。这个平台最大的优点是把元器件商城和开源硬件打通了你看中一个项目的BOM可以直接在商城下单原理图和PCB也能直接导出。搜索的时候我建议这么做先搜STM32再按收藏数或查看数排序那些高收藏项目基本经过大量验证坑少。看到感兴趣的项目重点检查三样东西原理图能不能在线编辑、PCB源文件是否提供、说明文档里有没有写固件来源。留意项目创建时间和最近更新状态。如果创建于三四年前且一直没有更新那么它使用的库版本、元件型号可能已经过时。我还在广场上找到了STM32最小系统板的完整工程直接导出Gerber、打样、焊接一次成功。这种经历会给你很大的信心特别是第一次画板的人。3.2 Gitee软件参考工程的国内主战场软件参考工程工程模板、驱动代码、RTOS例程我最推荐到Gitee码云上找。它的好处是国内服务器访问快、中文资料多很多做嵌入式开发的人会把个人例程库托管在那里。在Gitee上搜索关键词时我常用这么几个组合STM32F103 工程模板STM32 HAL 例程STM32 参考设计 硬件挑选仓库的时候我会看三个指标仓库的Star数、README的完整度、最近提交时间。一个常年不更新的老仓库其代码可能仍停留在标准库时代而现在官方主推HAL库如果你照着老代码学选型方向就落后了。反过来一些活跃的仓库会持续适配新版CubeMX和HAL库跟着它们学不会迷路。3.3 21ic、电子发烧友、CSDN老牌社区里的隐世高人老牌社区的价值在于有大量一线工程师在里头潜水。21ic论坛的单片机板块电子发烧友elecfans的下载中心和论坛里面能翻到多年前的经典帖子讨论的内容今天依然适用。在CSDN找资料要特别小心下载频道里的资源良莠不齐很多人只是把网上已有的资料转存一遍就收积分。我的习惯是先看评论区有多人回复可用才下载如果只有资源描述、没有任何代码截图大概率是凑数的。还有一个技巧搜索时限定关键词原理图PCBGerber能直接过滤掉不少纯论文式的水帖。3.4 B站表面上看视频实际是资料分发入口很多人把B站当娱乐网站但在嵌入式圈子里B站是很多开源作者首发作品的地方。特别是江科大STM32入门这类系列视频评论区、视频简介、置顶动态里经常挂着网盘资料或者Gitee链接。看视频时别忘了做一件小事去评论区搜资料网盘源码三个词往往会有惊喜。不过B站资料也杂乱我的原则是优先认准在更新视频的UP主资料版本新、有对应的讲解视频出问题时能找人问。那些只发视频不放资料的就当看个思路不必强行索要。4. 开发板厂商和模块商的成套参考设计最接近产品级的学习对象如果觉得社区开源项目不够严谨那就去看开发板厂商。正点原子、野火、微雪、合宙这些厂商为了卖板子会把技术资料做得极其丰富这些资料其实就是一套精心整理的产品级参考设计。4.1 正点原子、野火的资料包新手最友好的参考标准正点原子和野火的资料包结构非常清晰通常包含开发板原理图PDF ADAltium Designer源文件图纸上有详细的电路标注。外设例程源码配合库函数或HAL库注释写得比大多数网上的代码认真得多。视频讲解对着源码一步步讲适合自学。常见问题FAQ把用户踩过的问题集中整理成文档。这些资料最大的价值是它覆盖的例程面广GPIO、外部中断、定时器、PWM、ADC、DAC、DMA、串口、SPI、I2C、USB、以太网、FreeRTOS每个都有可直接编译的工程。对新手来说这就是一本带答案的外设习题集。我当年学STM32时就是靠野火的例程对照寄存器手册慢慢搞懂了外设工作的来龙去脉。4.2 微雪、合宙、国产兼容MCU的另类参考价值微雪Waveshare的很多STM32板卡在其官网wiki页面上会提供原理图、PCB布局建议和全套例程页面风格简洁适合快速检索。合宙最出名的虽然是Air系列4G模块但它家的文档习惯把单片机如何通过串口、SPI和模块对接的原理图画得明明白白这对做物联网网关、远程控制项目的朋友有很强的参考价值。另外国产兼容MCU厂商的经验也值得研究。兆易创新GD32、雅特力AT32、航顺HK32这些芯片很多以STM32作为兼容目标它们发布的参考设计文档和勘误表有时会把一些ST文档里没细讲的坑提前告诉你。当你做STM32项目遇到诡异问题时去看国产同行的勘误表经常能找到灵感——因为对应的硬件问题可能早就被总结过。4.3 为什么我说厂商参考比一般开源作品更值得研究学生作品和DIY项目往往是能工作就行对电磁兼容、电源纹波、信号完整性这些产品级问题考虑得少。而开发板厂商和模块厂商的东西是每天出货的他们要保证不同批次、不同环境下都能稳定工作。所以他们的原理图里你会看到更合理的去耦电容布局、防护器件、电源分割处理。把这些细节抄进自己的设计里能少走很多弯路。5. 从文件齐全到真正能跑参考设计的筛选、复刻与改造参考设计找到了不代表你的项目就成了。接下来这几步是我摸索了很久才总结出来的流程每一步都踩过坑。5.1 判断一个参考设计值不值得采用六连问我拿到一份参考设计文件不会急着下载而是先问自己六个问题问题怎么判断为什么重要文件是源文件还是只读文件原理图是否有源格式SchDoc/JsonPCB是否可导出只有PDF很难改造成自己的项目固件有没有源码代码工程里是否有HAL/标准库源码而不是只有hex只有hex意味着你无法学习或修改逻辑BOM表完整吗每个器件是否有位号、型号、数量缺BOM会导致买料时东拼西凑文档有没有写注意事项是否有链接、丝印、跳线的说明不写注意事项的项目老板自己可能都没跑通过最近有没有更新检查文件上传/修改日期老工程的元件停产或库版本过旧会白费功夫作者在评论区活跃吗看看别人提问后作者回不回有问有答的项目出问题才有人帮你这六个问题里最容易被忽略的是固件有没有源码。很多人复刻硬件成功后才发现下载固件只是一个hex文件点个灯容易改个功能就要疯。5.2 参考设计的标准落地流程从打板到下固件如果决定复刻一个项目我通常按这个顺序走导出Gerber或直接生成PCB订单嘉立创这类厂家打样小批量很划算。按BOM买料优先选商城有库存的型号别为了省几毛钱选个偏门封装焊接时容易翻车。焊接顺序有讲究先焊电源部分上电测电压正常后再焊主控和晶振最后焊外设。这么做的好处是出问题时可以快速定位是电源短路还是芯片焊接问题。烧录固件给STM32下载程序最省事的是ST-Link通过SWD接口四根线搞定。如果你的参考设计没留SWD接口可以把BOOT0拉高用串口ISP方式下载但这样每次烧录都要手动切换BOOT0比较麻烦。下载后先点灯再验证其他外设。不要上来就测通信协议先把最小系统确认没问题再说。我第一次复刻别人开源板子的时候就是急着把所有器件一次焊完结果上电没反应排查了半天才发现是3.3V LDO焊反了教训相当深刻。5.3 改成自己的项目重建工程而不是硬抄很多人拿到参考设计喜欢直接改别人的工程文件。但别人的工程里往往有一堆你没注意的配置牵一发动全身。我自己更推荐重建工程的方法用CubeMX新建一个自己的工程选好芯片型号按参考设计的原理图把外设添加进来。时钟树、引脚分配对照参考设计或自己改动的部分重新配一遍。从参考工程里复制驱动层文件比如传感器驱动、LCD驱动复用时保持源文件注释和作者信息方便以后回溯。业务逻辑比如状态机、协议解析、UI完全自己写这样代码的每个部分你心里都有数。举个实际例子热搜里有STM32如何做USB设备。参考设计往往只用CubeMX配置USB外设生成HID或CDC类代码但你拿到这份参考后如果直接改官方的usbd_hid.c改来改去容易把自己绕晕。更好的做法是先用参考工程把USB枚举跑通然后在官方生成的模板上从零添加你自己的报告描述符和收发逻辑。这样既保证了底层正确又拥有完全属于自己的上层实现。5.4 我在参考设计上摔过的几个跟头原理图与PCB不一致。有个项目原理图使用PA9做串口但PCB封装上却接到了PA10照抄板子后串口怎么都不通。从那以后我拿到工程会先核对引脚网络不迷信文件。晶振布局和负载电容照抄但电容值没看。同一个12MHz晶振有的板子用12pF负载电容有的用18pF厂家手册往往只给了标称实际稳频要去参考实际焊接的那块板子。抄错了会导致时钟跑偏串口波特率误差大。文件更新不同步。作者更新了原理图但没更新BOM或者更新了固件但没更新源码评论区一直有人在问。下载时要看清版本号和更新日期。参考设计的下载接口占用问题。不少开源项目用SWD接口的引脚兼职做GPIO比如PB3、PB4你插着ST-Link时程序能跑但拔掉后某些功能不工作。这其实是引脚复用冲突做自己的设计时尽量避免把SWD引脚占用。6. 关于合理借鉴参考设计不是万能药边界要清楚说了这么多找参考设计的办法最后必须泼一盆冷水。参考设计是用来降低起点、加快认知的不是用来抄作业的。做课程设计、毕业设计时如果你完全照搬某个开源作品只要老师细看原理图和你讲解时的回答基本一眼就能看出来。商业用途更是要谨慎别人的工程文件有版权芯片厂家也有知识产权限制。我的习惯是参考设计里的原理吃透后自己重新画一版代码里的驱动理解核心流程后自己重写或按开源协议合规使用对于涉及商业产品的部分尽量按它的设计思想重新布局而不是直接拿文件去打样。尤其在标注参考来源这件事上国内很多开发者做得不够好在开源社区发布自己的作品时把参考了某项目写清楚是对原作者起码的尊重。另外要明白参考设计的参考两字意味着它只是给你提供了一个已知可行的坐标而不是最终答案。温度、湿度、负载、带宽任何一环节变了电路都要跟着调。真正的高手不是找到一个参考就抄了完事而是能从一份参考里看出设计者的取舍为什么这里用MOS管而不用三极管为什么那里加了一个0欧电阻为什么电源入口要放两个电容而不是一个。看懂这些为什么你才算真正把参考设计消化成了自己的能力。最后的几点碎碎念写这篇文章时我又翻了一回自己的收藏夹发现这些年陆陆续续存了上百个参考设计和工程模板但真正反复使用的也就那么十来个。找参考设计这件事数量不重要质量和你消化了多少才最重要。我现在拿到一份新参考设计会顺手做三件事把作者和日期记录在工程目录里把CubeMX初始化的配置截图留档把原工程的链接存进README。这个习惯救了我很多次因为几个月后回头看代码你会发现你早就忘了当初这份文件是从哪来的。最后送大家一个小技巧当你准备搜索某个STM32功能时不要只搜STM32 xxx试着搜STM32 xxx 开源 原理图或STM32 xxx CubeMX 例程用这种方式筛出来的结果往往比泛搜质量高一个档次。如果你自己私藏了更好的STM32参考设计来源也欢迎分享出来我这边也等着补课。