STM32F103+CoreXY步进电机运动控制实现

用STM32F103驱动CoreXY机构的步进电机运动控制，整个过程最考验的不是让电机转起来，而是脉冲控制、加减速规划和结构联动是否稳定。我这次把CoreXY平台的最小系统跑通之后发现，单纯点动很容易，真正有价值的部分是把XY两个轴换算成两台电机的转速关系，再用稳定脉冲把运动指令跑完。

下面按这个顺序拆：先讲清楚CoreXY为什么需要两个电机联合控制，再给硬件接线、代码示例、调试方法和容易踩的坑。适合手里有STM32F103最小系统板、两相四线步进电机和驱动器，想把小尺寸绘图机、激光头或物料平台跑起来的人。

1. CoreXY + STM32F103 的组合到底值不值得做

1.1 先想清楚：CoreXY 不是简单的 X 轴加 Y 轴

很多第一次接触CoreXY的人，会默认把左边的电机叫X电机，把右边的电机叫Y电机。这个理解在控制层可以直接导致调试失败。CoreXY的结构特点是两个步进电机都固定在机架上，通过两根同步带联动，让运动头在XY平面里移动。也就是说，运动头往哪个方向走，取决于两个电机之间的转速差和方向组合。

这样设计的好处是运动头质量小、结构紧凑、加减速可以做得比较快，适合桌面级绘图和激光类应用。但对控制器来说，挑战变成了“两个电机同步协调”，而不是简单的“给A电机脉冲走X轴，给B电机脉冲走Y轴”。

我建议在写代码之前，先做一次运动学推导。不要只看别人项目里的公式，而是要对着自己机架的皮带绕法画一遍：同一方向转动两个电机时，运动头走哪个方向；一正一反转动时，又走哪个方向。因为皮带绕法和电机安装朝向不同，实际符号可能会和你参考的代码相反。先把这个弄清楚，后面至少省掉半天排错时间。

1.2 什么场景用 F103 合适，什么场景不合适

STM32F103适合的场景很明确：小尺寸CoreXY、轻载运动头、低速到中速运动、直线或简单圆弧路径，以及教育演示和原型验证。这个芯片主频72MHz，有多个定时器，能输出PWM，也支持DMA，做步进电机控制没有太大压力。

不适合的场景也很明确：高速高精度长时间生产，重负载龙门，需要处理复杂G代码和大量圆弧插补，以及要求很高同步精度的多轴联动。F103不是做不了，而是资源有限，开发成本和稳定性风险都会上升。如果目标是量产级设备，建议考虑F407、H7系列或独立的运动控制芯片。

还有一个容易被低估的点：如果只是在学习阶段，用标准外设库或者HAL库都可以，不要纠结“哪个库更高级”。真正决定运动稳定性的，是定时器配置、加减速算法和机械结构，而不是用哪个库。要是打算加FreeRTOS，也需要把任务优先级设计好，脉冲输出不能放在普通任务里用延时函数控制。

2. 硬件准备与接线：把机械和电气先拉通

2.1 核心器件清单与选型思路

CoreXY运动控制系统涉及的硬件并不算多，但每一件都要匹配好。下面是通用清单：

很多新手会拿24BYJ48这种小型减速步进电机来做CoreXY，它能跑，但不合适。24BYJ48内部是减速齿轮结构，转速低、转子惯量也不适合高速联动。CoreXY对两个电机的同步响应要求比较高，还是用42步进电机更省心。如果机架尺寸大、负载重，可以考虑57步进电机，但驱动器电流、电源功率和机械结构都要同步升级。

2.2 驱动器接线、细分设置和地线处理

常见的步进电机驱动器接口有STEP、DIR、ENABLE，以及电源端子和电机端子。STM32F103的GPIO输出到驱动器的控制信号，要注意共地。也就是说，MCU的GND和驱动器的逻辑GND必须接在一起，否则STEP脉冲很容易出现电平抖动或完全无响应。

我一般这样接线：

• STEP：接定时器PWM输出引脚，负责产生脉冲。
• DIR：接普通GPIO，控制电机正反转。
• ENABLE：接普通GPIO，低电平使能。默认可以拉低，或者悬空让驱动器保持使能。

驱动器细分设置一般通过MS1、MS2、MS3跳线完成。比如A4988使用1/16细分时，三个引脚都接高。细分越高，电机每转需要的脉冲数越多，低速振动越小，但控制器需要产生的脉冲频率也越高。桌面级CoreXY用1/16细分是比较常见的起点。

这里要特别注意：STM32F103的大多数IO不是5V耐受引脚。如果驱动器的逻辑电平是5V，不能直接把5V信号接到MCU引脚上，最好加电平转换电路或限流电阻。反过来，用3.3V逻辑输出通常可以兼容常见的步进驱动板，但最好确认驱动器逻辑输入阈值。

2.3 时钟和启动方式：外部晶振还是内部晶振

STM32F103最小系统板通常带8MHz外部晶振，核心时钟可以配置到72MHz。运动控制涉及定时器PWM，脉冲频率直接依赖定时器时钟，所以时钟源越准越好。

也有人在最小系统板上省掉外部晶振，完全使用内部HSI。这样可以跑，但在步进电机运动控制场景下要慎重。内部晶振的精度有限，温度变化后频率会漂移，长时间直线运动容易积累位置误差。如果你只是为了验证模块能不能转，内部晶振没问题；如果要让CoreXY画一段重复轨迹并回到原点，建议优先使用外部晶振。

低功耗场景可以另外考虑。比如电池供电、需要长期待机的设备，可以用STM32F103的Stop模式，在空闲时停止定时器并进入低功耗。但进入Stop模式之前要保证电机已经停止，且恢复后需要重新初始化定时器状态。运动控制任务里，低功耗和实时响应往往是矛盾的，不要为了省电牺牲脉冲稳定性。

3. 脉冲输出和加减速：步进电机运动控制的关键

3.1 为什么不能靠 GPIO 翻转延时

我见过不少人用HAL_GPIO_TogglePin加delay_us来产生步进脉冲。这样在单轴点动时看起来没问题，但一旦涉及CoreXY双轴联动，问题就来了：

• 延时函数的定时精度受中断影响，脉冲之间间隔不均匀。
• CPU被脉冲循环占满，不能同时处理串口指令、限位开关检测和运动规划。
• 两台电机需要同步，用软件切换GPIO很难保证两边相位一致。
• 高速时，软件翻转GPIO本身也占用大量CPU周期。

正确的做法是使用定时器硬件产生PWM脉冲。CPU只需要设置定时器的自动重载值、启动输出，剩下的脉冲由硬件自己翻转。这样即使有中断插入，脉冲宽度也相对稳定。

3.2 用定时器 PWM + 中断实现脉冲计数

热词里经常能看到“STM32F103 PWM + DMA PA1 PA3”这类组合。PA1和PA3确实可以复用为定时器通道，适合作为STEP输出。使用PWM输出时，占空比固定的情况下，脉冲频率由定时器周期决定，脉冲个数需要额外计数。

最简单的计数方案是使用定时器更新中断。每产生一个PWM周期，就进入一次中断，在中断里把脉冲计数加一，到达目标步数后关闭定时器。下面是一段简化伪代码：

// 伪代码：定时器PWM输出步进脉冲 void Motor_Step_Init(TIM_HandleTypeDef *htim, uint32_t Channel) { // 配置GPIO复用为TIM通道 // 配置PWM模式1，占空比50% // 先不启动输出 } void Motor_Move(int pulses, uint8_t dir) { HAL_GPIO_WritePin(DIR_PORT, DIR_PIN, dir ? GPIO_PIN_SET : GPIO_PIN_RESET); pulse_counter = 0; pulse_target = pulses; HAL_TIM_PWM_Start_IT(htim, TIM_CHANNEL_1); } void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM1) { pulse_counter++; if (pulse_counter >= pulse_target) { HAL_TIM_PWM_Stop_IT(htim, TIM_CHANNEL_1); Motor_Stop(); } } }

这个方案能跑，但中断频率会随速度升高而变高。如果设置高转速，中断会占用大量CPU时间，此时可以把步伐改得更“粗糙”：比如每N个脉冲进一次中断，或者使用DMA搬运速度表，让定时器自动改变ARR值，实现更平滑的加减速。DMA方式的核心思路是，把一串ARR值放在内存数组里，由DMA定时写到定时器的自动重载寄存器，CPU不需要在每次脉冲周期里干预。

注意：不同型号、不同库版本对定时器中断回调的封装不一样。示例代码能帮助理解，落到工程里时，要按你用的HAL库版本和芯片参考手册来调整。

3.3 梯形加减速：起步要慢，收尾要稳

步进电机的问题在于，脉冲频率从0瞬间跳到很高，电机转子跟不上，就会丢步。频率很高时突然停止，又可能因为惯性发生过冲。所以运动控制系统里通常要做加减速。

梯形加减速是最常用的一种：先加速到目标速度，保持匀速，再减速到0。在STM32F103上，可以预先计算一张速度表，保存加速段和减速段的定时器ARR值。每走一步，根据当前位置查表，更新定时器频率。

关键点如下：

• 加速段的起始频率不能太高，通常从几百Hz到几千Hz开始。
• 匀速段可以保持目标速度，但目标速度不要超过电机和机械结构能承受的上限。
• 减速段要提前开始，不能等跑到终点才减速。
• 加减速表如果计算成浮点数组，在F103上会占用Flash和RAM，建议用整数定标。

速度、加速度和机械刚度的关系最值得注意。提高加速度会让轨迹时间变短，但同步带如果张紧不足，运动头会抖动；电机扭矩不够时甚至直接丢步。不要一上来就追求最高速度，先把加速度调低，跑一条长直线，观察有没有丢步，再慢慢提高。

3.4 CoreXY 坐标映射：两个电机怎么合成 XY 运动

CoreXY的运动学映射可以通俗理解为：运动头在X方向的位移，来自两个电机同向转动的合成；Y方向的位移，来自两个电机反向转动的合成。具体方向和比例取决于皮带绕法。

假设你把目标位置换算成X方向脉冲增量dx_pulse和Y方向脉冲增量dy_pulse，那么两个电机的脉冲增量可以写成类似下面的形式：

// 根据实际CoreXY皮带绕法推导，下面只是示例 motorA_pulse = (dx_pulse + dy_pulse) / 2; motorB_pulse = (dx_pulse - dy_pulse) / 2;

这个公式看起来简单，但实际落地有几个坑：

• 如果两个电机的安装方向相反，第二个式子中的符号会变化。
• 如果皮带绕法不同，可能motorA_pulse = (dx - dy)/2，不能照抄。
• 除以2可能产生小数。不要在中断里用浮点运算，推荐用整数定标，或者保证目标位置步数是偶数。
• 最终两个电机的总步数不一定相同，所以运动队列里要分别记录两个电机的剩余步数和方向。

调试CoreXY联动时，不要直接跑复杂的画圆程序。我一般会先让运动头走一个单轴方向：手动推一下运动头，观察两个电机分别怎么转。然后在代码里分别让两个电机正转、反转，确认运动方向和预期一致。这个步骤最多十分钟，能避免后面所有运动轨迹都乱掉。

4. 代码落地：从点动到串口运动指令

4.1 驱动层：引脚、限位开关和点动测试

在写运动控制逻辑之前，先把底层驱动拆开。引脚定义要集中放在一个头文件里，方便改板子时统一调整。典型的定义包括：

#define MOTOR_A_STEP_PORT GPIOA #define MOTOR_A_STEP_PIN GPIO_PIN_1 #define MOTOR_A_DIR_PORT GPIOB #define MOTOR_A_DIR_PIN GPIO_PIN_0 #define MOTOR_B_STEP_PORT GPIOA #define MOTOR_B_STEP_PIN GPIO_PIN_3 #define MOTOR_B_DIR_PORT GPIOB #define MOTOR_B_DIR_PIN GPIO_PIN_1

点动测试是整个项目的第一道关卡。我给自己的顺序是：先单独让A电机正转和反转，再单独让B电机正转和反转，然后才组合起来看运动头方向。点动时最好用按键控制，每个按键对应一个方向和一条命令，代码足够简单，方便快速判断接线错误。

限位开关的接法也有讲究。机械微动开关默认要接成常闭或常开，避免线缆断开时被误判为触发。如果MCU内部上拉，开关一端接GND，打开内部上拉，触发时读到低电平。更稳妥的做法是在软件里加滤波，连续读到几次低电平才确认触发，防止机械抖动导致误停。

4.2 运动层：加减速表与简单命令队列

运动层要解决“怎么走”的问题。可以设计一个简单的结构体保存一条运动指令：目标X、目标Y、速度、加速度，以及是否需要等待完成。指令放到队列里，由运动规划器逐条解析，转换成两个电机的脉冲数、方向和速度曲线。

typedef struct { int16_t target_x; int16_t target_y; uint16_t feed_rate; uint16_t accel; } MoveCommand;

在F103上不需要一开始就实现完整的插补器。先支持直线运动就够了：把起点到终点的XY增量，映射成两个电机的脉冲量，再按加减速表执行。等直线没问题了，再考虑圆弧插补或连续轨迹。

如果使用FreeRTOS，可以用一个运动任务从命令队列里取指令，计算好参数后启动定时器，然后让出CPU。定时器中断只做脉冲计数和频率更新，不要在中断里打印日志、解析串口或者做浮点运算。这样做的目的很明确：把实时性要求高的部分交给硬件，把非实时部分放在任务里。

4.3 应用层：通过串口执行 G 代码形式的移动

应用层最简单的做法是通过串口接收类似G代码的文本命令。例如：

G0 X10 Y10 F800

G0表示快速移动，X10和Y10是目标坐标，F800是进给速度。收到命令后解析出数值，调用运动层的move_to()函数启动一次运动。

if (strncmp(cmd, "G0", 2) == 0) { int16_t x = parse_value(cmd, 'X'); int16_t y = parse_value(cmd, 'Y'); uint16_t feed = parse_value(cmd, 'F'); move_to(x, y, feed); }

这个设计的好处是方便上位机发送指令，也方便在串口调试助手里手动测试。对于绘图机或激光头，后续可以直接扩展成G代码文件解析器。

但这只是直线运动。真正要支持G代码里的圆弧和相对坐标，代码量会明显增加。建议在最初版本里先只支持G0和G1，把坐标、速度和加减速跑稳，再逐步加功能。

4.4 Vibecode 方式怎么用，才不会在硬件上翻车

Vibecode方式现在是很多项目迭代的常见做法，核心是用对话式辅助工具快速生成代码，再在板子上边跑边改。用在这种STM32F103步进电机项目上，效率确实高，但要注意几个问题。

第一，AI工具生成STM32代码时，经常默认你用的是某个特定库版本、某个特定型号的板子。如果生成的代码里引脚复用了串口、定时器通道，或者启动文件不匹配，编译能通过，下载到板子上也可能没有反应。

第二，AI生成的CoreXY运动学公式不一定适合你的皮带绕法。它可能给你一套标准公式，但你的机械结构因为电机安装方向不同，符号需要反过来。这时候不能只靠看代码找问题，要先手动验证电机方向。

第三，AI工具擅长生成“看起来完整”的工程，但不一定擅长老化边界条件：加减速表越界、限位触发后状态没恢复、脉冲目标为零时定时器还启动。这些边界问题往往才是运动控制里真正的坑。

所以我更建议把Vibecode当作编码工具，而不是设计工具。先自己把硬件接线、运动学方向和命令流程梳理清楚，再让辅助工具生成某一小段代码，最后逐段测试。这样既能提速，又不会在硬件调试里迷失方向。

5. 调试、常见问题与边界

5.1 丢步、抖动和噪声的排查顺序

丢步是步进电机项目里最常见的故障，现象包括：运动头跑不到目标位置、轨迹偏移、运行时有明显抖动、停止后位置和预期不一致。遇到丢步，我一般按这个顺序排查：

1. 先看电流。驱动器输出电流是否接近电机额定电流。A4988这类驱动器需要调Vref，调低了扭矩不够，最容易丢步。
2. 再看速度。把最大速度和加速度先降一半，如果现象消失，说明当前参数超出机械或电机能力。
3. 看细分。如果低速抖动明显，可以提高细分，比如从1/8改成1/16。
4. 看机械部分。同步带是否张紧、同步轮有没有松动、运动头和导轨之间有没有卡涩。
5. 看驱动信号。有条件的话，用逻辑分析仪看STEP引脚波形，检查脉冲是否均匀、有没有毛刺。

不要一上来就调电机电流到最大。电流太大会让电机发热严重，驱动器也可能过热保护。稳定运行的核心不是“电流大”，而是“电流匹配”。

5.2 电源、地线和信号干扰：最容易忽略的三件事

步进电机启动时电流瞬间变化很大，如果MCU和电机共用同一个电源，电压跌落会导致控制板复位或定时器时钟抖动。最稳妥的做法是步进电机使用独立的24V电源，MCU使用5V或3.3V电源，两者只共地，不共功率电路。

如果空间受限必须共用电源，那至少要在电机驱动器电源输入端加足够大的电解电容，在MCU电源附近加0.1uF和10uF滤波电容。电机电源线和STEP信号线不要并行走线，长距离时用屏蔽线并单端接地。

还有一个很多人会遇到的问题：最小系统板通过USB供电，电机一启动，电脑上的COM口就断开。这基本就是电压跌落或地线干扰导致的。解决方法是给控制板单独供电，不要把电机电源接到USB的5V上。

5.3 程序没输出或卡死的排查链路

如果程序下载后电机完全不动，不要急着改运动学公式。按下面的链路排查：

1. 看指示灯。MCU和驱动器是否都有电源；驱动器是否有错误指示。
2. 看引脚定义。STEP引脚是否真的配置成了定时器通道复用，GPIO和定时器通道是否匹配。
3. 看定时器配置。ARR值是否设置成了0，PWM模式是否选了正确极性，占空比是否设置成了50%。
4. 看中断回调。在中断回调里加个计数器，通过串口打印或调试器观察是否进入。如果不进入，说明定时器没有启动或中断优先级配置有问题。
5. 看限位开关。如果限位逻辑写反了，系统可能一启动就认为触发了限位，直接停止所有运动。
6. 看时钟配置。如果使用内部晶振且配置为72MHz，可能出现定时器频率不对。虽然通常不会完全不转，但速度会偏差，可用示波器或逻辑分析仪验证。

程序卡死也很常见。卡死不一定发生在运动开始，可能发生在一次运动结束后的状态清理阶段。比如定时器关闭后没有复位计数，下次运动参数异常，就会导致中断反复触发。建议每次运动结束后，把脉冲计数器、目标脉冲数和状态标志都清零，再等待下一次指令。

5.4 这个方案适合什么，不适合什么

STM32F103 + CoreXY这个组合，最适合的是桌面级原型。比如小型写字机、轻载激光头定位、教育演示底板、3D打印的简化验证平台。在这些场景里，F103的成本优势很明显，代码复杂度也容易控制。

但它不适合作为重型加工设备的控制器。CoreXY结构的皮带本身有弹性，运动头太重或者加速度太大，结构就会振动。F103虽然能输出稳定的脉冲，但无法补偿机械振动。如果要做闭环控制，还需要加编码器，甚至换用带运动控制外设的高性能MCU，F103更多是作为辅助控制器。

后续可以往几个方向优化：

• 把驱动器换成TMC2209这类静音驱动，同时支持失步检测。
• 给两个电机加编码器，实现简单闭环。
• 把核心运动规划放到上位机，F103只负责接收指令和产生脉冲。
• 增加OLED或触摸屏显示状态，但显示刷新不要占用定时器中断。

如果只是学习，默认配置通常够用。如果是长期使用，建议提前规划好日志、输出目录和任务队列。硬件运动控制最终比的是稳定，不是某一项参数跑得有多高。

最后留一个我自己的经验：先把单轴点动跑稳，再做双轴联动；先确认电机方向，再调加减速；先看日志和波形，再改参数。CoreXY本身不难，但前提是每一步都验证过再往下走。