USB Firmware Compilation

Check DIP Switch Settings

Note

• The DIP switches must be set to the positions shown below

SSH into the Host Machine

Warning

• You must connect to the host machine via SSH using Wi-Fi before compiling the firmware

• First, please: Use Wi-Fi to connect to the host machine via SSH

---

USB Firmware Flashing

USB Firmware Flashing

Tip

• A USB firmware has already been pre-compiled in the FLYOS-FAST system. There is no need to compile it manually. Simply execute the command below to flash it
• Alternatively, you can choose to compile the USB firmware manually

• Connect to the host machine via SSH and enter the following command:

fly-flash -d c8 -h -f /usr/lib/firmware/klipper/stm32f407-32k-usb.bin

Manually Compile USB Firmware

Manually Compile USB Firmware

Klipper Firmware Compilation and Configuration Page Operation Instructions

tip

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

1. The up arrow key ↑, down arrow key ↓ are used to move the cursor up and down to select menu items.
2. The confirm key Enter or space key 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. The Y key, when exiting the Klipper firmware configuration page and there is a prompt, click 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 the introduction on how to compile the firmware:

• After connecting to 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 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 STM32F407 and press Enter

  

• Select Bootloader offset, select: 32KiB bootloader

  

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

  

• Press the Q key and when Save configuration appears, press the Y key

• The configuration should now be saved, and you will be returned to the command line interface

• Enter the following command to start the compilation, which may take some time

make -j4

• The compilation is successful if the following output appears at the end

---

Firmware Flashing

tip

Execute the following command to flash the firmware

fly-flash -d c8 -h -f /data/klipper/out/klipper.bin

---

Search USB ID

1. Open the browser and enter the IP address of the host computer in the address bar. For example, if my host computer's IP is 192.168.101.179, simply type it in and press Enter.

2. Open the WEB interface of the host computer, and in the configuration section of the left sidebar, find:

For fluidd: {…}, click into it to find printer.cfg

For mainsail: Machine, click into it to find printer.cfg

3. After entering printer.cfg, click on DEVICES at the top right corner.

4. Click on SERIAL, then refresh.

   Refresh for fluidd

   Refresh for mainsail

5. Copy the ID; click the arrow to copy.

   For fluidd, check if ttyAMC exists, and ensure that Path by ID exists; this is the USBID

   For mainsail, check if ttyAMC exists, and ensure that Path by ID exists; this is the USBID

Fill in USB ID

1. Close DEVICES and fill in the ID

Note

• Please change the following in the configuration file:

[mcu] 
serial: /tmp/klipper_host_mcu

to

[mcu host] 
serial: /tmp/klipper_host_mcu

• Add:

[mcu]
serial: <Replace this with the ID you just found>

In fluidd, locate [MCU]

In mainsail, locate [MCU]

2. Fill in the ID into the configuration.

tip

• After filling in the ID, click SAVE & RESTART at the top right corner.

3. If Klipper shows a warning ADC out of range, this is normal. Connect the heated bed and thermistor to the mainboard, and configure the thermistor pins for the nozzle and heated bed, then save and restart.

dangerous

Note: All IDs shown in this document are examples. Each mainboard's ID is different; please fill in the actual ID you obtained.

---