USB를 통해 CAN 펌웨어 프로그래밍

컴파일 시작

• 설치된 klipper 서비스를 사용해야 합니다. 웹을 통해 SSH 연결
• 그리고 장치를 상위 기계에 연결해야 합니다.
• 주의: 일반적인 상위 기계, 예를 들어 라즈베리파이 FLY파이 등을 사용하십시오. 마이크로 변형 상위 기계(예: WiFi 스틱, 홍미 등)는 문제점이 많아 지원을 제공할 수 없습니다.

FlyOS-Armbian 시스템과 일반 시스템 주의사항

경고

• FlyOS-Armbian 시스템과 일반 시스템 주의사항
  • 라즈베리파이, FLY파이 등 일반적인 상위 기계 시스템은 이와 같습니다.
  • 이 종류의 상위 기계에서는 ROOT 사용자로 아무 작업도 하지 마십시오.
  • 일반 사용자로 작업하십시오.
  • 사용자 전환 방법, FlyOS-Armbian 시스템의 경우 su fly 명령어를 사용하여 일반 사용자로 전환하십시오.
  • 다른 시스템의 경우 su <상위 기계 사용자 이름> 명령어를 사용하여 일반 사용자로 전환하십시오.

  su <상위 기계 사용자 이름>

FlyOS-FAST 시스템 주의사항

경고

• FlyOS-FAST 시스템 주의사항
  • FAST 시스템의 기본 사용자는 root이며, 비밀번호는 mellow입니다.
  • 펌웨어를 컴파일하는 것은 root 사용자만이 수행할 수 있습니다.
  • 또한 FAST 시스템에는 ROOT 사용자만 존재하며, 사용자를 전환할 필요가 없습니다！！！

팁

• 상위기기(Up Host)가 정상적으로 네트워크에 연결되어 있는지 확인하세요.
• 펌웨어 컴파일 전에 SSH를 통해 상위기기에 네트워크로 로그인해야 합니다.
• 상위기기에 시리얼 포트(Serial Tool)를 사용하지 마세요.

Klipper 펌웨어 컴파일 및 구성 페이지 작동 설명

팁

키보드 입력 모드를 반각(Half-width) 모드로 설정해 주세요. 즉, 영문 모드입니다.

1. 키보드의 ↑(위쪽 화살표), ↓(아래쪽 화살표)는 메뉴 항목을 선택하기 위해 커서를 위아래로 이동시킵니다.
2. 확인 키 Enter 또는 공백 키 Space는 메뉴를 선택하거나 하위 메뉴로 진입합니다.
3. 종료 키 ESC는 상위 메뉴로 돌아갑니다.
4. Q 키는 Klipper 펌웨어 구성 페이지를 종료합니다.
5. Klipper 펌웨어 구성 페이지를 종료할 때 Y 키를 눌러 구성 파일을 저장할 수 있습니다.

경고

구성 페이지 옵션이 적을 경우, Enable extra low-level configuration options 항목을 선택([ ])하여 일부 숨겨진 옵션을 표시할 수 있습니다.

아래는 펌웨어를 컴파일하는 방법입니다:

• SSH에 접속한 후 아래의 명령어를 입력하고 엔터를 누릅니다:

  cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

• 여기서 rm -rf ~/klipper/.config && rm -rf ~/klipper/out은 이전에 컴파일된 데이터와 펌웨어를 삭제하고, make menuconfig는 펌웨어를 컴파일합니다. 실행 후 아래와 같은 화면이 나타나야 합니다.

  

• Enable extra low-level configuration options를 선택하고 엔터를 누릅니다.

  

• 메뉴 Micro-controller Architecture로 들어간 다음 STMicroelectronics STM32를 선택하고 엔터를 누릅니다.

  

• 메뉴 Processor model으로 들어가서 STM32H723를 선택하고 엔터를 누릅니다.

  

• Bootloader offset를 선택하고 128KiB bootloader를 선택합니다.

  

• **Clock Reference (8 MHz crystal)**를 선택하고 25 MHz crystal를 선택합니다.

  

• Communication interface를 선택하고 **USB to CAN bus bridge (USB on PA11/PA12)**를 선택합니다.

  

• Q 키를 누르면 Save configuration가 나타나며, 그 후 Y 키를 누릅니다.
  
• 이제 설정을 저장하고 명령줄 인터페이스로 나와야 합니다.
• 아래 명령어를 입력하여 컴파일을 시작합니다. 시간이 조금 걸립니다.

make -j4

• 마지막으로 다음 내용이 출력되면 컴파일이 성공입니다.

  Linking out/klipper.elf
  Creating hex file out/klipper.bin

프로그래밍 모드에 진입했는지 확인하기

• TypeC 데이터 케이블로 메인보드를 상위 기기에 연결한 후, reset 버튼을 두 번 누르세요. 이때 메인보드의 LED가 깜빡입니다.

경고

• LED가 깜빡이지 않는 경우, 다시 katapult 펌웨어를 프로그래밍하세요:katapult 펌웨어 프로그래밍
• katapult 펌웨어를 프로그래밍한 후에도 LED가 깜빡이지 않는 경우, 다음 단계로 진행하지 마세요

장치 검색

• 이제 상위 컴퓨터에 정상적으로 로그인한 상태라면 lsusb 명령어를 입력하여 장치를 검색할 수 있습니다. 다음과 같은 경우 중 하나가 발생할 수 있습니다.
  • lsusb 입력 시 ls 명령어를 찾을 수 없다는 메시지가 나오면, 아래 명령어를 입력하여 설치할 수 있습니다.

    sudo apt-get install usbutils

  • lsusb 입력 후 아무 반응이 없는 경우, 이는 시스템 문제로 해결이 불가능하므로 다른 정상적인 시스템으로 교체해야 합니다.
  • 아래 사진과 같은 정보가 나타납니다. 참고용이므로, 1d50:606f가 표시되는지만 확인하시면 됩니다.
    
• 1d50:606f는 이번에 사용할 장치입니다.
• 여러 개의 1d50:606f가 나타난다면, 하나를 제외하고는 제거해야 합니다. 그렇지 않으면 향후 플래싱 및 펌웨어 연결에 영향을 줄 수 있습니다. 예를 들어 FLY MINI PAD의 경우, 외부 CAN 브리지 장치가 아닌 내장된 UTOC를 사용하는 것이 좋습니다.
• 만약 나타나지 않았다면, 케이블 연결 상태와 펌웨어가 올바르게 작성되었는지 스스로 확인하십시오.

참고 사항

1d50:606f가 나타날 경우에만 CAN ID 검색을 진행해야 합니다.

펌웨어 프로그래밍

팁

• 플래시 플러그인 설치 시 인터넷 연결이 필요하므로 호스트 머신이 인터넷에 정상적으로 연결되어 있는지 확인하십시오.
• 이미 설치한 경우 다시 설치할 필요가 없습니다.

플래싱 시작

경고

• fly 호스트 머신이 아닌 경우 아래 코드를 꼭 실행하여 펌웨어 플래싱에 필요한 종속 패키지를 설치하십시오. 설치하지 않으면 펌웨어를 플래싱할 수 없습니다!

  기본 저장소

  cd && git clone https://github.com/Arksine/katapult.git

  국내 저장소

  cd && git clone https://gitee.com/MrCakeFuck/katapult.git

  

• 아래 명령어를 사용하여 장치 ID를 검색하십시오. 아래 그림과 같은 ID가 나타나야 합니다(참고: 그림의 ID는 예시이며, 각 보드의 ID는 다릅니다).

  ls /dev/serial/by-id/*

  

• 아래 코드를 사용하여 펌웨어를 플래싱하십시오. 펌웨어가 이미 컴파일되어 있는지 확인하십시오. <你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.

Fly-Armbian 및 일반 호스트 머신 플래싱 방법

~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<你的主板ID>

Fly-FAST 플래싱 방법

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<你的主板ID>

• 참고 자료:

  

• 플래싱 완료 후 참고:

  

펌웨어 업데이트

USB 펌웨어 업데이트

• 아래 명령어를 사용하여 보드 ID를 검색하십시오. 아래 그림과 같은 ID가 나타나야 합니다(참고: 그림의 ID는 예시이며, 각 보드의 ID는 다릅니다).

  ls /dev/serial/by-id/*

참고

아래 그림의 /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00은 보드 ID입니다.

• USB 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어로 업데이트하십시오. <你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.

  cd ~/klipper/ && make flash FLASH_DEVICE=<你的主板ID>

  

CAN 펌웨어 브리지 업데이트

• USB 브리지 CAN 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어로 Katapult에 재설정하십시오(아래 그림 참조. 그림의 ID는 예시이며, 실제 ID는 설정 파일에 따라 다릅니다).

참고

• <CANBUS UUID>는 printer.cfg 설정 파일에 있는 보드의 CANBUS UUID입니다.

Fly-Armbian 및 일반 호스트 머신 재설정 방법

• <你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.

  ~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>

Fly-FAST 재설정 방법

• <你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.

  python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>

참고

• 아래 그림의 f95cee90e1f9는 보드의 CANBUS UUID입니다.

• Katapult에 재설정된 후 아래 명령어로 보드 ID를 검색하십시오. 아래 그림과 같은 ID가 나타나야 합니다(참고: 그림의 ID는 예시이며, 각 보드의 ID는 다릅니다).

  ls /dev/serial/by-id/*

참고

아래 그림의 /dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00은 보드 ID입니다.

• 새 펌웨어 컴파일이 완료된 후 플래싱을 실행하십시오. <你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.

  cd ~/klipper/ && make flash FLASH_DEVICE=<你的主板ID>

  

잘못된 펌웨어 플래싱 시 해결 방법

• 보드의 전원을 끄고 다시 켠 후 빠르게 리셋 버튼을 두 번 클릭하면 플래싱 모드로 다시 진입할 수 있습니다.
• 또는 Windows/호스트 머신을 사용하여 katapult 펌웨어를 다시 플래싱하십시오. katapult 펌웨어 플래싱