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

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

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

我可以帮您翻译，但您没有提供需要翻译的 MDX 单行文本。请提供具体内容后我再进行翻译。

Проект	Что необходимо подтвердить
Системный образ	Образ платформы соответствует чипу устройства: 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. После сохранения перезапустите и поэтапно подтвердите работу служб и аппаратных интерфейсов.

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

• Конфигурация 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 устройства или адрес прямого подключения 10.10.10.1 Открыть веб-страницу
Платформа устройства	Последовательный порт, SPI и встроенные функции соответствуют фактическому продукту
Служба печати	Klipper или RRF запускают только выбранную среду
Экран	Отображение, сенсорное управление и ориентация поворота в норме
Камера	Запускайте только одну из выбранных программ: Crowsnest или GoCam
CAN	Все узлы могут быть запрошены без ошибок о несоответствии скорости

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