사용 설명
본 가이드는 라즈베리파이 시스템에서 moon2uart를 설치하고 설정하여 Nova 3.5 직렬 터치 스크린이 Klipper 호스트 컴퓨터와 UART 통신을 할 수 있도록 안내합니다.
| 항목 | 설명 |
|---|---|
| 참고 시스템 | Raspberry Pi OS with Desktop |
| 참고 버전 | Debian GNU/Linux 12 (bookworm) |
| 사전 조건 | Klipper 및 Moonraker가 설치되어 있으며, 브라우저로 Mainsail 또는 Fluidd에 접근 가능해야 함 |
| 작업 방식 | 먼저 SSH로 라즈베리파이에 로그인해야 함 |
시작하기 전에 먼저 시스템 버전을 확인하세요:
cat /etc/os-release
출력에 PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"와 유사한 내용이 포함되어 있다면, 시스템 버전이 본 가이드와 일치합니다.
다른 Linux 호스트 시스템을 사용하는 경우에도 본 가이드를 참조할 수 있으나, 파일 경로, 직렬 포트 이름 또는 서비스 관리 방식이 다를 수 있으므로 실제 시스템에 맞게 조정해야 합니다.
배선 설명
시작하기 전에 프린터를 완전히 끄고 전원 공급을 차단하세요. 전원이 켜진 상태에서 케이블을 연결하거나 분리하지 말고, 단자 핀 배열을 정리하거나 접촉하지 마십시오.
Nova 3.5는 UART 직렬 통신을 사용하며, 배선 시 5V, GND, TX, RX를 연결해야 합니다. 자세한 배선도는 준비 중입니다. 배선이 완료되면 아래의 소프트웨어 설정을 계속 진행하세요.
구성 요소 설치
SSH에서 아래 명령어를 실행하여 자동으로 moon2uart를 설치합니다:
curl -sSL https://cnb.cool/3dmellow/public/Moon2Uart/-/git/raw/master/scripts/install.sh | sudo bash
시스템 직렬 포트 설정 편집
1단계: 라즈베리파이 UART 활성화
/boot/firmware/config.txt 파일을 엽니다:
sudo nano /boot/firmware/config.txt
파일 끝에 다음 내용을 추가합니다:
enable_uart=1
dtoverlay=miniuart-bt
force_turbo=1
dtoverlay=uart0
추가가 완료되면 Ctrl + S를 눌러 저장하고, Ctrl + X를 눌러 편집기를 종료합니다.
2단계: 시스템 직렬 콘솔 비활성화
/boot/firmware/cmdline.txt 파일을 엽니다:
sudo nano /boot/firmware/cmdline.txt
파일에 console=serial0,115200가 있다면 이 부분을 삭제하여 시스템 콘솔이 직렬 포트를 점유하지 않도록 합니다.
수정이 완료되면 Ctrl + S를 눌러 저장하고, Ctrl + X를 눌러 편집기를 종료합니다.
3단계: 로그 파일 권한 조정
SSH에서 아래 명령어를 실행합니다:
sudo chmod 777 /home/pi/printer_data/logs/moon2uart.log
명령어에 출력이 없으면 일반적으로 성공적으로 실행된 것입니다. 시스템 사용자가 pi가 아닌 경우 /home/pi/printer_data를 실제 printer_data 경로로 변경하세요.
4단계: moon2uart 설정 수정
브라우저를 통해 Klipper 웹 인터페이스(예: Mainsail 또는 Fluidd)를 열고 moon2uart.conf 파일을 엽니다.
SERIAL_PORT= 설정 항목을 찾아 직렬 포트 주소를 다음과 같이 변경합니다:
SERIAL_PORT="/dev/ttyAMA0"
동시에 PRINTER_DATA_PATH가 현재 시스템의 실제 printer_data 경로인지 확인합니다. 예:
PRINTER_DATA_PATH="/home/pi/printer_data"
라즈베리파이의 UART 장치 이름은 시스템 버전, 하드웨어 모델 또는 시스템 설정에 따라 달라질 수 있습니다. /dev/ttyAMA0를 사용할 수 없는 경우 /dev/ttyS0를 시도하거나 실제 시스템의 직렬 포트 장치 이름에 따라 수정하세요.
다른 호스트 시스템의 경우 해당 시스템의 직렬 포트 이름을 사용하세요. 예를 들어 FLY 호스트는 일반적으로 /dev/ttyS0를 사용합니다.
수정이 완료되면 오른쪽 상단의 SAVE를 클릭하여 설정을 저장합니다.
5단계: 라즈베리파이 재부팅
설정을 저장한 후, 라즈베리파이를 재부팅하여 시스템 직렬 포트 설정을 적용합니다:
sudo reboot