User Manual

ManualsBrandsTrinamic ManualsAutomationStepper Motor Controller 3A 24V

Module for Stepper

MODULE

TMCM-1076 TMCL

™

Firmware Manual

Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23

The TMCM-1076 is an easy to use stepper motor driver module. The module is controlled via a

step and direction interface. One conﬁguration pin selects the current control mode between

StealthChop™ for absolute silent motor control and SpreadCycle™ for high speed. A TTL UART

interface allows for more advanced conﬁguration and permanent parameter storage via the TMCL-

IDE.

Features

• Supply Voltage +10. . . +30V DC

• Up to 3A RMS motor current

• Step and direction interface

• MicroPlyer™ to 256 microsteps

• StealthChop™ silent PWM mode

• SpreadCycle™ smart mixed decay

• StallGuard2™ load detection

• CoolStep™ autom. current scaling

• UART conﬁguration interface

Applications

• Laboratory Automation

• Manufacturing

• Semiconductor Handling

• Robotics

• Factory Automation

• Test & Measurement

• Life Science

• Biotechnology

• Liquid Handling

Simpliﬁed Block Diagram

µC

TMCL

Memory

Step

Motor

cDriver

with

stealthChop

UART

STEP/DIR

CHOP

9...24V

SPI

Terms of delivery and rights to technical change reserved.

Download newest version at: www.trinamic.com

Read entire documentation.

Summary of content (34 pages)

PAGE 1
MODULE Module for Stepper TMCM-1076 TMCL™ Firmware Manual Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 The TMCM-1076 is an easy to use stepper motor driver module. The module is controlled via a step and direction interface. One conﬁguration pin selects the current control mode between StealthChop™ for absolute silent motor control and SpreadCycle™ for high speed. A TTL UART interface allows for more advanced conﬁguration and permanent parameter storage via the TMCLIDE.
PAGE 2
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 2 / 34 Contents 1 Features 1.1 StallGuard2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 CoolStep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4 5 2 First Steps with TMCL 2.1 Basic Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.
PAGE 3
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3 / 34 10 Revision History 34 10.1 Firmware Revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 10.2 Document Revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 ©2019 TRINAMIC Motion Control GmbH & Co. KG, Hamburg, Germany Terms of delivery and rights to technical change reserved. Download newest version at www.
PAGE 4
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 1 4 / 34 Features The TMCM-1076 is a single axis controller/driver module for 2-phase bipolar stepper motors with state of the art feature set. It is highly integrated, offers a convenient handling and can be used in many decentralized applications. The module has been designed for coil currents up to 3A RMS and 24V DC supply voltage.
PAGE 5
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 5 / 34 stallGuard2 Load [Nm] Initial stallGuard2 (SG) value: 100% Max. load stallGuard2 (SG) value: 0 Maximum load reached. Motor close to stall. Motor stalls Figure 1: StallGuard2 Load Measurement as a Function of Load 1.2 CoolStep CoolStep is a load-adaptive automatic current scaling based on the load measurement via StallGuard2 adapting the required current to the load.
PAGE 6
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 2 6 / 34 First Steps with TMCL In this chapter you can ﬁnd some hints for your ﬁrst steps with the TMCM-1076 and TMCL. You may skip this chapter if you are already familiar with TMCL and the TMCL-IDE. Things that you will need • Your TMCM-1076 module. • A 5V TTL-UART cable. • A power supply (24V DC) for your TMCM-1076 module. • The TMCL-IDE 3.
PAGE 7
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 7 / 34 Number Axis Parameter Description Range [Units] Default Access 6 Maximum current Motor current used when motor is running. The maximum value is 31 which means 100% of the maximum current of the module. 0 . . . 31 24 RWE 7 Standby current The current used when the motor is not running. The maximum value is 31 which means 100% of the maximum current of the module.
PAGE 8
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3 8 / 34 TMCL and the TMCL-IDE — An Introduction As with most TRINAMIC modules the software running on the microprocessor of the TMCM-1076 consists of two parts, a boot loader and the ﬁrmware itself. Whereas the boot loader is installed during production and testing at TRINAMIC and remains untouched throughout the whole lifetime, the ﬁrmware can be updated by the user.
PAGE 9
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 9 / 34 TMCL Command Format Bytes Meaning 1 Module address 1 Command number 1 Type number 1 Motor or Bank number 4 Value (MSB ﬁrst!) 1 Checksum Table 2: TMCL Command Format Info Note 3.1.1 The checksum is calculated by accumulating all the other bytes using an 8-bit addition. When using the CAN interface, leave out the address byte and the checksum byte.
PAGE 10
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.2 10 / 34 Reply Format Every time a command has been sent to a module, the module sends a reply. The reply format with RS-232, RS-485, RS-422 and USB is as follows: TMCL Reply Format Bytes Meaning 1 Reply address 1 Module address 1 Status (e.g.
PAGE 11
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.3 11 / 34 TMCL Command Overview This sections gives a short overview of all TMCL commands.
PAGE 12
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 I/O Port Commands Mnemonic Command number Meaning GIO 15 Get input Table 7: I/O Port Commands ©2019 TRINAMIC Motion Control GmbH & Co. KG, Hamburg, Germany Terms of delivery and rights to technical change reserved. Download newest version at www.trinamic.
PAGE 13
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.5 13 / 34 Detailed TMCL Command Descriptions The module speciﬁc commands are explained in more detail on the following pages. They are listed according to their command number. 3.5.1 SAP (Set Axis Parameter) With this command most of the motion control parameters of the module can be speciﬁed. The settings will be stored in SRAM and therefore are volatile.
PAGE 14
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.5.2 14 / 34 GAP (Get Axis Parameter) Most motion / driver related parameters of the TMCM-1076 can be adjusted using e.g. the SAP command. With the GAP parameter they can be read out. In standalone mode the requested value is also transferred to the accumulator register for further processing purposes (such as conditional jumps).
PAGE 15
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.5.3 15 / 34 STAP (Store Axis Parameter) This command is used to store TMCL axis parameters permanently in the EEPROM of the module. This command is mainly needed to store the default conﬁguration of the module. The contents of the user variables can either be automatically or manually restored at power on.
PAGE 16
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.5.4 16 / 34 RSAP (Restore Axis Parameter) With this command the contents of an axis parameter can be restored from the EEPROM. By default, all axis parameters are automatically restored after power up. An axis parameter that has been changed before can be reset to the stored value by this instruction.
PAGE 17
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.5.5 17 / 34 GIO (Get Input) With this command the status of the available general purpose outputs of the module can be read. The function reads a digital or an analog input port. Digital input ports will read as 0 or 1. In standalone mode the requested value is copied to the accumulator register for further processing purposes such as conditional jumps.
PAGE 18
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 Reply (Status=no error, Value=302) Field Value Host address 02h Target address 01h Status 64h Instruction 0Fh Value (Byte 3) 00h Value (Byte 2) 00h Value (Byte 1) 01h Value (Byte 0) 2Eh Checksum A5h Bank 0 – Digital Inputs The digital input states can be accessed in bank 0.
PAGE 19
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 3.5.6 19 / 34 Customer speciﬁc Command Extensions (UF0. . . UF7 – User Functions) These commands are used for customer speciﬁc extensions of TMCL. They will be implemented in C by Trinamic. Please contact the sales department of Trinamic Motion Control GmbH & Co KG if you need a customized TMCL ﬁrmware. Related commands: none. Mnemonic: UF0. . .
PAGE 20
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 4 20 / 34 Axis Parameters Most motor controller features of the TMCM-1076 module are controlled by axis parameters. Axis parameters can be modiﬁed or read using SAP, GAP and AAP commands. Some axis parameters can also be stored to or restored from the EEPROM using STAP and RSAP commands. This chapter describes all axis parameters that can be used on the TMCM-1076 module.
PAGE 21
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 21 / 34 Number Axis Parameter Description Range [Units] Default Access 138 CoolConf Access to the COOLCONF register (0x6D of the TMC5130) for the CoolStep Conﬁguration. Use STGP and RSGP to access the stored value in the EEPROM. 0 . . . 4294967295 33011 RWE 139 CHOPConf Access to the CHOPCONF register (0x6C of the TMC5130) for the Chopper Conﬁguration (excluded Microstep Conﬁguration).
PAGE 22
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 22 / 34 Number Axis Parameter Description Range [Units] Default Access 170 SmartEnergy hysteresis Sets the distance between the lower and the upper threshold for StallGuard2 reading. Above the upper threshold the motor current becomes decreased. Hysteresis: ([AP172] + 1) * 32. Upper StallGuard threshold: ([AP172] + [AP170] + 1) * 32 0 . . .
PAGE 23
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 23 / 34 Number Axis Parameter Description Range [Units] Default Access 206 Load value Actual current control scaling for monitoring smart energy current scaling or automatic current scaling. 0 . . . 1023 0 R Table 8: All TMCM-1076 Axis 0 Parameters ©2019 TRINAMIC Motion Control GmbH & Co. KG, Hamburg, Germany Terms of delivery and rights to technical change reserved.
PAGE 24
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 5 24 / 34 Module Speciﬁc Conﬁguration This section explains how to use the two digital inputs of the TMCM-1076. It also describes the default conﬁguration for microstep resolution and interpolation as well as for current setting. 5.1 Digital Inputs The TMCM-1076 includes two digital inputs: ENABLE and CHOP. The ENABLE input is a low active input which powers the motor when the ENABLE is not set.
PAGE 25
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 5.4 25 / 34 Conﬁguration with the TMCL-IDE Plugin When using a PC and the TMCL-IDE, the TMCM-1076 can be easily conﬁgured with the Module Settings plugin. This tool provides a direct graphic interface to the most important parameters of the module. Figure 3 shows the ﬁrst tab of the tool, which is called Current.
PAGE 26
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 Figure 4: TMCL-IDE Plugin: Tab StealthChop Figure 5: TMCL-IDE Plugin: Tab CoolStep ©2019 TRINAMIC Motion Control GmbH & Co. KG, Hamburg, Germany Terms of delivery and rights to technical change reserved. Download newest version at www.trinamic.
PAGE 27
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 6 27 / 34 Hints and Tips This chapter gives some hints and tips on using the functionality of TMCL, for example how to use and parameterize the built-in reference search algorithm. You will also ﬁnd basic information about StallGuard2™ and CoolStep™ in this chapter. 6.1 StallGuard2 The module is equipped with motor driver chips that feature load measurement.
PAGE 28
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 6.2 28 / 34 CoolStep This section gives an overview of the CoolStep related parameters. Please bear in mind that the ﬁgure only shows one example for a drive. There are parameters which concern the conﬁguration of the current. Other parameters are there for velocity regulation and for time adjustment. Figure 6 shows all the adjustment points for CoolStep.
PAGE 29
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 CoolStep Adjustment Points and Thresholds Number Axis Parameter Description I6 Absolute maximum current The maximum value is 255. This value means 100% of the maximum current of the module. The current adjustment is within the range 0. . . 255 and can be adjusted in 32 steps (0. . . 255 divided by eight; e.g. step 0 = 0. . . 7, step 1 = 8. . . 15 and so on).
PAGE 30
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 7 30 / 34 Figures Index 1 StallGuard2 Load Measurement as a Function of Load . . . . . . . . . . . . . . 2 Energy Eﬃciency Example with CoolStep 3 TMCL-IDE Plugin: Tab Current . . . . . . 5 5 25 ©2019 TRINAMIC Motion Control GmbH & Co. KG, Hamburg, Germany Terms of delivery and rights to technical change reserved. Download newest version at www.trinamic.com 4 TMCL-IDE Plugin: Tab StealthChop . . . .
PAGE 31
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 8 31 / 34 Tables Index 1 2 3 4 5 6 7 Most important Axis Parameters . TMCL Command Format . . . . . . TMCL Reply Format . . . . . . . . . TMCL Status Codes . . . . . . . . . Overview of all TMCL Commands Parameter Commands . . . . . . . I/O Port Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 9 10 10 11 11 12 ©2019 TRINAMIC Motion Control GmbH & Co.
PAGE 32
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 9 32 / 34 Supplemental Directives 9.1 Producer Information 9.2 Copyright TRINAMIC owns the content of this user manual in its entirety, including but not limited to pictures, logos, trademarks, and resources. © Copyright 2019 TRINAMIC. All rights reserved. Electronically published by TRINAMIC, Germany.
PAGE 33
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 33 / 34 or of any other nature are made hereunder with respect to information/speciﬁcation or the products to which information refers and no guarantee with respect to compliance to the intended use is given. In particular, this also applies to the stated possible applications or areas of applications of the product.
PAGE 34
TMCM-1076 TMCL™ Firmware Manual • Firmware Version V1.02 | Document Revision V1.02 • 2019-APR-23 10 Revision History 10.1 Firmware Revision Version Date Author Description V1.02 2018-MAR-26 OK First release. Table 11: Firmware Revision 10.2 Document Revision Version Date Author Description V1.00 2018-MAR-26 OK First release. V1.01 2019-JAN-25 OK Reset to factory default description changed. Superﬂuous global parameters removed. V1.