USB Firmware Compilation

Start Compilation

FAST System Firmware Compilation Tutorial

warning

• FlyOS-FAST System Notes
  • The default username for the FAST System is root, and the password is mellow
  • Firmware compilation can only be performed using the root user
  • The FAST System only has the ROOT user; you do not need to switch users!!!

::: tip

• Please ensure that the host machine can connect to the network normally.
• Before compiling the firmware, use SSH to log in to the host machine via the network.
• Do not use a serial port tool to log in to the host machine.

:::

Klipper Firmware Compilation and Configuration Page Operation Instructions

::: tip

Please make sure that the keyboard input method is in half-width mode, i.e., English mode.

:::

1. The key ↑ (up arrow) and ↓ (down arrow) on the keyboard are used to move the cursor up and down to select menu items.
2. The confirm key Enter or spacebar Space is used to check the menu or enter a sub-menu.
3. The exit key ESC is used to return to the previous menu.
4. The Q key is used to exit the Klipper firmware configuration page.
5. When exiting the Klipper firmware configuration page and there is a prompt, press the Y key to save the configuration file.

::: warning

If there are fewer options in the configuration page, please first check [ ] Enable extra low-level configuration options to display some hidden options.

:::

Below is an introduction on 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:

  

• Select Enable extra low-level configuration options and press Enter:

  

• Enter the menu Micro-controller Architecture, then select STMicroelectronics STM32 and press Enter:

  

• Enter the menu Processor model, select STM32F405, and press Enter:

  

• Select Bootloader offset, choose: 32KiB bootloader:

  

• Communication interface, select: USB (on PA11/PA12):

  

• Press the Q key. When Save configuration appears, press the Y key.
  
• You should now have saved the configuration and returned to the command line interface.
• Enter the command below to start compilation. It will take some time.

make -j4

• 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

Firmware Flashing

tip

Execute the following command to flash the firmware.

fly-flash -d gemini-v3 -h -f ~/klipper/out/klipper.bin