Project Files of TMC2209 Stepper Driver Library for Proteus Simulation

TMC2209 STEPPER DRIVER LIBRARY FOR PROTEUS SIMULATION - V1.0 (a silent two-phase stepper driver module, with a pop-up)
Designed by The Engineering Projects
www.TheEngineeringProjects.com

IMPORTANT LINKS
Article (read it first - pictures, step by step, every feature explained):
  https://www.theengineeringprojects.com/2026/11/tmc2209-stepper-driver-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/motor-driver-proteus-library
The demo runs on our Arduino UNO V4.0 (included) - working LEDs, RESET and a
built-in serial monitor, no Virtual Terminal to wire - its own article:
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
The demo drives our NEMA 17 Linear Stage library (a SEPARATE library - install it too):
  https://www.theengineeringprojects.com/2026/11/nema-17-linear-stage-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
TMC2209-Stepper-Driver-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPTMC2209.LIB                                 16.0 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPTMC2209.DLL                                300.0 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPTMC2209.DLL                                300.0 KB   copy of the model
|   |-- TMC2209_Demo.hex                               22.2 KB   the demo firmware
|   |-- TMC2209-STAGE100-ArduinoUnoV4.pdsprj           21.1 KB   the demo project
|-- Arduino Code/
|   |-- TMC2209_Demo/TMC2209_Demo.ino                   4.9 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~14.0 KB   this file
Total: 2.59 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
The TMC2209 StepStick module - the silent stepper driver of 3D printers and CNC machines - drawn at
true scale (a 15.24 x 20.32 mm black
board with the chip's thermal pad, the VREF trimmer, the two 8-pin rows and the DIAG / INDEX pins;
our own drawing, no maker's mark):
  * The chip (its datasheet): 4.75 - 28 V on this module, 2 A RMS / 2.8 A peak, 0.17 ohm switches;
    STEP / DIR with 8, 16, 32 or 64
    microsteps by MS1 / MS2, interpolated to 256 at the motor (MicroPlyer); StealthChop2 (silent) or
    SpreadCycle.
  * MS2 MS1: 00 = 1/8, 01 = 1/32, 10 = 1/64, 11 = 1/16. EN low enables (open reads low here).
  * The current: I peak = VREF in volts (the module's 0.11 ohm sense resistors; 0.2 - 2.2 V, 1.2 V
    from the factory = 1.2 A peak, 0.85 A
    RMS). The model's VREF property is the trimmer.
  * The model: four averaged half-bridges and a current loop per coil that makes the coil current
    follow a cosine and a sine of the
    microstep counter (1024 to an electrical turn); INDEX high at the counter's zero; DIAG high on
    over-temperature (120 C warning, 143 C off)
    or a short.
  * Click it at Run for the pop-up: the two coil currents against their targets (about four
    electrical turns, 20 - 200 ms), the current
    vector on its microstep circle, the inputs (the MS1 / MS2 table lit), graphs, an event log and a
    check page.
The body is drawn as on the real part and to true scale against our Arduino.
The TEP signature and the pop-up are TEP additions.

ONE DEVICE (search "TMC2209" in Pick Devices):
  TMC2209TEP  "TMC2209 Stepper Driver V1.0" in TEPTMC2209.LIB (Electromechanical > Motor Drivers),
  prefix U, model TEPTMC2209.DLL (mixed).
              Pins EN, MS1, MS2, STEP, DIR (left); VM, GND, A2, A1, B1, B2, VDD (right); DIAG and
              INDEX (top). PDN, UART, CLK and the
              second GND are pads only. The name starts with T so that it sorts after the embedded
              ARDUINO UNO V4.0.
The demo's load is our 100 mm stage (STAGE100TEP in TEPLINSTAGE.LIB / TEPLINSTAGE.DLL): a separate
library - install it from its own package.

THE POP-UP
Click the part at Run. Tabs:
    Driver     the two coil currents (A yellow, B green) with their targets over about four
    electrical turns (20 - 200 ms), the
               current vector against its target on the microstep circle, the inputs (the MS1 / MS2
               table, EN, VDD, INDEX, DIAG), and
               eight live values: the microsteps, the step rate, coil A, coil B, VREF, the microstep
               counter, VM and the power, the junction
               and DIAG.
    Graphs     the live values over the last 2, 6 or 15 s. Live / Freeze.
    Event log  every change and warning; filters All / Changes / Warnings, Pause, Clear
    Check      what the part is doing and what to look at, each with a verdict (green = fine, amber
    = check, red = wrong)
    Settings   theme, text size, open at Run, window size
    Help       report a bug, suggest a feature, article, updates, donate, forum; Copy diagnostics
    for a bug report

TEST STATUS
V1.0: verified in Proteus 8.5 on 8 Nov 2026 (the demo project as shipped: an A4 sheet, an Arduino UNO V4.0).
What the runs showed (the model's own numbers and the sketch's monitor):
  * The project loads and starts cleanly; the 9 s program runs in about three minutes on our PC
    (with both pop-ups open).
  * The TMC2209 on 24 V (VDD 5 V), VREF 1.2 V = 1.20 A peak, moving our 100 mm stage 20 mm at a
    time. 1/8: 4.00 kHz, 150 RPM, 1.32 A in
    the coils (coil A 0.59 A against 0.67, the loop a little behind at speed); holding after 4000
    steps with coil A 1.20 A, coil B 0.00 A,
    the counter at 0 of 1024 and INDEX high. 1/16: 8.00 kHz, the same 150 RPM. 1/32: 16.29 kHz, 153
    RPM; the stage at 58.28 mm at 20.0 mm/s,
    the same point and speed as at 1/8. 1/64 at 10 mm/s: 16.10 kHz, 75 RPM, 1.25 A.
  * After the four moves: 60000 steps, the counter at 0, the carriage back at 50.00 mm. EN high:
    DISABLED, both coils 0.00 A, 0.24 W, the
    stage NO CURRENT; EN low: holding 1.20 A again, the counter kept. The junction 31 C at the most,
    DIAG low throughout.
  * The pop-up: Driver (the coil currents against their targets, the current vector on its microstep
    circle, the inputs with the MS1 / MS2
    table), Graphs, Event log, Check - all four followed the run.

INSTALLATION (about 2 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" (TEPTMC2209.LIB and our Arduino library V4.0,
ArduinoV4TEP.LIB, with the ARDUINO UNO V4.0 used by the demo) to the LIBRARY folder of Proteus, for
example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (use the folder that already holds Proteus's own .LIB files).
3. Copy TEPTMC2209.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the MODELS folder
(...\Proteus 8 Professional\MODELS).
4. Delete TEPTMC2209.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "TMC2209".

RUN THE DEMO
"Proteus Simulation\TMC2209-STAGE100-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file and the
DLLs beside the project.
  ARD1:   Arduino UNO V4.0 running TMC2209_Demo.hex, its serial monitor built in (window "TEP
  Arduino UNO - ARD1").
  U1:     the TMC2209 on 24 V (VDD 5 V): STEP D3, DIR D4, EN D8, MS1 D5, MS2 D6, DIAG to D7; A1 A2
  B1 B2 to the stage's coils.
  M1:     our 100 mm stage (its switches on D10 / D11).
  1. 20 mm moves at 20 mm/s at 1/8, 1/16 and 1/32 - the same distance takes 200, 400 and 800 pulses
  a mm - then 1/64 at 10 mm/s.
  2. EN high: the outputs open, the motor free; EN low: holding again.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  VM 4.75 - 28 V (with a capacitor near the module), VDD 3.3 or 5 V (the logic), GND to both
  grounds. A1 A2 to one coil, B1 B2 to the
  other. STEP, DIR, EN, MS1, MS2 to outputs. Set VREF with the trimmer for the motor's current (1.2
  V = 1.2 A peak).
REAL HARDWARE:
 * Set the current first: VREF in volts = the peak in amperes with this module; RMS = peak / 1.41.
   Too high heats the motor and the chip.
 * Cool it: at more than about 1 A RMS the module needs its heatsink and some air.
 * Never unplug the motor with VM on: the coil's current has nowhere to go and the driver can fail.

THE DEMO SKETCH ON THE SERIAL MONITOR (TMC2209_Demo V1.0, 9600 baud)
The sketch runs its program, then waits. Type a command:
  m 8    1/8 (16, 32, 64)     g 10    move 10 mm      e 0 / e 1    EN high / low
EXPECTED MONITOR OUTPUT
  TMC2209 stepper driver - The Engineering Projects
  MS2 MS1: 00 1/8, 01 1/32, 10 1/64, 11 1/16; 25 x the microsteps pulses a mm

PROPERTIES (double-click the part > Edit Properties)
  VREF (VREF)                          the trimmer, V (0.2 - 2.2): the peak coil current in amperes
  (1.2)
Every run starts again from the properties.

LINKS.INI (OPTIONAL)
The Help page cards of the pop-up open web pages. To point them somewhere else without a new DLL,
put a text file named links.ini next to TEPTMC2209.DLL with lines KEY=URL, for example:
  ARTICLE=https://www.theengineeringprojects.com/...
Keys: WEBSITE, FORUM, BUG_REPORT, FEATURE_REQUEST, ARTICLE, USER_GUIDE,
UPDATE_CHECK, DONATE. Only http:// and https:// links are used; lines starting
with # are comments.

TROUBLESHOOTING
* The motor does not move: EN is high, VM or VDD is missing, or STEP never changes.
* It moves the wrong way: swap DIR's level in the sketch, or swap one coil's two wires.
* DIAG high: over-temperature or a short - lower VREF, cool the module; a short needs EN high and
  low again.
* The part is not simulated: TEPTMC2209.DLL is missing from MODELS and from the project folder.
* The part is not simulated: TEPTMC2209.DLL is missing from MODELS and from the project folder. No
  UNO / no monitor window: TEPARDUINO.DLL is missing, or click the UNO's USB port.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot, the Serial Monitor text, the
simulation log and the pop-up's Copy diagnostics text:
  https://www.theengineeringprojects.com/forum/category/motor-driver-proteus-library

SUPPORT US
This library is free. If it saves you time, please support our work:
  https://www.theengineeringprojects.com/donate

WEBSITE
  https://www.theengineeringprojects.com/

LICENCES AND THIRD-PARTY NOTES
* The model (TEPTMC2209.DLL), the symbols and artwork, the other parts of ours in the demo and the
  Arduino Library V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, with its built-in TEP Serial Monitor
  Advance) are made by The Engineering Projects. The models use only standard Windows libraries; no
  Visual C++ redistributable is needed.
  The C++ source code is not included.
* Arduino UNO V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, our Arduino Library V4.0 - its
  microcontroller is Proteus's own AVR model): The Engineering Projects,
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
* The .hex file is built from the demo sketch and the Arduino AVR core 1.8.6, which includes
  LGPL-licensed code; its source code is available at
  https://github.com/arduino/ArduinoCore-avr/tree/1.8.6
* Proteus is a product of Labcenter Electronics and is not included. Arduino is a trademark of Arduino SA.
  This library is not made or endorsed by Arduino or Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied; Arduino IDE is not needed to run the demo. To edit the sketch, open
Arduino Code\TMC2209_Demo\TMC2209_Demo.ino, select Arduino Uno and use Sketch > Export Compiled
Binary. Replace the simulation's .hex with the exported HEX. The sketch needs 8,088 bytes of flash
and 292 bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the STEP / DIR / EN / MS1 / MS2 inputs and the microstep counter, the coil currents
through four averaged half-bridges with a
1 kHz current loop (our tuning), VREF, INDEX, DIAG, over-temperature (lumped die: 30 K/W, 0.5 J/K -
our figures), the short protection.
Not modelled: the UART registers, StealthChop's voltage mode and the chopper's ripple, StallGuard,
CoolStep, the standstill reduction.

VERSION
TEP TMC2209 Stepper Driver library V1.0 (Nov 2026). Device TMC2209TEP (TEPTMC2209.LIB /
TEPTMC2209.DLL). Demo sketch TMC2209_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino Library
V4.0) with its built-in serial monitor; load: our NEMA 17 Linear Stage library.