/*

* tmc2209.h - register and message (datagram) descriptors for Trinamic TMC2209 stepper driver

*

* v0.0.8 / 2024-11-16

*/

/*

Copyright (c) 2020-2024, Terje Io

All rights reserved.

Redistribution and use in source and binary forms, with or without modification,

are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this

list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this

list of conditions and the following disclaimer in the documentation and/or

other materials provided with the distribution.

* Neither the name of the copyright holder nor the names of its contributors may

be used to endorse or promote products derived from this software without

specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR

ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/

#ifndef _TRINAMIC2209_H_

#define _TRINAMIC2209_H_

#include <stdint.h>

#include <stdbool.h>

#include "common.h"

#pragma pack(push, 1)

typedef enum {

TMC2209_Microsteps_1 = 1,

TMC2209_Microsteps_2 = 2,

TMC2209_Microsteps_4 = 4,

TMC2209_Microsteps_8 = 8,

TMC2209_Microsteps_16 = 16,

TMC2209_Microsteps_32 = 32,

TMC2209_Microsteps_64 = 64,

TMC2209_Microsteps_128 = 128,

TMC2209_Microsteps_256 = 256

} tmc2209_microsteps_t;

// default values

// General

#define TMC2209_F_CLK 12000000UL // factory tuned to 12MHz - see datasheet for calibration procedure if required

#define TMC2209_MODE TMCMode_StealthChop // 0 = TMCMode_StealthChop, 1 = TMCMode_CoolStep, 3 = TMCMode_StallGuard

#define TMC2209_MICROSTEPS TMC2209_Microsteps_4

#define TMC2209_R_SENSE 110 // mOhm

#define TMC2209_CURRENT 500 // mA RMS

#define TMC2209_HOLD_CURRENT_PCT 50

// CHOPCONF

#define TMC2209_INTPOL 1 // Step interpolation: 0 = off, 1 = on

#define TMC2209_TOFF 3 // Off time: 1 - 15, 0 = MOSFET disable

#define TMC2209_TBL 1 // Blanking time: 0 = 16, 1 = 24, 2 = 36, 3 = 54 clocks

#define TMC2209_HSTRT 1 // Hysteresis start: 1 - 8

#define TMC2209_HEND -1 // Hysteresis end: -3 - 12

#define TMC2209_HMAX 16 // HSTRT HEND

#define TMC2209_IHOLDDELAY 10 // 0 - 15

// TPOWERDOWN

#define TMC2209_TPOWERDOWN 20 // 0 - ((2^8)-1) * 2^18 tCLK

// TPWMTHRS

#define TMC2209_TPWM_THRS TMC_THRESHOLD_MIN // tpwmthrs: 0 - 2^20 - 1 (20 bits)

// PWMCONF - StealthChop defaults

#define TMC2209_PWM_FREQ 1 // 0 = 1/1024, 1 = 2/683, 2 = 2/512, 3 = 2/410 fCLK

#define TMC2209_PWM_AUTOGRAD 1 // boolean (0 or 1)

#define TMC2209_PWM_GRAD 14 // 0 - 255

#define TMC2209_PWM_LIM 12 // 0 - 15

#define TMC2209_PWM_REG 8 // 1 - 15

#define TMC2209_PWM_OFS 36 // 0 - 255

// TCOOLTHRS

#define TMC2209_COOLSTEP_THRS TMC_THRESHOLD_MIN // tpwmthrs: 0 - 2^20 - 1 (20 bits)

// COOLCONF - CoolStep defaults

#define TMC2209_SEMIN 5 // 0 = coolStep off, 1 - 15 = coolStep on

#define TMC2209_SEUP 0 // 0 - 3 (1 - 8)

#define TMC2209_SEMAX 2 // 0 - 15

#define TMC2209_SEDN 1 // 0 - 3

#define TMC2209_SEIMIN 0 // boolean (0 or 1)

// end of default values

#if TMC2209_MODE == 0 // StealthChop

#define TMC2209_PWM_AUTOSCALE 1

#define TMC2209_SPREADCYCLE 0

#elif TMC2209_MODE == 1 // CoolStep

#define TMC2209_PWM_AUTOSCALE 0

#define TMC2209_SPREADCYCLE 1

#else //StallGuard

#define TMC2209_PWM_AUTOSCALE 0

#define TMC2209_SPREADCYCLE 0

#endif

typedef uint8_t tmc2209_regaddr_t;

enum tmc2209_regaddr_t {

};

typedef union {

uint8_t value;

struct {

uint8_t

reset_flag :1,

driver_error :1,

sg2 :1,

standstill :1,

unused :4;

};

} TMC2209_status_t;

// --- register definitions ---

// GCONF : RW

typedef union {

uint32_t value;

struct {

uint32_t

I_scale_analog :1,

internal_Rsense :1,

en_spreadcycle :1,

shaft :1,

index_otpw :1,

index_step :1,

pdn_disable :1,

mstep_reg_select :1,

multistep_filt :1,

test_mode :1,

reserved :22;

};

} TMC2209_gconf_reg_t;

// GSTAT : R C

typedef union {

uint32_t value;

struct {

uint32_t

reset :1,

drv_err :1,

uv_cp :1,

reserved :29;

};

} TMC2209_gstat_reg_t;

// IFCNT : R

typedef union {

uint32_t value;

struct {

uint32_t

count :8,

reserved :24;

};

} TMC2209_ifcnt_reg_t;

// SLAVECONF : W

typedef union {

uint32_t value;

struct {

uint32_t

reserved0 :8,

conf :4,

reserved1 :20;

};

} TMC2209_slaveconf_reg_t;

// OTP_PROG : W

typedef union {

uint32_t value;

struct {

uint32_t

otpbit :2,

otpbyte :2,

otpmagic :28;

};

} TMC2209_otp_prog_reg_t;

// OTP_READ : R

typedef union {

uint32_t value;

struct {

uint32_t

otp0_0_4 :5,

otp0_5 :1,

otp0_6 :1,

otp0_7 :1,

otp1_0_3 :4,

otp1_4 :1,

otp1_5_7 :3,

otp2_0 :1,

otp2_1 :1,

otp2_2 :1,

otp2_3_4 :2,

otp2_5_6 :2,

otp2_7 :1,

reserved :8;

};

} TMC2209_otp_read_reg_t;

// IOIN : R

typedef union {

uint32_t value;

struct {

uint32_t

enn :1,

unused0 :1,

ms1 :1,

ms2 :1,

diag :1,

unused1 :1,

pdn_uart :1,

step :1,

spread_en :1,

dir :1,

reserved :14,

version :8;

};

} TMC2209_ioin_reg_t;

// FACTORY_CONF : RW

typedef union {

uint32_t value;

struct {

uint32_t

fclktrim :4,

reserved1 :3,

ottrim :2,

reserved :23;

};

} TMC2209_factory_conf_reg_t;

// IHOLD_IRUN : R

typedef union {

uint32_t value;

struct {

uint32_t

ihold :5,

reserved1 :3,

irun :5,

reserved2 :3,

iholddelay :4,

reserved3 :12;

};

} TMC2209_ihold_irun_reg_t;

// TPOWERDOWN : W

typedef union {

uint32_t value;

struct {

uint32_t

tpowerdown :8,

reserved :24;

};

} TMC2209_tpowerdown_reg_t;

// TSTEP : R

typedef union {

uint32_t value;

struct {

uint32_t

tstep :20,

reserved :12;

};

} TMC2209_tstep_reg_t;

// TPWMTHRS : W

typedef union {

uint32_t value;

struct {

uint32_t

tpwmthrs :20,

reserved :12;

};

} TMC2209_tpwmthrs_reg_t;

// TCOOLTHRS : W

typedef union {

uint32_t value;

struct {

uint32_t

tcoolthrs :20,

reserved :12;

};

} TMC2209_tcoolthrs_reg_t;

// VACTUAL : W

typedef union {

uint32_t value;

struct {

uint32_t

actual :24,

reserved :8;

};

} TMC2209_vactual_reg_t;

// SGTHRS : W

typedef union {

uint32_t value;

struct {

uint32_t

threshold :8,

reserved :24;

};

} TMC2209_sgthrs_reg_t;

// SG_RESULT : R

typedef union {

uint32_t value;

struct {

uint32_t

result :10,

reserved :22;

};

} TMC2209_sg_result_reg_t;

// MSCNT : R

typedef union {

uint32_t value;

struct {

uint32_t

mscnt :10,

reserved :22;

};

} TMC2209_mscnt_reg_t;

// MSCURACT : R

typedef union {

uint32_t value;

struct {

uint32_t

cur_a :9,

reserved1 :7,

cur_b :9,

reserved2 :7;

};

} TMC2209_mscuract_reg_t;

// CHOPCONF : RW

typedef union {

uint32_t value;

struct {

uint32_t

toff :4,

hstrt :3,

hend :4,

reserved0 :4,

tbl :2,

vsense :1,

reserved1 :6,

mres :4,

intpol :1,

dedge :1,

diss2g :1,

diss2vs :1;

};

} TMC2209_chopconf_reg_t;

// DRV_STATUS : R

typedef union {

uint32_t value;

struct {

uint32_t

otpw :1,

ot :1,

s2ga :1,

s2gb :1,

s2vsa :1,

s2vsb :1,

ola :1,

olb :1,

t120 :1,

t143 :1,

t150 :1,

t157 :1,

reserved1 :4,

cs_actual :5,

reserved2 :3,

reserved3 :6,

stealth :1,

stst :1;

};

} TMC2209_drv_status_reg_t;

// COOLCONF : W

typedef union {

uint32_t value;

struct {

uint32_t

semin :4,

reserved1 :1,

seup :2,

reserved2 :1,

semax :4,

reserved3 :1,

sedn :2,

seimin :1,

reserved5 :16;

};

} TMC2209_coolconf_reg_t;

// PWMCONF : W

typedef union {

uint32_t value;

struct {

uint32_t

pwm_ofs :8,

pwm_grad :8,

pwm_freq :2,

pwm_autoscale :1,

pwm_autograd :1,

freewheel :2,

reserved :2,

pwm_reg :4,

pwm_lim :4;

};

} TMC2209_pwmconf_reg_t;

// PWM_SCALE : R

typedef union {

uint32_t value;

struct {

uint32_t

pwm_scale_sum :8,

reserved1 :8,

pwm_scale_auto :9,

reserved2 :7;

};

} TMC2209_pwm_scale_reg_t;

// PWM_AUTO : R

typedef union {

uint32_t value;

struct {

uint32_t

pwm_ofs_auto :8,

unused0 :8,

pwm_grad_auto :8,

unused1 :8;

};

} TMC2209_pwm_auto_ctrl_reg_t;

// --- end of register definitions ---

typedef union {

tmc2209_regaddr_t reg;

uint8_t value;

struct {

uint8_t

idx :7,

write :1;

};

} TMC2209_addr_t;

// --- datagrams ---

typedef struct {

TMC2209_addr_t addr;

TMC2209_gconf_reg_t reg;

} TMC2209_gconf_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_gstat_reg_t reg;

} TMC2209_gstat_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_tpowerdown_reg_t reg;

} TMC2209_tpowerdown_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_ifcnt_reg_t reg;

} TMC2209_ifcnt_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_slaveconf_reg_t reg;

} TMC2209_slaveconf_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_otp_prog_reg_t reg;

} TMC2209_otp_prog_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_otp_read_reg_t reg;

} TMC2209_otp_read_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_ioin_reg_t reg;

} TMC2209_ioin_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_factory_conf_reg_t reg;

} TMC2209_factory_conf_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_ihold_irun_reg_t reg;

} TMC2209_ihold_irun_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_tstep_reg_t reg;

} TMC2209_tstep_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_tpwmthrs_reg_t reg;

} TMC2209_tpwmthrs_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_tcoolthrs_reg_t reg;

} TMC2209_tcoolthrs_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_vactual_reg_t reg;

} TMC2209_vactual_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_sgthrs_reg_t reg;

} TMC2209_sgthrs_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_sg_result_reg_t reg;

} TMC2209_sg_result_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_mscnt_reg_t reg;

} TMC2209_mscnt_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_mscuract_reg_t reg;

} TMC2209_mscuract_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_chopconf_reg_t reg;

} TMC2209_chopconf_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_drv_status_reg_t reg;

} TMC2209_drv_status_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_coolconf_reg_t reg;

} TMC2209_coolconf_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_pwmconf_reg_t reg;

} TMC2209_pwmconf_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_pwm_scale_reg_t reg;

} TMC2209_pwm_scale_dgr_t;

typedef struct {

TMC2209_addr_t addr;

TMC2209_pwm_auto_ctrl_reg_t reg;

} TMC2209_pwm_auto_ctrl_dgr_t;

// -- end of datagrams

typedef union {

uint32_t value;

uint8_t data[4];

TMC2209_gconf_reg_t gconf;

TMC2209_gstat_reg_t gstat;

TMC2209_ifcnt_reg_t ifcnt;

TMC2209_slaveconf_reg_t slaveconf;

TMC2209_otp_prog_reg_t otp_prog;

TMC2209_otp_read_reg_t otp_read;

TMC2209_ioin_reg_t ioin;

TMC2209_factory_conf_reg_t factory_conf;

TMC2209_ihold_irun_reg_t ihold_irun;

TMC2209_tpowerdown_reg_t tpowerdown;

TMC2209_tstep_reg_t tstep;

TMC2209_tpwmthrs_reg_t tpwmthrs;

TMC2209_tcoolthrs_reg_t tcoolthrs;

TMC2209_vactual_reg_t vactual;

TMC2209_sgthrs_reg_t sgthrs;

TMC2209_sg_result_reg_t sg_result;

TMC2209_coolconf_reg_t coolconf;

TMC2209_mscnt_reg_t mscnt;

TMC2209_mscuract_reg_t mscuract;

TMC2209_chopconf_reg_t chopconf;

TMC2209_drv_status_reg_t drv_status;

TMC2209_pwmconf_reg_t pwmconf;

TMC2209_pwm_scale_reg_t pwm_scale;

TMC2209_pwm_auto_ctrl_reg_t pwm_auto_ctrl;

} TMC2209_payload;

typedef struct {

TMC2209_addr_t addr;

TMC2209_payload payload;

} TMC2209_datagram_t;

typedef union {

uint8_t data[8];

struct {

uint8_t sync;

uint8_t slave;

TMC2209_addr_t addr;

TMC2209_payload payload;

uint8_t crc;

} msg;

} TMC2209_write_datagram_t;

typedef union {

uint8_t data[4];

struct {

uint8_t sync;

uint8_t slave;

TMC2209_addr_t addr;

uint8_t crc;

} msg;

} TMC2209_read_datagram_t;

typedef struct {

// driver registers

TMC2209_gconf_dgr_t gconf;

TMC2209_gstat_dgr_t gstat;

TMC2209_ifcnt_dgr_t ifcnt;

TMC2209_slaveconf_dgr_t slaveconf;

TMC2209_otp_prog_dgr_t otp_prog;

TMC2209_otp_read_dgr_t otp_read;

TMC2209_ioin_dgr_t ioin;

TMC2209_factory_conf_dgr_t factory_conf;

TMC2209_ihold_irun_dgr_t ihold_irun;

TMC2209_tpowerdown_dgr_t tpowerdown;

TMC2209_tstep_dgr_t tstep;

TMC2209_tpwmthrs_dgr_t tpwmthrs;

TMC2209_tcoolthrs_dgr_t tcoolthrs;

TMC2209_vactual_dgr_t vactual;

TMC2209_sgthrs_dgr_t sgthrs;

TMC2209_sg_result_dgr_t sg_result;

TMC2209_coolconf_dgr_t coolconf;

TMC2209_mscnt_dgr_t mscnt;

TMC2209_mscuract_dgr_t mscuract;

TMC2209_chopconf_dgr_t chopconf;

TMC2209_drv_status_dgr_t drv_status;

TMC2209_pwmconf_dgr_t pwmconf;

TMC2209_pwm_scale_dgr_t pwm_scale;

TMC2209_pwm_auto_ctrl_dgr_t pwm_auto;

TMC2209_status_t driver_status;

trinamic_config_t config;

} TMC2209_t;

#pragma pack(pop)

bool TMC2209_Init(TMC2209_t *driver);

void TMC2209_SetDefaults (TMC2209_t *driver);

const trinamic_cfg_params_t *TMC2209_GetConfigDefaults (void);

void TMC2209_SetCurrent (TMC2209_t *driver, uint16_t mA, uint8_t hold_pct);

uint16_t TMC2209_GetCurrent (TMC2209_t *driver, trinamic_current_t type);

float TMC2209_GetTPWMTHRS (TMC2209_t *driver, float steps_mm);

void TMC2209_SetTPWMTHRS (TMC2209_t *driver, float mm_sec, float steps_mm);

bool TMC2209_MicrostepsIsValid (uint16_t usteps);

void TMC2209_SetMicrosteps(TMC2209_t *driver, tmc2209_microsteps_t usteps);

void TMC2209_SetTCOOLTHRS (TMC2209_t *driver, float mm_sec, float steps_mm);

void TMC2209_SetConstantOffTimeChopper(TMC2209_t *driver, uint8_t constant_off_time, uint8_t blank_time, uint8_t fast_decay_time, int8_t sine_wave_offset, bool use_current_comparator);

TMC2209_datagram_t *TMC2209_GetRegPtr (TMC2209_t *driver, tmc2209_regaddr_t reg);

bool TMC2209_WriteRegister (TMC2209_t *driver, TMC2209_datagram_t *reg);

bool TMC2209_ReadRegister (TMC2209_t *driver, TMC2209_datagram_t *reg);

#endif