Updating your printer.cfg

Upon installing OpenNept4une, you'll receive the most current version of printer.cfg. This is occasionally refreshed with new features and therefore requires periodic updating to get the latest configurations & macros.

User-Calibrated Settings

During the initial setup of OpenNept4une, accessible via this Wiki, you'll conduct several calibrations detailed on the Printer Calibration page. Essential settings such as bed_mesh, z_offset, PID tuning, and input_shaper are automatically saved at the end of your printer.cfg under the SAVE_CONFIG section, which looks like this:

#*# <---------------------- SAVE_CONFIG ---------------------->

These settings are commented out (#) in the main body of the printer.cfg file so Klipper actively uses your SAVE_CONFIG values. This approach ensures your calibrated values are separated and prioritised from the main body of the printer.cfg, a standard practice in Klipper.

---

Making changes to the printer.cfg

Your Custom Macros:

• Insert any new or personal macros into the user_settings.cfg file. This file is specifically intended for your customisations, ensuring they remain separate from the default configuration.

Keeping your Modified Settings:

• If you've made changes to the printer.cfg file (Not values within SAVE_CONFIG) and want these changes to persist through future updates, copy the modified sections into user_settings.cfg. Alternatively, you can directly copy the sections you intend to modify from printer.cfg into user_settings.cfg and apply your changes there.

When you place your custom settings/macros in user_settings.cfg, these entries override any matching ones found in printer.cfg, eliminating the need to delete or comment out the original entries in printer.cfg.

The system is designed so that user_settings.cfg is not affected by updates to the printer's configuration, ensuring that your customisations and additions remain intact.

Example user_settings.cfg

This example shows how one might use the user_settings.cfg to disable both beeper PAUSE_TUNE / END_TUNE & Make changes to the default firmware retraction settings.

---

How to Update your OpenNept4une printer.cfg

1. Access your printer via SSH.
2. Execute the opennept4une command.
3. Choose Option (1) to install the latest printer configuration.
4. You may skip additional config & dtb.

The update process automatically creates a back-up of your existing printer.cfg as backup-printer.cfg.bak in the same directory, with subsequent backups numbered sequentially. It then integrates your previous SAVE_CONFIG settings into the new printer.cfg file, ensuring your calibrated data is preserved through the update.