Skip to content

MCU development and verification

OpenCreator has separate host software, printer configuration, and firmware for four controller boards. They should be fully working as of 19 of October.

Board MCU Primary role
MainboardGD GD32H737VGT6 Main motion and machine I/O
eBoard N32G455CCL7 Shared extrusion drive and pressure-advance sensing
Heaterboard N32G455REL7 Tool heaters and temperature I/O
Levelboard N32G430F8S7 Probing and levelboard sensing

The source for the MCU ports and the host is in kalico. It replaces klipper-c5, which is archived and kept for reference only. The configuration is maintained separately in opencreator-fs and opencreator-tunnel.

One motor, four logical tools

T0 through T3 represent four removable toolheads, but they share one physical extruder motor and its eBoard TMC2209 driver. The logical extruders share the eBoard step, direction, and enable signals. Tool selection associates that drive with the selected heater, sensors, and filament state; it does not switch among four independent motor drivers.

The printer and tunneled configurations have a [tmc2209 extruder] through [tmc2209 extruder3] section, all with identical settings and all addressing the same driver. Each logical extruder needs one so that it requests the same step-on-both-edges (DEDGE) mode as the others. A tool without one sends single-edge pulses, and the driver, already in DEDGE mode, counts each pulse twice, so that tool extrudes about double. Their configured pins are eBoard PB11 for UART receive, PB10 for UART transmit, address 0, PB14 for step, PB15 for direction, and PB12 for enable. The eBoard uses USART3 for this driver. The host's Creator 5 UART transport and the eBoard's MCU command must both be present; ordinary GPIO UART bitbanging does not implement this hardware path. The configured 0.70 A current approximates stock behavior. The assumed 0.110-ohm sense resistor has been verified working.

Each logical extruder is a separate MCU stepper on the same PB15 direction pin. Stock Klipper toggles a stepper's direction pin relative to that stepper's own last direction, so with four steppers on one pin the actual level ends up as the XOR of all four. A tool then runs backwards whenever an odd number of the other tools last moved in reverse, for example a retract before docking. eBoard builds (CONFIG_C5_EBOARD) therefore write the absolute direction at the start of every move in src/stepper.c. This needs the eBoard reflashed; until then a FIRMWARE_RESTART resets all four to forward.

Shared MCUs across older printers

The MCUs are heavily shared.

Older printers such as the AD5X and AD5M both have the same Nations MCU, but the Gigadevice GD32 chip for the main MCU is completely new, and has not been seen on any other 3D printer made yet. A lot of libraries such as MCLib and addons such as VFA testing are assumed or said to be made by GigaDevice, the MCU manufacturer. In the grape vine, there is supposed to be another printer coming out with the same MCU but as a revision, not a new release.

How MCLib drives the motors, and how Kalico's replacement for it works, is documented in Architecture.