RS232 Firmware Compilation

Start Compilation

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.

Use tools like MobaXterm, PuTTY, etc., to SSH into the host.

Standard System (Official Raspberry Pi system, etc.)
Do not use root; switch to a regular user:
```
su <username>
```
FLY Host System (FlyOS-FAST system)
Only supports login as root user (password: mellow)

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

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/out is to delete previous compilation data and firmware
make menuconfig is to compile the firmware, after execution the following interface should appear

Loading...
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...

Press the Q key, Save configuration appears, then press the Y key
Loading...
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.bin indicates success
```
Linking out/klipper.elf
Creating uf2 file out/klipper.uf2
```

Tip

The circled area is the BOOT button

To enter flashing mode, ensure the tool board is completely powered off. Press and hold the BOOT button, then connect the Type-C cable capable of data transfer to the tool board and the host machine.
Loading...

Note that the current toolboard is in firmware flashing mode, and only firmware with the .uf2 suffix can be flashed.
Use the following command to flash the firmware onto the toolboard:
```
cd && cd ~/klipper/
make flash FLASH_DEVICE=2e8a:0003
```
Tip
If 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...