Extra Configuration.h Settings – Unified 2 Firmware

We have some settings and checks in place to allow you to override our default settings in our firmware. As requests come in and/or workarounds are needed we’ll add different #ifndefs to the code so that if you place them in the Configuration.h file you can override what we have set. Below are the ones in the latest Unified 2 Releases.

Where to put these? #

All these options should be added right after your Printer line that you uncomment.

Filament Change Unload Length #

If you want to change the filament change unload length you can add the below line to your Configuration.h file.

#define FILAMENT_CHANGE_UNLOAD_LENGTH 999

Change the “999” shown in the example to however many millimeters that you want the unload length to be.

Acceleration Settings #

If you want to tune your acceleration settings instead of letting our firmware set it for you there are a few options. Requires Unified 2.46 or higher.

These are values that control how fast things accelerate and decelerate. Setting these too high for your printer can result in damage and/or layer shifts.

WARNING – READ THIS

Max Acceleration #

If you want to override the XY Max acceleration you can add the below lines to your Configuration.h file. You MUST specify BOTH the MAX_X_ACCEL and MAX_Y_ACCEL values. These must also be set higher than the DEFAULT_ACCELERATION and DEFAULT_TRAVEL_ACCELERATION values (these are covered next).

#define MAX_X_ACCEL 2000
#define MAX_Y_ACCEL 2000

In the above example, you can change the “2000” values to whatever value you want to use. Do not exceed 10000.

Default Printing Acceleration #

If you want to override the default acceleration value for printing acceleration moves add the below line to your Configuration.h file. This value must be lower than the MAX_X_ACCEL and MAX_Y_ACCEL values.

#define DEFAULT_ACCELERATION 1000

In the above example, you can change the “1000” value to whatever value you want to use. We typically recommend setting this to about 50% of your max acceleration values that we specified above.

Default Travel Acceleration #

If you want to override the default acceleration value for printing acceleration moves add the below line to your Configuration.h file. This value must be lower than the MAX_X_ACCEL and MAX_Y_ACCEL values.

#define DEFAULT_TRAVEL_ACCELERATION 1000

In the above example, you can change the “1000” value to whatever value you want to use. We typically recommend setting this to about 50%-75% of your max acceleration values that we specified above.

Fancier Heating Icons #

If you want the hotend and bed icons to show as “progress bars” you can add the below line to your Configuration.h file. This does take up a lot more CPU memory and is only recommended on 512K or higher CPUs.

#define STATUS_HEAT_PERCENT

WARNING: This should only be used on newer 32-Bit boards with 512K memory or more (like our EZBoards). If you add this option and the compile fails, remove it as that means your board cannot handle the extra memory this takes up.

Auto Hotend Fan Trigger Temp #

On printers equipped with a hotend fan control, you can change the trigger temp by adding the below line. The default is 50C. Not all printers have this and setting this when your printer is not equipped with this type of control will not do anything. This value is in degrees Celcius, the default for our firmware is 50C.

#define EXTRUDER_AUTO_FAN_TEMPERATURE 60

In the above example setting it to 60 will set the fan to turn on at 60C and off below 60C. Do not set this too high because it will cause heat creep and potentially lead to a nasty clog due to insufficient cooling on the hotend heatsink. Requires Unified 2.49 or higher to use.

Auto Hotend Fan Speed #

On printers equipped with a hotend fan control, you can change the speed by adding the below line. The default is full speed (a value of 255). The range is 0-255 with 0 being off and 255 being full speed. Not all printers have this and setting this when your printer is not equipped with this type of control will not do anything.

#define EXTRUDER_AUTO_FAN_SPEED 127

In the above example setting it to 127 will set the fan to about 50% speed. Do not set this too low because it will cause heat creep and potentially lead to a nasty clog due to insufficient cooling on the hotend heatsink. Requires Unified 2.49 or higher to use.

EZBoard V1/V2 – FAN2 Auto Hotend Mode #

If you have an EZBoard V1 or V2 and want to use the FAN2 header for a hotend controlled fan you can add the below line to your Configuration.h file to change its function. By default (aka this line not added) the FAN2 functions as a controller fan and will come on and off with the motors and heaters. This alternate mode makes the fan turn on and off with the hotend temperature. If you use this mode we highly recommend wiring your control box cooling fan to the always-on fan terminal on the EZBoard.

#define EZBOARD_FAN2_HOTEND_MODE

The default hotend trigger temperature is 50C (this can be changed using the EXTRUDER_AUTO_FAN_TEMPERATURE option discussed above) and at 100% speed (this can also be changed with the EXTRUDER_AUTO_FAN_SPEED option discussed above). Requires Unified 2.49 or higher to use.

CR Touch Probe LCD Menu Names #

If you have a CRTouch and want the LCD to display CRTouch instead of BLTouch add the below line to your Configuration.h file.

#define CRTOUCH_PROBE_NAMING

Bonus – Games Mode #

If you want some games to play on your LCD you can add the below line to enable Brickout, Space Invaders, and Snake to your LCD.

#define GAMES_MODE

WARNING: This should only be used on newer 32-Bit boards with 512K memory or more (like our EZBoards). If you add this option and the compile fails, remove it as that means your board cannot handle the extra memory this takes up.

Updated on September 9, 2022
Was this article helpful?