TMC报错相关
技术背景
TMC（Trinamic）驱动器通过专用寄存器报告状态和错误信息。了解这些寄存器有助于快速诊断问题：
- IFCNT寄存器：通信帧计数器，用于验证主控制器与驱动器之间的通信是否正常。
- GSTAT寄存器：全局状态寄存器，包含复位、驱动错误等全局状态信息。
- DRV_STATUS寄存器：驱动状态寄存器，提供详细的驱动器工作状态，包括温度警告、短路、开路等故障信息。
当Klipper报告TMC错误时，通常会显示具体的寄存器值和故障标志。本指南将针对常见的TMC错误提供详细的诊断和解决方法。
链接不上驱动
Unable to read tmc uart 'stepper_x' register IFCNT 或 Unable to read tmc spi 'stepper_x' register IFCNT
报错详情：当Klipper尝试读取TMC驱动器的IFCNT寄存器时失败，通常会在日志中看到类似错误信息。
报错原因：TMC驱动器与主控制器之间的通信失败，导致无法读取寄存器值。
主要解决方法： 首先检查硬件连接，确认对应驱动的UART引脚配置是否正确（参考主板/驱动板文档），检查UART跳线帽是否安装正确，并使用万用表测量驱动板是否得到正常供电（通常为24V）。然后进行诊断步骤：尝试更换驱动板或更换驱动端口进行测试，以确定是驱动板还是端口问题，同时检查数据线是否完好，无断裂或接触不良。如果使用非FLY品牌驱动，需要确认其UART引脚定义与FLY一致（FLY驱动UART脚通常是左边从上往下数第四个引脚）。
对于特殊情况，如果购买的驱动UART脚在第五个引脚，可按下方跳线方法解决：
驱动复位
TMC XXXX reports error: GSTAT: 00000001 reset=1(Reset)
报错详情：TMC驱动器的GSTAT寄存器显示复位标志被置位，表示驱动器发生了自动复位。
报错原因：通常由电源不稳定或外部干扰导致驱动器自动复位。电源电压波动、接线接触不良或电磁干扰都可能导致此问题。
主要解决方法： 首先检查电源质量：检查24V电源接线是否牢固，无接触不良；确认电源电压稳定，无大幅波动；如有条件，可使用示波器检查电源纹波。然后检查电机连接：检查电机线是否完好，无断裂或短路；确认电机接头连接牢固。最后排除干扰：建议将电机金属外壳连接到主板或工具板的GND引脚，以减少静电干扰；检查是否有大功率设备（如加热床）与电机线平行走线，造成干扰。
驱动过热
TMC 'extruder' reports error: DRV_STATUS: c00d0103 otpw=1(OvertempWarning!)
报错详情：TMC驱动器的DRV_STATUS寄存器显示温度警告标志被触发。
报错原因：TMC驱动器的温度警告标志被触发，驱动芯片温度超过安全阈值（通常>150°C）。注意：这是驱动器过热，不是电机过热！
主要解决方法： 首先调整电流设置：降低运行电流（run_current），建议减少20-30%；如有设置保持电流（hold_current），可适当降低或完全禁用。然后检查硬件配置：确认驱动板采样电阻（sense resistor）值配置正确；检查驱动板与散热片的接触是否良好，导热硅脂是否充足。接着改善散热条件：确保驱动板有足够的空气流通；考虑添加小型风扇直接对着驱动板吹风；检查设备外壳通风是否良好，避免热量积聚。最后检查工作环境：避免在高温环境中长时间运行；检查是否有其他热源（如加热块、加热床）影响驱动板温度。
A相短路B相开路
TMC 'extruder' reports error: DRV_STATUS: 601f1000 s2vsa=1(ShortToSupply_A!) csactual=31 ola=1(OpenLoad_A!) olb=1(OpenLoad_B!))
报错详情：TMC驱动器的DRV_STATUS寄存器显示多个硬件故障标志同时被触发。
报错原因：TMC驱动器故障诊断位指示硬件问题：s2vsa=1表示A相短路到电源，ola=1表示A相开路，olb=1表示B相开路，csactual=31表示当前电流设置值可能过高。这些故障通常同时出现，表明电机或驱动器存在严重的硬件问题。
主要解决方法：
首先检查电机绕组：使用万用表测量步进电机AB两组线圈的阻值是否一致（通常应为1-2Ω且两组值相近）。然后检查接线：仔细检查步进电机或驱动板内部的电线是否有松动、短路或接触不良。接着检查驱动配置：确认TMC驱动器的电流设置是否合适，过高电流可能导致这些问题。最后检查静音模式：尝试禁用stealthChop模式（在配置中设置stealthchop_threshold: 0）。
B相短路A相开路
TMC 'extruder' reports error: DRV_STATUS: 00190060 s2vsb=1(ShortToSupply_B!) ola=1(OpenLoad_A!) cs_actual=25
报错详情：TMC驱动器的DRV_STATUS寄存器显示B相短路和A相开路故障。
报错原因：TMC驱动器故障诊断位指示：s2vsb=1表示B相短路到电源，ola=1表示A相开路，cs_actual=25表示当前电流设置值。通常由以下原因导致：电机接线错误（A/B相接反或短路）、电机本身故障（绕组开路）或驱动板硬件问题。
主要解决方法： 首先检查电机绕组：使用万用表测量步进电机A、B两组线圈的阻值是否一致（正常应相近）。然后检查接线顺序：确认电机线序正确，通常应为左边一组（A相）、右边一组（B相）。接着检查连接质量：检查所有接线端子是否牢固，无松动或接触不良。最后如有条件，可尝试将电机连接到其他已知正常的驱动端口进行测试。