USB Firmware Compilation

Check the DIP Switch

Important

• For normal use, please set the DIP switch to the UP position.
• When setting the switch, please push it all the way UP, otherwise it may not connect to the lower computer!!!

SSH Connect to the Upper Computer

Warning

• Before compiling the firmware, you need to connect to the upper computer SSH via wifi.

• First, please: Connect to the upper computer SSH via wifi

---

USB Firmware Flashing

USB Firmware Flashing

Note

• The FLYOS-FAST system has a pre-compiled USB firmware, so manual compilation is not required. Execute the command below to flash.
• You can also choose to manually compile the USB firmware to compile it yourself.

• Connect to the upper computer via SSH and enter the following command:

fly-flash -d auto -h -f /usr/lib/firmware/klipper/stm32h723-128k-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 an 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 to compile 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 STM32H723 and press Enter

  

• Select Bootloader offset, select: 128KiB bootloader

  

• Select Clock Reference (8 MHz crystal), select: 25 MHz crystal

  

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

  

• Press the Q key, then Save configuration will appear. Press the Y key.

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

• Enter the following command to start compilation. It will take some time.

make -j4

• If the final output shows the following content, the compilation is successful.

---

Firmware Flashing

tip

Execute the following command to flash the firmware.

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

---

Searching for USB ID

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

2. Open the host's WEB interface. In the left sidebar configuration options, find:

For fluidd: {…}, click to enter, then find printer.cfg

For mainsail: Machine, click to enter, then find printer.cfg

3. Click printer.cfg to enter, then click DEVICES in the top right corner.

4. Click SERIAL, then refresh.

Refreshing in fluidd

Refreshing in mainsail

5. Copy the ID. Click where the arrow points to copy.

In fluidd, check if ttyAMC exists, and ensure Path by ID exists. This is the USB ID.

In mainsail, check if ttyAMC exists, and ensure Path by ID exists. This is the USB ID.

Filling in the USB ID

dangerous

Please note, the ID below cannot be used!!!!

serial: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0

1. Close DEVICES and fill in the ID.

Important Notes

• In the configuration file, change:

[mcu] 
serial: /tmp/klipper_host_mcu

to:

[mcu host] 
serial: /tmp/klipper_host_mcu

• Add:

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

Find [MCU] in fluidd

Find [MCU] in mainsail

2. Fill the ID into the configuration.

tip

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

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

dangerous

Note: All IDs appearing in this document are examples. The actual ID for each mainboard is different. Please fill in the ID you actually obtained.