Includes & Overrides
RatOS uses a modular configuration that heavily takes advantage of the config file include and merge logic in Klipper. For this reason, the order of includes and overrides are very important, do not change the order of the configuration unless you know what you're doing.
Do NOT edit the files inside the
config/ folder. These files are controlled by RatOS and will be updated when the RatOS package is updated.
You can override any setting in RatOS, to do so you just copy the section and the parameter you need to change, and paste it in your printer.cfg in the
USER OVERRIDES section. Let's say we wanted to change the current the extruder motor. If we navigate to
config/printers/v-core-3/steppers.cfg we'll see this section:
We're only interested in the
hold_current settings, so all we need to do is go back to printer.cfg, scroll down to the
USER OVERRIDES comment section and put in the following:
### USER OVERRIDES
# Place all your overrides here
This works for any section (including gcode macros) and any parameter. You only need to override the parts you're interested in. Imagine that each
[include] section is simply replaced by the contents of the included file. You can have the same section defined multiple times, they will all get merged by klipper when it reads the config, with the last parameters taking precedence. This makes for a super powerful way to build your config! Refer to the klipper config reference for all the cool things you can do.