시스템 구성 가이드
- 이 가이드는 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에서 "숨김 파일 표시"를 체크합니다.
Loading... | Loading... |
.flyos-config폴더에서sys-config.conf를 엽니다.
- 필요한 설정 항목을 수정하고 저장합니다.
- 호스트 컴퓨터를 완전히 다시 시작하여 시스템 서비스와 하드웨어 설정이 다시 로드되도록 합니다.
웹 페이지 방식은 매번 부팅 시 읽는 설정을 수정하는 데 적합합니다. 최초 부팅 시점을 놓친 초기화 항목은 단순히 재부팅만으로는 다시 실행할 수 없습니다. 해당 기능의 자체 수정 방법을 사용하세요.
저장 후 확인
재부팅 후 최소한 다음 항목을 확인하세요:
- 웹 페이지가 정상적으로 열리고 인쇄 모드와 웹 인터페이스 선택이 올바른지 확인합니다.
- 로컬 화면, 터치 방향 및 화면 UI가 정상인지 확인합니다.
- 카메라, Moon2UART 등 선택 서비스 중 필요한 항목만 하나만 실행되었는지 확인합니다.
- CAN을 사용하는 경우 시스템 속도가 메인보드, 툴보드 펌웨어 속도와 완전히 일치하는지 확인합니다.
- Klipper 또는 RRF가 해당 제어 보드에 정상적으로 연결될 수 있는지 확인합니다.
수정 후 시스템이 정상적으로 부팅되지 않으면 시스템 카드를 PC에 연결하고 수정 전의 config.txt를 복원한 다음 항목별로 수정하고 검증하세요.
H3 / H5 설정 항목
아래 설정은 H3, H5 v1.3.10 공식 이미지의 FlyOS-Conf/config.txt를 기준으로 확인되었습니다. 두 플랫폼의 서비스 구성은 기본적으로 동일하지만, 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 이미지는 H3의 board를 사용할 수 없으며, H3 이미지도 H5의 board를 사용할 수 없습니다. 시작 스크립트는 현재 플랫폼에 속하지 않는 장치 값을 거부합니다. 최초 시작 전에 실제 장치를 명확히 입력하고 이미지 기본값에 의존하지 마십시오.
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 | 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을 우선 시작합니다. 화면 모델, 인터페이스 방향 및 시리얼 경로는 해당 제품 문서를 기준으로 해야 합니다.
웹 및 카메라
| 설정 항목 | 기본값 | 선택 가능한 값 | 설명 |
|---|---|---|---|
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는 특정 장치 하드웨어와 관련이 있습니다. 해당 제품 문서에 명확한 값이 제공된 경우에만 수정할 수 있으며, 다른 메인보드, 다른 하드웨어 버전 또는 다른 칩 플랫폼의 구성을 복사하지 마십시오.
전원 차단 종료와 전원 차단 후 인쇄 재개는 동시에 활성화할 수 없습니다. 전원 차단 후 인쇄 재개가 필요한 경우 해당 제품 튜토리얼에 따라 전원 차단 종료 감지를 꺼야 합니다.