Руководство по конфигурации системы FLYOS-FAST

Данное руководство предназначено для настройки платформы устройства, сети, среды печати, экрана, камеры и CAN-связи FLYOS-FAST. Методы использования системных служб H3, H5 и H618 схожи, но параметры, связанные с аппаратным обеспечением, нельзя копировать между платформами.

Подтверждение перед настройкой

Перед началом работы подтвердите следующую информацию:

Пункт	Что необходимо подтвердить
Системный образ	Платформа образа соответствует чипу устройства: H3, H5 или H618
Модель устройства	Необходима для выбора правильного board
Среда печати	Используется Klipper или RRF
Локальный дисплей	Без экрана, HDMI, FLY-TFT, KlipperScreen, FLY Screen или последовательный экран
Камера	Не используется, Crowsnest или GoCam из тестовой версии FLYOS-FAST v1.4.0
Скорость CAN	Материнская плата, инструментальная плата и система используют единое значение 1000000, 500000 или 250000

В первую очередь установите board

board влияет на конфигурацию таких аппаратных компонентов, как последовательный порт, SPI, экран и встроенный MCU. Неправильный выбор может привести к недоступности интерфейсов, неисправности экрана или ошибкам обработки прошивки при первом запуске. Не копируйте полную конфигурацию, а затем изменяйте имя устройства — начните с исходного config.txt текущего образа и настраивайте параметры поэтапно.

Рекомендуемый порядок настройки

1. Выберите системный образ и board, соответствующие устройству.
2. Настройте Wi-Fi, часовой пояс и имя принтера.
3. Выберите printer=klipper или printer=rrf.
4. Выберите фактический тип экрана и интерфейс экрана.
5. Включите камеру или Moon2UART по мере необходимости, тестируя по одному пункту за раз.
6. При использовании CAN задайте единую скорость для всех устройств.
7. После сохранения перезапустите систему и поэтапно проверьте службы и аппаратные интерфейсы.

Выбор способа настройки

• Config Myprint
• Непосредственное изменение файла конфигурации

Использование Config Myprint для настройки системной карты

Config Myprint подходит для графической настройки системной карты перед первым запуском. Подключите записанную системную карту к компьютеру, откройте программное обеспечение и дождитесь, пока оно определит раздел FlyOS-Conf.

Интерфейс программы и версия образа

Доступные параметры в программе могут обновляться позже, чем тестовый образ. После завершения записи следует открыть FlyOS-Conf/config.txt и проверить, соответствуют ли board, экран, камера и скорость CAN фактическому оборудованию. Новые параметры конфигурации, отсутствующие в программе, необходимо добавлять вручную, не используя похожие названия.

Шаг 1: Включение системной конфигурации

Включите переключатель Включить системную конфигурацию.

Loading...

Шаг 2: Выполнение базовых настроек

Управление файлами конфигурации

• Выбирайте только папку с файлами конфигурации принтера, не выбирайте отдельные файлы.
• Программа скопирует конфигурацию из выбранной папки на системную карту и загрузит её при первом запуске.
• Перед записью убедитесь, что в папке нет оставшихся от других принтеров файлов printer.cfg или дублирующих конфигураций.

Loading...

Wi-Fi сеть

Укажите доступное имя и пароль Wi-Fi. При использовании проводной сети или если планируется настройка Wi-Fi позже, поля можно оставить пустыми.

Loading...

Веб-интерфейс Klipper

Выберите Fluidd или Mainsail. Этот параметр влияет только на веб-интерфейс, используемый по умолчанию в режиме Klipper.

Loading...

Локальный дисплей

Выберите фактически подключенный интерфейс дисплея, затем решите, включать ли KlipperScreen или FLY Screen. Если оба включены, система сначала запустит KlipperScreen; при использовании FLY Screen следует отключить KlipperScreen.

Loading...

Шаг 3: Выполнение расширенных настроек

Имя принтера

Укажите имя принтера для удобной идентификации. Рекомендуется использовать только латинские буквы, цифры, дефисы и подчеркивания.

Loading...

Служба камеры

Включите Crowsnest по мере необходимости. Если для образа тестовой версии v1.4.0 требуется GoCam, после завершения записи необходимо убедиться, что в config.txt указано crowsnest=0, gocam=1; обе службы одновременно включать не следует.

Loading...

Язык и часовой пояс

Выберите начальный язык системы и фактический часовой пояс. После подключения к сети система будет отображать время в соответствии с этим часовым поясом.

Loading...

Скорость связи CAN

Выберите скорость, соответствующую прошивке материнской платы и всех CAN-инструментальных плат. Обычные значения: 1000000, 500000 или 250000; на одной шине CAN нельзя использовать разные скорости.

Loading...

Шаг 4: Запись и проверка

После завершения всех настроек нажмите Записать конфигурацию вручную. Если вы только выбирали параметры в интерфейсе, но не нажали запись, конфигурация не будет сохранена на системную карту.

Loading...

После завершения записи выполните следующие проверки:

1. Откройте FlyOS-Conf/config.txt.
2. Убедитесь, что board полностью соответствует фактическому оборудованию.
3. Убедитесь, что включены только необходимые интерфейсы экрана и службы камеры.
4. Убедитесь, что canbus_bitrate соответствует прошивке всех CAN-устройств.
5. После сохранения безопасно извлеките системную карту, затем вставьте её в целевое устройство и запустите.

Изменение файла конфигурации

Системный файл конфигурации FLYOS-FAST отображается под разными именами в разных местах, но фактически указывает на одну и ту же конфигурацию:

Сценарий использования	Расположение файла	Применимость
Подключение карты системы к компьютеру	FlyOS-Conf/config.txt	Настройка сети, модели устройства и параметров инициализации перед первым запуском
Внутри Linux-системы	/config/config.txt	Проверка конфигурации через SSH
Fluidd / Mainsail	.flyos-config/sys-config.conf	Онлайн-изменение параметров, считываемых при каждом запуске после загрузки системы

Перед изменением обратите внимание

• Сначала сделайте резервную копию исходного файла конфигурации.
• Сохраняйте формат key=value, не меняйте его на key: value.
• Не добавляйте повторно одноимённые элементы конфигурации; при необходимости измените исходное значение.
• Не используйте функцию веб-перевода браузера для редактирования конфигурации, чтобы избежать перезаписи содержимого.
• В именах и путях старайтесь использовать только латинские буквы, цифры, дефисы и подчёркивания.
• Не изменяйте содержимое после строки ######### PLEASE DO NOT EDIT THE FOLLOWING #########.

• Изменение карты системы перед первым запуском
• Изменение через веб-интерфейс после запуска системы

1. После завершения записи образа подключите карту системы обратно к компьютеру.
2. Откройте съёмный диск с именем FlyOS-Conf.
3. Откройте config.txt с помощью простого текстового редактора.
4. Измените значение board в соответствии с фактическим устройством, затем настройте Wi-Fi, режим печати, экран и скорость CAN.
5. Сохраните файл и безопасно извлеките карту системы, затем вставьте её в устройство и запустите.

Параметры первого запуска

Такие параметры инициализации, как language, printer_name и firmware, следует изменять здесь. После завершения первого запуска системы редактирование этих значений не приведёт к повторному выполнению процесса инициализации.

1. Убедитесь, что компьютер и上位机 подключены к одной сети.
2. Откройте в браузере IP-адрес устройства, например http://192.168.1.2/.
3. В Fluidd снимите флажок «Фильтровать скрытые файлы и папки», или в Mainsail установите флажок «Показывать скрытые файлы».

Loading...

Loading...

4. Откройте sys-config.conf в папке .flyos-config.

Loading...

5. Измените необходимые параметры конфигурации и сохраните.

Loading...

6. Полностью перезапустите上位机, чтобы системные службы и аппаратная конфигурация перезагрузились.

Ограничения веб-изменения

Веб-способ подходит для изменения параметров, считываемых при каждом запуске. Параметры инициализации, пропущенные при первом запуске, не могут быть выполнены повторно только перезагрузкой; используйте собственные методы изменения соответствующих функций.

Проверка после сохранения

После перезапуска убедитесь как минимум в следующем:

• Веб-интерфейс открывается корректно, и режим печати с выбором интерфейса страницы соответствуют друг другу.
• Локальный экран, направление касания и интерфейс экрана работают корректно.
• Из дополнительных служб, таких как камера и Moon2UART, запущена только необходимая.
• При использовании CAN скорость системы полностью совпадает со скоростью прошивки основной платы и платы инструмента.
• Klipper или RRF корректно подключаются к соответствующей управляющей плате.

Если после изменения система не запускается корректно, подключите карту системы к компьютеру, восстановите предыдущий config.txt и затем вносите изменения и проверяйте по одному пункту.

Просмотр параметров конфигурации по платформам

• H618: C5 / C8P / Pi V3
• Устройства H3 / H5

Параметры конфигурации H618

Следующие значения по умолчанию и допустимые значения проверены по FlyOS-Conf/config.txt в официальном образе H618 v1.3.10; новые параметры конфигурации, добавленные в тестовом образе v1.4.0, будут отмечены отдельно.

Беспроводная сеть

WIFI_SSID и WIFI_PASS считываются при каждом запуске. При использовании открытой сети пароль можно оставить пустым; при использовании зашифрованной сети необходимо заполнить оба поля.

Параметр	Значение по умолчанию	Допустимые значения	Описание
WIFI_SSID	Пусто	Имя Wi-Fi	После заполнения система автоматически подключается к этой сети при запуске
WIFI_PASS	Пусто	Пароль Wi-Fi	Можно оставить пустым для открытой сети

Настройки первого запуска

language, printer_name и firmware используются только в процессе первого запуска после прошивки полного образа. После завершения первого запуска системы повторное изменение этих параметров не приведет к повторной инициализации.

Параметр	Значение по умолчанию	Допустимые значения	Описание
language	zh-CN	zh-CN, en, ja, ko и другие коды языков, указанные в образе	Устанавливает начальный язык Fluidd и Mainsail
printer_name	Пусто	Любое имя без специальных символов	Устанавливает начальное имя принтера
firmware	/usr/lib/firmware/klipper/stm32h723-128k-usb.bin	Путь к прошивке в образе или /config/klipper.bin	Для C5, C5 V1.1, C8P при первом запуске можно автоматически прошить встроенный MCU в соответствии с board; Pi V3 не использует этот параметр для прошивки внешней платы

Условия автоматической прошивки

Автоматическая прошивка выполняется только при наличии маркера первого запуска, а также при действительности board и firmware и существовании файла прошивки. Не создавайте вручную маркер первого запуска для повторной прошивки; для последующего обслуживания прошивки используйте руководства по прошивке соответствующей платы.

Система и плата

Следующие параметры считываются при каждом запуске.

Параметр	Значение по умолчанию	Допустимые значения	Описание
board	none	fly-c5, fly-c5-v1.1, fly-c8p, fly-pi-v3	Выбор фактической модели устройства; это значение влияет на конфигурацию последовательных портов и SPI-периферии H618
localtime	Asia/Shanghai	Названия мировых часовых поясов	Системный часовой пояс после синхронизации времени с сетью
printer	klipper	klipper, rrf	Выбор среды управления печатью для запуска
console	serial	serial, both	Установка системной консоли; оставляйте значение по умолчанию без явной необходимости
canbus_bitrate	1000000	1000000, 500000, 250000	Установка скорости CAN-интерфейса системы; должна совпадать со всеми CAN-устройствами в сети

Правильный выбор board

Исходная конфигурация образа — board=none, устройство сначала попытается считать результат аппаратного распознавания; при невозможности распознавания H618 v1.3.10 будет использовать fly-c5 как запасной вариант. Поэтому пользователям C8P, C5 V1.1 и Pi V3 следует явно выбрать свою модель устройства перед первым запуском и не полагаться на запасное значение.

Периферийные устройства H618, активируемые при разных значениях board, указаны ниже. Эта таблица предназначена только для объяснения последствий неправильного выбора и не означает, что эти последовательные порты или SPI-интерфейсы можно свободно использовать для других целей.

Значение board	Активируемые встроенные периферийные устройства
fly-c5	UART1
fly-c5-v1.1	UART1, SPI1.2
fly-c8p	UART1, UART3, UART4, SPI1.2
fly-pi-v3	UART1, UART3, UART4, SPI1.2

Экран и интерфейс

Параметр	Значение по умолчанию	Допустимые значения	Описание
screen	hdmi	none, hdmi, fly-tft-v2-r, fly-tft-v2-c	Выбор интерфейса отображения; none отключает локальный вывод изображения
rotate	auto	auto, 0, 90, 180, 270	При auto для HDMI по умолчанию используется 0 градусов, для FLY-TFT — 90 градусов; для HDMI-дисплея и сенсорного управления также применяется ручной угол
klipper_screen	0	0, 1	Включение KlipperScreen в режиме Klipper
fly_screen	0	0, 1	Включение FLY Screen в режиме Klipper
moon2uart	0	0, 1	Включение службы последовательного экрана Moon2UART
m2u_port	/dev/ttyS1	Фактический путь к последовательному устройству	Последовательный порт, используемый Moon2UART
m2u_baud	115200	Скорость, требуемая экраном	Скорость последовательной связи Moon2UART

При одновременной установке klipper_screen=1 и fly_screen=1 система сначала запускает KlipperScreen. При использовании FLY Screen следует установить klipper_screen=0, fly_screen=1.

Сохранение старой конфигурации при OTA-обновлении

После OTA-обновления со старой версии в config.txt могут отсутствовать fly_screen, m2u_port или m2u_baud. При необходимости соответствующих функций можно добавить параметры конфигурации в соответствии с таблицей выше.

Веб-интерфейс Klipper и камера

Параметр	Значение по умолчанию	Допустимые значения	Описание
klipper_webui	fluidd	fluidd, mainsail	Веб-интерфейс, используемый в режиме Klipper
crowsnest	0	0, 1	Включение или отключение службы камеры

Конфигурация тестовой версии v1.4.0

Параметр	Значение по умолчанию	Допустимые значения	Описание
gocam	0	0, 1	Включение службы камеры GoCam UVC

В официальной версии v1.3.10 нет gocam. В тестовой версии v1.4.0 при одновременной установке crowsnest=1 и gocam=1 система сначала запускает Crowsnest. При использовании GoCam следует явно установить crowsnest=0, gocam=1.

Метод использования GoCam: Просмотр службы камеры GoCam

Отключение питания

В исходной конфигурации H618 v1.3.10 параметры shutdown_pin_state и shutdown_pin по умолчанию закомментированы, то есть обнаружение отключения питания не включено. Уровни срабатывания могут различаться для разных продуктов и версий оборудования. Заполняйте значения в соответствии с документацией "Отключение питания и продолжение печати" для соответствующего продукта, не копируйте значения с других устройств.

Взаимное исключение функций

Отключение питания и продолжение печати не могут быть включены одновременно. При необходимости продолжения печати держите обнаружение отключения питания выключенным.

Расширенная конфигурация

Параметр	Значение по умолчанию	Допустимые значения	Описание
spidev	spidev0.0	Комбинации SPI-устройств, явно указанные в документации продукта	Управление SPI-устройствами, предоставляемыми пространству пользователя Linux

Параметры spidev, overlays и другие используются для включения низкоуровневого аппаратного обеспечения. Если в руководствах по продукту нет явных требований, сохраняйте значения по умолчанию из образа и не изменяйте содержимое после ######### PLEASE DO NOT EDIT THE FOLLOWING #########.

Параметры конфигурации H3 / H5

Следующая конфигурация проверена в соответствии с FlyOS-Conf/config.txt в официальных образах H3 и H5 v1.3.10. Конфигурация служб двух платформ в основном идентична, но значения board, модели экранов и параметры нижележащего оборудования нельзя смешивать.

Беспроводная сеть

Параметр	Значение по умолчанию	Допустимые значения	Описание
WIFI_SSID	пусто	Имя Wi-Fi	После заполнения система попытается подключиться к этой сети при запуске
WIFI_PASS	пусто	Пароль Wi-Fi	Можно оставить пустым для открытой сети

Эти два параметра считываются при каждом запуске. Если имя или пароль содержат пробелы и специальные символы, следует сохранять формат с двойными кавычками из образа.

Настройки при первом запуске

Параметр	Значение по умолчанию	Допустимые значения	Описание
language	zh-CN	Коды языков, перечисленные в образе	Устанавливает начальный язык Fluidd и Mainsail
printer_name	пусто	Имя без специальных символов	Устанавливает начальное имя принтера
firmware	по умолчанию не включено	Путь к прошивке, указанный в документации продукта	Используется только если соответствующий продукт явно поддерживает прошивку при первом запуске

language, printer_name и firmware используются только в процессе первого запуска после записи полного образа. Не следует самостоятельно раскомментировать firmware или копировать пути к прошивкам других продуктов.

Платформа устройства и board

Платформа образа	Устройство	Значение конфигурации board
H5	FLY-Pi	fly-pi
H5	FLY-Pi V2	fly-pi-v2
H5	FLY-Gemini V1	fly-gemini-v1
H5	FLY-Gemini V2	fly-gemini-v2
H5	FLY-Gemini V3	fly-gemini-v3
H5	FLY-C8	fly-c8
H3	FLY-Lite2	fly-lite2
H3	FLY-Lite2.1	fly-lite2.1
H3	FLY-MiniPad	fly-minipad

Образ и устройство должны соответствовать друг другу

Образ H5 не может использовать board от H3, а образ H3 не может использовать board от H5. Скрипт запуска отклонит значения устройств, не принадлежащих текущей платформе. Перед первым запуском следует явно указать фактическое устройство и не полагаться на значения по умолчанию из образа.

Исходное значение по умолчанию в образе H5 v1.3.10 — board=fly-pi-v2, а в образе H3 v1.3.10 — board=fly-lite2.1. Значения по умолчанию можно оставить только если фактическое устройство точно соответствует этим моделям.

Система и связь

Параметр	Значение по умолчанию	Допустимые значения	Описание
localtime	Asia/Shanghai	Названия мировых часовых поясов	Системный часовой пояс, используемый после синхронизации времени с сетью
console	serial	serial, both	Режим системной консоли; оставлять по умолчанию без явной необходимости
printer	klipper	klipper, rrf	Выбор запуска среды печати Klipper или RRF
canbus_bitrate	1000000	1000000, 500000, 250000	Скорость CAN-шины системы, должна совпадать со всеми устройствами на шине

Тип экрана

Платформа образа	Допустимые значения screen
H5	none, hdmi, fly-tft-v1, fly-tft-v2-r, fly-tft-v2-c
H3	none, hdmi, fly-tft-v1, fly-minipad-r, fly-minipad-c, fly-tft-v2-r, fly-tft-v2-c

Параметр	Значение по умолчанию	Допустимые значения	Описание
screen	hdmi	Значения, поддерживаемые текущей платформой из таблицы выше	Выбор интерфейса отображения; none отключает локальный вывод изображения
rotate	auto	auto, 0, 90, 180, 270	При auto для HDMI по умолчанию используется 0 градусов, для TFT — 90 градусов
klipper_screen	0	0, 1	Включение KlipperScreen в режиме Klipper
fly_screen	0	0, 1	Включение FLY Screen в режиме Klipper
moon2uart	0	0, 1	Включение службы последовательного экрана Moon2UART
m2u_port	/dev/ttyS1	Путь к последовательному порту, указанный в документации продукта	Последовательный порт, используемый Moon2UART
m2u_baud	115200	Скорость, требуемая экраном	Скорость последовательного порта Moon2UART

Если одновременно заданы klipper_screen=1 и fly_screen=1, система сначала запускает KlipperScreen. Модель экрана, направление интерфейса и путь к последовательному порту следует определять в соответствии с документацией соответствующего продукта.

Веб-интерфейс и камера

Параметр	Значение по умолчанию	Допустимые значения	Описание
klipper_webui	fluidd	fluidd, mainsail	Веб-интерфейс, используемый по умолчанию в режиме Klipper
crowsnest	0	0, 1	Включение или отключение службы камеры Crowsnest

В официальных образах H3 и H5 v1.3.10 нет параметра gocam, не следует копировать настройки из тестового образа v1.4.0.

Отключение питания при выключении и расширенная конфигурация

shutdown_pin_state, shutdown_pin, spidev и overlays связаны с аппаратным обеспечением конкретного устройства. Их можно изменять только если в документации соответствующего продукта указаны явные значения. Не копируйте конфигурации с других плат, других версий аппаратного обеспечения или других чиповых платформ.

Отключение питания при выключении и продолжение печати после сбоя питания не могут быть включены одновременно. Если требуется продолжение печати после сбоя питания, следует отключить функцию отключения питания при выключении в соответствии с руководством соответствующего продукта.

Часто используемые комбинации функций

Цель	Ключевая конфигурация	Примечания
Только веб-интерфейс, без локального экрана	screen=none, klipper_screen=0, fly_screen=0	Последовательный экран Moon2UART можно включить независимо по мере необходимости
HDMI + KlipperScreen	screen=hdmi, klipper_screen=1, fly_screen=0	Параметр rotate задает направление отображения и сенсорного ввода
Использование FLY Screen	klipper_screen=0, fly_screen=1	В screen по-прежнему необходимо выбрать фактический интерфейс отображения
Использование Crowsnest	crowsnest=1	В тестовой версии v1.4.0 также следует сохранять gocam=0
Использование GoCam	crowsnest=0, gocam=1	Применимо только к тестовому образу v1.4.0; см. руководство
Использование Moon2UART	moon2uart=1	Одновременно проверьте m2u_port и m2u_baud
Использование CAN	Установите единый canbus_bitrate	Система, материнская плата и все CAN-узлы должны быть согласованы

Контрольный список после перезагрузки

Проверяемый пункт	Нормальный результат
Сеть	Веб-интерфейс открывается по IP-адресу устройства, local.klipper.cn или прямому адресу
Платформа устройства	Последовательный порт, SPI и встроенные функции соответствуют фактическому продукту
Служба печати	Запущена только выбранная среда — Klipper или RRF
Экран	Отображение, сенсорный ввод и направление поворота работают корректно
Камера	Запущен только выбранный сервис — Crowsnest или GoCam
CAN	Все узлы обнаруживаются, ошибок несоответствия скорости нет

Изменяйте только одну группу связанных параметров за раз. При возникновении неисправности сначала верните эту группу конфигурации. Не изменяйте одновременно board, экран, CAN и расширенные аппаратные параметры, чтобы можно было определить источник проблемы.