Skip to main content

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 use root. Switch to a regular user:
    su <username>
  • FLY Host Machine (FlyOS-FAST system)
    Only supports logging in as the root user (password: mellow).

Firmware Compilation Operation Guide

In the Klipper firmware configuration interface, only keyboard operations are supported; mouse usage is not possible.

KeyFunction
↑ / ↓Move the cursor up/down to select menu items
Enter / SpaceConfirm selection, toggle options, or enter submenus
ESCReturn to the previous menu
QExit the configuration interface
YWhen 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/out deletes previous compilation data and firmware.

  • make menuconfig is 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, enter: !gpio5,!gpio19,!gpio24
    Caution

    Please enter !gpio5,!gpio19,!gpio24 in English input mode.

  • Press the Q key. When Save configuration appears, press the Y key.
    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
Loading...
  • Finally, if the following content is output, the compilation is successful.
  • Due to Klipper version differences, as long as out/klipper.bin appears, it indicates success.
    Linking out/klipper.elf
    Creating uf2 file out/klipper.uf2

Enter Flashing Mode

Tip

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

  • 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:0003
    Tip

    If 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 will light up.
    Loading...
Loading...