시스템 구성 가이드

이 가이드는 FlyOS-Fast 시스템의 기본 구성을 안내하여 빠르게 시작하고 사용 경험을 최적화하는 데 도움을 드립니다.

구성 방법

Config Myprint 소프트웨어를 통한 시스템 구성
브라우저를 통한 시스템 구성

Config Myprint으로 시스템 카드 설정하기

Config Myprint는 최초 부팅 전에 시스템 카드를 그래픽으로 설정하기에 적합합니다. 플래싱이 완료된 시스템 카드를 컴퓨터에 연결하고, 소프트웨어를 실행한 후 FlyOS-Conf 파티션을 인식할 때까지 기다립니다.

소프트웨어 인터페이스와 이미지 버전

소프트웨어에서 제공되는 옵션은 테스트 이미지보다 늦게 업데이트될 수 있습니다. 쓰기가 완료된 후에는 FlyOS-Conf/config.txt를 열어 board, 화면, 카메라 및 CAN 속도가 실제 장치와 일치하는지 확인해야 합니다. 소프트웨어에 표시되지 않는 새 구성 항목은 직접 추가해야 하며, 유사한 이름으로 대체하지 마십시오.

1단계: 시스템 구성 활성화

시스템 구성 활성화 스위치를 켭니다.

2단계: 기본 설정 완료

구성 파일 관리

프린터 구성 파일이 있는 폴더만 선택하고, 개별 파일은 선택하지 마십시오.
소프트웨어는 선택한 폴더의 구성을 시스템 카드에 복사하고, 최초 부팅 시 로드합니다.
쓰기 전에 폴더에 다른 프린터에서 남은 printer.cfg 또는 중복 구성이 없는지 확인하십시오.

Wi-Fi 네트워크

사용 가능한 Wi-Fi 이름과 비밀번호를 입력합니다. 유선 네트워크를 사용하거나 나중에 Wi-Fi를 설정할 예정이면 비워 둘 수 있습니다.

Klipper 웹 인터페이스

Fluidd 또는 Mainsail을 선택합니다. 이 옵션은 Klipper 모드에서 기본적으로 사용되는 웹 인터페이스에만 영향을 줍니다.

로컬 디스플레이

실제 연결된 디스플레이 인터페이스를 선택한 후, KlipperScreen 또는 FLY Screen을 활성화할지 결정합니다. 두 항목을 동시에 켜면 시스템은 KlipperScreen을 우선적으로 시작합니다. FLY Screen을 사용할 때는 KlipperScreen을 꺼야 합니다.

3단계: 고급 설정 완료

프린터 이름

식별하기 쉬운 프린터 이름을 설정합니다. 영문 알파벳, 숫자, 하이픈 및 밑줄만 사용하는 것이 좋습니다.

카메라 서비스

필요에 따라 Crowsnest를 활성화합니다. v1.4.0 베타 이미지에서 GoCam을 사용하려면 쓰기 완료 후 config.txt에서 crowsnest=0, gocam=1인지 확인해야 합니다. 두 서비스를 동시에 활성화하지 마십시오.

언어 및 시간대

시스템 초기 언어와 실제 시간대를 선택합니다. 시스템이 네트워크에 연결된 후 이 시간대에 따라 시간이 표시됩니다.

CAN 통신 속도

메인보드 및 모든 CAN 툴보드 펌웨어와 일치하는 속도를 선택합니다. 일반적인 값은 1000000, 500000 또는 250000이며, 동일한 CAN 버스에서 서로 다른 속도를 혼용할 수 없습니다.

4단계: 쓰기 및 확인

모든 설정을 완료한 후 수동으로 구성 쓰기를 클릭합니다. 인터페이스에서 옵션을 선택만 하고 쓰기를 클릭하지 않으면 구성이 시스템 카드에 저장되지 않습니다.

쓰기가 완료된 후 다음 사항을 확인합니다:

FlyOS-Conf/config.txt를 엽니다.
board가 실제 장치와 완전히 일치하는지 확인합니다.
필요한 화면 UI 및 카메라 서비스만 활성화되었는지 확인합니다.
canbus_bitrate가 모든 CAN 장치 펌웨어와 일치하는지 확인합니다.
저장 후 시스템 카드를 안전하게 꺼낸 다음 대상 장치에 삽입하여 부팅합니다.

주의 사항

브라우저로 시스템을 구성할 때, 구성 인터페이스에 원활하게 접근할 수 있도록 장치가 동일한 네트워크에 연결되어 있는지 확인하세요.
SSH 연결 상위 기기 튜토리얼에 따라 시스템 카드를 설치하고 시스템을 시작한 후, 브라우저를 통해 시스템 IP 주소에 접속하여 구성을 진행해야 합니다.

설정 파일 수정

FLYOS-FAST의 시스템 설정 파일은 위치에 따라 다른 이름으로 표시되지만, 실제로는 동일한 설정을 가리킵니다:

사용 시나리오	파일 위치	적용 상황
시스템 카드를 PC에 연결	`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 ######### 이후의 내용은 수정하지 마세요.

최초 부팅 전 시스템 카드 수정
시스템 부팅 후 웹 페이지로 수정

이미지 플래싱 완료 후 시스템 카드를 PC에 다시 연결합니다.
FlyOS-Conf라는 이동식 디스크를 엽니다.
순수 텍스트 편집기로 config.txt를 엽니다.
실제 장치에 맞게 board를 수정한 후 Wi-Fi, 인쇄 모드, 화면 및 CAN 속도를 설정합니다.
파일을 저장하고 시스템 카드를 안전하게 제거한 후 장치에 삽입하여 부팅합니다.

최초 부팅 항목

language, printer_name 및 firmware와 같은 초기화 항목은 여기에서 수정해야 합니다. 시스템이 이미 최초 부팅을 완료한 후에는 이러한 값을 편집해도 초기화 프로세스가 다시 실행되지 않습니다.

PC와 호스트 컴퓨터가 동일한 네트워크에 연결되어 있는지 확인합니다.
브라우저에서 장치 IP 주소(예: http://192.168.1.2/)를 엽니다.
Fluidd에서 "숨김 파일 및 폴더 필터링" 체크를 해제하거나 Mainsail에서 "숨김 파일 표시"를 체크합니다.

.flyos-config 폴더에서 sys-config.conf를 엽니다.

필요한 설정 항목을 수정하고 저장합니다.

호스트 컴퓨터를 완전히 다시 시작하여 시스템 서비스와 하드웨어 설정이 다시 로드되도록 합니다.

웹 페이지 수정 제한

웹 페이지 방식은 매번 부팅 시 읽는 설정을 수정하는 데 적합합니다. 최초 부팅 시점을 놓친 초기화 항목은 단순히 재부팅만으로는 다시 실행할 수 없습니다. 해당 기능의 자체 수정 방법을 사용하세요.

저장 후 확인

재부팅 후 최소한 다음 항목을 확인하세요:

웹 페이지가 정상적으로 열리고 인쇄 모드와 웹 인터페이스 선택이 올바른지 확인합니다.
로컬 화면, 터치 방향 및 화면 UI가 정상인지 확인합니다.
카메라, Moon2UART 등 선택 서비스 중 필요한 항목만 하나만 실행되었는지 확인합니다.
CAN을 사용하는 경우 시스템 속도가 메인보드, 툴보드 펌웨어 속도와 완전히 일치하는지 확인합니다.
Klipper 또는 RRF가 해당 제어 보드에 정상적으로 연결될 수 있는지 확인합니다.

수정 후 시스템이 정상적으로 부팅되지 않으면 시스템 카드를 PC에 연결하고 수정 전의 config.txt를 복원한 다음 항목별로 수정하고 검증하세요.

H618 구성 항목

다음 기본값 및 선택 가능한 값은 H618 v1.3.10 정식 이미지의 FlyOS-Conf/config.txt를 기준으로 확인했습니다. 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는 최초 시작 시 `board`에 따라 보드 MCU를 자동으로 플래싱할 수 있으며, Pi V3는 이 항목으로 외부 메인보드를 플래싱하지 않습니다

자동 플래싱 조건

자동 플래싱은 최초 시작 표시가 존재하고, board 및 firmware가 모두 유효하며 펌웨어 파일이 존재할 때만 실행됩니다. 반복 플래싱을 위해 최초 시작 표시를 수동으로 생성하지 마십시오. 이후 펌웨어 유지보수는 해당 메인보드의 펌웨어 플래싱 튜토리얼을 사용하십시오.

시스템 및 메인보드

다음 설정은 매 부팅 시 읽습니다.

구성 항목	기본값	선택 가능한 값	설명
`board`	`none`	`fly-c5`, `fly-c5-v1.1`, `fly-c8p`, `fly-pi-v3`	실제 장치 모델을 선택합니다. 이 값은 H618의 시리얼 포트 및 SPI 주변 장치 구성에 영향을 줍니다
`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 사용자는 최초 시작 전에 자신의 장치 모델을 명확히 선택해야 하며, 대체 값을 의존하지 마십시오.

다른 board 값에 따라 활성화되는 H618 주변 장치는 다음과 같습니다. 이 표는 잘못된 선택의 영향을 설명하기 위한 것일 뿐이며, 이러한 시리얼 포트나 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`	Klipper 모드에서 KlipperScreen을 활성화합니다
`fly_screen`	`0`	`0`, `1`	Klipper 모드에서 FLY Screen을 활성화합니다
`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 장치 조합	Linux 사용자 공간에 제공되는 SPI 장치를 제어합니다

spidev, overlays 등의 항목은 하위 레벨 하드웨어 활성화에 사용됩니다. 제품 튜토리얼에서 명확히 요구하지 않으면 이미지 기본값을 유지하고, ######### PLEASE DO NOT EDIT THE FOLLOWING ######### 이후의 내용은 수정하지 마십시오.

구성 방법​

Config Myprint으로 시스템 카드 설정하기​

1단계: 시스템 구성 활성화​

2단계: 기본 설정 완료​

구성 파일 관리​

Wi-Fi 네트워크​

Klipper 웹 인터페이스​

로컬 디스플레이​

3단계: 고급 설정 완료​

프린터 이름​

카메라 서비스​

언어 및 시간대​

CAN 통신 속도​

4단계: 쓰기 및 확인​

설정 파일 수정​

저장 후 확인​

H618 구성 항목​

무선 네트워크​

최초 시작 설정​

시스템 및 메인보드​

화면 및 인터페이스​

Klipper 웹 인터페이스 및 카메라​

전원 차단 종료​

고급 구성​