ADI TMCL-IDE 基础使用介绍

本文主要介绍 ADI TMCL-IDE 的定义与特点、使用前的硬件软件准备、固件更新步骤、以及常用配置与调试功能的详细说明，旨在帮助开发者快速上手并高效使用该工具进行运动控制项目开发。

TMCL-IDE 是 Trinamic 运动控制语言集成开发环境的缩写，它是一个集成开发环境，用于使用 ADI Trinamic™ 模块和芯片开发应用程序。GUI 提供了用于轻松设置参数、实时可视化数据以及使用 TMCL 开发和调试独立应用程序的工具。

如果需要使用 Trinamic 电机驱动产品进行运动控制开发，TMCL-IDE 是官方推荐的配套编程工具，能显著提升开发效率。

TMCL (Trinamic Motion Control Language) 是 Trinamic 专为运动控制设计的指令集，TMCL-IDE 提供该语言的语法高亮、自动补全、编译检查等功能，方便开发者编写控制程序。

通过串口、USB 或其他接口与 Trinamic 电机驱动模块 (如 TMCM 系列) 连接，可直接下载程序到设备、实时监控运行状态 (如位置、速度、电流等)，并支持在线调试。

包含单步执行、断点设置、变量监控等调试功能，帮助开发者排查程序逻辑错误，优化运动控制效果 (如平滑度、精度等)。

可保存和加载设备配置参数 (如电机参数、运动曲线设置等)，简化多设备批量部署或重复调试的流程。

TMCL-IDE 完全免费。

使用 TMCL-IDE 之前，需要准备好 Trinamic 开发套件。开发套件一共分为 3 个部分，主控板 Landungsbruecke (图1) +桥接板 Eselsbruecke (图2) +各类不同的驱动板卡，本例为 TMC9660-3PH-EVKIT 驱动板 (图3)。将三者连接在一起后，通过 USB 线缆连接电脑即可开始使用 TMCL-IDE。

在开始调试之前，需要先确认软件和固件版本是否为最新，官方下载地址为 TMCL-IDE。如下图 (图4) 所示，直接打开软件后可在界面左上角查看当前软件版本。当前最新版本为 4.9.0，IDE 低于该版本可以先更新版本。

同样，主控板卡的固件版本也可以在下图 (图5) 的位置看到，目前的最新版本为 3.11.4。

主控板固件会在 ADI GitHub 仓库更新，下载地址为 Firmware。通过菜单栏的 Tools→Firmware Update，Browse 选择固件文件，点击 update 即可更新固件。

完成以上硬件连接电脑和软件固件版本更新后，即可在 IDE 左侧看到如下图 (图8) 所示的连接设备列表。点击相应的模块即可进行配置操作，下文将为大家详细介绍每一步操作。

首先进入 Motor1→Current settings 配置电机电流，分别是电机工作电流和保持电流，这一步根据电机型号和应用场景选择合适的电流即可。部分内置 MOSFET 驱动型号需要选择电流范围和 Scale。外置 Rsense 型号也可以根据不同应用需要硬件更改采样 Rsense 取值，以及自行计算电流配置。

接下来依次点击 Motor1→Control mode→Velocity mode 配置加速度和转速，即可控制电机开始转动。这里转速和加速度的单位是脉冲/秒和脉冲/秒²，需要根据实际电机齿槽数、细分数等转化为我们常用的转速单位 RPM。

另外 TMCL-IDE 也支持位置控制模式，点击 Motor1→Control mode→Position mode 即可对电机进行绝对位置和增量位置的控制，支持输入负值。这里的位置单位也是脉冲数，可以按照速度部分的介绍进行换算。 

对于部分带有 Ramp 控制功能的 TMC5XXX 系列型号，可在位置控制界面右侧打开如下图 (图11) 所示的 6/8 点加减速控制，通过手动输入不同速度下的加速度，帮助电机丝滑运动，同时极大降低主控端的性能要求。

除了这些基本的操作外，也可以直接点击 Register browser 打开寄存器浏览器，这里能查看并实时更新所有寄存器的值，也可以手动配置特定寄存器，更加细致地控制驱动 IC，实现 Stealth Chop、Cool Step、Stall Guard 等功能。

全部配置完成后可以点击下图 (图13) 导入导出按钮，在弹出窗口中可以进行导入和导出操作，既可以将当前的配置导出保存下来，也可以导入配置好的寄存器值，快速验证功能。

导出配置可以选择导出寄存器的值或直接导出 C 代码的形式，更加方便主控端完成代码部分的设计。

最后，ADI 官方也提供可用于嵌入式项目中使用 Trinamic 集成电路的可移植 C 库 TMC-API，它与 CPU 无关且自成体系 (无外部依赖)。点击此处即可下载。

TMC-API 正在对其核心结构进行重做，这将包括新的寄存器读写机制。该新机制旨在提供对 Trinamic IC 寄存器的便捷访问。它提供了便捷的读写功能，以及寄存器及其位域定义，简化了与寄存器交互的过程。用户只需几行代码，就能快速轻松地从寄存器中获取信息或修改其数值。这些功能极大简化了与集成电路寄存器 (IC register) 的作过程，使开发者能够充分发挥集成电路的全部潜力，节省宝贵的开发时间。

为了进一步帮助开发者利用 API，ADI 每个 IC 均添加一个示例文件夹。该文件夹包含一系列功能，展示了 IC 的具体功能。每个示例都作为示例代码，帮助开发者理解如何将 API 用于不同用途。它还作为一个综合资源，加速学习曲线，帮助构建强大的应用。

通过使用 ADI TMCL-IDE 和 TMC-API，开发者可构建从参数调试到嵌入式集成的完整运动控制解决方案，充分发挥 Trinamic 芯片的性能，提升开发效率与系统可靠性。

欲了解关于更多 ADI 相关方案或技术信息，请与骏龙科技当地的办事处联系或点击下方「联系我们」，提交您的需求，骏龙科技公司愿意为您提供更详细的技术解答。

相关下载链接：

• TMCL-IDE
• Firmware
• TMC-API