Skip to content

Hardware

The TMC9660's package, pins, bus settings, timing and power, as the driver uses them. The chip is a 70 V smart gate driver with a servo controller (FOC) in hardware and a buck converter; the driver talks to its processor over SPI or UART, never to the power stage directly.

Datasheet sections this page relies on

From Analog Devices (Trinamic) 19-101926 1:

  • Package, pins and power-up pin functions: Pin Configurations; Pin Descriptions, p. 11
  • Supply ranges and the hibernation mode: Power Supply - Electrical Characteristics, p. 17
  • Pin functions at power-up and the UART and SPI of the bootloader: General-Purpose Input/Output Description, p. 19
  • Clock, reset, DRV_EN, WAKE and FAULTN: Clock and Control Description, p. 63

All of them, with the driver API for each: Datasheet map.

Package and pins

The TMC9660 is sold in one package, the 64-pin TQFN (9 x 9 mm, 0.5 mm pitch) with an exposed pad that is GND. The pin table below is drawn from docs/hardware.yml, which cites the datasheet for each pin.

Pinout of the TMC9660 in TQFN-64, top view: 64 pins and an exposed pad, each with its name, its electrical type as a colour and the driver hook that uses it.Pinout of the TMC9660 in TQFN-64, top view: 64 pins and an exposed pad, each with its name, its electrical type as a colour and the driver hook that uses it.
TMC9660 pinout, TQFN-64
Figure description and sources

The TMC9660 seen from the top, in its TQFN-64 package. Pin 1 is marked by the dot; the numbers run counter-clockwise from it. Each pad is coloured by the pin's electrical type (legend below). Next to it is the pin's name and, in mono, the hook of the driver's port that drives or reads it; a pin without a hook is not used by the driver. The dashed square is the exposed pad.

Drawn from: docs/hardware.yml; inc/tmc9660_spi_interface.hpp; inc/tmc9660_types.hpp; inc/tmc9660_uart_interface.hpp.

Outline of the TMC9660 in TQFN-64 drawn to scale from above: body 9.0 x 9.0 mm, pitch 0.5 mm, 64 pins and an exposed pad.Outline of the TMC9660 in TQFN-64 drawn to scale from above: body 9.0 x 9.0 mm, pitch 0.5 mm, 64 pins and an exposed pad.
TMC9660 package, TQFN-64
Figure description and sources

The TMC9660 package seen from the top and, when the height is known, from the side, drawn to scale: 9.0 x 9.0 mm. The arrows carry the datasheet's dimensions, the dot marks pin 1 and the pads are numbered counter-clockwise from it, coloured by the pin's electrical type (legend below). Pads sit centred on each side at the stated pitch; the datasheet's land pattern is the reference for a board.

Drawn from: docs/hardware.yml; inc/tmc9660_spi_interface.hpp; inc/tmc9660_types.hpp; inc/tmc9660_uart_interface.hpp.

TQFN-64, 64 pins and an exposed pad (Pin Configurations, p. 11).

Pin Name Type (domain) Function Driver hook If unused Datasheet
1 GPIO9 bus (VCC_IO) GPIO9, or SPI0_MISO after power-up (bootloader SPI, data out) Transfer() Leave open (internal pull-up) Pin Descriptions, p. 12
2 GPIO10 bus (VCC_IO) GPIO10, or SPI0_MOSI after power-up (bootloader SPI, data in) Transfer() Leave open (internal pull-up) Pin Descriptions, p. 12
3 GPIO11 bus (VCC_IO) GPIO11, or SPI0_SCK after power-up (bootloader SPI, clock in) Transfer() Leave open (internal pull-up) Pin Descriptions, p. 12
4 GPIO12 bus (VCC_IO) GPIO12, or SPI0_CS0 after power-up (bootloader SPI, chip select, active low) Transfer() Leave open (internal pull-up) Pin Descriptions, p. 12
5 GPIO13 digital in/out (VCC_IO) GPIO13 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
6 GPIO14 digital in/out (VCC_IO) GPIO14 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
7 1V8 power (1V8) Digital core supply input; 10 uF to GND - - Pin Descriptions, p. 12
8 GND ground Ground - - Pin Descriptions, p. 12
9 VCC_IO power (VCC_IO) Logic supply input, 2.5 V to 5 V (3 V or more for SPI at 10 MHz); 1 uF to GND - - Pin Descriptions, p. 12
10 GPIO15 digital in/out (VCC_IO) GPIO15 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
11 GPIO16 digital in/out (VCC_IO) GPIO16 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
12 GPIO17 digital in/out (VCC_IO) GPIO17 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
13 GPIO18 digital in/out (VCC_IO) GPIO18 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
14 DNC1 not connected Do not connect, internally connected (the datasheet names it DNC) - Do not connect Pin Descriptions, p. 12
15 DNC2 not connected Do not connect, internally connected, or tie to GND (the datasheet names it DNC) - Do not connect, or tie to GND Pin Descriptions, p. 12
16 GNDP ground Buck power ground - - Pin Descriptions, p. 12
17 SW analog (VSA) Buck switching output; inductor to VBUCK - - Pin Descriptions, p. 12
18 VSA power (VSA) Core and buck supply input, 7.7 V to 80 V; at least 0.5 uF and a 10 uF bulk capacitor to GNDP - - Pin Descriptions, p. 12
19 WAKE digital in (VSA) Drive high to power up and to leave hibernation; may be shorted to VSA GpioSet(CtrlPin::Wake) Short to VSA, or pull down Pin Descriptions, p. 12
20 FAULTN open drain (VCC_IO) Fault output, open drain: busy while bootstrapping, or a severe error GpioGet(CtrlPin::Faultn) Leave open Pin Descriptions, p. 12
21 DRV_EN digital in (VCC_IO) Driver enable, active high, internal pull-down GpioSet(CtrlPin::DrvEn) - Pin Descriptions, p. 12
22 RSTN digital in (VCC_IO) System reset, active low, internal pull-down GpioSet(CtrlPin::Reset) - Pin Descriptions, p. 12
23 VEXT1 power output (VEXT1) Configurable 5.0 V, 3.3 V or 2.5 V supply output for external circuits; 1.6 uF to GND - Leave open Pin Descriptions, p. 12
24 VEXT2 power output (VEXT2) Configurable 5.0 V, 3.3 V or 2.5 V supply output for external circuits; 1.6 uF to GND - Leave open Pin Descriptions, p. 12
25 VBUCK power (VBUCK) Buck output, charge pump and LDO supply input - - Pin Descriptions, p. 12
26 CPI analog (VBUCK) Charge pump fly capacitor, low-voltage side - - Pin Descriptions, p. 12
27 CPO analog (VDRV) Charge pump fly capacitor, high-voltage side - - Pin Descriptions, p. 12
28 VDRV power (VDRV) Charge pump output, gate driver supply; OTP programming voltage input - - Pin Descriptions, p. 12
29 BS_Y2 analog (VDRV) Bootstrap capacitor, phase Y2 (tie to VDRV when HS_Y2 drives a low-side gate) - - Pin Descriptions, p. 12
30 HS_Y2 power output (VDRV) High-side gate driver output, phase Y2 - - Pin Descriptions, p. 12
31 BM_Y2 analog (VDRV) High-side source and driver return, phase Y2 (tie to GND when HS_Y2 drives a low-side gate) - - Pin Descriptions, p. 12
32 LS_Y2 power output (VDRV) Low-side gate driver output, phase Y2 - - Pin Descriptions, p. 12
33 CSP3 analog (VDRV) Current-sense amplifier 3, positive input; low-side driver return - - Pin Descriptions, p. 12
34 CSN3 analog (VDRV) Current-sense amplifier 3, negative input - - Pin Descriptions, p. 12
35 CSN2 analog (VDRV) Current-sense amplifier 2, negative input - - Pin Descriptions, p. 12
36 CSP2 analog (VDRV) Current-sense amplifier 2, positive input; low-side driver return - - Pin Descriptions, p. 12
37 LS_WY1 power output (VDRV) Low-side gate driver output, phase W/Y1 - - Pin Descriptions, p. 12
38 BM_WY1 analog (VDRV) High-side source and driver return, phase W/Y1 - - Pin Descriptions, p. 12
39 HS_WY1 power output (VDRV) High-side gate driver output, phase W/Y1 - - Pin Descriptions, p. 12
40 BS_WY1 analog (VDRV) Bootstrap capacitor, phase W/Y1 - - Pin Descriptions, p. 12
41 BS_VX2 analog (VDRV) Bootstrap capacitor, phase V/X2 - - Pin Descriptions, p. 12
42 HS_VX2 power output (VDRV) High-side gate driver output, phase V/X2 - - Pin Descriptions, p. 12
43 BM_VX2 analog (VDRV) High-side source and driver return, phase V/X2 - - Pin Descriptions, p. 12
44 LS_VX2 power output (VDRV) Low-side gate driver output, phase V/X2 - - Pin Descriptions, p. 12
45 CSP1 analog (VDRV) Current-sense amplifier 1, positive input; low-side driver return - - Pin Descriptions, p. 12
46 CSN1 analog (VDRV) Current-sense amplifier 1, negative input - - Pin Descriptions, p. 12
47 CSN0 analog (VDRV) Current-sense amplifier 0, negative input - - Pin Descriptions, p. 12
48 CSP0 analog (VDRV) Current-sense amplifier 0, positive input; low-side driver return - - Pin Descriptions, p. 12
49 LS_UX1 power output (VDRV) Low-side gate driver output, phase U/X1 - - Pin Descriptions, p. 12
50 BM_UX1 analog (VDRV) High-side source and driver return, phase U/X1 - - Pin Descriptions, p. 12
51 HS_UX1 power output (VDRV) High-side gate driver output, phase U/X1 - - Pin Descriptions, p. 12
52 BS_UX1 analog (VDRV) Bootstrap capacitor, phase U/X1 - - Pin Descriptions, p. 12
53 VS power (VS) Gate driver supply input, 7.7 V to 70 V; at least 1 uF to GND - - Pin Descriptions, p. 12
54 A1V8 power (A1V8) Analog core supply input; 10 uF to GND - - Pin Descriptions, p. 12
55 GNDA ground Analog ground - - Pin Descriptions, p. 12
56 GPIO0 digital in/out (VCC_IO) GPIO0 (input with pull-down at power-up) - Leave open (internal pull-down) Pin Descriptions, p. 12
57 GPIO1 digital in/out (VCC_IO) GPIO1 (input with pull-down at power-up) - Leave open (internal pull-down) Pin Descriptions, p. 12
58 AIN0 analog (VCC_IO) Analog input 0 (high impedance at power-up) - Connect to a defined level, for example GND Pin Descriptions, p. 12
59 AIN1 analog (VCC_IO) Analog input 1 (high impedance at power-up) - Connect to a defined level, for example GND Pin Descriptions, p. 12
60 AIN2 analog (VCC_IO) Analog input 2 (high impedance at power-up) - Connect to a defined level, for example GND Pin Descriptions, p. 12
61 AIN3 analog (VCC_IO) Analog input 3 (high impedance at power-up); parameter mode reads an external temperature sensor here - Connect to a defined level, for example GND Pin Descriptions, p. 12
62 GPIO6 bus (VCC_IO) GPIO6, or UART_TX after power-up (bootloader UART, data out) Exchange() Leave open (internal pull-up) Pin Descriptions, p. 12
63 GPIO7 bus (VCC_IO) GPIO7, or UART_RX after power-up (bootloader UART, data in) Exchange() Leave open (internal pull-up) Pin Descriptions, p. 12
64 GPIO8 digital in/out (VCC_IO) GPIO8 (input with pull-up at power-up) - Leave open (internal pull-up) Pin Descriptions, p. 12
EP EP ground Exposed pad, connected to GND - - Pin Configurations, p. 11

Source of this table and of the chip figures: docs/hardware.yml.

Block diagram

Block diagram of the TMC9660: its function blocks, how they connect and which package pins reach each block.Block diagram of the TMC9660: its function blocks, how they connect and which package pins reach each block.
Inside the TMC9660
Figure description and sources

The TMC9660's function blocks inside its outline. Arrows between blocks carry signals or data in the direction they point (both ways where they have two heads). The package pins stand on the left and right edges with their numbers, each wired to the block it reaches.

Drawn from: docs/hardware.yml; inc/tmc9660_spi_interface.hpp; inc/tmc9660_types.hpp; inc/tmc9660_uart_interface.hpp.

Reference circuit

Schematic of the TMC9660 typical application: the chip with U2 MCU, C1 capacitor ≥ 0.5 µF, C11 capacitor 10 µF, C2 capacitor ≥ 1 µF, C3 capacitor 1 µF, C4 capacitor 10 µF, C5 capacitor 10 µF, C6 capacitor 8 µF, C7 capacitor 4.7 µF, C8 capacitor 220 nF, C9 capacitor 1.6 µF, C10 capacitor 1.6 µF, L1 inductor 27 µH, R1 resistor 10 kΩ; the MCU wires carry the port hooks GpioGet(CtrlPin::Faultn), GpioSet(CtrlPin::DrvEn), GpioSet(CtrlPin::Reset), GpioSet(CtrlPin::Wake), Transfer().Schematic of the TMC9660 typical application: the chip with U2 MCU, C1 capacitor ≥ 0.5 µF, C11 capacitor 10 µF, C2 capacitor ≥ 1 µF, C3 capacitor 1 µF, C4 capacitor 10 µF, C5 capacitor 10 µF, C6 capacitor 8 µF, C7 capacitor 4.7 µF, C8 capacitor 220 nF, C9 capacitor 1.6 µF, C10 capacitor 1.6 µF, L1 inductor 27 µH, R1 resistor 10 kΩ; the MCU wires carry the port hooks GpioGet(CtrlPin::Faultn), GpioSet(CtrlPin::DrvEn), GpioSet(CtrlPin::Reset), GpioSet(CtrlPin::Wake), Transfer().
TMC9660: Typical application
Figure description and sources

A schematic. The MCU is on the left, each of its pins level with the chip pin it connects to; above each wire is the hook of the driver's port that drives or reads it. Supply pins point up to their supply and decoupling, ground pins down. Pins on the right carry the loads and the pins tied to a supply or ground; a cross marks a pin left open. A dot is a junction; wires that cross without a dot are not connected.

Drawn from: docs/hardware.yml; inc/tmc9660_spi_interface.hpp; inc/tmc9660_types.hpp; inc/tmc9660_uart_interface.hpp.

Part Kind Value Connects Datasheet
U2 MCU - VIO: VCC_IO, GND: GND, SCK: SPI0_SCK, MOSI: SPI0_MOSI, MISO: SPI0_MISO, CS: SPI0_CS0, RST: RSTN, DRVEN: DRV_EN, FLT: FAULTN Pin Descriptions, p. 12
C1 capacitor ≥ 0.5 µF VSA, GNDP Pin Descriptions, p. 12
C11 capacitor 10 µF VSA, GNDP Pin Descriptions, p. 12
C2 capacitor ≥ 1 µF VS, GND Pin Descriptions, p. 12
C3 capacitor 1 µF VCC_IO, GND Pin Descriptions, p. 12
C4 capacitor 10 µF 1V8, GND Pin Descriptions, p. 12
C5 capacitor 10 µF A1V8, GND Pin Descriptions, p. 12
C6 capacitor 8 µF GND, VBUCK Power Supply - Electrical Characteristics, p. 17
C7 capacitor 4.7 µF GND, VDRV Power Supply - Electrical Characteristics, p. 17
C8 capacitor 220 nF CPI, CPO Power Supply - Electrical Characteristics, p. 17
C9 capacitor 1.6 µF GND, VEXT1 Pin Descriptions, p. 12
C10 capacitor 1.6 µF GND, VEXT2 Pin Descriptions, p. 12
L1 inductor 27 µH SW, VBUCK Power Supply - Electrical Characteristics, p. 17
R1 resistor 10 kΩ (not confirmed: the pull-up value is a choice; the datasheet says FAULTN is open drain) VCC_IO, FAULTN Pin Descriptions, p. 12

Export a circuit for a schematic or PCB tool: kokeb-docs hardware --kicad-netlist OUT.net --circuit typical.

At power-up the bootloader selects the interface from the first valid command it sees on either bus, and the pin functions below replace the plain GPIO functions of the same pins (datasheet, General-Purpose Input/Output Description). A boot configuration written with BlWriteConfig() can move them.

Interface Pins Notes
UART GPIO6 (pin 62) is UART_TX, GPIO7 (pin 63) is UART_RX The bootloader detects the baud rate from the first byte, 0x55
SPI GPIO9 (pin 1) MISO, GPIO10 (pin 2) MOSI, GPIO11 (pin 3) SCK, GPIO12 (pin 4) CS0 Mode 3, up to 10 MHz, 40-bit bootloader datagrams

The driver is built for one bus per object: a port derives from SpiInterface or from UartInterface, never both (a compile-time check, tests/compile_fail/both_buses.cpp).

Control pins

The driver drives the control pins only through the optional GpioSet() and GpioGet() hooks of your port, with logical levels; the port maps a level to the physical polarity.

Pin Hook Meaning of the logical level
RSTN (22) GpioSet(CtrlPin::Reset, ...) ACTIVE holds the chip in reset (the pin is low). Used when Config::hardware_reset is set
DRV_EN (21) GpioSet(CtrlPin::DrvEn, ...) ACTIVE allows the gate driver outputs (the pin is high)
WAKE (19) GpioSet(CtrlPin::Wake, ...) ACTIVE asserts the wake condition; only your own power-down logic uses it
FAULTN (20) GpioGet(CtrlPin::Faultn, high) An input: high false means the chip pulls the pin low. Service() reads it

A board that wires DRV_EN high or RSTN to a supervisor leaves GpioSet() out. The driver then cannot drop DRV_EN in DisableDrive(); the chip-side stop (COMMUTATION_MODE 0, or zero enables in register mode) still runs, and the call never fails because the pin hook is missing. Config::hardware_reset without GpioSet() returns Error::Unsupported from EnsureInitialized().

FAULTN is open drain. In the bootloader it signals that the chip is busy bootstrapping or that a severe error stopped the processor (datasheet, Bootloader FAULTN Signaling). In an application it can also pulse when the chip restarts; Config::faultn_is_reset makes Service() treat a low level as a reset (ambiguity A18 in Ambiguities).

Bus settings

Setting Bootloader SPI TMCL SPI Register-mode SPI UART (all three)
Mode 3 3 3 8N1
Clock Up to 10 MHz Up to 10 MHz Up to 10 MHz Autobaud after 0x55; 115200 is a safe start
Bit order MSB first MSB first MSB first LSB first, standard UART
Frame 5 bytes 8 bytes, two transfers 6 bytes 8 bytes (bootloader), 9 bytes (TMCL, register)
Chip select Low for each frame Low for each frame Low for each frame -

Every SPI exchange is one Transfer() call with chip select low for the whole frame. The TMCL SPI reply arrives in the transfer after the command, so a command costs two transfers (see Parameter mode).

The MISO line stays driven after chip select rises (erratum 2)

The TMC9660's SPI peripheral does not return MISO to high impedance when chip select is released. With other SPI devices on the same MISO line, hold the chip in reset during their transfers or add the switch the datasheet shows (Errata, Erratum 2). The driver cannot detect this, and GpioSet(CtrlPin::Reset, ...) is the hook for the first workaround.

Timing

Parameter Value Driver
Power-up or wake to a ready application, self-test on 44 ms typical Config::boot_timeout_ms (500 ms: the datasheet gives a typical value only, A9)
Same, self-test off 10.5 ms typical The same wait
Wait after a write that reconfigures the chip not specified Config::settle_us (20 ms, A13)
Gap between a TMCL SPI command and its reply request not specified Config::spi_gap_us (1 ms)
UART reply wait not specified Config::reply_timeout_us (50 ms)

The driver waits with your port's DelayUs(); nothing in it sleeps or spins on a clock of its own.

Power

Rail Range Note
VSA 7.7 V to 80 V Core and buck supply; the WAKE pin may be shorted to it
VS 7.7 V to 70 V Gate driver supply
VCC_IO 2.5 V to 5 V (3 V or more for SPI at 10 MHz) Logic levels of the GPIO and of the host link
VEXT1, VEXT2 5.0 V, 3.3 V or 2.5 V Outputs, set in the boot configuration; BlWriteConfig() refuses to change them unless allow_ldo_change is set, because both move at once

Hibernation (PowerDown()) puts everything but the always-on block into reset; the chip restarts after the time given or on a rising edge at WAKE, and the driver reports itself uninitialised until EnsureInitialized() runs again.

Reference documents

Every pin, setting and timing on this page cites a document in docs/datasheets.yml; the driver never contains a vendor PDF, only the revision, date and SHA-256 of the file it was written against.

Document Revision Get it
Datasheet: TMC9660 70V Smart Gate Driver with Servo (FOC) Controller in HW and Buck Converter (Analog Devices (Trinamic) 19-101926) 1, 2024-11 vendor page
Datasheet: TMC9660 Parameter Mode Reference Manual (Analog Devices (Trinamic) n/a) 0, 2025-02 vendor page
Datasheet: TMC9660 Register Mode Reference Manual (Analog Devices (Trinamic) n/a) 0, 2025-04 vendor page
Datasheet: TMC9660 Configuration and Bootstrapping (Analog Devices (Trinamic) AN-2601) 0, 2025-01-08 vendor page

Written against these revisions; the SHA-256 of each file is in docs/datasheets.yml. Where each part of the driver is in the datasheet: Datasheet map.

Also useful Contents
inc/tmc9660_registers.hpp The 163 registers of register mode, generated from the Register Mode Reference Manual
inc/tmc9660_params.hpp The 289 parameters of parameter mode, generated from Table 57 of the Parameter Mode Reference Manual