РУКОВОДСТВО ПО НАСТРОЙКЕ СИСТЕМЫ FLYOS-FAST

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

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

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

Пункт	Что нужно подтвердить
Системный образ	Платформа образа соответствует чипу устройства: H3, H5 или H618
Модель устройства	Используется для выбора правильного board
Среда печати	Используется Klipper или RRF
Локальный дисплей	Без экрана, HDMI, FLY-TFT, USB-экран, 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. После сохранения перезапустите и поэтапно подтвердите работу служб и аппаратных интерфейсов.

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

• Конфигурация Myprint
• Отредактируйте файл конфигурации напрямую.

Настройка системной карты с помощью Config Myprint

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

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

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

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

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

Loading...

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

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

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

Loading...

Сеть Wi-Fi

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

Loading...

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

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

Loading...

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

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

Loading...

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

Имя принтера

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

Loading...

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

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

Loading...

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

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

Loading...

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

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

Loading...

Шаг четвёртый: запись и проверка

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

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	Включение службы UVC-камеры GoCam

В официальной версии 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 всё ещё требует выбора фактического интерфейса дисплея
Использование USB-экрана	klipper_screen=1, fly_screen=0 или fly_screen=1, klipper_screen=0	Настройка screen= не требуется; требуется система версии v1.4.0 и выше
Использование 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 устройства или адрес прямого подключения 10.10.10.1 Открыть веб-страницу
Платформа устройства	Последовательный порт, SPI и встроенные функции соответствуют фактическому продукту
Служба печати	Klipper или RRF запускают только выбранную среду
Экран	Отображение, сенсорное управление и ориентация поворота в норме
Камера	Запускайте только одну из выбранных программ: Crowsnest или GoCam
CAN	Все узлы могут быть запрошены без ошибок о несоответствии скорости

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