STM32 Blue Pill 运行 GRBL：从烧录到多轴 CNC 配置全攻略

简介：这是一份面向嵌入式开发者、CNC设备制造商及创客群体的STM32平台GRBL固件资源，解决传统8位AVR版GRBL在轴数扩展、通信速率与开发灵活性上的瓶颈问题。资源基于GRBL 1.1f深度适配STM32F103系列，支持3至6轴高精度运动控制，兼容Blue Pill等低成本开发板，并提供USB与USART双通信通道（最高波特率921600），特别适合需定制化CNC/激光雕刻控制逻辑且倾向命令行开发环境的用户。压缩包含178个文件，以70个.h头文件和55个.c源码为主，覆盖USB描述符、步进电机驱动、G代码解析、定时器与外设底层驱动等核心模块；另有4个.hex烧录文件、9张原理图与界面参考图（jpg/png）、Makefile构建脚本及PDF说明文档，总大小4.21MB。目前已有81人学习下载，可直接获取预编译固件快速部署，亦可通过文本编辑器+命令行完成全流程二次开发与调试。 如果你跟我一样，先是玩了一两年基于 Arduino 的 GRBL，后来慢慢觉得 3 轴不够用、想加第四轴旋转轴或者直接上激光联动，那你大概率会遇到同一个坎：原版 GRBL 在 8 位单片机上的性能已经压榨到极限了。我在这个节点上转到了 STM32 平台的 32 位 GRBL 固件，也就是标题里这套基于 STM32、支持 3 至 6 轴控制、专门适配 Blue Pill 等开发板、可以走 USB 或串口通信的固件包。这篇文章完整记录我从选型、烧录、接线到配置调参的全过程，以及我踩过的那些坑。如果你正准备升级自己的桌面级 CNC、激光雕刻机，或者手里刚好有一块吃灰的 Blue Pill 想让它干点正事，这篇应该能帮你省掉好几个晚上的折腾时间。

整套东西说白了就是把经典的 GRBL 运动控制核心，从 8 位 AVR 移植到了 ARM Cortex-M3 上，让运动控制有了更充裕的 CPU 资源、更大的内存空间和更丰富的外设。原来在 Arduino UNO 上跑 3 轴就紧张兮兮的固件，现在可以在 STM32F103C8T6 这块十几块钱的板子上跑 6 轴，而且还不用额外插 USB 转串口模块——板载 USB 就能直接当虚拟串口用。这篇文章面向的读者，就是那些不甘心止步于 3 轴雕刻机、想把手上的 Blue Pill 改造成多轴运动控制器的 DIY 玩家。

1. 项目核心思路：为什么是 STM32 而不是 Arduino

1.1 原版 GRBL 的性能天花板

如果你看过市面上绝大多数 GRBL 教程，基本都是同一个套路：Arduino UNO 刷一个 grbl 1.1h.20190825.zip 的 Release，连上 CNC Shield V3，然后就能用了。不是说这个方案不能跑，而是它的天花板太明显了。Arduino UNO 用的 ATmega328P 是一颗 8 位、16MHz、2KB RAM 的单片机，GRBL 要在这样的芯片上实时生成步进脉冲、处理 G 代码解析、响应上位机命令，靠的是定时器中断在一微秒一微秒地挤。

3 轴、每轴 40kHz 左右的脉冲频率，基本就是这个平台的舒适区上限。一旦你想上第 4 轴、第 5 轴，中断处理的时间就分配不过来了，脉冲频率一高，电机就开始丢步。更麻烦的是，ATmega328P 的串口缓冲区只有 256 字节，上位机发送 G 代码的速度稍微快一点，缓冲区就满了，上位机只能停下来等固件消化，整体加工效率会明显降低。

1.2 32 位平台带来的硬核升级

转 STM32 之后，这些瓶颈基本都被解开了。STM32F103C8T6 的 CPU 主频 72MHz，是 AVR 的 4.5 倍；20KB RAM 是 AVR 的 10 倍；64KB Flash 也整整扩大了一倍。更重要的是，STM32 有多个硬件定时器，步进脉冲生成可以更多交给硬件去处理，CPU 只需要在定时器中断里更新下一个脉冲的计数值，负载压力比纯软件翻转 IO 低得多。

我把两个平台的对比整理成了表格，方便你直观感受差异：

看到这个对比，基本就能理解为什么这么多做桌面级 CNC 的人开始转向 STM32 方案。当然，不是说 Arduino 版 GRBL 就该被淘汰，如果你只做简单的 3 轴雕刻、进给速度要求不高，那 Arduino 方案依然够用且简单。但如果你想跑 4 轴联动、或者把主轴转速提高、或者接激光模块，那 32 位平台几乎是必然选择。

2. 硬件准备与引脚分配

2.1 Blue Pill 开发板选型

Blue Pill 这个名字很形象，蓝色的小板子，核心是 STM32F103C8T6。它现在最大的优势就是便宜，十几块钱就能买到一块，而且板载了 USB 接口、8MHz 晶振、LED、复位按键，引脚也全部引出，特别适合当运动控制板。买的时候有一点要注意：部分廉价版的晶振没有焊，或者焊的是贴片陶瓷谐振器，这会导致 USB 通信不稳定甚至无法识别，拿到手先确认晶振在不在。

板载 USB D+ 的上拉电阻，绝大多数 Blue Pill 是有的，所以可以直接插 USB 线识别成虚拟串口，不需要额外飞线。这一点对后面选通信方式影响很大，因为很多 32 位 GRBL 固件默认就是用板载 USB 做串口通信的。

如果你手头没有 Blue Pill，其实 STM32F103 系列其他型号也大多能跑，只是引脚定义需要自己重新映射。F103C8T6 是性价比最高的选择，Flash 64KB 正好能装下 6 轴版的 GRBL 固件，再多加功能就容易超了。

2.2 引脚分配一览

不同作者发布的 32 位 GRBL 固件，引脚定义会有差异，这个一定要先看自己固件包里的源码或者说明文档，不要在网上随便找一张引脚图就照着接。我用的这套固件，引脚分配大概是这样：

这里特别提醒一句：PA15、PB3、PB4 这三个引脚在 STM32F103 上默认复用为 JTAG 的 JTDI、JTDO、NJTRST，如果你用的固件没有在启动阶段禁用 JTAG，那这三只脚是输出不了步进脉冲的。好在大多数成熟的 32 位 GRBL 固件都默认把 JTAG 关掉、只保留 SWD，在 SystemInit 里就处理好了，这也是为什么烧录仍然可以用 ST-Link 的 SWD 接口，因为 SWD 只用 PA13/PA14，不影响。

2.3 USB 和串口两种通信方式

这套固件的通信方式有两种：一是板载 USB 直连电脑，二是通过外部 USB 转 TTL 模块连接硬件串口。我实际两种都用过，说下各自场景。

板载 USB 的好处是干净利落，一根 USB 线搞定供电和通信，不需要额外接任何模块。F103 内置 USB 2.0 全速外设，固件里跑一个 USB CDC 虚拟串口，电脑上会识别成一个 COM 口，grbl control 这类上位机直接选它就行。缺点就是线不能太长，超过一米半容易掉线，而且有的 Windows 系统需要用 Zadig 或者 ST 官方驱动来正确识别虚拟串口。

外接 USB 转 TTL 模块，常见芯片有 CH340、CP2102、FT232R、FT231X 这几类。接线方式很简单：模块的 RX 接板子 PA9（USART1_TX），模块的 TX 接板子 PA10（USART1_RX），GND 共地。这里有个容易翻车的点：很多 USB 转 TTL 模块默认输出 5V 电平，Blue Pill 是 3.3V 逻辑，直接怼上去长期使用有风险。稳妥做法是选支持 3.3V 电平的模块，或者在模块和板子之间加电平转换。我自己因为偷懒，用 5V 电平的模块怼过一次，结果板子偶尔重启，排查了半天才发现是电平不匹配。

2.4 供电注意事项

Blue Pill 板子本身是 3.3V 逻辑，而电机驱动板（比如 A4988、DRV8825）需要 12V 或 24V 供电。接线时最核心的一条：所有模块的 GND 必须共地。如果不共地，信号电平根本没有参考点，步进脉冲会乱跳，甚至可能烧毁驱动板。

另外，供电来源要理清楚。如果 USB 只负责通信、电机驱动板单独供电，那没问题；如果同时用 ST-Link 给板子供电、又用 USB 给板子供电，可能会出现倒灌，导致板上稳压芯片发热。我习惯的做法是：调试阶段用 USB 供电给板子，VMOT 单独接 12V；大功率主轴启动瞬间电压跌落严重，此时建议给板子单独加一个 5V 稳压供电，否则 GRBL 容易电压不足复位，加工行程跑到一半突然回到原点，非常折磨人。

3. 从固件编译到烧录

3.1 编译环境准备

你拿到的固件包是 .zip，解压之后里面一般有两种东西：一是已经编译好的 .bin 或 .hex 固件文件；二是完整源码工程。如果你不想折腾编译，直接用现成的固件文件烧录就行。但如果你想改轴数、改引脚、调整脉冲频率上限，那就需要自己编译。

编译环境我推荐 PlatformIO，主要是它能把 toolchain、依赖库、烧录工具一次性装好，不用手动折腾 arm-none-eabi-gcc。具体步骤：先在 VSCode 里装好 PlatformIO 插件，然后用它打开固件源码工程目录，在 platformio.ini 里确认 board 是 bluepill_f103c8，framework 设置为 stm32cube。改好之后点一下 Build，几分钟就能编出固件。

如果你更熟悉 STM32CubeIDE，也完全可以。但要注意，GRBL 源码依赖 STM32 HAL 库的定时器、串口、USB 初始化代码，这些在 CubeMX 生成工程时必须勾选对应外设，否则编译直接报错。我第一次用 CubeIDE 编译的时候就踩了“缺少 USB 设备描述符回调”的坑，后来回去看了工程 README 才发现它要求先跑一下 CubeMX 重新生成代码，把外设初始化补全。

3.2 用 ST-Link Utility 烧录固件

最推荐的烧录方式是用 ST-Link V2 调试器，因为它走 SWD 接口，速度稳定、可靠，而且可以顺便检查芯片状态。接线就四根：ST-Link 的 SWDIO 接板子的 PA13，SWCLK 接 PA14，GND 接 GND，3.3V 看情况接（如果 ST-Link 能从 USB 供电给目标板，可以接，但我建议还是不要靠 ST-Link 给板子供电，因为 Blue Pill 在带电机驱动板的情况下电流需求并不小，ST-Link 那点电流很容易被拖垮）。

打开 STM32 ST-LINK Utility，先点 Target -> Connect，连接成功后会看到芯片型号和 Flash 大小。然后点击 Target -> Program，选择解压出来的 .hex 或 .bin 文件，把地址设为 0x08000000，烧录完成后按一下板子上的复位键，固件就开始运行了。

这里要提醒一个非常常见的问题：如果你之前在这块板子上烧过其他程序，而且那个程序禁用了 SWD 引脚，或者芯片开启了读保护，ST-Link 会一直连不上。解决方法是先把 BOOT0 跳线跳到 1，让芯片从系统存储器启动，而不是从 Flash 启动，再用 ST-Link 连接并擦除整个 Flash，最后把 BOOT0 跳回 0，重新烧录。

3.3 没有 ST-Link 时的串口 ISP 烧录

手上没有 ST-Link 也没关系，用 USB 转 TTL 模块一样能烧，走的是芯片内置的串口 ISP 引导程序。把 BOOT0 跳到 1、BOOT1 保持 0，PA9 和 PA10 分别接 USB 转 TTL 的 RX 和 TX，GND 共地，然后用 FlyMcu 或者 STM32CubeProgrammer 的 UART 模式连接。选择串口号、波特率 115200，点击读取芯片信息，能读到芯片就说明 ISP 链路通了。

烧录时需要选择 .hex 文件，擦除全片之后写入，然后要把 BOOT0 跳回 0，再按复位键，固件才会从 Flash 启动。这个流程稍微麻烦，好处是不需要额外买调试器，USB 转 TTL 模块基本人人都有。FlyMcu 这个软件有点老，界面也简陋，但胜在稳定，大部分人烧录 Blue Pill 都是靠它。

3.4 连接上位机并执行第一次回测

固件烧好之后，电脑上插上 USB 线或者接上 USB 转 TTL 模块，打开设备管理器，看看串口有没有出现。CH340 会出现一个 USB-SERIAL CH340 的 COM 口，CP2102 会出现 Silicon Labs CP210x USB to UART Bridge 的 COM 口，FT232R 和 FT231X 都会出现 FTDI FT232R USB UART 的 COM 口，而板载 USB 虚拟串口则显示为 STMicroelectronics Virtual COM Port。如果没有出现，先别慌，大概率是驱动问题，这个我在第五部分详细说。

打开 grbl control 或者 grbl studio，选对 COM 口，波特率填 115200，点击打开连接。正常情况下立刻就能在日志区域看到固件返回的欢迎信息，一般是一行类似 “Grbl 1.1h ['$' for help]” 的字符串。看到这行字符串，就说明固件在正常跑了。我自己习惯先用串口调试助手发一个 ? 命令，收到状态报告就说明通信完全畅通。

4. GRBL 参数配置与多轴扩展

4.1 核心参数速查

GRBL 的参数通过$命令来查看和设置。连上上位机之后，先发一个$$，固件会把当前所有参数全部打印出来。不同版本的参数编号基本兼容，我在这里按我自己常用的版本列一份速查表。

其中 $100/$101/$102 是所有人必须改的参数，直接决定了电机走多少步才是一毫米。计算公式很简单：步进电机固有步数（通常 200 步/圈）乘以驱动器细分数，再除以丝杆导程（或者齿轮减速比换算出来的每毫米行程）。比如一个 1.8 度的步进电机，驱动器设置为 16 细分，丝杆导程是 5mm，那 X 轴的步数/mm 就是 200 × 16 ÷ 5 = 640。这个值填错，最直观的后果就是 G 代码里走 10mm，实际跑出去 8mm 或者 12mm，怎么调都对不上图纸尺寸。

4.2 三轴到六轴怎么配

原版 GRBL 只支持 3 轴，而 32 位版固件一般能支持到 6 轴。但这不意味着烧录进去就直接能用 6 轴，多出来的 A、B、C 轴通常需要在固件编译阶段就开启，或者在参数层面对应轴做一些显式配置。

我用的这套固件，编译时默认开启了前三轴，第四轴 A 轴也要自己打开宏定义，然后再重新编译。打开之后，$103 就是 A 轴步数/mm，$113 是 A 轴最大进给率，$123 是 A 轴加速度，$133 是 A 轴行程。以此类推，B 轴对应 $104/$114/$124/$134，C 轴对应 $105/$115/$125/$135。如果你只是把某个轴当作旋转轴（比如第四轴做旋转雕刻），那步数/mm 需要按旋转轴的角度步数来算，而不是线性的 mm 步数。比如一个 200 步的步进电机、16 细分、减速比 5:1，那每转一周是 200 × 16 × 5 = 16000 步，对应 360 度，步数/度就是 16000 ÷ 360 ≈ 44.44。

有一点很重要：不是所有固件都默认把 6 轴全部映射到引脚上。如果你需要 5 轴或者 6 轴，一定要看固件源码里的 cpu_map 或 pinout，确认对应轴位是否已经分配了步进脉冲和方向引脚。如果没有分配，那就要自己改引脚映射重新编译，难度会稍微高一些，但只要盯住定时器通道和 GPIO 配置，基本能搞定。

4.3 常见配置误区

第一个误区：改完参数不重启。GRBL 的很多参数，尤其是 $100 系列步数/mm 和 $110 系列进给率，在修改后需要软复位或者重启固件才能真正生效。你连着 grbl control 改完参数，如果不执行重启命令，下次发 G 代码走的还是旧参数，很容易让人误以为参数没保存。我自己习惯改完就发一个 Ctrl+X 或者直接按上位机的重置按钮。

第二个误区：进给率设置过高。很多人刚装好 3 轴，兴奋地设了一个 5000mm/min 的进给率，实际跑起来电机啸叫、丢步、甚至板子重启。原因很简单：脉冲频率超过了固件或者驱动器的承受范围。以 $100=640、$110=5000 为例，这个参数组合下的脉冲频率是 640 × 5000 ÷ 60 ≈ 53.3kHz，一般没问题，但如果细分再高一点、进给再快一点，就很容易超限。所以配置完之后，先用低速试跑，比如 F100，然后逐步加大，不要一上来就全速冲刺。

第三个误区：激光模式搞错。如果你要接激光模块做雕刻，$32 必须设为 1。这个参数开启后，主轴 PWM 会随着运动指令实时开关，否则激光会一直常亮，容易烧坏工件，而且激光模式下运动轨迹规划的逻辑也不一样，不改这个参数，雕刻出来的线条边缘会很糊。

第四个误区：把 Arduino 版 GRBL 的习惯直接套到 32 位版。Arduino 版在改完参数后需要写 EEPROM 保存，32 位版虽然也做了 EEPROM 模拟，但不同固件版本的保存时机不一样，有的版本是在每次参数修改时自动写，有的需要手动执行一条特定的存储命令。建议拿到固件后先看 README 里关于参数保存方式的说明，免得每次断电都要重新配置一遍。

5. 常见问题与排查实录

5.1 USB 和串口识别不到

这个问题是我被问得最多的，也是新手最容易卡住的地方。现象是插上 USB 线，电脑一点反应都没有，或者设备管理器里出现一个带黄色感叹号的未知设备。

处理顺序我建议这样：第一步，确认线是不是纯充电线，很多 USB 线只有电源线没有数据线，这种情况在 mini-USB 时代尤其常见，换一条线试试；第二步，看设备管理器里出现的是什么。如果是 CH340 相关的未知设备，就去装 CH340 的官方驱动；如果是 CP2102，去 Silicon Labs 官网下 CP210x 驱动；如果是 FTDI 芯片（FT232R、FT231X），去 FTDI 官网下 VCP 驱动，Win10/Win11 下如果系统自动更新装了一个错误版本的 FTDI 驱动，一定要手动卸载后装官网新版。

特别说一下 STM32 板载 USB 虚拟串口。这种设备依赖固件的 USB 描述符，Windows 一般会识别成 COM 端口，但偶尔会有识别不到的情况。一个有效的办法是用 Zadig 给这个设备安装 WinUSB 驱动，或者去 ST 官网下载并安装 STM32 Virtual COM Port 驱动。如果连设备枚举这一步都没到，用 USB Device Tree Viewer 看一下 USB 总线上有没有设备挂载，如果能看到设备但无法识别，多半是固件 USB 描述符与驱动不兼容；如果根本看不到设备，请检查 USB 口的 D+ 上拉电阻和 USB 线的信号线是否正常。

Linux 下又是另一套情况，但结论很简单：设备节点一般是 /dev/ttyACM0 或 /dev/ttyUSB0，如果没有权限，执行sudo chmod 666 /dev/ttyACM0即可。如果你发现从串口接收数据会丢失，最可能是上位机设置的波特率与固件不一致，因为 GRBL 默认 115200，如果你不小心配到了 9600，那根本不可能顺畅通信。

5.2 烧录失败的问题排查

烧录失败也是高频问题，我把常见情况整理成一张表，方便你直接对照排查。

我遇到过最诡异的一次：ST-Link 连上了，烧录也显示成功，但板子就是不工作。后来发现是我忘了把 BOOT0 从 1 跳回 0，固件一直停留在 ISP 引导模式。这个错误很小，但排查起来很浪费人生，写在这里提醒一下。

5.3 电机不转、抖动、乱跑

固件跑起来了，参数也设了，结果电机不转或者抖动，这是第二个大坑。

电机完全不转，先查驱动板供电，VMOT 有没有接 12V 或者 24V；然后查使能引脚，A4988 之类的驱动板 EN 引脚默认低电平使能，如果固件的使能逻辑是反的，需要检查 $4 参数。如果使能没问题，再检查步进 PUL 有没有信号，可以用示波器量一下引脚，没有示波器的话用万用表看电压跳动也行。

电机抖动最常见的原因是脉冲频率超出范围。尤其当你用的是高细分驱动板时，比如 32 细分，$100 参数算出来可能是 6400 步/mm，此时 $110 设置个 5000mm/min，脉冲频率就高达 6400 × 5000 ÷ 60 ≈ 533kHz，这个频率很多普通光耦隔离驱动器都跟不上了。降低细分、降低进给率、提高 $0 脉冲宽度，三个方向都能缓解。

电机往一个方向疯跑，这种一般是方向引脚没接好或者方向映射错误。确认 $3 的方向反转掩码，如果 X 轴方向反了，把 $3 的 bit0 置 1 就可以反转。另外 DIR 信号和步进脉冲的时序配合也很重要，GRBL 里的方向信号会在脉冲之前提前一点建立，如果驱动器反应慢，可以在固件里调方向建立时间，但多数情况下不用动。

5.4 上位机连接不上或频繁掉线

grbl control 和 grbl studio 都连不上的时候，先排查是不是串口被其他程序占用了。Windows 下同一时刻只能有一个程序占用串口，如果你开了串口调试助手又开 grbl control，那后者必然打不开。关掉其他占用程序再试。

还有一种情况是 USB 供电不足导致板子反复复位。现象就是连上后能收到一两条欢迎信息，然后立刻消失，或者每次点击连接都会听到 Windows 的 USB 拔插声。这时候单独给板子接一个稳定电源，问题基本就解决了。

grbl studio 连不上的一个细节：它默认的波特率是 115200，但有些 USB 转 TTL 模块在高波特率下如果线材质量差、干扰大，就会丢数据，导致连接不稳定。可以尝试把波特率降到 57600 或者 38400，然后在固件里重新编译对应波特率配置，或者在 grbl studio 里修改串口波特率再测试。

写在最后的实操体会

这套基于 STM32 的 32 位 GRBL 固件，我前前后后用了小半年，从最初的 3 轴改到现在的 4 轴，最大的感受是：可玩性和稳定性都远高于 Arduino 方案，但前提是你要耐心把引脚映射和参数配置吃透。拿到固件包的第一时间，不是急着接线，而是先看源码里的引脚定义，确认每个轴对应哪些定时器通道，这样才能少烧几块驱动板。

一个小技巧分享给你：把步数/mm 的计算公式直接存到上位机的参数备注里，每次换机械结构直接套用，不用重新推导。另一个建议是先把 USB 或串口通信跑通，确认能看到固件欢迎信息之后再接电机和机械部分，分轴调试时单独发G91 G1 X10 F100这样的短命令，逐个方向确认，遇到问题就能很快定位到具体是哪个轴、哪个信号出了问题。多轴控制的折腾过程确实费时间，但当你看到四个轴同时跟着代码顺畅运动的时候，前面那些排查的辛苦，一下子就值了。

本文还有配套的精品资源，点击获取