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​

Below are the steps 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

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

  • Navigate to the Micro-controller Architecture menu, then select STMicroelectronics STM32 and press Enter.

    Loading...

  • Go to the Processor model menu, select STM32H723, and press Enter.

    Loading...

  • Select Bootloader offset, and choose: NO bootloader.

    Loading...

  • Select Clock Reference (8 MHz crystal), and choose: 25 MHz crystal.

    Loading...

  • For Communication interface, select: Serial (on USART1 PA10/PA9).

    Loading...
  • Select GPIO pins to set at micro-controller startup, input: !PA15 Please note that ! is uppercase
    Loading...
  • Press the Q key. When Save configuration appears, press the Y key.
    Loading...
  • The configuration should now be saved, and you will return to the command line interface.
  • Enter the following command to start compilation. This process may take some time.
make -j4
Loading...
  • If the following content is output at the end, the compilation is successful.
  • Due to Klipper version differences, as long as out/klipper.bin appears, it indicates success. 
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

Enter Flashing Mode​

tip

The upper button is the RESET button, and the lower button is the BOOT button.

  • There are two methods to enter DFU mode.
  • First method: With the main board completely powered off, press and hold the BOOT button, then connect a data cable (capable of data transfer) between the main board and the host computer.
  • Second method: With a data cable (capable of data transfer) connected between the main board and your host computer, press and hold the BOOT button, then press the RST button, release the RST button, and finally release the BOOT button.
    Loading...

Flash the Firmware​

  1. Install the Flashing Tool

    • FLY host machine does not need to install the flashing tool.
    • If you need to install it, please note: the host machine must be able to connect to the internet for proper installation.
    • If already installed, no need to reinstall.
    sudo apt update
    sudo apt install dfu-util -y

  2. Execute the following command to check if the connection is successful.

    lsusb

    • If no DFU device is found, try re-entering flashing mode.

    • Due to system version differences, it may display other names. If 0483:df11 appears, it indicates successful entry into flashing mode.

      Loading...

  3. Flash the Firmware

    • Execute the code below to start flashing.
    sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/klipper/out/klipper.bin

  4. If the content shown by the arrow in the image below, File downloaded successfully, appears, the flashing is successful.

    Loading...
    tip

    After flashing is complete, the mainboard needs to be completely powered off once.

Confirm Firmware Startup​

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