USB Firmware Compilation
Check DIP Switch
- When in normal use, please set the
DIP switch to the up position
- When switching the DIP switch, please push it all the way up, otherwise it may fail to connect to the lower-level machine!!!

SSH Connection to Host Machine
- Before compiling the firmware, you need to use
WiFi to connect to the host machine via SSH
- First, please: Use WiFi to connect to the host machine SSH
- USB Firmware Burning
- Manually Compile USB Firmware
USB Firmware Burning
- A pre-compiled USB firmware is available in the FLYOS-FAST system, so there is no need to manually compile the firmware; just execute the command below to burn it.
- Alternatively, you can choose to
manually compile the USB firmware
and compile the firmware yourself.
- Enter the following command through SSH connection to the host machine
fly-flash -d c5 -h -f /usr/lib/firmware/klipper-h723-128k-usb.bin


Manually Compile USB Firmware
Klipper固件编译和配置页面操作说明
请确保键盘输入法为半角模式,即英文模式
- 键盘上键
↑
,下键↓
,用于上下移动光标来选中菜单项 - 确认键
Enter
或 空格键Space
,用于勾选菜单或进入子菜单 - 退出键
ESC
,用于返回上一级菜单 Q
键,用于退出Klipper固件配置页面Y
键,在退出Klipper固件配置页面时,如果有提示,则点击Y
键保存配置文件
如果配置页面选项比较少,请先勾选[ ] Enable extra low-level configuration 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
Q
key, aSave configuration
prompt will appear, then pressY
key
-
Now the configuration should be saved, and you should have returned to the command line interface
-
Enter the following command to start compiling, this process takes some time
make -j4

- Finally, if the output is as follows, the compilation is successful

Firmware Burning
Execute the following command to burn the firmware
fly-flash -d c5 -h -f ~/klipper/out/klipper.bin


Search for USB ID
- Open the browser and enter the IP address of the host computer in the address bar, for example, if the IP address of my host computer is
192.168.101.179
, simply enter it and press Enter.

- Open the WEB interface of the host computer, find in the configuration options on the left sidebar:
![]() |
![]() |
- Click into
printer.cfg
, then clickDEVICES
on the top right
![]() | ![]() |
- Click
SERIAL
, then refresh
![]() |
![]() |
- Copy the ID, click the arrow to copy
![]() |
![]() |
Fill in USB ID
- Close
DEVICES
and fill in the ID
- Please modify the configuration file as follows:
[mcu]
serial: /tmp/klipper_host_mcu
to
[mcu host]
serial: /tmp/klipper_host_mcu
- Add:
[mcu]
serial: <replace with the ID you just queried>
![]() |
![]() |
- Fill in the ID in the configuration
- After filling in the ID, click
SAVE & RESTART
on the top right
![]() | ![]() |
- If Klipper prompts
ADC out of range
, this is a normal phenomenon. Connect the heated bed and thermistor to the motherboard, configure the thermistor pins for the nozzle and heated bed, then save and restart.
Note: All IDs mentioned in the document are examples. Each motherboard has a different ID, please fill in the actual obtained ID.