¶ Introduction
The Duet 3 Expansion 1HCL board provides a high current Stepper motor driver, combined with multiple interfaces for position feedback and firmware to implement closed loop position control. In addition it has a number of peripheral inputs and outputs for functions such as sensing motor temperature, controlling a brake and axis endstop. It connects to the Duet 3 CAN-FD bus using RJ11 connectors (same as the Duet 3 Mainboard 6HC, Duet 3 expansion boards, and the tool distribution board). Multiple Duet 3 Expansion 1HCL boards can be daisy chained on the bus, with power (up to 48V) provided locally. This allows for very large machines to be constructed without a significant wiring burden and signal integrity issues.
¶ Features
¶ Hardware specification
| Processor | Microchip ATSAME51G19A |
| Processor features | 32-bit, 120MHz ARM Cortex-M4F, 512Kb flash, 192Kb RAM, hardware single precision floating point unit |
| Networking/Comms | CAN-FD BUS for connection to the Duet 3 Mainboard. Optional on-board CAN bus termination. |
| On-board stepper driver | 1 x TMC2160A |
| Stepper driver features | SPI controlled, can be run in open loop or closed loop mode. Maximum motor current 6.3A peak per phase (4.45A RMS). |
| Encoder Inputs | Quadrature or SPI bus |
| Thermistor/PT1000 inputs | 2 x thermistor/PT1000 inputs. This is intended to allow for motor temperature monitoring, potentially coupled with a cooling system controlled by one of the outputs. |
| Medium current outputs | 2 x medium-current (2.5A max recommended) outputs at V_FUSED or V_BRAKE voltage, with PWM capability and built-in flyback diodes. Optionally provide V_BRAKE at a different voltage from V_FUSED, to allow (for example) running the stepper motor at 48V and the brake at 24V. |
| Inputs/Outputs | 2 x 3.3V-level PWM capable output (3mA max), 2 x digital inputs, protected against over-voltage. Example use: endstop switches. |
¶ Operating limits
| Input voltage | 12V to 50V |
| VIN connector rated current | 25A maximum, or fused limit (whichever is lower) |
| Fuses | 5A for V_FUSED (max 10A), 5A for V_BRAKE |
| Stepper driver | Up to 6.3A peak current per phase (4.45A RMS per phase; max. standstill current 4.45A) |
| Medium current outputs | OUT0/1 up to 2.5A each |
| Inputs/Outputs | Inputs are 30V-tolerant |
| 12V current limit | 200mA |
| 5V and 3.3V current limit | 100mA total on 5V and 3.3V |
¶ Compatible motors
Use motors with 1.8 or more degrees per step. We advise against using 0.9deg motors because the maximum speed will be reduced. The positioning accuracy in closed-loop mode depends on the resolution of the encoder, not on the degrees/step of the motor.
The maximum speed at which the firmware can drive the motor reliably in closed loop mode is about 5000 full steps/second. However, the maximum step rate may be much lower if the driver is not able to change the motor current fast enough because of high moor inductance. The calculator at https://www.reprapfirmware.org/emf.html will estimate the maximum speeds for which full torque is available for a given motor and supply voltage. Good closed loop operation will typically be available up to the "high slip angle" speed.
¶ Compatible Encoders
RRF 3.4 supports quadrature motor shaft encoders only. RRF 3.5 also supports Duet3D magnetic shaft encoders and linear composite encoders.
Encoder resolutions of over 1000PPR/4000CPR are highly recommended. resolutions below this are unlikely to work well in most situations.
¶ Quadrature motor shaft encoders
Stepper motors can be purchased with integral optical shaft encoders. It is also possible to buy add-on quadrature shaft encoders, which are typically mounted on the back of dual-shaft stepper motors. The resolution is specified in counts or pulses per motor revolution. There must be an integer number of output pulses from the encoder per 4 full steps. For example, a 1.8deg/step motor (200 full steps/rev) could have an encoder with 1000cpr (20 pulses per 4 full steps), 2000 cpr (40 pulses per 4 full steps) or 2500 cpr (50 pulses per 4 full steps).
¶ Duet3D magnetic motor shaft encoders
The Duet3D magnetic motor encoder is a small board that mounts on the back of the stepper motor. It is supplied with a diametrically-magnetised disc magnet, which must be glued to the centre of the end of the shaft at the back of the motor. A jig should be used to centre the magnet accurately while the glue sets.
¶ Linear composite encoder
A linear composite encoder comprises a linear quadrature encoder that tracks position on a linear axis (for example the Renishaw LM10IA or LM10IB) and a Duet3D magnetic shaft encoder. The shaft encoder handles motor commutation, the linear encoder is used to close the loop.
¶ Firmware notes
- Compatible RepRapFirmware versions: RRF 3.4 and later
- Firmware limitations: See Duet 3 with CAN expansion firmware configuration limitations.
¶ Open source
Importantly Duets are Open:
- The Duets are Open Hardware, see our license here.
- All hardware source files are available on Github.
- The Duet hardware and RepRapFirmware are built with Open tools: designed in KiCad and Eclipse using open tools means the barrier to getting involved is as low as possible.
¶ Physical properties
¶ Dimensions
¶ 3D model
A STEP 3D model of the Duet 3 Expansion 1HCL is available on github.
¶ Physical connections
¶ Wiring Diagram
¶ Description of Connections
Duet 3 Expansion 3HC provides the following connectors:
| Header | Label | Function |
|---|---|---|
| 1 x 2-way barrier strip | VIN, GND | Two pins for main VIN and GND. |
To come
¶ LED indications
LEDs are provided to indicate the following:
| Label | Colour | Function |
|---|---|---|
| ACT | Green | Indicates activity on the CAN-FD bus |
| STATUS | Red | See description below |
| V_FUSED | Blue | Indicates fused VIN supply present |
| 12V+ | Amber | Indicates indicates on-board 12V regulator operating |
| 5V+ | Red | Indicates indicates 5V supply present |
| 3.3V+ | Green | Indicates on-board 3.3V regulator operating |
The red LED labelled "STATUS", next to the Reset button, indicates the state of the board, as follows.
STATUS LED: In normal use, the red LED flashes slowly in sync with the main board to indicate that it has CAN sync, or flashes continuously and rapidly to indicate that it doesn't. It also flashes startup error codes, for example if the bootloader doesn't find valid firmware on the board. For a list of these error codes see CAN_connection basics.
¶ Pin names
For more information on pin names, see Pin Names.
RepRapFirmware 3 uses pin names for user-accessible pins, rather than pin numbers, to communicate with individual pins on the PCB. In RRF 3 no user-accessible pins are defined at startup by default. Pins can be defined for use by a number of gcode commands, eg M574, M558, M950.
The Duet 3 series uses the pin name format "expansion-board-address.pin-name" to identify pins on expansion board, where expansion-board-address is the numeric CAN address of the board. A pin name that does not start with a sequence of decimal digits followed by a period, or that starts with "0." refers to a pin on the Duet 3 Mainboard.
| Function | Pin location | RRF3 Pin name | Notes |
|---|---|---|---|
| Outputs | OUT_0 | out0 | PWM |
| OUT_1 | out1 | PWM | |
| Inputs/Outputs | IO_0 | io0.out | PWM |
| io0.in | analog/digital input | ||
| IO_1 | io1.out | PWM | |
| io1.in | digital input | ||
| Test pad | pa20 | brought out to a test pad only | |
| Quadrature input | pdec.a | used to connect a quadrature encoder. If no quadrature encoder is connected then they are available as digital inputs. | |
| pdec.b | |||
| pdec.n | |||
| TEMP_0 | temp0 | 2K2 pullup + filter, intended for thermistor/pt1000 | |
| TEMP_1 | temp1 |
¶ Input/Output
OUT_0 and OUT_1 are PWM-capable.
The individual IO_x connectors have the following capabilities:
| IO # | UART/I2C? | Analog in? | PWM out? | Notes |
|---|---|---|---|---|
| IO_0 | No | Yes | Yes | |
| IO_1 | Yes | No | Yes | io1 in/out are theoretically capable of I2C but this isn't implemented at present |
| pa20 | No | No | No | digital in/out , brought out to a test pad only |
| pdec.a, pdec.b. pdec.n | No | No | No | digital inputs |
Note: RepRapFirmware does not currently support I2C on Duet 3 boards.
¶ Encoders
¶ Quadrature encoder
The 1HCL supports a quadrature encoder connected to the Quadrature Input interface. This works with common 5V, 1000CPR-2500CPR optical encoders that are frequently supplied with closed loop stepper motors. (One example is the 17E1K-05), however there are many other examples).
¶ Connecting a Quadrature Shaft Encoder
Quadrature encoders (which may use optical or magnetic technology) have either a differential output (often shown as A+,A-, B+,B-,N+,N- or as A,A',B,B',N,N') or a single ended output. The Duet 3 Expansion 1HCL has a 5-pin Molex KK connector for quadrature signals.
Note the index signal (N or Z) is not currently used
If the encoder has a single ended output then the signal lines connect to the 1HCL input: A to A_INPUT, B to B_INPUT, and 5V or VCC to the +5V and ground to ground. The Z or N can be left disconnected.
If the encoder has a differential output then connect the A+, B+ to the signal inputs on the 1HCL. 5V/VCC to 5V and ground to ground. The A-,B- and Z+Z-/N+N- can be left disconnected.
Here is a picture (courtesy of LDO motors) which shows a single ended and differential encoder output:
¶ Duet3D Magnetic Shaft Encoder
This support is available from RRF 3.5
The Duet 3 Expansion 1HCL supports the Duet3D Magnetic Encoder board based on the AS5047D encoder IC. We supply this encoder on a Nema17 form factor PCB, designed to sense a diametrically magnetised magnet glued to the back of the motor shaft. We have also used this encoder board on a Nema23 motor using a printed adapter.
Connect the encoder board to the Duet 3 Expansion 1HCL to the 10-way box connector using a 10-way straight-through ribbon cable. The cable length should not exceed 200mm.
See the Duet3D Magnetic Encoder documentation for more information.
¶ Linear quadrature encoder plus Duet3D Magnetic Shaft Encoder
This support is available on an experimental basis in RRF 3.5
Attach and connect the Duet3D magnetic shaft encoder as described above. Connect the linear quadrature encoder to the 5-pin Molex connector as described above for a quadrature shaft encoder.
¶ Commissioning
All boards in the system must have different CAN addresses. 1HCL boards are shipped set to a default CAN address of 123. They will also revert to 123 if you use the jumper to force the bootloader to request new firmware. Therefore, if you have more than one new 1HCL board, only one of them must be powered up and connected to the CAN bus. So disconnect power to all but one of them (you can leave the CAN bus connected if it's easier). When you have changed the CAN address of that board, you can connect the next one; and so on.
¶ Startup Time
It is recommended to add the following to config.g, before any commands that reference any CAN bus connected expansion boards
G4 S1 ;wait for expansion boards to start
¶ Testing communication
Check that you can communicate with the 1HCL board, by sending:
M115 B123
If that fails try placing a jumper on the CAN_RST pins and powering up, then power down and remove the jumper before powering up again, this will reset the CAN-FD bus settings to the default (address 123, bus speed 1Mbps)
¶ Update the bootloader
Duet 3 expansion boards and tool boards have a bootstrap loader written to the start of flash so that they can load firmware from the main board via CAN. This bootloader may occasionally need to be updated in order to support new features. See Updating the bootloader on Duet 3 expansion and tool boards.
¶ Updating the firmware
The 1HCL board will be shipped with firmware loaded during production. You can check the version loaded by sending
M115 B123
(or B## where ## is the new CAN address of the board if you have changed it already)
To update the firmware get the latest version from the RepRapFirmware github. It is recommended to upgrade all the firmware in your Duet 3 system together so that the versions do not get out of sync.
Send M997 B## to carry out a firmware update. The bootloader will request the Duet3Firmware_EXP1HCL.bin from the Duet 3 main board; it needs to be in the /firmware folder of the SD card.
¶ Set the CAN address
- Send command M115 B## to verify that the main board can communicate with the 1HCL board, where ## is the default address of 123 if it has not been changed already.
- Send command M952 B# A## where ## is the new address you want to use. Allowed CAN addresses for normal use are 1 to 119. We suggest you use addresses starting at 50 for 1HCLs. So for the first 1HCL board, if your new CAN board was at address 123, send M952 B123 A50.
- Power the system down and up again, or send M999 B123. This will cause the 1HCL board to restart with the new address.
- Send command M122 B50 (or whatever address you chose) to verify that you can communicate with the 1HCL board at its new address
- You can now power up the next 1HCL board and commission it in the same way, choosing a different CAN address for it.
¶ Firmware
The default CAN address is 123. It can be changed as described above.
¶ Limitations
Please see the current RepRapFirmware limitations at Duet 3 firmware with CAN expansion configuration limitations.
¶ Microstepping
While in closed loop mode step pulses are not sent to the stepper motor driver in the same manner as an open loop driver; however firmware versions prior to 3.5 still use microsteps internally to represent moves.
To that end the microstep setting for the 1HCL should be high enough to use the full encoder CPR. e.g. if the encoder is 1000 PPR (so 4000 CPR) and the full steps/rev of a 1.8 degree/step motor is 200, then the microstepping needs to be at least 4000/200 = 20 to make use of the full resolution of the encoder.
Microsteps must be set in powers of 2, in the same manner as open loop drivers (1,2,4,8,16,32,64,128,256)
So in the case of a 4000CPR encoder on a 1.8 degree/step motor microstepping should be set to 32. Note steps/mm should be adjusted to match the microstep setting chosen.
¶ Sample configuration examples
CAUTION before using these examples check the datasheet and user manual of the motor, encoder (and optionally brake) you are using. Especially: check compatibility of signal voltages.
¶ Adding a closed loop motor
M569.1 is used to configure the closed loop driver.
Two general types of encoder can be used for feedback:
- A quadrature encoder connected to the Quadrature Input interface. This works with common 5V optical encoders that are frequently supplied with closed loop stepper motors.
- An SPI connection that can communicate with supported encoders that communicate over SPI. Initially this is the AS5047D encoder sensing a magnet on the motor shaft. In the future other SPI encoders may be supported.
Here's an sample excerpt from a config.g file for RRF 3.4 to drive the X and Y motors from 1HCL boards configured at CAN addresses 50 and 51, with quadrature encoders. Note, some parameters have changed in RRF 3.5.
M569.1 P50.0 T2 C5 R100 I0 D0 ; Configure the 1HCL board at CAN address 50 with a quadrature encoder on the motor shaft that has 5 steps per motor full step.
M569.1 P51.0 T2 C5 R100 I0 D0 ; Configure the 1HCL board at CAN address 51 with a quadrature encoder on the motor shaft that has 5 steps per motor full step.
M569 P50.0 D4 S1 ; Configure the motor on the 1HCL at can address 50 as being in closed-loop drive mode (D4) and not reversed (S1)
M569 P51.0 D4 S1 ; Configure the motor on the 1HCL at can address 51 as being in closed-loop drive mode (D4) and not reversed (S1)
M584 X50.0 Y51.0 ; set X and Y drivers
M917 X0 Y0 ; Set the closed loop axes to have a holding current of zero
M350 X32 Y32 ; set steps/mm to 32 to make full use of the encoder resolution
M92 X160 Y160 ; steps/mm for a 20 tooth gt2 pulley
Note the initial PID values show will need to be tuned to the particular motor.
In contrast to usual drivers, the closed loop axes can have their holding current set to zero using M917, with negligible detrimental effect. Whilst a normal driver may slip if it's holding current is set to zero, a closed loop driver will notice that it has slipped an apply a current to return the drive to it's intended position. Setting a holding current of zero will also mean less current is used, so the motor runs cooler. However, a holding current can still be set using M917 if desired.
¶ Tuning the PID for the closed loop
See Tuning the Duet 3 Expansion 1HCL for details on tuning.
¶ Temperature sensor
The following code could be used in config.g to set the sensor as a thermistor:
M308 S3 P"50.temp0" Y"thermistor" T100000 B3950 A"X Motor Temp" ; Setup temp 0 on 1HCL at CAN address 50 as sensor 3 - sensing X motor temperature
M308 S4 P"51.temp0" Y"thermistor" T100000 B3950 A"Y Motor Temp" ; Setup temp 0 on 1HCL at CAN address 51 as sensor 4 - sensing Y motor temperature
These sensors would be displayed in the "extras" tab in DWC and available in the object model to query and potentially take action on for example the following could be inserted into daemon.g to check the motor temperature every second and raise the alarm if they are higher than a set value of 70C
if sensors.analog[3].lastReading >70
echo "X MOTOR Temp Alarm: ", sensors.analog[3].lastReading
M98 P"motorovertemp.g"
if sensors.analog[4].lastReading >70
echo "Y MOTOR Temp Alarm: ", sensors.analog[4].lastReading
M98 P"motorovertemp.g"
G4 P1000
Where the "motorovertemp.g" macro can have whatever actions are appropriate. This logic can be extended to take different actions at different temperatures ( e.g. log at 70, sound alarm at 80, pause print at 100)
¶ Motor Brake Control
Some motors have a motor brake fitted for an holding brake solenoid. As long as the solenoid max current draw is <2.5A it can be directly controlled by out 0 or out 1. If the Brake needs a different voltage from the VIN voltage used for the motor then that can supplied on the VBRAKE connector.
This example sets out0 to control the brake using the M569.7 command
M569.7 P50.0 C"out0"
NOTE proceed with caution, always test these examples with low motor current and slow speeds first
When the motor driver is enabled, the specified output port will be turned on at the same time to release the brake. When the motor driver is disabled, the output port will be turned off. Idle current mode does not count as disabled.
After M569.7 is executed, the port will be initially off. Therefore, M569.7 should be executed before the motor is first enabled.
¶ Revisions
- Changed polarity of the VBrake connector to match other JST VHs used in the Duet 3 series.
- Improved ESD protection on temperature circuits.
- Changed to different CAN-FD CM choke part, no functional impact.
- Various MOSFETs changed due to part availability, no functional impact.
- Pin changes to allow a UART and PWM on IO_0 and I2C on IO_1
- Add a physical jumper for I2C support on IO_1
Note: RepRapFirmware does not currently support I2C on Duet 3 boards. - Change the SPI header to be a 2x5 box header so an off the shelf 2x5 ribbon cable can be used. Used the same pinout arrangement as the SPI temperature Daughterboard connector (with the quadrature pins where CS lines were).
- Add a second temperature input on PA7 (AIN7)
- Remove the button
- First prototype to use the SAME51 processor. This revision is no longer supported by firmware.
Dimensions:
Wiring:
