USB 인쇄 기능 사용 가이드
FLYOS-FAST는 USB 드라이브를 자동으로 마운트하며, 웹 파일 관리자 또는 본체 화면에서 G-code를 탐색하고 인쇄할 수 있습니다. 본 문서는 H3, H5, H618의 v1.3.10 이미지와 H618 v1.4.0 이미지를 기준으로 확인되었습니다.
작동 원리
USB 드라이브 파티션은 U_로 시작하는 폴더로 G-code 디렉터리에 마운트됩니다. 인쇄를 시작하면 시스템이 먼저 전체 파일을 로컬로 복사합니다:
/usr/share/printer_data/gcodes/.UDISK/tmp.gcode
복사가 완료된 후에야 Klipper가 해당 임시 파일에서 인쇄를 실행하며, 다음 USB 인쇄 시 이 파일을 덮어씁니다.
웹페이지에 "인쇄 중"이 표시된다고 해서 파일 복사가 완료된 것은 아닙니다. 콘솔에 Copy files from removable disk completed가 나타나거나 프린터가 이미 가열·이동을 시작한 후에 분리하세요. 복사 중에 드라이브를 분리하면 이번 인쇄가 시작되지 않습니다.
파일 요구 사항
| 항목 | 지원 범위 | 권장 사항 |
|---|---|---|
| 파일 시스템 | FAT32, exFAT, NTFS | FAT32 또는 exFAT 우선 |
| 파일 형식 | .gcode, .g, .gco | .gcode 우선 |
| 파일 위치 | 루트 디렉터리 또는 다단계 폴더 | 모델별로 분류하여 저장 |
| 파일 이름 | UTF-8, 공백 및 중국어 지원 | 짧게 작성하여 크로스 플랫폼 호환 권장 |
.stl, .obj 등의 모델 파일이나 슬라이싱 프로젝트 파일은 지원하지 않으며, 슬라이싱 소프트웨어를 사용하여 G-code를 먼저 내보내야 합니다.
본 기능은 USB 3.0을 지원하지 않습니다. USB 드라이브를 USB 2.0 포트에 연결하고, USB 3.0 USB 드라이브도 사용하지 마십시오. 3.0 사용 시 전송 속도가 매우 느려져 복사 대기 시간이 현저히 길어집니다.
파일 탐색기에서 파일 확장명을 체크하여 확장자가 실제로 .gcode, .g 또는 .gco인지 확인하고, 모델.gcode.txt와 같은 형태가 되지 않도록 하십시오.
사용 단계
- 슬라이싱으로 생성된 G-code를 USB 드라이브에 복사합니다.
- USB 드라이브를 상위 컴퓨터의 USB 포트에 삽입합니다.
- Fluidd, Mainsail 또는 본체 화면의 파일 목록을 열고
U_로 시작하는 폴더를 찾습니다. 즉시 나타나지 않으면 목록을 새로고침합니다. - 해당 폴더에 들어가 G-code 파일을 선택하고 미리보기 정보를 확인한 후 "인쇄 시작"을 한 번만 클릭합니다.
- 콘솔에 복사 완료 안내가 표시될 때까지 기다리면 시스템이 이어서 자동으로 인쇄를 시작합니다.
복사 중에는 "인쇄 시작"을 반복해서 클릭하지 말고 두 번째 USB 드라이브 파일을 선택하지도 마십시오. 모든 USB 드라이브 인쇄는 동일한 tmp.gcode를 공유하므로 동시 복사 시 서로 덮어쓰게 됩니다.
디스크 제거 및 제한 사항
- 복사가 완료된 것을 확인한 후 USB 드라이브를 제거할 수 있으며, 프린트는 계속해서 로컬 임시 파일을 읽습니다. 콘솔에 여전히
Copying file이 표시될 때는 제거하지 마십시오. - 복사 진행 표시가 전혀 없을 때는 드라이브를 제거하지 마십시오. 일부 USB 하드 드라이브 인클로저나 SSD는 이동식 장치로 인식되지 않을 수 있으며, Klipper가 외부 파일을 직접 읽습니다.
- 웹 페이지에서 USB 드라이브에 업로드, 삭제 또는 이름 변경 작업을 수행 중일 때는 작업이 완료될 때까지 기다린 후 제거하십시오.
- 파티션 테이블이 없는 USB 드라이브는 표시되지 않을 수 있으며, 다시 파티션을 나누고 포맷할 수 있습니다. 제조사, 모델, 용량 및 파티션 구조가 완전히 동일한 두 개의 USB 드라이브는 동일한 디렉토리에 마운트되어 충돌할 수 있습니다.
- 자동 인식은 일반적인 단일 숫자 파티션(예:
/dev/sda1)만 지원하며, 특수한 다중 파티션 장치는 마운트가 완전하지 않을 수 있습니다. - 파일이 클수록 프린트 시작 전 복사 대기 시간이 길어지며, 상위 컴퓨터의 로컬 남은 공간에 의존합니다.
자주 묻는 질문
파일은 보이지만 인쇄를 시작할 수 없음
확장자가 .gcode, .g 또는 .gco인지 확인하고, 파일이 슬라이서 소프트웨어에서 정상적으로 미리보기되는지 확인하세요. 로컬 남은 공간을 확인하세요:
df -h /usr/share/printer_data/gcodes
그런 다음 Klipper 로그에서 복사 또는 열기 오류를 확인하세요:
tail -n 100 /usr/share/printer_data/logs/klippy.log
웹 업로드는 인쇄 가능하지만 USB는 안 됨
일부 슬라이서 소프트웨어는 GBK, ANSI로 중국어 주석을 저장하는데, USB 파일은 먼저 .UDISK/tmp.gcode로 복사된 후 엄격하게 UTF-8로 읽히므로 UTF-8이 아닌 바이트를 만나면 오류가 발생할 수 있습니다:
UnicodeDecodeError: 'utf-8' codec can't decode byte
중국어 파일명은 보통 원인이 아니며, 영어로 변경해도 파일 내부 인코딩은 바뀌지 않습니다. 다음 중 하나의 방법으로 처리하세요:
- 슬라이서 소프트웨어에서 다시 내보내기하고 인코딩을 UTF-8로 설정하세요.
- 인코딩 변환을 지원하는 편집기로 전체 파일을 UTF-8로 저장하세요. 확장자만 변경하지 마세요.
- 인코딩을 선택할 수 없는 경우, 파일 헤더의 비UTF-8 중국어 주석을 삭제한 후 저장하세요. 운동, 온도 및 압출 명령은 변경하지 마세요.
- 임시로 웹에서 로컬 G-code 디렉토리로 업로드한 후 인쇄할 수 있습니다.
복사 실패 후 계속 "인쇄 중"으로 표시됨
프린터가 가열이나 운동을 실행하고 있지 않은지 확인한 후 Klipper를 재시작하세요:
systemctl restart klipper
USB를 다시 삽입하고 재시도하세요. 반복적으로 발생하면 USB를 교체하고 기술 지원에 다음 두 로그를 제공하세요:
/var/log/flyos-auto-mount.log
/usr/share/printer_data/logs/klippy.log