Skip to main content

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 use root; switch to a regular user:
    su <username>
  • FLY Host System (FlyOS-FAST system)
    Only supports login as root user (password: mellow)

Firmware Compilation Operation Guide

In the Klipper firmware configuration interface, only keyboard operations are supported; the mouse cannot be used.

KeyFunction
↑ / ↓Move cursor up/down to select menu items
Enter / SpaceConfirm selection, check options, or enter submenus
ESCReturn to the previous menu
QExit the configuration interface
YIf 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/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...
  • 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, 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
Loading...
  • 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

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

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

Verify Firmware Startup

  • If the firmware starts normally, the LED will light up.
    Loading...
Loading...