FireWatchTower_2axis/firmware/lib/tmc/ic/TMC2130

TMC2130

How to use

To access the TMC2130's registers, the TMC-API offers two functions: tmc2130_readRegister and tmc2130_writeRegister. Each of these functions takes in an icID, which is used to identify the IC when multiple ICs are connected. This identifier is passed down to the callback functions (see How to Integrate).

How to integrate: overview

1. Include all the files of the TMC-API/ic/tmc/TMC2130 folder into the custom project.
2. Include the TMC2130.h file in the custom source code.
3. Implement the necessary callback functions (see below).
4. (optional): Take a look at the Examples subfolder for ready-made examples of the TMC-API usage.

Accessing the TMC2130 via SPI

The following diagram depicts how to access the TMC2130 via SPI using the TMC-API.

The description of the functions, in the above flowchart, are as follows:

• The functions tmc2130_readRegister and tmc2130_writeRegister are used to read and write the registers respectively. These functions check the current active bus and calls the bus-specific function i.e readRegisterSPI or writeRegisterSPI.
• These bus specific functions constructs the datagram and further calls the bus specific callback 'tmcXXXX_readWriteSPI.
• This callback function further calls the hardware specific read/write function for SPI and needs to be implemented externally.

How to integrate: Callback functions

To communicate with TMC2130 IC, the TMC-API library needs to know which bus (UART, SPI) it shall use. For that, the callback function 'tmc2130_getBusType()' needs to be implemented. Additionally, implement the following callback functions to access the chip via SPI:

1. tmc2130_readWriteSPI(), which is a HAL wrapper function that provides the necessary hardware access. This function should also set the chip select pin CSN to low before starting the data transfer and set to high upon completion. Please refer to the datasheet of the IC for further details.

Option to use the cache logic for Write-Only registers

The chip features write-only registers that are unable to be read, necessitating the creation of a shadow copy to cache their contents. This copy is automatically updated whenever data is written to these registers. This cache logic could be enabled by setting the macro TMC2130_CACHE to '1' or disabled by setting to '0' respectively. If this feature is enabled then there comes another option to use tmc2130_cache function, which is already implemeted in the API, by defining TMC2130_ENABLE_TMC_CACHE macro to '1 or one can implement their own function. The function tmc2130_cache works for both reading from and writing to the shadow array. It first checks whether the register has write-only access and data needs to be read from the hadow copy. On the basis of that, it returns true or false. The shadowRegisters on the premade cache implementation need to be one per chip. TMC2130_IC_CACHE_COUNT is set to '1' by default and is user-overwritable. If multiple chips are being used in the same project, increment its value to the number of chips connected.

Further info

Dependency graph for the ICs with new register R/W mechanism

This graph illustrates the relationships between files within the TMC-API library, highlighting dependencies and identifying the files that are essential for integrating the library into the custom projects.

Example usage: TMC-Evalsystem

For a reference usage of the TMC-API, visit the TMC-Evalsystem

Migration status

The TMC2130 has been reworked to the access system described above. For more infos on the status of this and other ICs, check out the migration page.