µCNC config builder

Basic board settings

What board will you be using?

Advanced configurations

Custom boards might require aditional settings that may not be available in this tool.
Check the Custom configurations tab
Also might require either a different base board selection on the ini file (PlatformIO) or a board type (Arduino IDE).
Please refer to the architecture documentation or submit a question on Github about custom boards.

Special purpose timers and features

The board name printed with $I command? Name must be between quotation marks (string)

In which port are PCINT pins 0 to 7? In which port are PCINT pins 8 to 15? In which port are PCINT pins 16 to 23?

Which hardware port will be UART_PORT? Which hardware port will be UART2_PORT? Which hardware port will be SPI_PORT? Which hardware port will be SPI2_PORT? Which hardware port will be I2C_PORT?

Which Timer will be used as {{x.timer}}_TIMER?

Board pin mapping

µCNC pin	Pin number	Pin port	IO OFFSET(74HC595)
{{x.pin}}

µCNC pin	Pin number	Pin port	CHANNEL	TIMER	MUX	IO OFFSET(74HC595)
{{x.pin}}

µCNC pin	Pin number	Pin port	IO OFFSET(74HC595)
{{x.pin}}

µCNC pin	Pin number	Pin port	Pullup	ISR	IO OFFSET(74HC165)
{{x.pin}}				wiki

µCNC pin	Pin number	Pin port	CHANNEL	ADC
{{x.pin}}

µCNC pin	Pin number	Pin port	Pullup	ISR	IO OFFSET(74HC165)
{{x.pin}}				wiki

µCNC pin	Pin number	Pin port	Pullup	IO OFFSET(74HC595)
{{x.pin}}

Enable extension options

Enable main cnc application loop extension callbacks

Enable IO extension callbacks

Enable Gcode and Grbl commands parser extension callbacks

Enable motion control extension callbacks

Enable interpolation realtime extension callbacks

Enable settings storage extension callbacks

Disable settings storage extension callbacks

Run the interpolator in the RTC task When running extra modules and functionalities this increases the computation time required for a whole internal cycle to be computed. This can lead to step interpolation starving and hickups in the motion. To prevent this you can enable this feature to isolate the stepper interpolator from the main loop and be regulary called from the RTC task.

Enable extension modules

Custom boardmap configs

Custom hal configs

Custom PIO configs

Custom PIO board Set the PIO base board Custom PIO additional build flags Set the PIO additional build flags Example: -D myextraflag=1 Custom PIO additional options. Set the PIO additional environment conditions. Example: board_build.offset = 0x2000

Config µCNC

To build your custom version of µCNC follow these steps:

Download µCNC ({{getVersion(VERSION)}})If setting the build environment manually unzip this file.
Download µCNC addon modulesIf you are using VSCode+PlatformIO you can skip this file.You only need to download the modules if setting the build environment manually (like in Arduino IDE). Open the zip and place each module directory used in the modules directory inside uCNC/src/modules/ directory.Do not copy the entire contentof uCNC-modules to the modules directory. Copy only the modules you are using. Doing this will result in compilation errors
Download your configuration files Copy all the files to the uCNC root directory. This will replace some files
If want to update your existing override files, without having to download the zip again, you can copy them to the clipboard here
Compile and upload the project either via Platform IO (recommended) or Arduino IDE.
Download config settings These can be later used to reload your settings

µCNC config generator

New version available!!!

Advanced configurations

Config µCNC