RS232 Firmware Compilation
Start Compilation
Firmware Compilation Quick Guide
Notes
- Network: Ensure the host machine (Raspberry Pi, etc.) is connected to the network.
- Login Method: Must use SSH to log in via the network; disable serial port.
- 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 (Raspberry Pi official system, 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 the cursor up/down to select menu items |
| Enter / Space | Confirm selection, toggle options, or enter submenus |
| ESC | Return to the previous menu |
| Q | Exit the configuration interface |
| Y | When exiting, press Y if prompted 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 -
Among these,
rm -rf ~/klipper/.config && rm -rf ~/klipper/outdeletes previous compilation data and firmware. -
make menuconfigis for compiling the firmware. After execution, the following interface 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, and choose: NO bootloader.
Loading... -
Select Communication interface, and choose: UART0 on GPIO0/GPIO1.
Loading...
- Select GPIO pins to set at micro-controller startup, input: !gpio18
Caution
Please input
!gpio18in English input mode.Loading...
- Press the
Qkey. When Save configuration appears, press theYkey.Loading... - The configuration should now be saved, and you will exit to the command line interface.
- Enter the following command to start the compilation. This process may take some time.
make -j4
- Finally, if the following content is output, 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 arrow points to 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 capabilities to connect the Tool Board to a USB port on your host computer. Release the BOOT button after the Tool Board is successfully connected to the host.
Loading...
Flash the RS232 Firmware
-
Please note that the current tool board is 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 setting up the system on the host computer, you may encounter a prompt similar to the one highlighted in the red circle in the image below—some red text may appear. This is normal and not an error.
Loading...
Verify Firmware Startup
- If the firmware starts normally, the LED shown in the image below will light up.
Loading...