RS232 Firmware Compilation
Start Compilation
Brief Guide to Firmware Compilation
Notes
- Network: Ensure the host (Raspberry Pi, etc.) is connected to the internet.
- Login Method: Must log in via SSH over the network; serial port access is disabled.
- Input Method: Keep the keyboard in English half-width mode.
SSH Login and User Switching
Use tools like MobaXterm, PuTTY, etc., to SSH into the host.
Switch User:
- Standard System (Official Raspberry Pi system, etc.)
Do not useroot; switch to a regular user:su <username> - FLY Host System (FlyOS-FAST system)
Only supports login asrootuser (password:mellow)
Firmware Compilation Operation Guide
In the Klipper firmware configuration interface, only keyboard operations are supported; the mouse cannot be used.
| Key | Function |
|---|---|
| ↑ / ↓ | Move cursor up/down to select menu items |
| Enter / Space | Confirm selection, check options, or enter submenus |
| ESC | Return to the previous menu |
| Q | Exit the configuration interface |
| Y | If prompted when exiting, press Y to save the configuration |
Start Firmware Compilation
The following describes how to compile the firmware:
-
After connecting via SSH, enter the following command and press Enter:
cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig -
Where
rm -rf ~/klipper/.config && rm -rf ~/klipper/outis to delete previous compilation data and firmware -
make menuconfigis to compile the firmware, after execution the following interface should appearLoading... -
Select Enable extra low-level configuration options and press Enter
Loading... -
Enter the menu Micro-controller Architecture then select Raspberry Pi RP2040/RP235x and press Enter
Loading... -
Select Bootloader offset, choose:NO bootloader
Loading... -
Select Communication interface, choose:UART0 on GPIO0/GPIO1
Loading...
- Select GPIO pins to set at micro-controller startup, enter: !gpio5,!gpio19,!gpio24
Caution
Please enter
!gpio5,!gpio19,!gpio24in English input mode.
- Press the
Qkey, Save configuration appears, then press theYkeyLoading... - The configuration should now be saved and you have exited to the command line interface
- Enter the following command to start compilation, it will take some time
make -j4
- Compilation is successful if the following output appears at the end
- Due to Klipper version issues, only the appearance of
out/klipper.binindicates successLinking out/klipper.elfCreating uf2 file out/klipper.uf2
Enter Flashing Mode
The left button is the RESET button, and the right button is the BOOT button.
- With the tool board completely powered off, press and hold the BOOT button. Use a Type-C data cable with data transfer capability to connect the tool board to the USB port of your host computer. Once successfully connected to the host computer, you can release the BOOT button.
Loading...
Flash the Firmware
-
Note that the current toolboard is in firmware flashing mode, and only firmware with the
.uf2suffix can be flashed. -
Use the following command to flash the firmware onto the toolboard:
cd && cd ~/klipper/make flash FLASH_DEVICE=2e8a:0003TipIf this is the first flash after setting up the system on the host machine, you may see a prompt similar to the one highlighted in the red circle in the image below—some red hints may appear. This is normal and not an error.
Loading...
Verify Firmware Startup
- If the firmware starts normally, the LED will light up.
Loading...