Skip to main content

RS232 Firmware Compilation

Start Compilation

Firmware Compilation Quick Guide

Precautions

  • Network: Ensure the host machine (Raspberry Pi, etc.) is connected to the network.
  • Login Method: Must log in via SSH over the network; serial port login 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 machine.

Switching Users:

  • Standard Systems (Official Raspberry Pi OS, 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 cursor up/down to select menu items
Enter / SpaceConfirm selection, toggle options, or enter submenus
ESCReturn to the previous menu level
QExit the configuration interface
YWhen exiting, press Y to save the configuration if prompted

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 interface below 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, choose: NO bootloader.

    Loading...
  • Select Communication interface, choose: UART0 on GPIO0/GPIO1.

    Loading...
  • Select GPIO pins to set at micro-controller startup, input: !gpio18
    warning

    Please enter !gpio18 in English input mode

    Loading...
  • Press the Q key, then Save configuration will appear. At this point, press the Y key.
    Loading...
  • The configuration should now be saved, and you will exit back to the command line interface.
  • Enter the command below to start compilation. This process may take some time.
make -j4
Loading...
  • Finally, if the output shows the content below, 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 capability to connect the Tool Board to the USB port of your host computer. You can release the BOOT button after successfully connecting to the host computer.
    Loading...

Flash RS232 Firmware

  • Please note that the tool board is currently 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 writing the system to the host computer, you may see prompts similar to those highlighted in the red circle in the image below—partial red prompts may appear. This is normal and not an error.

    Loading...

Confirm Firmware Startup

  • If the firmware starts normally, the LED shown in the image below will light up.
    Loading...
Loading...