How to drive a stepper motor with your Raspberry Pi 3/2 using a TMC5130-EVAL

In this start up guide you get explained how to connect your Raspberry Pi 3 or 2 for the basic operation of the TMC5130-EVAL board. It will use the internal Motion Controller and +3V3 logic supply for the TMC5130. The wiring will be limited to the basic functionallity to communicate via SPI. The internal CLK for the TMC5130 will be used respective the CLK16 pin (Shown on figure 1) has to be tied to GND. The SPI CLK frequency of the Raspberry Pi will be set up to be 1MHz.


With a fresh installation of Raspbian (In this tutorial Raspbian Jessy Lite – Version March 2017 – Release date 2017-03-02) first update the libraries:

This may take a while since it will upgrade all packages that are installed to the newest version if available. Furthermore it will upgrade dependencies or remove them if they have been replaced with other dependencies.

Download and install the bcm2835 library. Note XXX is a place holder for the latest version. For this guide version “1.52” was used. In this case XXX is replaced by “1.52”. You can check the latest version by scrolling to the bottom of the following page:

Afterwards restart your PI by typing.



The wiring is very simple. You will need 8 jumper wires. As a reference you can use the TMC5130-Eval_v15_01_Schematic.pdf. You will find the signals that are on each pin.

Signal Raspberry Pi 2 TMC5130-EVAL
+5V +5V (2) +5V (5)
GND GND (39) GND (2)
TMC5130 enable GND (9) DIO_0 (8)
TMC5130 CLK GND (6) CLK16 (23)
Chip select (CS) SPI0 CS0 (24) SPI1_CSN (30)


Pinheader of TMC5130-EVAL


Raspberry Pi 3 GPIO Header
Raspberry Pi 3 GPIO Header – Source:

Raspberry 3 wired up with TMC5130-EVAL
Raspberry 3 wired up with TMC5130-EVAL


Please note that the TMC5130-EVAL has to be powered with the supply voltage e.g. 24V. To avoid damage only disconnect or connect a motor without supply voltage.

Raspberry Pi Code

An example code to initialize the TMC5130 is shown below. It will clear the reset flag in the GCONF register, sets example chopper configurations and sets the run and hold current for the motor. Furthermore it will set the ramping mode to velocity mode, an acceleration and a velocity. Be aware that the motor runs as soon as you execute the script.
You can download the code directly with your pi by typing:

Compiling and running the code

Please use the following command to compile the code.

This compiles the file spi-5130.c

Now you are able to execute the example.

Related Pages


  • parovelb

    Good reference. And how to connect a RPi2/3 to a TMCM 6110 RS485 with a db9 connector?

  • Lars Jaskulski

    Hello, thanks for your feedback! Connecting a Raspberry Pi with a TMCM-6110 sounds interesting. We do not have an example ready but it sounds like a great idea. Are you currently working on that?

  • parovelb

    Yes, I am working on that. I have trouble finding the complete pinout diagram for the rs485 connector of the module. In the hardware manual only the DATA+ (pin 7), DATA- (pin 2) and POWER(GND) (pin 3) are mentioned.

  • Lars Jaskulski

    Hi, that is correct. The TMCM-6110 comes with a 2-wire RS-485 interface (Half-Duplex).
    Furthermore it seems that you will need additional RS-485 transceiver Hardware for the Pi. You’ll find ready to use modules / addons but could develop your own electronic as well.
    I could think of using a USB to RS-485 converter connected to the Raspberry Pi as well. Sureley depends on the compatibility of the drivers but might be worth a try.

  • A Hacking

    I have a few questions:

    Any example code for Python?

    As I understand the 5130 chip enables real time control of the stepper motor which is a huge benefit when working with a system like the RPi.

    How would you implement the end-stop detection in python via the stepper motor?



  • Lars Jaskulski

    Hi Adam,

    Currently we do not have code examples available for python but this is a good idea for a future blog post.
    The end-stop detection is mainly dependent on the stallGuard2 feature. First a SPI communication to the chip is necessary. After that you can configure the responsible registers fitting for your needs.

    Below a screen capture on youtube that shows the necessary steps when using our GUI – TMCL IDE and the TMC5130-EVAL-KIT.

    You’ll find additional information on stallGuard2 in the TMC5130 datasheet and in an application note.

    I hope that helps and feel free to share your results with the RPi using python + stallGuard2.

    Best regards,

  • Patrick


    could someone explain to me how I can convert a number like 512000 into the 4 Sequences I need for the SPI transfer.
    I´m programming in C and I have no idea how to do this. It should be automatically converted in my program for example for Xtarget.

    thanks in advance


  • Lars Jaskulski

    Hello Patrick,

    This is a simple conversion from decimal to hexadecimal. 512000 dec equals 7D000 in hex. This can either be done by your own functions or I am sure you’ll find functions on the web that can be easily implemented.

    The datagram length of the SPI communication with the TMC5130 is 40 bit. As SPI in most cases work with 8 bit respective 1 byte the 40 bit are seperated into these sequences.

    Hope that helps. If you need more guidance, please let us know.

    Best regards,

  • John


    Potentially a very stupid question, can you drive a TMC 2130 using a raspberry pi? If so can you point to somewhere I can find out more about doing so?

    All the best,


  • Lars Jaskulski

    Hi John,

    You can use the same example that is been used for the TMC5130. As the TMC2130 is driven via external STEP/DIR you need to have a source to provide the step signal and the direction signal from a output pin of the RasPi.

    You can use the TMC2130 datasheet for further information on the register settings.

    Hope that helps as a starting point.

    Best regards,

  • yanick

    HI Lars

    I have a question.
    I did everything as it says in this description. but when I compile I get an error:

    pi @ raspberrypi: ~ $ gcc -o spi-test spi-5130.c -lbcm2835
    gcc: error: -o: No such file or directory
    gcc: error: spi-test: No such file or directory
    gcc: error: -lbcm2835: No such file or directory
    pi @ raspberrypi: ~ $

    what is the problem? I installed everything as described

    Best regards,

  • Lars Jaskulski

    Hi Yanick,
    Sound to me that the source file is not in the directory you are currently working in. Have you fixed this issue in the mean time? Let me know and we can go on checking what might be the reason here.
    Best regards,

  • Jade yang

    I am testing the tmc5130 using tmc5130-eval and TMCL-IDE 3.0.
    I want to get the all register values at TMCL-IDE3.0, and I will copy these values to our new hardware system.

    I have checked your register browser, but I think the values in register browser are not the exact register values in tmc5130-eval board.
    For example, if i change the amax value, amax register value in register browser is not changed.

    Best regards.

  • Lars Jaskulski

    Hi Jade,
    You can read the register values in the register browser by clicking on the icon shown in the screenshot below. Please note it will read registers with RC (read and clear) as well and therefore clear set flags.
    The write only registers do not get updated when using for example the position mode but the read button Read button in register browser will update the values when clicked.
    TMC5130 Register Browser - Read all values
    Hope this helps!
    Best regards,

  • Rhom

    nice example…
    i want to stop the motors after 1 turn, which command i have to use?
    I thought with:
    uint8_t ramp_mode[40] = { 0xA0, 0x00, 0x00, 0x00, 0x03 };
    bcm2835_spi_transfernb(ramp_mode, ramp_mode, 5);
    i can set the motors in status hold but it doesnt work,
    can you please advice me?

  • Lars Jaskulski


    If you want to stop the motor after one turn in position mode you simply set the target position to one revolution. With 256 micro step resolution and a 200 ful step motor per turn this would be position 51200 (256 multiplied with 200).

    Best regards,

  • Sebastian Müller


    I had the sam problem, compiling with gcc.

    Changing the parameter order fixed the problem

    gcc ./spi-5130.c -lbcm2835 -o spi-test


Leave a Reply

Your email address will not be published. Required fields are marked *