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, input: !gpio18
    Caution

    Please input !gpio18 in English input mode.

    Loading...
  • 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 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: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 shown in the image below will light up.
    Loading...
Loading...