Configuring RatOS Macros
RatOS comes with a bunch of flexible predefined macro's that can be customized via variables and macro hooks.
In your printer.cfg at the bottom of the Macro's section, you'll notice this:
### MACRO CONFIGURATION
### Configure the behavior...
This is a macro that serves as a place to store variables that all the RatOS macro's refer to when they're executed. Since they're gcode variables you can change them on the fly, for example from your slicer's custom gcode sections:
SET_GCODE_VARIABLE MACRO=RatOS VARIABLE=relative_extrusion VALUE=True
SET_GCODE_VARIABLE MACRO=RatOS VARIABLE=preheat_extruder_temp VALUE=200
Not all of the available variables are listed in printer.cfg by default. If you want to change a variable that isn't in printer.cfg simply just add it under the
[gcode_macro RatOS] section.
Below you'll find a list of the available variables and what they do.
|variable_relative_extrusion||True / False||False|
Controls which extrusion mode START_PRINT ends in. Which value you use here depends on your slicer configuration, in other words this variable should always correspond to the extrusion mode setting in your slicer. It is recommended to configure your slicer for relative extrusion and set this variable to True.
Travel speed to use for gcode moves in RatOS Macro's in mm/s.
|variable_safe_home_x||"middle" / number||"middle"||The x coordinate for where to return the toolhead to when homing Z|
|variable_safe_home_y||"middle" / number||"middle||The y coordinate for where to return the toolhead to when homing Z|
|variable_homing_z_hop||number||15||How much to raise the toolhead after homing Z. Probe configs may change this value.|
|variable_driver_type_x||string||"tmc2209"||The driver type used on X. Used to restore current after sensorless homing|
|variable_driver_type_y||string||"tmc2209"||The driver type used on X. Used to restore current after sensorless homing|
|variable_preheat_extruder||True / False||True||Enables or disables preheating of the nozzle to 150 degrees during the START_PRINT macro. There are several benefits to preheating the nozzle. 1) Gives the bed additional time to diffuse the heat. 2) Softens plastic that may be stuck in the nozzle so it doesn't block your probe from triggering. 3) If using a non thermally compensated inductive probe, it makes the temperature and thus the offset of the probe more predictable and consistent.|
|variable_start_print_heat_chamber_bed_temp||Number||115||The bed temperature to use when heating the chamber when the |
|variable_preheat_extruder_temp||Number||150||The temperature to preheat the extruder to, to soften the material at the nozzle tip|
Bed Mesh Calibration
|variable_calibrate_bed_mesh||True / False||True|
Whether or not to calibrate a bed mesh before each print. If you prefer calibrating your bed mesh manually instead of on each print, you can disable it by setting this to
variable_calibrate_bed_mesh will stop RatOS from loading a bed mesh entirely. If you want it to load a mesh, you can set
variable_bed_mesh_profile to the name of the profile you want it to load.
|variable_bed_mesh_profile||undefined / string||undefined|
Use this variable to set name for the bed_mesh profile that RatOS calibrate and loads. If
False you must set this variable to the profile name you wish to load, or no bed mesh will be loaded. If variable_calibrate_bed_mesh is
True and this variable isn't set, RatOS will use
ratos as the profile name.
|variable_nozzle_priming||"primeline" / "primeblob" / False||"primeblob"||Whether or not to prime the nozzle during the START_PRINT macro. "primeline" will make START_PRINT draw a short line to prime the nozzle. "primeblob" will put a small blob at the edge of the bed that is intended to wrap around the nozzle, then lifts the toolhead out of it while extruding a small line, effective for cleaning the nozzle and it's easy to clean up.|
|variable_nozzle_prime_start_x||"min" / "max" / number||"max"||Where to place the primeline or blob in X. "min" starts the blob or line at x=0 + some safety margin. "max" starts the blob or line at x=max - some safety margin. If set to a number, that number will be used as the starting x coordinate of the line or blob.|
|variable_nozzle_prime_start_y||"min" / "max" / number||"min"||Where to place the primeline or blob in Y. "min" starts the blob or line at y=0 + some safety margin. "max" starts the blob or line at y=max - some safety margin. If set to a number, that number will be used as the starting y coordinate of the line or blob.|
|variable_nozzle_prime_direction||"auto" / "forwards" / "backwards||"auto"||The direction to draw the line or blob in, if "backwards" the toolhead will move toward the front of the printer, if "forwards" it will move towards the back. When set to "auto" it will move towards the middle regardless of |
|variable_filament_unload_length||number||130||How much to retract in mm when unloading filament after the tip has been formed|
|variable_filament_unload_speed||number||5||How fast to retract the |
|variable_filament_load_length||number||100||How much to extrude in mm when loading filament to get the filament to the nozzle|
|variable_filament_load_speed||number||10||How fast to extrude the |
|variable_start_print_park_in||"back" / "center" / "front"||"back"||Where to park the toolhead during final nozzle heating.|
|variable_start_print_park_x||number / undefined||undefined||Custom X coordinate to park the toolhead during final nozzle heating.|
|variable_start_print_park_z_height||number||50||The z height at which to park the toolhead during final nozzle heating.|
|variable_end_print_park_in||"back" / "center" / "front"||"back"||Where to park the toolhead after ending or canceling a print.|
|variable_end_print_park_x||number / undefined||undefined||Custom X coordinate to park the toolhead after ending or canceling a print.|
|variable_end_print_park_z_hop||number||number||How many mm to lift the nozzle when after ending or cancelling a print.|
|variable_pause_print_park_in||"back" / "center" / "front"||"back"||Where to park the toolhead when pausing a print.|
|variable_pause_print_park_x||number / undefined||undefined||Custom X coordinate to park the toolhead when pausing a print.|
These variables are only relevant when using a stowable probe such as Euclid or Klicky. Use these to customize and finetune the deployment and stowing procedures.
|variable_stowable_probe_position_preflight||Tuple||undefined||The coordinates to move the toolhead to before the probe deployment routine. Example: |
|variable_stowable_probe_position_side||Tuple||undefined||The coordinates to move the toolhead to before entering the dock during deployment, or exiting the dock while stowing. Example: |
|variable_stowable_probe_position_dock||Tuple||undefined||The coordinates of the toolhead when it's positioned perfectly inside the dock for pickup. Example: |
|variable_stowable_probe_position_exit||Tuple||undefined||The coordinates to move the toolhead to when exiting the dock while deploying or entering the dock while stowing. Example: |
|variable_skew_profile||string or undefined||undefined||Use this if you have calibrated and saved a skew profile that you want to load in the START_PRINT macro. To activate it, set the variable to the name of your saved skew profile.|
User macro hooks
These hooks do nothing by default, that means you can safely implement them in your USER OVERRIDES section without copy pasting anything from the RatOS config files, like so:
Runs right after the chamber has started heating, if CHAMBER_TEMP is supplied to START_PRINT.
Runs right after the bed has reached temp, before the internal _START_PRINT_AFTER_HEATING_BED
Runs before _START_PRINT_BED_MESH
Runs before _START_PRINT_PARK
Runs just before _START_PRINT_AFTER_HEATING_EXTRUDER
Internal macro hooks
These hooks are used internally, so if you override these be sure to copy paste the original implementation and modify that or you may break some functionality. Remember to check if there's an override in the printer's macro.cfg file, in which case that's the one you would copy.
Heats the chamber, if CHAMBER_TEMP is supplied to START_PRINT.
Runs right after the bed has reached temp, after _USER_START_PRINT_AFTER_HEATING_BED. It is usually used for additional bed calibration, such as Z_TILT_ADJUST or QUAD_GANTRY_LEVELING depending on the printer.
Handles bed meshing logic.
Parks the extruder while heating the nozzle to print temperature.
Primes the nozzle and loads the skew profile if any is defined in the RatOS variables.