Skip to content
Wiki
Main site

Firmware restart

A firmware restart reloads the Klipper firmware and all configuration files without rebooting the Raspberry Pi. It is faster than a full reboot (~10–15 seconds vs. ~60 seconds) and is the correct action after most configuration changes.

When to use it

Section titled “When to use it”
  • After editing any file in ~/printer_data/config/ (e.g., printer.cfg)
  • After saving new PID values or calibration results that require a config reload
  • After a slicer sends FIRMWARE_RESTART at the end of a print
  • When Klipper shows “Klippy not connected” but the Raspberry Pi is still running

When NOT to use it (use full reboot instead)

Section titled “When NOT to use it (use full reboot instead)”
  • After a G1OS (system) update — use Host Control → Reboot
  • If the display or network is unresponsive
  • After updating Moonraker or Mainsail

How to do it — from G1OS (Mainsail)

Section titled “How to do it — from G1OS (Mainsail)”
  1. Open http://g1os.local in a browser
  2. Click the power icon in the top-right corner of the dashboard
  3. In the dropdown menu, select Firmware restart
  4. Klipper restarts — the dashboard briefly shows “Klippy not connected” then reconnects automatically within 10–15 seconds

How to do it — from the Klipper console

Section titled “How to do it — from the Klipper console”

In Mainsail, open the Console tab and type:

FIRMWARE_RESTART

Press Enter. Same effect as the dashboard button.

How to do it — from the display (KlipperScreen)

Section titled “How to do it — from the display (KlipperScreen)”

On the touchscreen display:

  1. Tap the Settings (gear) icon
  2. Tap Restart → Firmware restart

What it does

Section titled “What it does”
  • Reloads printer.cfg and all included config files
  • Re-initializes all stepper drivers and heaters
  • Clears any Klipper error state (including “Emergency stop” triggered by software)
  • Does not reboot the Raspberry Pi or reset the network
  • Does not clear uploaded G-code files

After a firmware restart

Section titled “After a firmware restart”
  • Home the printer before printing — the position is lost on restart
  • If you changed temperatures or PID values, they are now active
  • If Klipper fails to connect after restart, check the console for config errors
Section titled “Related notes”