一、项目概述

本项目基于 EEPW 与 DigiKey 联合举办的 2026 年第一期活动，完成了主题二：基于UART的TMC2209驱动参数配置系统的全部基础任务与进阶任务。

与常见的 STEP/DIR 脉冲控制方式不同，本项目完全抛弃 STEP/DIR/EN 引脚，采用纯 UART 寄存器通信方式，直接对 TMC2209 内部寄存器进行读写，实现了对电机的全面控制，包括：

• 微步细分动态设置（全步 ~ 1/256，共9档）

• 运行电流 / 保持电流实时配置（5% ~ 100%）

• 驱动模式切换（StealthChop 静音模式 ↔ SpreadCycle 高动态模式）

• 软件斜坡加减速（平滑启停，保护机械结构）

• 寄存器状态实时读回与串口打印

• 一键全自动演示系统（SHOW命令），为视频拍摄而专项优化

二、硬件连接

2.1 接线总览

本项目最大的硬件特点是：PDN_UART 引脚承担收发复用，MCU 仅需一条信号线（加一只 1kΩ 限流电阻）即可完成 TMC2209 的双向 UART 通信。

⚠️ 关键细节：TX 与 RX 并联后通过 1kΩ 电阻连接至 PDN_UART，这是 TMC2209 单线 UART 半双工通信的标准接法。电阻阻值不可过小（防止短路）也不可过大（防止波形失真），1kΩ 为推荐值。

2.2 引脚对应表

本项目不使用 STEP、DIR、ENN 引脚，所有控制信号均通过 UART 寄存器下发。

三、软件架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────┐
│                 STM32U083C-DK                           │
│                                                         │
│  ┌───────────┐    ┌──────────────┐    ┌─────────────┐  │
│  │ 串口命令  │───►│  命令解析器  │───►│  状态管理   │  │
│  │ 接收模块  │    │ parseCommand │    │  g_velocity │  │
│  └───────────┘    └──────┬───────┘    │  g_ms_index │  │
│                          │            │  g_current  │  │
│                   ┌──────▼───────┐    │  g_mode     │  │
│                   │  演示状态机  │    └─────────────┘  │
│                   │ SHOW/DEMO/   │                      │
│                   │ DEMOC/COMPARE│                      │
│                   └──────┬───────┘                      │
│                          │ UART (115200bps)             │
└──────────────────────────┼──────────────────────────────┘
                           │ 1kΩ
                    ┌──────▼──────────────┐
                    │  TMC2209 寄存器     │
                    │  GCONF / CHOPCONF   │
                    │  IHOLD_IRUN / VMAX  │
                    └──────┬──────────────┘
                           │ 相线驱动
                    ┌──────▼──────┐
                    │  42步进电机  │
                    └─────────────┘

3.2 关键模块说明

系统由以下几个核心模块构成：

四、核心功能实现

4.1 UART通信初始化与验证

上电后，系统首先验证与 TMC2209 的 UART 通信是否正常。若通信失败，立即输出详细的错误提示，避免带着故障继续运行：

stepper_driver.setup(serial_stream, SERIAL_BAUD_RATE);
delay(2000);

if (!stepper_driver.isSetupAndCommunicating()) {
    Serial.println("╔═══════════════════════════════════╗");
    Serial.println("║  [错误] TMC2209 UART通信失败！    ║");
    Serial.println("║  检查: TX/RX → 1kΩ → PDN_UART    ║");
    Serial.println("║  检查: VIO=3.3V, VMOT=12V         ║");
    Serial.println("╚═══════════════════════════════════╝");
    while (true) delay(1000);  // 挂起，等待排查
}

初始化成功后，一次性配置所有默认参数：

stepper_driver.setRunCurrent(50);        // 运行电流50%
stepper_driver.setHoldCurrent(25);       // 保持电流25%
stepper_driver.setMicrostepsPerStep(16); // 默认1/16细分
stepper_driver.enableStealthChop();      // 默认静音模式
stepper_driver.enableCoolStep();         // 使能CoolStep节能
stepper_driver.enable();                 // 软件使能驱动器

4.2 转速与VMAX寄存器换算

TMC2209 内部脉冲发生器（VACTUAL 寄存器）的单位并非 RPM，而是基于内部时钟频率（约12MHz）的步进脉冲计数率。系统实现了双向换算函数：

// RPM → VMAX 寄存器值
// 公式: V = (RPM/60) × 全步数 × 细分数 / 时钟换算因子
int32_t rpmToVelocity(float rpm, uint16_t microsteps) {
    return (int32_t)((rpm / 60.0f) * FULL_STEPS_REV
                     * microsteps / FCLK_FACTOR);
}

// VMAX 寄存器值 → RPM（用于状态显示）
float velocityToRpm(int32_t vel, uint16_t microsteps) {
    return (abs(vel) * FCLK_FACTOR)
           / (FULL_STEPS_REV * microsteps) * 60.0f;
}

换算依据：FCLK_FACTOR = 0.715f，由 TMC2209 内部 12MHz 时钟推导得出。细分切换时系统自动重新计算 VMAX 值，保持转速不变，无需手动重算。

4.3 软件斜坡加减速

步进电机在高速时若突然启停，容易因惯性失步。系统实现了60步线性插值的软件斜坡：

void rampTo(int32_t target, uint16_t steps = 60,
            uint8_t interval_ms = 15) {
    int32_t start = g_running ? g_velocity : 0;
    for (uint16_t i = 1; i <= steps; i++) {
        int32_t v = start + (int32_t)(
            (float)(target - start) * i / steps);
        stepper_driver.moveAtVelocity(v);
        delay(interval_ms);
    }
    stepper_driver.moveAtVelocity(target);
    g_velocity = target;
    g_running  = (target != 0);
}

整个加速过程约耗时 60 × 15ms = 900ms，兼顾响应速度与平顺性。

4.4 寄存器状态实时读取

通过 STATUS 命令，可一键从 TMC2209 读回所有关键寄存器并格式化打印：

五、基础任务验证

5.1 微步细分对比（DEMO 命令）

测试策略：固定转速 5 RPM（极慢速），依次切换全步 → 1/4 → 1/16 → 1/256，在电机轴上安装指针臂辅助观察。

✅ 验证结论：细分数越高，转动越平滑，但寄存器 VMAX 值须同比例增大才能维持相同转速。程序已自动处理这一补偿逻辑。

5.2 电流设置对比（DEMOC 命令）

测试策略：固定 30 RPM、1/16 细分，依次设置 10% → 50% → 100% 运行电流，通过手指捏轴感受力矩差异。

✅ 验证结论：电流与力矩呈近线性关系。实际使用中建议从额定电流的 50% 开始调整，在满足力矩需求的前提下尽量降低电流，减少发热。

六、进阶任务验证

6.1 驱动模式切换（COMPARE 命令）

测试策略：相同转速（60 RPM）、相同细分（1/16），仅切换驱动模式，对比噪音差异。

StealthChop 模式：
  SC 命令 → enableStealthChop()
  → 写入 GCONF 寄存器：en_spread_cycle = 0
  → 电机几乎无声，仅有轴承轻微摩擦音

SpreadCycle 模式：
  SP 命令 → disableStealthChop()
  → 写入 GCONF 寄存器：en_spread_cycle = 1
  → 明显电磁啸叫，"嗞嗞"声清晰可闻

6.2 实时参数修改与串口交互

系统实现了完整的文本命令交互界面，支持18条指令，全部实时生效：

╔═══════════ 命令帮助 ═══════════╗
║ ── 自动演示（视频拍摄用）──     ║
║ SHOW     一键完整演示           ║
║ DEMO     微步细分对比           ║
║ DEMOC    电流设置对比           ║
║ COMPARE  驱动模式对比           ║
║ GUIDE    交互演示引导           ║
║ ── 电机控制 ──                  ║
║ START    启动电机               ║
║ STOP     停止电机               ║
║ REV      反转方向               ║
║ ── 参数设置 ──                  ║
║ V<n>     VELOCITY原始值         ║
║ RPM<n>   按RPM设速度            ║
║ RAMP<n>  斜坡到目标RPM          ║
║ MS<0~8>  微步 1/1~1/256         ║
║ C<5~100> 电流百分比             ║
║ ── 驱动模式 ──                  ║
║ SC       StealthChop静音        ║
║ SP       SpreadCycle高动态      ║
║ STATUS   读取寄存器状态         ║
╚═════════════════════════════════╝

典型交互演示序列（进阶任务手动操作部分）：

START         → 电机以30RPM启动
RPM120        → 平滑加速至120RPM
SC            → 切换静音模式，噪音立即降低
SP            → 切换高动态模式，啸叫声出现
MS0           → 切至全步，明显顿挫
MS8           → 切至1/256，立即恢复丝滑
C20           → 电流降至20%，力矩减小
C80           → 电流升至80%，力矩恢复
STATUS        → 读取并打印所有寄存器当前值
STOP          → 斜坡减速停止

七、一键演示系统（SHOW命令）

为方便视频拍摄，系统设计了 SHOW 命令，一键顺序执行所有演示环节，并在每个环节开始前自动进行 3秒倒计时，方便摄像机对焦和记录：

SHOW 命令执行流程：
  ├─ 5秒倒计时："完整演示即将开始"
  ├─ 演示1：demoMicrostep()  微步对比（全步→1/256，各8秒）
  ├─ 等待3秒
  ├─ 演示2：demoCurrent()    电流对比（10%→50%→100%，各8秒）
  ├─ 等待3秒
  ├─ 演示3：demoMode()       模式对比（SC vs SP，各8秒）
  ├─ 等待2秒
  └─ 演示4：demoInteractive() 打印手动交互引导

八、效果对比总结

九、遇到的问题与解决

问题1：UART通信失败

现象：上电后串口提示 UART通信失败。
原因：PDN_UART 引脚的 1kΩ 电阻焊接时虚焊。
解决：重新焊接，确认电阻阻值，通信即恢复正常。

问题2：细分切换后转速异常

现象：执行 MS0（切到全步）后，电机转速明显加快。
原因：细分变化后，VMAX 寄存器值未同步换算，单位步长增大导致等效转速飙升。
解决：在 parseCommand 的 MS 分支中，切换细分时自动用 velocityToRpm() + rpmToVelocity() 进行补偿换算，保持转速不变。

问题3：模式切换后电机短暂失步

现象：从 SpreadCycle 切回 StealthChop 时，电机有轻微颤动。
原因：StealthChop 需要一段学习时间才能建立正确的电流波形。
解决：属于正常现象，切换前适当降低转速可减轻颤动。

十、总结与展望

本次活动成功完成了基础任务和进阶任务的全部要求：

✅ MCU 通过 UART 动态配置微步细分（1/1 ~ 1/256 共9档）
✅ MCU 通过 UART 动态配置运行电流（5% ~ 100%）
✅ 验证了不同细分下电机运行的平滑度差异
✅ 验证了不同电流设置下力矩输出的变化
✅ 实现了 StealthChop / SpreadCycle 驱动模式实时切换
✅ 实现了运行参数（转速/电流/细分/模式）的实时修改
✅ 实现了串口打印当前配置与寄存器状态  

后续可以扩展的方向：

• 接入 STM32U083C-DK 板载 LCD 显示当前参数，实现无串口可视化

• 利用 coolStep 功能实现负载自适应节能

• 基于 stallGuard4 实现无传感器堵转检测与自动归零

• 通过 OTP 固化常用配置，掉电不丢失

感谢 EEPW 和 DigiKey 提供的这次实践机会！TMC2209 的 UART 全寄存器控制方式为步进电机应用带来了前所未有的灵活性，期待在后续项目中继续深入探索。