RS232 Firmware Compilation
Start Compilation
Firmware Compilation Quick Guide
Precautions
- Network: Ensure the host machine (Raspberry Pi, etc.) is connected to the network.
- Login Method: Must log in via SSH over the network; serial port login 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 machine.
Switching Users:
- Standard Systems (Official Raspberry Pi OS, etc.)
Do not useroot. Switch to a regular user:su <username> - FLY Host Machine (FlyOS-FAST System)
Only supports logging in as therootuser (password:mellow).
Firmware Compilation Operation Guide
In the Klipper firmware configuration interface, only keyboard operations are supported; mouse usage is not possible.
| Key | Function |
|---|---|
| ↑ / ↓ | Move cursor up/down to select menu items |
| Enter / Space | Confirm selection, toggle options, or enter submenus |
| ESC | Return to the previous menu level |
| Q | Exit the configuration interface |
| Y | When exiting, press Y to save the configuration if prompted |
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 -
Among these,
rm -rf ~/klipper/.config && rm -rf ~/klipper/outdeletes previous compilation data and firmware. -
make menuconfigis for compiling the firmware. After execution, the interface below should appear.Loading... -
Select Enable extra low-level configuration options and press Enter.
Loading... -
Enter the Micro-controller Architecture menu, 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, input: !gpio5,!gpio19,!gpio24
warning
Please input
!gpio5,!gpio19,!gpio24in English input mode.
- Press the
Qkey, then Save configuration will appear. At this point, press theYkey.Loading... - The configuration should now be saved, and you will exit back to the command line interface.
- Enter the command below to start compilation. This process may take some time.
make -j4
- Finally, if the output shows the content below, the compilation is successful.
- Due to Klipper version differences, as long as
out/klipper.binappears, it indicates success.Linking out/klipper.elf
Creating 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. Release the BOOT button after it is correctly connected to the host computer.
Loading...
Flash the Firmware
-
Please note that the tool board is currently in firmware flashing mode and can only flash firmware with the .uf2 file extension.
-
Use the command below to flash the firmware to the tool board.
cd && cd ~/klipper/
make flash FLASH_DEVICE=2e8a:0003tipIf this is the first time flashing after writing the system to the host computer, you may see prompts similar to those highlighted in the red circle in the image below—partial red prompts may appear. This is normal and not an error.
Loading...
Verify Firmware Startup
- If the firmware starts normally, the LED will light up.
Loading...