1. 项目概述

1.1 项目背景

        步进电机(Stepper Motor)是工业自动化、3D 打印、CNC、机器人等领域常用的执行元件。与直流电机不同,步进电机通过接收脉冲信号来控制转动角度,每个脉冲驱动电机转动一个固定的"步距角",因此具有开环精度高、控制简单、无需编码器反馈等优点。

        TMC2209是德国Trinamic(现 Maxim Integrated)推出的超静音步进电机驱动芯片,在SilentStepStick模组上集成了完整的功率级电路。该芯片采用StealthChop2斩波技术,使电机在低速运行时几乎无声,非常适合桌面级应用。

        本项目使用ST官方推出的STM32H533 Nucleo开发板作为主控,搭配TMC2209 SilentStepStick驱动板,实现一个完整的三按键步进电机演示系统。

1.2 功能目标

1. 启动:用户按键按下后,电机使能端(EN)拉低,LED 点亮,电机从极慢速度通过斜坡平滑加速到当前档位的目标速度,持续单方向旋转。

2. 停止:再次按下用户按键,电机使能端拉高,LED 熄灭,电机停转。

3. 方向切换:在运行状态下,按下按键 A,电机先减速到一个低速阈值,再翻转方向信号,最后加速回目标速度,实现完全平滑的换向。

4. 速度切换:在任何时候(运行中)按下按键 B,目标速度切换到下一档,电机通过斜坡平滑过渡到新速度(若当前在换向过程中,会在换向完成后再开始速度过渡)。

2. 硬件资源说明

2.1 主控板:STM32H533 Nucleo

        STM32H533 是 ST 推出的高性能 Cortex-M33 微控制器,基于 250 MHz 主频,具有丰富的外设资源。Nucleo-H533 板集成了 ST-LINK/V3 调试器、USB 接口、Arduino 兼容扩展排针,便于快速原型开发。

2.2 驱动板:TMC2209 SilentStepStick

• StealthChop2: 无噪音斩波技术,适合低速静音运行

• UART 配置接口: 可配置细分、电流等参数(本项目使用默认配置)

• 内置 MOSFET: 输出电流可达 2.5 A(RMS)

• 低功耗待机: EN 引脚拉高时驱动器进入高阻态

2.3 引脚分配总表

2.4 电源与接线

• MCU 板:USB 供电(5V),经板载LDO转3.3V

• TMC2209:由外部8~35 V直流电源VM供电(本演示使用9V)

• 逻辑电平:3.3V (与MCU直接兼容,无需电平转换)

3. 方案框图与设计思想

系统总体框图

整个系统的核心思想是:主循环几乎不参与任何电机控制,所有实时性要求高的动作都在中断服务程序中完成。这样做的好处:

• 主循环可以处理其他低优先级任务(如未来扩展的 UART 调试、LCD 显示等)

• 中断响应时间确定,不会因主循环耗时而被阻塞

• 代码结构清晰:按键事件 → 设置状态标志 → 1ms tick 推进状态机

为避免"中断中复杂操作"导致 ISR 过长,采用双层状态机:

按键事件 → 设置高层状态(ramp_state / speed_index)
                ↓
   TIM12 ISR 读取状态并推进
                ↓
   stepper_on_tick() 根据当前 ramp_state 做对应处理

4. 开发与调试环境

软件工具链

5. 软件流程图

主程序流程

6. 关键代码介绍

数据结构 stepper_controller_t

typedef struct {
    /* 顶层状态 */
    stepper_run_state_t    run_state;          /* DISABLED / RUNNING */
    stepper_direction_t    target_dir;         /* 期望方向 */
    stepper_direction_t    current_dir;        /* 实际 DIR 引脚 */
    stepper_pulse_phase_t  pulse_phase;        /* 步进脉冲内部相位 */
    stepper_ramp_state_t   ramp_state;         /* 斜坡状态 */

    /* 速度参数 */
    uint8_t   speed_index;            /* 当前档位 0..3 */
    uint16_t  target_period_us;       /* 目标步进周期 */
    uint16_t  current_period_us;      /* 实际步进周期 */
    uint16_t  acc_us;                 /* 1ms tick 微秒累加器 */

    /* 辅助计时 */
    uint16_t  pulse_ticks;            /* HIGH 相位计时 */
    uint16_t  settling_ticks;         /* DIR 建立等待 */
    int32_t   steps_in_dir;           /* 当前方向已走的步数 */
    uint8_t   dir_change_pending;
    uint16_t  ramp_counter_ms;        /* 斜坡周期计时 */

    /* 按键消抖时间戳 */
    uint32_t  last_press_tick_user;
    uint32_t  last_press_tick_dir;
    uint32_t  last_press_tick_speed;
} stepper_controller_t;

static stepper_controller_t stepper = { ... };

函数总览

stepper_toggle_enable — 启停切换核心

static void stepper_toggle_enable(void)
{
    if (stepper.run_state == STEPPER_DISABLED)
    {
        /* 启动: 缓慢起步,通过斜坡平滑加速到 target */
        stepper.run_state          = STEPPER_RUNNING;
        stepper.pulse_phase        = STEPPER_PHASE_READY;
        stepper.ramp_state         = STEPPER_RAMP_TO_TARGET;
        stepper.current_period_us  = STEPPER_STOPPED_PERIOD_US;
        stepper.target_period_us   = stepper_speed_period_us[stepper.speed_index];
        stepper.acc_us             = 0;
        stepper.pulse_ticks        = 0;
        stepper.settling_ticks     = 0;
        stepper.steps_in_dir       = 0;
        stepper.dir_change_pending = 0;
        stepper.ramp_counter_ms    = 0;
    }
    else
    {
        /* 停止: 立即关闭输出, 清零全部中间状态 */
        stepper.run_state          = STEPPER_DISABLED;
        stepper.ramp_state         = STEPPER_RAMP_IDLE;
        stepper.pulse_phase        = STEPPER_PHASE_READY;
        stepper.acc_us             = 0;
        stepper.pulse_ticks        = 0;
        stepper.settling_ticks     = 0;
        stepper.steps_in_dir       = 0;
        stepper.dir_change_pending = 0;
        stepper.ramp_counter_ms    = 0;
    }
    stepper_apply_output();
}

stepper_cycle_speed — 速度档位循环

static void stepper_cycle_speed(void)
{
    stepper.speed_index = (stepper.speed_index + 1U) % STEPPER_SPEED_COUNT;
    stepper.target_period_us = stepper_speed_period_us[stepper.speed_index];

    /* 若当前在 IDLE, 立刻启动一次 TO_TARGET 斜坡 */
    if (stepper.ramp_state == STEPPER_RAMP_IDLE)
    {
        stepper.ramp_state = STEPPER_RAMP_TO_TARGET;
        stepper.ramp_counter_ms = 0;
    }
}

stepper_request_dir_change — 方向请求

static void stepper_request_dir_change(void)
{
    if (stepper.run_state != STEPPER_RUNNING)
    {
        return;  /* 仅运行时允许换向 */
    }
    /* 计算新方向 */
    stepper.target_dir = (stepper.current_dir == STEPPER_DIR_CW)
                         ? STEPPER_DIR_CCW : STEPPER_DIR_CW;
    /* 触发减速斜坡,减速到阈值后由 stepper_on_tick 完成翻 DIR + 加速 */
    stepper.ramp_state = STEPPER_RAMP_DIR_CHANGE_DOWN;
    stepper.ramp_counter_ms = 0;
}

stepper_on_tick — 1ms ISR 核心

static void stepper_on_tick(void)
{
    /* 停止状态: 关闭输出 */
    if (stepper.run_state == STEPPER_DISABLED) { ... return; }

    /* 1) 斜坡推进 (每 20ms 应用一次) */
    stepper.ramp_counter_ms++;
    if (stepper.ramp_counter_ms >= STEPPER_RAMP_PERIOD_MS)
    {
        stepper.ramp_counter_ms = 0;
        switch (stepper.ramp_state)
        {
            case STEPPER_RAMP_TO_TARGET:
                /* current 朝 target 逼近 ±150us */
                ...
                break;

            case STEPPER_RAMP_DIR_CHANGE_DOWN:
                /* 减速: current += 150us */
                if (current >= DIR_CHANGE_US)
                {
                    /* 阈值到达: 翻 DIR + 进入 UP 阶段 */
                    stepper_apply_dir_pin(stepper.target_dir);
                    stepper.settling_ticks = STEPPER_DIR_SETUP_MS;
                    stepper.pulse_phase    = STEPPER_PHASE_SETTLING;
                    stepper.ramp_state     = STEPPER_RAMP_DIR_CHANGE_UP;
                }
                break;

            case STEPPER_RAMP_DIR_CHANGE_UP:
                /* 加速: current -= 150us 直到 target */
                ...
                break;
        }
    }

    /* 2) 步进脉冲生成 (按 current_period_us) */
    switch (stepper.pulse_phase)
    {
        case STEPPER_PHASE_READY:
            /* 累加器,达周期则 STEP=HIGH */
            if (acc_us >= current_period_us) { ... }
            break;
        case STEPPER_PHASE_HIGH:
            /* 保持 1ms 后 STEP=LOW */
            if (pulse_ticks >= 1) { ... }
            break;
        case STEPPER_PHASE_SETTLING:
            /* DIR 翻转后等待 5ms */
            if (settling_ticks-- == 0) phase = READY;
            break;
    }
}

由于定时器 tick 为 1ms,但目标周期可能小于 1ms(最快档 current_period_us=1000us 实际为 2ms 一脉冲),通过 acc_us 累加器实现分频:

设 period_us = 3000us:
  tick 1: acc=1000, <3000 不触发
  tick 2: acc=2000, <3000 不触发
  tick 3: acc=3000, ≥3000 触发, STEP=HIGH
  tick 4: HIGH 相位 → STEP=LOW (返回 READY)
  tick 5: acc=1000, <3000
  tick 6: acc=2000, <3000
  tick 7: acc=3000, 触发
  → 上升沿间隔 = 4ms (250 步/秒)

整除周期(如 1500us)由累加器自动取平均,长期均匀。

HAL 回调覆写

HAL 库使用弱符号机制,用户可在自己的文件中重写关键回调:

HAL_TIM_PeriodElapsedCallback

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
    if (htim->Instance != TIM12) return;
    stepper_on_tick();
}

HAL_GPIO_EXTI_Falling_Callback

void HAL_GPIO_EXTI_Falling_Callback(uint16_t GPIO_Pin)
{
    if (GPIO_Pin == GPIO_PIN_10)       /* PA10 = 按键 A = 方向 */
    {
        if (stepper_debounce_check(&stepper.last_press_tick_dir) == 0U) return;
        stepper_request_dir_change();
    }
    else if (GPIO_Pin == GPIO_PIN_9)   /* PA9 = 按键 B = 速度 */
    {
        if (stepper_debounce_check(&stepper.last_press_tick_speed) == 0U) return;
        stepper_cycle_speed();
    }
}

BSP_PB_Callback

PC13 由 BSP 单独管理(因其初始配置为上升沿,且板内已有下拉),通过 BSP_PB_IRQHandler(BUTTON_USER) → BUTTON_USER_EXTI_Callback → BSP_PB_Callback 三级调用到达:

void BSP_PB_Callback(Button_TypeDef Button)
{
    if (Button != BUTTON_USER) return;
    if (stepper_debounce_check(&stepper.last_press_tick_user) == 0U) return;
    stepper_toggle_enable();
}

7. 功能验证与运行结果

实际连接如下：

8. 心得体会

本项目以"最小可用 + 良好扩展"为原则,在不到 500 行的应用代码中实现了:

• 3 个独立按键的中断响应与消抖

• 4 档速度循环与斜坡过渡

• 方向改变的减速-翻转-加速完整流程

• 启停时的完整状态管理

这套代码可直接用于实际产品的原型验证,也可作为嵌入式教学示例展示"状态机 + 中断驱动"的标准模式。希望本项目能对后续开发者有所帮助。