CAN 펌웨어 컴파일

빌드 시작

klipper 서비스가 설치된 상위기기를 사용해야 합니다. 네트워크를 통해 SSH 연결하기
그리고 장치를 상위기에 잘 연결해야 합니다.
주의: 일반적인 상위기기를 사용하십시오. 예를 들어 라즈베리 파이 FLY 패 등입니다. WiFi 스틱, 홍미폰 등의 모modified 상위기는 지원 문제가 많아 기술 지원을 제공할 수 없습니다.

경고

ROOT 사용자를 일반 사용자로 전환하려면 아래 명령어를 입력할 수 있습니다.
ROOT 사용자는 사용하지 마십시오.
fly 사용자는 다음을 입력할 수 있습니다: su fly. fly 사용자가 아닌 경우 <상위기기 사용자 이름>을 상위기기의 사용자 이름으로 바꾸십시오!

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

팁

请确保上位机可以正常联网
固件编译前需要使用SSH通过网络登录上位机
请不要使用串口工具登录上位机

Klipper固件编译和配置页面操作说明

팁

请确保键盘输入法为半角模式，即英文模式

键盘上键↑，下键↓，用于上下移动光标来选中菜单项
确认键Enter 或空格键Space，用于勾选菜单或进入子菜单
退出键ESC，用于返回上一级菜单
Q键，用于退出Klipper固件配置页面
Y键，在退出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로 들어간 후 Raspberry Pi RP2040를 선택하고 엔터를 누릅니다.
Bootloader offset를 선택하고 16KiB bootloader를 선택합니다.
Communication interface를 선택하고 CAN bus를 선택합니다.

마이크로컨트롤러 시작 시 설정할 GPIO 핀을 선택, 입력: !gpio20 (주의: !는 대문자입니다)
Q 키를 누르면 Save configuration이 나타나고, 이 때 다시 Y 키를 누릅니다.
이제 구성이 저장되고 명령줄 인터페이스로 돌아왔습니다.
make -j4를 입력하여 빌드를 시작합니다. 시간이 좀 걸립니다.
마지막으로 아래의 내용이 출력되면 빌드가 성공했습니다.
```
Linking out/klipper.elf
Creating hex file out/klipper.bin
```

장치 검색

상위기기를 정상적으로 네트워크에 연결할 수 있도록 하십시오. 그리고 하위기기가 상위기기와 데이터 전송 기능을 갖춘 데이터 케이블로 연결되어 있는지 확인하십시오.
SSH를 통해 상위기에 연결한 후 lsusb를 입력하고 엔터를 누릅니다. 아래 이미지에서 둥근 부분으로 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.
- 아무런 정보도 반환되지 않으면 상위기기의 시스템 문제입니다. 여기서는 도움을 드릴 수 없습니다. 정상적인 시스템으로 교체하거나 상위기를 교체해야 합니다.
- lsusb 명령어가 없다는 메시지가 나오면 다음 명령어를 실행하여 설치할 수 있습니다.
```
sudo apt-get install usbutils
```
1d50:606f는 이번에 사용할 장치에 속합니다. OpenMoko, Inc. Geschwister Schneider CAN adapter라는 설명은 참고용이지만 판단 기준은 아닙니다.
- 일부 상위기는 시스템 문제로 인해 장치 정보가 완전히 표시되지 않을 수 있습니다.
- lsusb 명령어를 입력하면 장치가 표시되지만 1d50:606f가 나타나지 않는 경우 데이터 케이블을 교체해 보거나 메인보드를 상위기기의 다른 USB 포트에 연결해 보십시오.
위의 단계를 이전에 수행했고 Klipper 펌웨어를 성공적으로 프로그래밍하여 메인보드가 정상 작동하는 경우 펌웨어를 업데이트하기만 하면 됩니다. 이 페이지 오른쪽 메뉴에서 펌웨어 업데이트 섹션을 참조하십시오.

주의사항

1d50:606f가 표시될 때까지 다음 단계로 진행하지 마십시오.

펌웨어 프래싱

펌웨어 프래싱 전 XT30 데이터 케이블로 도구 보드를 UTOC 또는 브리지 펌웨어가 깔린 메인보드에 연결합니다. 참고 접선도는 아래에 있습니다.
다이얼 스위치가 적절한 위치에 있는지 확인하십시오.
CAN H와 CAN L가 전원이 꺼진 상태에서 만용표를 사용하여 저항 값을 측정해야 합니다. 약 60Ω 정도여야 합니다. 만약 120Ω이면 120Ω 점퍼를 연결해야 하고, 약 40Ω이면 점퍼를 제거해야 합니다.

::: tip

ID를 찾거나 펌웨어를 플래시하는 것은 모두 프린팅 중에는 권장하지 않습니다.
동일한 메인보드 또는 Katapult 도구 보드의 CAN 펌웨어와 Klipper의 CAN 펌웨어는 그들의 ID가 완전히 일치합니다.

:::

::: warning

상위 컴퓨터의 CAN 네트워크가 구성되었는지 확인하시기 바랍니다.
lsusb 명령어 실행 후에 1d50:606f가 나타날 경우에만 아래 명령어를 사용하여 CAN ID를 검색할 수 있습니다.
도구 보드의 CAN 속도가 상위 컴퓨터와 같아야 하며 그렇지 않으면 ID를 찾을 수 없고 플래시할 수도 없습니다.

:::

다음 명령어를 실행하여 CANBus UUID를 조회하세요:
```
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
```
- 입력 후 기기에 따라 아래와 같은 몇 가지 상황이 나타날 수 있으며, 참고하세요:
  - 첫 번째 경우: 브리지 펌웨어가 설치된 메인보드에서 ID 하나가 나타나고 "Application: Klipper"라는 메시지가 표시됩니다.
  - 두 번째 경우: 브리지 펌웨어가 설치된 메인보드와 함께 도구 보드를 사용하는 경우 두 개의 ID가 나타납니다.
  - 세 번째 경우: UTOC와 도구 보드를 사용하는 경우
  - 팁: UTOC는 ID가 표시되지 않습니다.
  - 네 번째 경우: ID가 나타나지 않으며 일반적으로 Klipper에 의해 점유된 경우, 상위 컴퓨터의 CAN0 속도가 올바르지 않거나 연결이 잘못된 경우입니다.
- 일반적으로 도구 보드가 CANBOOT 상태에 있을 경우 "Application: CanBoot"이라는 메시지와 함께 해당 펌웨어 LED가 깜빡이는 것이 표시됩니다. 이 경우 Klipper 펌웨어를 플래시해야 하며 그렇지 않으면 연결할 수 없습니다!
- 팁: Klipper 펌웨어가 이미 설정 파일에 ID를 입력한 경우, ID는 표시되지 않고 Klipper에 의해 점유되며, 해당 ID를 차단하고 메인보드를 완전히 전원을 끈 후 다시 시작해야 합니다.
::: warning
- UUID를 찾을 수 없는 경우 아래 문서를 참조하세요.
- CAN 문제 모음집
:::

펌웨어 플래싱

아래 명령어에서 241696050c56를 UUID를 찾은 UUID로 바꾸세요. -u 뒤에는 공백이 있어야 합니다.
```
python3 ~/klipper/lib/canboot/flash_can.py -u 241696050c56
```
아래 사진과 같이 CAN Flash Success가 나타나면 플래싱 성공입니다.

펌웨어 업데이트가 필요한 경우 펌웨어를 재컴파일한 후 다시 플래싱 명령을 실행하면 펌웨어를 업데이트할 수 있습니다. 하지만 ID를 찾거나 Klipper가 연결될 수 있도록 해야 합니다.

python3 ~/klipper/lib/canboot/flash_can.py -u  <MCU ID>

펌웨어 시작 확인

펌웨어가 정상적으로 시작하면 LED가 켜집니다.

빌드 시작​

Klipper固件编译和配置页面操作说明​

장치 검색​

펌웨어 프래싱​

펌웨어 업데이트가 필요한 경우 펌웨어를 재컴파일한 후 다시 플래싱 명령을 실행하면 펌웨어를 업데이트할 수 있습니다. 하지만 ID를 찾거나 Klipper가 연결될 수 있도록 해야 합니다.​

펌웨어 시작 확인​