1. 堵转检测为什么值得花时间调TMC5160 这颗驱动芯片在 DIY 圈子里火了好几年静音、防抖、内置六点加减速曲线随便拎一个出来都能让传统 A4988 用户眼馋。但真正让它在同类产品里站稳脚跟的其实是StallGuard2这个无传感器负载检测功能。说白了它让电机在不需要外挂编码器的情况下也能感知到自己是不是被卡住了、是不是撞到了限位、是不是扭矩快撑不住了。这个功能听起来很美好实际调起来却让不少人抓狂。我见过太多人把SG_RESULT读出来一看数值从 0 到 1023 之间乱跳电机空转的时候读数比堵转还低或者干脆一直贴着 0 不动。然后就开始怀疑芯片是假的、驱动板布线有问题、电机不匹配折腾一圈下来发现其实只是几个寄存器的参数没配对。这篇内容就是把我自己踩过的坑、帮别人远程排查过的案例以及从 TMC5160 数据手册字缝里抠出来的细节整理成一份可以直接抄作业的调参指南。不管你是用 Arduino 配 TMC5160 做 3D 打印机挤出机堵转保护还是用 STM32 做 CNC 的碰撞回退又或者只是想搞明白SG_RESULT到底该怎么看这里应该都能找到能直接用的东西。核心关键词先摆出来TMC5160、StallGuard2、SG_RESULT、SGT、TCOOLTHRS。这五个词基本覆盖了整个调参链路后面每个章节都会围绕它们展开。适合有基本步进电机驱动经验、能看懂寄存器配置、手头有串口调试工具的读者。纯小白建议先把 TMC5160 的 Datasheet 第 11 章翻一遍再回来不然有些概念会接不上。2. StallGuard2 到底在测什么2.1 从反电动势到 SG_RESULT 的物理链路很多人把 StallGuard2 当成一个“堵转开关”觉得配置好了就应该输出一个“堵了/没堵”的布尔值。实际上它输出的是一个0 到 1023 的负载指标数值越小代表负载越重数值越大代表负载越轻。这个数值就是SG_RESULT。它的物理原理并不复杂。步进电机在旋转时线圈里会产生反电动势这个反电动势和转速、负载都有关系。TMC5160 在每一个微步周期内会测量线圈电流达到目标值所需的时间或者说测量电流波形的一个特征点。当电机负载轻、转速稳定时这个测量值比较“干净”当负载加重、电机开始失步或者堵转时电流波形会发生畸变测量值就会明显下降。SG_RESULT就是这个测量值的数字化结果。它不是扭矩的直接读数也不是一个线性指标更像是一个“健康度评分”。空载时可能跑到 800 到 1000中等负载降到 400 到 600接近堵转时掉到 100 以下完全堵死时可能直接归零。这里有一个关键点SG_RESULT 的绝对值没有意义有意义的是它在你的具体系统里的相对变化。同一颗芯片换一个电机、换一个电压、换一个转速读数范围可能完全不一样。所以调参的第一步不是去追求某个“标准值”而是先在你的系统里建立一个基线。2.2 SGT 和 TCOOLTHRS 各自管什么SGT是 StallGuard2 的阈值寄存器全称 StallGuard Threshold。它决定了SG_RESULT在什么条件下被判定为“堵转”。具体来说当SG_RESULT低于某个由SGT决定的阈值时芯片的DIAG或者SG_STOP信号就会触发。SGT是一个有符号的 7 位值范围是 -64 到 63。它的作用不是直接设定一个SG_RESULT的数值门槛而是调整 StallGuard2 内部的比较器偏移。SGT 越大越容易触发堵转SGT 越小越不容易触发。很多人在这里搞反了以为 SGT 是“灵敏度”调大应该更不敏感结果越调越乱。TCOOLTHRS是另一个关键寄存器全称 CoolStep Threshold。它设定了 StallGuard2 开始工作的最低速度。在TCOOLTHRS以下的速度StallGuard2 不输出有效的SG_RESULT读数会飘或者直接为 0。这是因为低速时反电动势太弱测量信噪比不够。所以一个常见的坑就是电机慢慢转的时候读SG_RESULT发现一直是 0然后以为芯片坏了。其实只是速度没超过TCOOLTHRS。TCOOLTHRS 的单位是 TSTEP也就是两个微步之间的时间间隔。TSTEP 越小速度越快。所以TCOOLTHRS设得越大StallGuard2 启动的速度门槛就越低。这两个寄存器的配合关系可以这样理解TCOOLTHRS决定“什么时候开始测”SGT决定“测到多少算堵转”。两个都配对StallGuard2 才能稳定工作。2.3 为什么你的 SG_RESULT 会飘忽不定SG_RESULT读数不稳通常不是单一原因造成的。我整理了一下自己遇到过和帮别人排查过的案例大概可以归成几类速度太低电机转速对应的 TSTEP 大于TCOOLTHRSStallGuard2 根本没在正常工作区间。SGT 设置不合理SGT 太靠近边界导致SG_RESULT在阈值附近来回穿越触发信号抖动。电机电流设置不对IHOLD和IRUN如果太小电机本身扭矩不足SG_RESULT会整体偏低且不稳定。供电电压波动电源纹波大或者电压接近电机额定下限反电动势测量会受到干扰。微步设置和实际转速不匹配微步数太高导致单个微步的电流变化太小测量分辨率下降。SPI 读取时机不对SG_RESULT是一个实时更新的值如果在电机换向或者加减速的瞬间读取读数会跳变。这六条里前三条占了八成以上的案例。所以调参的顺序应该是先确认速度在 StallGuard2 工作区间内再调 SGT最后检查电流和供电。3. 调参前的硬件和软件准备3.1 硬件清单与接线检查在开始调寄存器之前先把硬件层面能排除的问题排除掉。我一般会按下面这个清单过一遍检查项正常状态常见问题电机相线四线两两导通阻值接近相线接错、虚焊供电电压在电机额定电压 1.2 到 1.5 倍电压过低导致扭矩不足电源纹波空载和负载下波动小于 5%纹波大导致 SG_RESULT 跳变SPI 接线SCK、MOSI、MISO、CS 四线可靠线太长或没屏蔽导致读写错误散热芯片温度低于 80 度过热降频影响测量电机轴负载空载可自由转动机械卡死导致误判特别说一下 SPI 接线。TMC5160 的寄存器读写对时序比较敏感如果杜邦线太长或者没有共地读出来的SG_RESULT可能是错的。我遇到过一个人SG_RESULT一直显示 1023换了三块驱动板都没解决最后发现是 MISO 线虚焊读到的全是 0xFF。3.2 软件工具与最小测试代码调参需要一个能实时读寄存器的环境。我习惯用 Arduino 或者 STM32 加一个串口打印把SG_RESULT、TSTEP、SGT、TCOOLTHRS这几个值一起输出方便对照。下面是一个最小可用的读取框架基于 Arduino 和 TMCStepper 库#include TMCStepper.h #define CS_PIN 10 #define SW_RX 18 #define SW_TX 19 #define R_SENSE 0.075f TMC5160Stepper driver(CS_PIN, R_SENSE); void setup() { Serial.begin(115200); SPI.begin(); driver.begin(); driver.toff(5); driver.rms_current(1200); driver.microsteps(16); driver.en_spreadCycle(false); driver.pwm_autoscale(true); // StallGuard2 初始配置 driver.TCOOLTHRS(0xFFFFF); // 先设一个很大的值让 StallGuard2 全速段工作 driver.SGT(10); // 初始阈值后面再调 driver.diag1_stall(true); // DIAG1 输出堵转信号 } void loop() { static uint32_t last 0; if (millis() - last 100) { last millis(); uint32_t sg driver.SG_RESULT(); uint32_t tstep driver.TSTEP(); Serial.print(SG_RESULT); Serial.print(sg); Serial.print( TSTEP); Serial.print(tstep); Serial.print( SGT); Serial.print(driver.SGT()); Serial.print( TCOOLTHRS); Serial.println(driver.TCOOLTHRS()); } }这段代码的作用是每 100 毫秒把关键寄存器打印一次。TCOOLTHRS先设成0xFFFFF是为了让 StallGuard2 在尽可能低的速度下也能工作方便观察低速时的SG_RESULT行为。等调好之后再根据实际工作速度收窄。注意R_SENSE必须和驱动板上的采样电阻一致。常见的 TMC5160 板子有 0.075 欧和 0.11 欧两种填错了电流计算会偏间接影响SG_RESULT。3.3 建立基线读数的操作步骤在调 SGT 之前先做一组基线测试。步骤很简单但必须按顺序来让电机空载以你实际应用中的工作速度旋转。比如 3D 打印机挤出机就用挤出速度CNC 就用切削进给速度。记录空载时的SG_RESULT和TSTEP。连续记录 20 个点看波动范围。用手给电机轴施加一个中等阻力模拟中等负载再记录一组数据。用手把电机轴捏住模拟堵转记录SG_RESULT的最低值。对比三组数据确定你的系统里“空载”“中等负载”“堵转”分别对应什么读数区间。这个基线非常重要。我见过有人直接抄别人的 SGT 值结果完全不能用因为电机型号、电压、速度都不一样。基线是你自己系统的指纹抄不来。4. SGT 和 TCOOLTHRS 的配合调法4.1 TCOOLTHRS 的计算与设置TCOOLTHRS的单位是 TSTEP而 TSTEP 和实际转速的关系可以这样算TSTEP 表示一个微步的时间间隔单位是时钟周期。TMC5160 的内部时钟通常是 12 MHz 左右具体看芯片版本。转速和 TSTEP 的关系是转速(转/秒) 1 / (TSTEP × 微步数 × 200 × 时钟周期)对于 1.8 度步进电机200 步一圈16 微步就是 3200 微步一圈。假设时钟周期是 83 纳秒12 MHzTSTEP 为 1000 时转速 1 / (1000 × 3200 × 83e-9) ≈ 3.76 转/秒 ≈ 225 RPM这个速度已经比较快了。实际应用中StallGuard2 在 50 到 200 RPM 之间通常工作得比较好。所以TCOOLTHRS可以设成对应你最低工作速度的 TSTEP 值。一个实用的做法是先让电机以你应用中的最低速度旋转读TSTEP寄存器然后把TCOOLTHRS设成这个值再稍微放大一点。比如读到 TSTEP 是 800TCOOLTHRS就设 1000 左右留一点余量。提示TCOOLTHRS设得太大StallGuard2 会在很低的速度就启动但低速时读数不可靠反而容易误触发。设得太小高速时才启动又可能错过低速堵转。所以它应该匹配你的实际工作速度范围。4.2 SGT 的二分法调参流程SGT 的调整我推荐用二分法比盲目试值快得多。具体流程如下先把 SGT 设成 0让电机空载运行记录SG_RESULT的平均值记为SG_empty。用手施加堵转记录SG_RESULT的最低值记为SG_stall。计算中间值SG_mid (SG_empty SG_stall) / 2。把 SGT 从 0 开始往上调每次加 5观察 DIAG 信号在堵转时是否触发。如果堵转时不触发SGT 继续加大如果空载时就误触发SGT 减小。找到刚好能在堵转时触发、空载时不触发的 SGT 值然后往安全方向退 2 到 3 个刻度。这个流程的核心逻辑是SGT 决定了触发阈值而这个阈值应该落在空载读数和堵转读数之间。二分法能快速逼近这个区间。我自己的经验是大部分系统里 SGT 落在 5 到 20 之间就能工作。如果调到 30 以上才能触发说明SG_RESULT的区分度不够要回头检查电流和速度。如果 SGT 为 0 还误触发说明空载读数本身就太低可能是电机电流太小或者机械阻力太大。4.3 不同工作模式下的参数差异StallGuard2 的表现和驱动模式关系很大。TMC5160 支持SpreadCycle和StealthChop两种斩波模式StallGuard2 在SpreadCycle下工作得更好因为SpreadCycle的电流波形更干净反电动势测量更准。如果你用StealthChopSG_RESULT的噪声会明显变大读数波动可能超过 100。这时候要么切到SpreadCycle要么把 SGT 的余量留大一点并且加软件滤波。另外diag1_stall和diag1_index不能同时用DIAG1引脚一次只能输出一种信号。如果你需要同时用堵转检测和编码器索引得把其中一个映射到DIAG0或者通过 SPI 读取状态位。工作模式SG_RESULT 噪声推荐 SGT 余量备注SpreadCycle小波动 20 以内2 到 3 刻度首选StealthChop大波动 50 到 1005 到 8 刻度需软件滤波低速很大可能无效不适用提高速度或加大 TCOOLTHRS高速较小但绝对值偏低3 到 5 刻度注意电流是否足够5. 实操现场从飘忽到稳定的完整记录5.1 案例背景与初始状态前段时间帮一个做桌面级 CNC 的朋友调 TMC5160 的堵转检测。他的需求是铣刀碰到夹具或者工件边缘时电机堵转系统要立刻停机并回退。他用的是 42 步进电机24V 供电16 微步工作转速大概 120 RPM。初始配置是网上抄来的SGT10TCOOLTHRS0xFFFFFIRUN800mA。结果SG_RESULT在空载时在 200 到 700 之间乱跳堵转时反而有时候能到 400完全没法用。5.2 逐步排查与参数修正第一步先看速度。读TSTEP发现工作转速下 TSTEP 大概是 1200。TCOOLTHRS设的是0xFFFFF也就是 1048575远大于 1200说明 StallGuard2 确实在工作区间。这一步没问题。第二步看电流。IRUN800mA但电机额定电流是 1.5A。电流设小了电机扭矩不足SG_RESULT整体偏低且不稳定。把IRUN改成 1200mAIHOLD改成 600mA。重新读SG_RESULT空载读数升到 400 到 800波动还是有点大但比之前好。第三步切斩波模式。原来用的是StealthChop切到SpreadCycle后空载SG_RESULT稳定在 650 到 720 之间波动降到 70 以内。这一步改善很明显。第四步调 SGT。空载平均 680堵转最低 120。中间值大概是 400。把 SGT 从 10 开始往上调调到 18 的时候堵转能稳定触发空载不误触发。再往上调到 20空载开始偶尔误触发。所以最终 SGT 定在 16留了两个刻度余量。第五步收窄TCOOLTHRS。原来设的0xFFFFF太大导致电机在极低速时 StallGuard2 也在工作读数很乱。根据实际工作速度把TCOOLTHRS改成 1500对应大概 100 RPM 以上才启动 StallGuard2。这样低速启动阶段不会误触发进入工作速度后检测稳定。5.3 最终配置与效果验证最终配置如下driver.rms_current(1200); driver.microsteps(16); driver.en_spreadCycle(true); driver.TCOOLTHRS(1500); driver.SGT(16); driver.diag1_stall(true); driver.diag1_active_high(true);验证方法让 CNC 空跑程序手动在铣刀侧面施加阻力观察 DIAG 信号。连续测试 50 次堵转触发 50 次空载误触发 0 次。SG_RESULT在空载时稳定在 650 到 720堵转时降到 100 到 150区分度非常明显。朋友后来反馈实际加工中碰到夹具边缘时系统能在 50 毫秒内停机没有出现漏检或者误停。这个响应速度对于桌面级 CNC 来说完全够用。6. 常见问题速查与避坑清单6.1 SG_RESULT 始终为 0 或 1023这是最常被问到的问题。SG_RESULT为 0 通常意味着 StallGuard2 没有在工作区间或者电机完全堵死。为 1023 则可能是 SPI 读取错误读到了全 1。排查顺序确认TCOOLTHRS小于当前 TSTEP。如果 TSTEP 大于TCOOLTHRSStallGuard2 不工作读数为 0。确认 SPI 通信正常。读一个已知寄存器比如IOIN看返回值是否合理。确认电机在转。如果电机没转SG_RESULT没有意义。确认en_spreadCycle或pwm_autoscale配置正确。StealthChop下SG_RESULT可能异常。6.2 堵转不触发或空载误触发这两个问题的根源通常是 SGT 没调好但也可能是其他因素。现象可能原因解决方法堵转不触发SGT 太小增大 SGT每次加 2 到 5堵转不触发电流太小增大 IRUN 到电机额定值的 80% 到 100%堵转不触发速度太低提高转速或降低 TCOOLTHRS空载误触发SGT 太大减小 SGT空载误触发机械阻力大检查导轨、皮带、联轴器空载误触发电源纹波大加电容或换电源两者都出现SG_RESULT 区分度不够切 SpreadCycle检查电流和速度6.3 高速时 SG_RESULT 偏低导致误判高速时反电动势增强SG_RESULT的绝对值会整体下降。如果 SGT 是按低速调的高速时可能误触发。解决办法有两个一是用TCOOLTHRS限制 StallGuard2 只在工作速度区间工作二是如果速度变化范围大可以考虑分段配置 SGT在高速段用更小的 SGT。我自己的做法是如果应用速度变化超过 3 倍就在固件里根据当前 TSTEP 动态调整 SGT。虽然麻烦一点但能保证全速度段稳定。6.4 独家避坑经验三条第一条先调电流再调 SGT。很多人一上来就调 SGT调了半天发现是电流不对。电流是基础基础不对上面怎么调都是白费。第二条用示波器看 DIAG 信号。串口打印有延迟看不到瞬态。如果条件允许用示波器抓 DIAG 引脚能清楚看到触发时刻和抖动情况。没有示波器的话至少用逻辑分析仪。第三条留足余量。SGT 不要调到临界值往安全方向退 2 到 3 个刻度。温度变化、电压波动、机械磨损都会让SG_RESULT漂移临界值今天能用明天可能就误触发。7. 和编码器方案怎么选7.1 StallGuard2 与编码器的适用边界tmc5160编码器这个搜索词最近热度不低说明很多人在纠结要不要加编码器。我的看法是StallGuard2 和编码器不是替代关系而是互补关系。StallGuard2 的优势是成本低、接线简单、响应快适合检测“堵转”这种突变事件。它的局限是精度有限不能做位置闭环也不能检测丢步。编码器的优势是精度高、能做闭环但成本和接线复杂度都上去了。选择逻辑很简单只需要堵转保护、碰撞检测、限位回退StallGuard2 够用。需要位置闭环、丢步补偿、高精度定位加编码器。两者都需要StallGuard2 做快速保护编码器做慢速校正。7.2 混合方案的接线与配置要点如果两个都用接线要注意DIAG1的复用问题。DIAG1一次只能输出一种信号所以堵转信号和编码器索引信号要分开映射。TMC5160 的DIAG0和DIAG1可以分别配置具体看寄存器DIAG0和DIAG1的映射位。配置上StallGuard2 的参数调法不变编码器走独立的定时器接口。固件里做优先级处理StallGuard2 触发时立即停机编码器偏差超过阈值时做位置校正。两者不要同时触发同一个动作否则逻辑会乱。提示混合方案里StallGuard2 的 SGT 可以调得稍微保守一点因为编码器能兜底。这样能减少误触发提高系统可用性。8. 调参之外的系统级考量8.1 电源和布线对检测稳定性的影响SG_RESULT的稳定性很依赖电源质量。我实测过同一个电机和驱动板换一个纹波大的电源SG_RESULT的波动能从 30 涨到 150。所以如果调参怎么都调不稳先检查电源。具体做法在驱动板电源输入端并一个 470 微法以上的电解电容再并一个 0.1 微法的陶瓷电容。电机相线尽量短远离 SPI 信号线。如果电机线和信号线必须交叉尽量垂直交叉减少耦合。8.2 温度漂移与长期稳定性TMC5160 芯片温度变化会影响内部比较器的偏移进而影响SG_RESULT。夏天和冬天、冷启动和热机后读数可能有 10% 到 20% 的漂移。所以 SGT 的余量要留够不能调到临界值。如果应用环境温度变化大可以考虑在固件里做温度补偿。TMC5160 有内置温度传感器读TEMP寄存器根据温度微调 SGT。这个做法比较进阶但效果确实好。8.3 固件层面的滤波与状态机设计SG_RESULT本身有噪声直接拿单次读数做判断容易误触发。我一般在固件里做两层处理第一层是滑动平均滤波取最近 5 到 10 次读数的平均值。这样能滤掉高频噪声但会引入一点延迟。对于堵转检测来说50 毫秒以内的延迟可以接受。第二层是状态机不是一低于阈值就触发而是连续 3 次低于阈值才确认堵转。这样能进一步降低误触发概率。状态机里还可以加一个“恢复”状态堵转解除后延迟一段时间再恢复运行避免反复触发。// 简化的堵转检测状态机 #define SG_THRESHOLD 200 #define CONFIRM_COUNT 3 int stall_count 0; bool stalled false; void check_stall(uint32_t sg_result) { if (sg_result SG_THRESHOLD) { stall_count; if (stall_count CONFIRM_COUNT) { stalled true; // 执行停机或回退 } } else { stall_count 0; stalled false; } }这段代码很简单但能解决大部分误触发问题。实际用的时候可以把SG_THRESHOLD换成动态阈值根据当前 TSTEP 查表得到这样全速度段都能稳定工作。调 TMC5160 的 StallGuard2 这件事说到底就是理解它的物理原理然后按顺序把速度、电流、模式、SGT、TCOOLTHRS 这几个变量一个一个固定下来。最怕的就是同时调多个参数调乱了都不知道是哪个起的作用。我自己的习惯是每次只改一个寄存器改完记录一组数据对比前后差异。这样即使出了问题也能快速定位。最后再分享一个小技巧如果手头没有合适的负载来模拟堵转可以用一根橡皮筋缠在电机轴上另一端用手拉住。橡皮筋的拉力比较线性能模拟从轻到重的连续负载变化比直接用手捏更可控。这个办法我在好几个项目里都用过简单但有效。 1. 堵转检测为什么值得花时间调TMC5160 这颗驱动芯片在 DIY 圈子里火了好几年静音、防抖、内置六点加减速曲线随便拎一个出来都能让传统 A4988 用户眼馋。但真正让它在同类产品里站稳脚跟的其实是StallGuard2这个无传感器负载检测功能。说白了它让电机在不需要外挂编码器的情况下也能感知到自己是不是被卡住了、是不是撞到了限位、是不是扭矩快撑不住了。这个功能听起来很美好实际调起来却让不少人抓狂。我见过太多人把SG_RESULT读出来一看数值从 0 到 1023 之间乱跳电机空转的时候读数比堵转还低或者干脆一直贴着 0 不动。然后就开始怀疑芯片是假的、驱动板布线有问题、电机不匹配折腾一圈下来发现其实只是几个寄存器的参数没配对。这篇内容就是把我自己踩过的坑、帮别人远程排查过的案例以及从 TMC5160 数据手册字缝里抠出来的细节整理成一份可以直接抄作业的调参指南。不管你是用 Arduino 配 TMC5160 做 3D 打印机挤出机堵转保护还是用 STM32 做 CNC 的碰撞回退又或者只是想搞明白SG_RESULT到底该怎么看这里应该都能找到能直接用的东西。核心关键词先摆出来TMC5160、StallGuard2、SG_RESULT、SGT、TCOOLTHRS。这五个词基本覆盖了整个调参链路后面每个章节都会围绕它们展开。适合有基本步进电机驱动经验、能看懂寄存器配置、手头有串口调试工具的读者。纯小白建议先把 TMC5160 的 Datasheet 第 11 章翻一遍再回来不然有些概念会接不上。2. StallGuard2 到底在测什么2.1 从反电动势到 SG_RESULT 的物理链路很多人把 StallGuard2 当成一个“堵转开关”觉得配置好了就应该输出一个“堵了/没堵”的布尔值。实际上它输出的是一个0 到 1023 的负载指标数值越小代表负载越重数值越大代表负载越轻。这个数值就是SG_RESULT。它的物理原理并不复杂。步进电机在旋转时线圈里会产生反电动势这个反电动势和转速、负载都有关系。TMC5160 在每一个微步周期内会测量线圈电流达到目标值所需的时间或者说测量电流波形的一个特征点。当电机负载轻、转速稳定时这个测量值比较“干净”当负载加重、电机开始失步或者堵转时电流波形会发生畸变测量值就会明显下降。SG_RESULT就是这个测量值的数字化结果。它不是扭矩的直接读数也不是一个线性指标更像是一个“健康度评分”。空载时可能跑到 800 到 1000中等负载降到 400 到 600接近堵转时掉到 100 以下完全堵死时可能直接归零。这里有一个关键点SG_RESULT 的绝对值没有意义有意义的是它在你的具体系统里的相对变化。同一颗芯片换一个电机、换一个电压、换一个转速读数范围可能完全不一样。所以调参的第一步不是去追求某个“标准值”而是先在你的系统里建立一个基线。2.2 SGT 和 TCOOLTHRS 各自管什么SGT是 StallGuard2 的阈值寄存器全称 StallGuard Threshold。它决定了SG_RESULT在什么条件下被判定为“堵转”。具体来说当SG_RESULT低于某个由SGT决定的阈值时芯片的DIAG或者SG_STOP信号就会触发。SGT是一个有符号的 7 位值范围是 -64 到 63。它的作用不是直接设定一个SG_RESULT的数值门槛而是调整 StallGuard2 内部的比较器偏移。SGT 越大越容易触发堵转SGT 越小越不容易触发。很多人在这里搞反了以为 SGT 是“灵敏度”调大应该更不敏感结果越调越乱。TCOOLTHRS是另一个关键寄存器全称 CoolStep Threshold。它设定了 StallGuard2 开始工作的最低速度。在TCOOLTHRS以下的速度StallGuard2 不输出有效的SG_RESULT读数会飘或者直接为 0。这是因为低速时反电动势太弱测量信噪比不够。所以一个常见的坑就是电机慢慢转的时候读SG_RESULT发现一直是 0然后以为芯片坏了。其实只是速度没超过TCOOLTHRS。TCOOLTHRS 的单位是 TSTEP也就是两个微步之间的时间间隔。TSTEP 越小速度越快。所以TCOOLTHRS设得越大StallGuard2 启动的速度门槛就越低。这两个寄存器的配合关系可以这样理解TCOOLTHRS决定“什么时候开始测”SGT决定“测到多少算堵转”。两个都配对StallGuard2 才能稳定工作。2.3 为什么你的 SG_RESULT 会飘忽不定SG_RESULT读数不稳通常不是单一原因造成的。我整理了一下自己遇到过和帮别人排查过的案例大概可以归成几类速度太低电机转速对应的 TSTEP 大于TCOOLTHRSStallGuard2 根本没在正常工作区间。SGT 设置不合理SGT 太靠近边界导致SG_RESULT在阈值附近来回穿越触发信号抖动。电机电流设置不对IHOLD和IRUN如果太小电机本身扭矩不足SG_RESULT会整体偏低且不稳定。供电电压波动电源纹波大或者电压接近电机额定下限反电动势测量会受到干扰。微步设置和实际转速不匹配微步数太高导致单个微步的电流变化太小测量分辨率下降。SPI 读取时机不对SG_RESULT是一个实时更新的值如果在电机换向或者加减速的瞬间读取读数会跳变。这六条里前三条占了八成以上的案例。所以调参的顺序应该是先确认速度在 StallGuard2 工作区间内再调 SGT最后检查电流和供电。3. 调参前的硬件和软件准备3.1 硬件清单与接线检查在开始调寄存器之前先把硬件层面能排除的问题排除掉。我一般会按下面这个清单过一遍检查项正常状态常见问题电机相线四线两两导通阻值接近相线接错、虚焊供电电压在电机额定电压 1.2 到 1.5 倍电压过低导致扭矩不足电源纹波空载和负载下波动小于 5%纹波大导致 SG_RESULT 跳变SPI 接线SCK、MOSI、MISO、CS 四线可靠线太长或没屏蔽导致读写错误散热芯片温度低于 80 度过热降频影响测量电机轴负载空载可自由转动机械卡死导致误判特别说一下 SPI 接线。TMC5160 的寄存器读写对时序比较敏感如果杜邦线太长或者没有共地读出来的SG_RESULT可能是错的。我遇到过一个人SG_RESULT一直显示 1023换了三块驱动板都没解决最后发现是 MISO 线虚焊读到的全是 0xFF。3.2 软件工具与最小测试代码调参需要一个能实时读寄存器的环境。我习惯用 Arduino 或者 STM32 加一个串口打印把SG_RESULT、TSTEP、SGT、TCOOLTHRS这几个值一起输出方便对照。下面是一个最小可用的读取框架基于 Arduino 和 TMCStepper 库#include TMCStepper.h #define CS_PIN 10 #define SW_RX 18 #define SW_TX 19 #define R_SENSE 0.075f TMC5160Stepper driver(CS_PIN, R_SENSE); void setup() { Serial.begin(115200); SPI.begin(); driver.begin(); driver.toff(5); driver.rms_current(1200); driver.microsteps(16); driver.en_spreadCycle(false); driver.pwm_autoscale(true); // StallGuard2 初始配置 driver.TCOOLTHRS(0xFFFFF); // 先设一个很大的值让 StallGuard2 全速段工作 driver.SGT(10); // 初始阈值后面再调 driver.diag1_stall(true); // DIAG1 输出堵转信号 } void loop() { static uint32_t last 0; if (millis() - last 100) { last millis(); uint32_t sg driver.SG_RESULT(); uint32_t tstep driver.TSTEP(); Serial.print(SG_RESULT); Serial.print(sg); Serial.print( TSTEP); Serial.print(tstep); Serial.print( SGT); Serial.print(driver.SGT()); Serial.print( TCOOLTHRS); Serial.println(driver.TCOOLTHRS()); } }这段代码的作用是每 100 毫秒把关键寄存器打印一次。TCOOLTHRS先设成0xFFFFF是为了让 StallGuard2 在尽可能低的速度下也能工作方便观察低速时的SG_RESULT行为。等调好之后再根据实际工作速度收窄。注意R_SENSE必须和驱动板上的采样电阻一致。常见的 TMC5160 板子有 0.075 欧和 0.11 欧两种填错了电流计算会偏间接影响SG_RESULT。3.3 建立基线读数的操作步骤在调 SGT 之前先做一组基线测试。步骤很简单但必须按顺序来让电机空载以你实际应用中的工作速度旋转。比如 3D 打印机挤出机就用挤出速度CNC 就用切削进给速度。记录空载时的SG_RESULT和TSTEP。连续记录 20 个点看波动范围。用手给电机轴施加一个中等阻力模拟中等负载再记录一组数据。用手把电机轴捏住模拟堵转记录SG_RESULT的最低值。对比三组数据确定你的系统里“空载”“中等负载”“堵转”分别对应什么读数区间。这个基线非常重要。我见过有人直接抄别人的 SGT 值结果完全不能用因为电机型号、电压、速度都不一样。基线是你自己系统的指纹抄不来。4. SGT 和 TCOOLTHRS 的配合调法4.1 TCOOLTHRS 的计算与设置TCOOLTHRS的单位是 TSTEP而 TSTEP 和实际转速的关系可以这样算TSTEP 表示一个微步的时间间隔单位是时钟周期。TMC5160 的内部时钟通常是 12 MHz 左右具体看芯片版本。转速和 TSTEP 的关系是转速(转/秒) 1 / (TSTEP × 微步数 × 200 × 时钟周期)对于 1.8 度步进电机200 步一圈16 微步就是 3200 微步一圈。假设时钟周期是 83 纳秒12 MHzTSTEP 为 1000 时转速 1 / (1000 × 3200 × 83e-9) ≈ 3.76 转/秒 ≈ 225 RPM这个速度已经比较快了。实际应用中StallGuard2 在 50 到 200 RPM 之间通常工作得比较好。所以TCOOLTHRS可以设成对应你最低工作速度的 TSTEP 值。一个实用的做法是先让电机以你应用中的最低速度旋转读TSTEP寄存器然后把TCOOLTHRS设成这个值再稍微放大一点。比如读到 TSTEP 是 800TCOOLTHRS就设 1000 左右留一点余量。提示TCOOLTHRS设得太大StallGuard2 会在很低的速度就启动但低速时读数不可靠反而容易误触发。设得太小高速时才启动又可能错过低速堵转。所以它应该匹配你的实际工作速度范围。4.2 SGT 的二分法调参流程SGT 的调整我推荐用二分法比盲目试值快得多。具体流程如下先把 SGT 设成 0让电机空载运行记录SG_RESULT的平均值记为SG_empty。用手施加堵转记录SG_RESULT的最低值记为SG_stall。计算中间值SG_mid (SG_empty SG_stall) / 2。把 SGT 从 0 开始往上调每次加 5观察 DIAG 信号在堵转时是否触发。如果堵转时不触发SGT 继续加大如果空载时就误触发SGT 减小。找到刚好能在堵转时触发、空载时不触发的 SGT 值然后往安全方向退 2 到 3 个刻度。这个流程的核心逻辑是SGT 决定了触发阈值而这个阈值应该落在空载读数和堵转读数之间。二分法能快速逼近这个区间。我自己的经验是大部分系统里 SGT 落在 5 到 20 之间就能工作。如果调到 30 以上才能触发说明SG_RESULT的区分度不够要回头检查电流和速度。如果 SGT 为 0 还误触发说明空载读数本身就太低可能是电机电流太小或者机械阻力太大。4.3 不同工作模式下的参数差异StallGuard2 的表现和驱动模式关系很大。TMC5160 支持SpreadCycle和StealthChop两种斩波模式StallGuard2 在SpreadCycle下工作得更好因为SpreadCycle的电流波形更干净反电动势测量更准。如果你用StealthChopSG_RESULT的噪声会明显变大读数波动可能超过 100。这时候要么切到SpreadCycle要么把 SGT 的余量留大一点并且加软件滤波。另外diag1_stall和diag1_index不能同时用DIAG1引脚一次只能输出一种信号。如果你需要同时用堵转检测和编码器索引得把其中一个映射到DIAG0或者通过 SPI 读取状态位。工作模式SG_RESULT 噪声推荐 SGT 余量备注SpreadCycle小波动 20 以内2 到 3 刻度首选StealthChop大波动 50 到 1005 到 8 刻度需软件滤波低速很大可能无效不适用提高速度或加大 TCOOLTHRS高速较小但绝对值偏低3 到 5 刻度注意电流是否足够5. 实操现场从飘忽到稳定的完整记录5.1 案例背景与初始状态前段时间帮一个做桌面级 CNC 的朋友调 TMC5160 的堵转检测。他的需求是铣刀碰到夹具或者工件边缘时电机堵转系统要立刻停机并回退。他用的是 42 步进电机24V 供电16 微步工作转速大概 120 RPM。初始配置是网上抄来的SGT10TCOOLTHRS0xFFFFFIRUN800mA。结果SG_RESULT在空载时在 200 到 700 之间乱跳堵转时反而有时候能到 400完全没法用。5.2 逐步排查与参数修正第一步先看速度。读TSTEP发现工作转速下 TSTEP 大概是 1200。TCOOLTHRS设的是0xFFFFF也就是 1048575远大于 1200说明 StallGuard2 确实在工作区间。这一步没问题。第二步看电流。IRUN800mA但电机额定电流是 1.5A。电流设小了电机扭矩不足SG_RESULT整体偏低且不稳定。把IRUN改成 1200mAIHOLD改成 600mA。重新读SG_RESULT空载读数升到 400 到 800波动还是有点大但比之前好。第三步切斩波模式。原来用的是StealthChop切到SpreadCycle后空载SG_RESULT稳定在 650 到 720 之间波动降到 70 以内。这一步改善很明显。第四步调 SGT。空载平均 680堵转最低 120。中间值大概是 400。把 SGT 从 10 开始往上调调到 18 的时候堵转能稳定触发空载不误触发。再往上调到 20空载开始偶尔误触发。所以最终 SGT 定在 16留了两个刻度余量。第五步收窄TCOOLTHRS。原来设的0xFFFFF太大导致电机在极低速时 StallGuard2 也在工作读数很乱。根据实际工作速度把TCOOLTHRS改成 1500对应大概 100 RPM 以上才启动 StallGuard2。这样低速启动阶段不会误触发进入工作速度后检测稳定。5.3 最终配置与效果验证最终配置如下driver.rms_current(1200); driver.microsteps(16); driver.en_spreadCycle(true); driver.TCOOLTHRS(1500); driver.SGT(16); driver.diag1_stall(true); driver.diag1_active_high(true);验证方法让 CNC 空跑程序手动在铣刀侧面施加阻力观察 DIAG 信号。连续测试 50 次堵转触发 50 次空载误触发 0 次。SG_RESULT在空载时稳定在 650 到 720堵转时降到 100 到 150区分度非常明显。朋友后来反馈实际加工中碰到夹具边缘时系统能在 50 毫秒内停机没有出现漏检或者误停。这个响应速度对于桌面级 CNC 来说完全够用。6. 常见问题速查与避坑清单6.1 SG_RESULT 始终为 0 或 1023这是最常被问到的问题。SG_RESULT为 0 通常意味着 StallGuard2 没有在工作区间或者电机完全堵死。为 1023 则可能是 SPI 读取错误读到了全 1。排查顺序确认TCOOLTHRS小于当前 TSTEP。如果 TSTEP 大于TCOOLTHRSStallGuard2 不工作读数为 0。确认 SPI 通信正常。读一个已知寄存器比如IOIN看返回值是否合理。确认电机在转。如果电机没转SG_RESULT没有意义。确认en_spreadCycle或pwm_autoscale配置正确。StealthChop下SG_RESULT可能异常。6.2 堵转不触发或空载误触发这两个问题的根源通常是 SGT 没调好但也可能是其他因素。现象可能原因解决方法堵转不触发SGT 太小增大 SGT每次加 2 到 5堵转不触发电流太小增大 IRUN 到电机额定值的 80% 到 100%堵转不触发速度太低提高转速或降低 TCOOLTHRS空载误触发SGT 太大减小 SGT空载误触发机械阻力大检查导轨、皮带、联轴器空载误触发电源纹波大加电容或换电源两者都出现SG_RESULT 区分度不够切 SpreadCycle检查电流和速度6.3 高速时 SG_RESULT 偏低导致误判高速时反电动势增强SG_RESULT的绝对值会整体下降。如果 SGT 是按低速调的高速时可能误触发。解决办法有两个一是用TCOOLTHRS限制 StallGuard2 只在工作速度区间工作二是如果速度变化范围大可以考虑分段配置 SGT在高速段用更小的 SGT。我自己的做法是如果应用速度变化超过 3 倍就在固件里根据当前 TSTEP 动态调整 SGT。虽然麻烦一点但能保证全速度段稳定。6.4 独家避坑经验三条第一条先调电流再调 SGT。很多人一上来就调 SGT调了半天发现是电流不对。电流是基础基础不对上面怎么调都是白费。第二条用示波器看 DIAG 信号。串口打印有延迟看不到瞬态。如果条件允许用示波器抓 DIAG 引脚能清楚看到触发时刻和抖动情况。没有示波器的话至少用逻辑分析仪。第三条留足余量。SGT 不要调到临界值往安全方向退 2 到 3 个刻度。温度变化、电压波动、机械磨损都会让SG_RESULT漂移临界值今天能用明天可能就误触发。7. 和编码器方案怎么选7.1 StallGuard2 与编码器的适用边界tmc5160编码器这个搜索词最近热度不低说明很多人在纠结要不要加编码器。我的看法是StallGuard2 和编码器不是替代关系而是互补关系。StallGuard2 的优势是成本低、接线简单、响应快适合检测“堵转”这种突变事件。它的局限是精度有限不能做位置闭环也不能检测丢步。编码器的优势是精度高、能做闭环但成本和接线复杂度都上去了。选择逻辑很简单只需要堵转保护、碰撞检测、限位回退StallGuard2 够用。需要位置闭环、丢步补偿、高精度定位加编码器。两者都需要StallGuard2 做快速保护编码器做慢速校正。7.2 混合方案的接线与配置要点如果两个都用接线要注意DIAG1的复用问题。DIAG1一次只能输出一种信号所以堵转信号和编码器索引信号要分开映射。TMC5160 的DIAG0和DIAG1可以分别配置具体看寄存器DIAG0和DIAG1的映射位。配置上StallGuard2 的参数调法不变编码器走独立的定时器接口。固件里做优先级处理StallGuard2 触发时立即停机编码器偏差超过阈值时做位置校正。两者不要同时触发同一个动作否则逻辑会乱。提示混合方案里StallGuard2 的 SGT 可以调得稍微保守一点因为编码器能兜底。这样能减少误触发提高系统可用性。8. 调参之外的系统级考量8.1 电源和布线对检测稳定性的影响SG_RESULT的稳定性很依赖电源质量。我实测过同一个电机和驱动板换一个纹波大的电源SG_RESULT的波动能从 30 涨到 150。所以如果调参怎么都调不稳先检查电源。具体做法在驱动板电源输入端并一个 470 微法以上的电解电容再并一个 0.1 微法的陶瓷电容。电机相线尽量短远离 SPI 信号线。如果电机线和信号线必须交叉尽量垂直交叉减少耦合。8.2 温度漂移与长期稳定性TMC5160 芯片温度变化会影响内部比较器的偏移进而影响SG_RESULT。夏天和冬天、冷启动和热机后读数可能有 10% 到 20% 的漂移。所以 SGT 的余量要留够不能调到临界值。如果应用环境温度变化大可以考虑在固件里做温度补偿。TMC5160 有内置温度传感器读TEMP寄存器根据温度微调 SGT。这个做法比较进阶但效果确实好。8.3 固件层面的滤波与状态机设计SG_RESULT本身有噪声直接拿单次读数做判断容易误触发。我一般在固件里做两层处理第一层是滑动平均滤波取最近 5 到 10 次读数的平均值。这样能滤掉高频噪声但会引入一点延迟。对于堵转检测来说50 毫秒以内的延迟可以接受。第二层是状态机不是一低于阈值就触发而是连续 3 次低于阈值才确认堵转。这样能进一步降低误触发概率。状态机里还可以加一个“恢复”状态堵转解除后延迟一段时间再恢复运行避免反复触发。// 简化的堵转检测状态机 #define SG_THRESHOLD 200 #define CONFIRM_COUNT 3 int stall_count 0; bool stalled false; void check_stall(uint32_t sg_result) { if (sg_result SG_THRESHOLD) { stall_count; if (stall_count CONFIRM_COUNT) { stalled true; // 执行停机或回退 } } else { stall_count 0; stalled false; } }这段代码很简单但能解决大部分误触发问题。实际用的时候可以把SG_THRESHOLD换成动态阈值根据当前 TSTEP 查表得到这样全速度段都能稳定工作。调 TMC5160 的 StallGuard2 这件事说到底就是理解它的物理原理然后按顺序把速度、电流、模式、SGT、TCOOLTHRS 这几个变量一个一个固定下来。最怕的就是同时调多个参数调乱了都不知道是哪个起的作用。我自己的习惯是每次只改一个寄存器改完记录一组数据对比前后差异。这样即使出了问题也能快速定位。最后再分享一个小技巧如果手头没有合适的负载来模拟堵转可以用一根橡皮筋缠在电机轴上另一端用手拉住。橡皮筋的拉力比较线性能模拟从轻到重的连续负载变化比直接用手捏更可控。这个办法我在好几个项目里都用过简单但有效。