STM32 电机 PID 调速系统（一）环境搭建，我踩过的 3 个致命大坑

STM32 电机 PID 调速系统一环境搭建我踩过的 3 个致命大坑从 0 到 1 打磨一份可以写进简历的嵌入式实战项目系列第一篇硬件环境STM32F103C8T6 蓝板 ST‑LINK V2 PlatformIOArduino 框架前言大二暑假我决定动手做电机 PID嵌入式软件驱动项目。大学课内实验大多停留在点灯、串口打印这类简单例程网上不少网课为了引流直接封装好底层、提供现成库文件配套专属开发板。这种高度封装的教学商业化很重跟着做完也很难独立完整落地一套驱动最终只能得到一个玩具 Demo放到嵌入式软件面试里很难有说服力。所以这一系列文章我打算从底层一步步记录电机驱动、正交编码器测速、PID 算法调参全部自己捋一遍不直接套用封装好的库完整记录踩坑过程方便自己复盘也希望能给正在学习 STM32 驱动开发的同学一点参考。我手上另一个项目是 ESP32 水质监测偏向物联网传感、云边协同我想再补齐单片机底层驱动、实时闭环控制这块能力两个项目技术栈互补简历内容不会重复。做这个项目我的目标很明确丰富简历竞赛素材不是玩具 demo分层架构完整可实物运行竞赛、秋招面试都可以讲练习工程化思维严格按照驱动层‑算法层‑应用层分层开发贴近工业项目的编写思路不能写成一锅粥的 main 函数循序渐进学 STM32先用 Arduino 框架快速跑通全部功能拿到正向反馈后续再下沉学习 HAL 库、寄存器降低上手挫败感核心思路先跑通实物再深挖底层原理不要一上来死磕寄存器打击信心。硬件选型部件型号 说明主控STM32F103C8T6 蓝板 (Blue Pill)下载调试器ST‑LINK V2电机带 AB 相正交编码器直流减速电机电机驱动TB6612FNG H 桥驱动模块外设显示0.96 寸 OLED 屏幕 SSD1306I2C为什么选择 STM32F103C8T6行业普及度高市面上大量产品还在使用 F1 系列面试高频芯片学会可以迁移到 F4/F103 其他型号内核Cortex‑M3主频 72MHzFlash 64KBRAM 20KB资源做电机闭环控制完全够用性价比极高价格便宜网上教程、踩坑案例海量遇到 bug 很容易找到参考⚠️ 注意区分72MHz 是芯片系统主频不是外设通信频率RAM 只有 20KB写代码要注意内存开销。为什么选用 PlatformIO完全免费开源Windows、Mac、Linux 工程文件通用不用来回换 IDE编译、烧录、串口监视器集成一体不需要来回切换软件库依赖管理简单一行配置自动拉取第三方库省去手动复制 .h/.c 文件的麻烦为什么用 Arduino 框架起步STM32duino 把底层寄存器初始化做了封装不用一开始就啃复杂寄存器配置可以快速把电机、编码器、OLED 跑起来我的学习路线Arduino 快速实现闭环 → 回过头研读底层 HAL、定时器寄存器避免一上来直接寄存器开发调试几天看不到现象直接摆烂PlatformIO 完整工程配置直接复制这份platformio.ini就可以编译使用[env:bluepill_f103c8] platform ststm32 board bluepill_f103c8 framework arduino upload_protocol stlink monitor_speed 115200 lib_deps adafruit/Adafruit SSD1306^2.5.0 ; OLED屏幕驱动 adafruit/Adafruit GFX Library^1.11.0 ; OLED绘图库 2093 ; STM32duino FreeRTOS库ID编译命令pio run补充说明lib_deps会联网自动下载依赖库。FreeRTOS 这里直接填数字 ID2093可以规避库名空格带来的找不到包问题。⚠️ 血泪踩坑新手 90% 都会中招 坑 1工程放在中文路径直接链接报错报错信息ld.exe: cannot open map file ... Illegal byte sequence现象代码本身没有错误编译到链接阶段直接失败。原因ARM 交叉编译工具链arm‑none‑eabi‑gcc不识别中文、特殊字符路径。✅解决工程整体迁移到纯英文路径D:\项目\电机PID ❌错误含中文 E:\stm32_motor_pid ✅正确全英文路径经验嵌入式开发工程路径、文件名、头文件全部尽量只用英文 下划线。 坑 2STM32duino 不会自带 FreeRTOS和 ESP32 不一样报错src\main.cpp:16:10: fatal error: FreeRTOS.h: No such file or directory很多人会混淆 ESP32 与 STM32duinoESP32STM32 (stm32duino)FreeRTOSSDK 内置直接#include FreeRTOS.h没有内置必须手动安装第三方库调度器系统自动启动需要手动调用vTaskStartScheduler()✅解决platformio.ini引入 ID2093 的库代码头文件写#includeSTM32FreeRTOS.h教训同样是 Arduino 框架不同芯片内核差异巨大不要把 ESP32 的经验直接套到 STM32。 坑 3库名带空格凭记忆导入直接报找不到包报错UnknownPackageError: Could not find the package with stm32duino/STM32FreeRTOS原因这个库完整名字叫STM32duino FreeRTOS名字中间带空格。手动写名字很容易出错。✅最优方案直接写库数字 ID2093零歧义。技巧找库的时候优先执行pio lib search查询官方注册表不要靠脑子回忆库名。编译成功验证输出RAM: [] 10.3% (used 2100 bytes from 20480 bytes) Flash: [] 68.5% (used 44892 bytes from 65536 bytes) [SUCCESS] 看到上面输出代表工具链、依赖库、配置全部搞定。本篇小结 下一篇预告读完本文你掌握STM32F103 PlatformIO Arduino 选型思路适合大二做项目的学习路径一份开箱即用的platformio.ini配置3 个高频坑中文路径、FreeRTOS 库差异、库名空格 bug下一篇预告电机驱动 正交编码器测速讲解 TB6612 的 H 桥驱动原理定时器 PWM 底层参数 PSC、ARR正交编码器方向判断为什么测速读取变量一定要加volatile关键字。*我大二暑假从零开始做嵌入式实战项目持续更新完整 STM32 电机 PID 系列项目全部实物调试验证欢迎一起交流踩坑。