2026-07-05
Ender 3 V3 SE Klipper 전환 기록 (3) - 프린터 설정
Ender 3 V3 SE를 Klipper로 전환하는 과정의 세 번째 게시글입니다.
BTT Pi와 Klipper 설치가 끝났다면 이제 실제 프린터 설정을 진행해야 한다. 이번 글에서는 Ender 3 V3 SE에서 사용한 printer.cfg 수정 사항과 Z 오프셋, 베드 메시 설정 과정을 정리한다.
printer.cfg 설정
Ender 3 V3 SE는 공개된 설정 파일들이 여러 가지 있는데, 이것을 기반으로 printer.cfg를 설정한다. 나는 여기를 기반으로 설정을 시작했다. 이 레포지토리를 참고한다면 printer-creality-ender3-v3-se-2023.cfg 파일의 내용을 기반으로 printer.cfg를 작성하면 된다.
Mainsail 설정 추가
해당 파일의 내용을 그대로 복사했다면, Mainsail 기준 virtual_sdcard가 없다는 등의 여러 오류가 보일 수 있다. [include mainsail.cfg]를 추가하면 해결된다.
X축 가동 범위 수정
나는 알려진 설정들을 사용하면 출력을 베드 바깥부터 시작하는 문제가 있었다. [stepper_x] 섹션을 다음과 같이 조정해서 해결했다.
# 기존 설정
[stepper_x]
...
position_endstop: -6
position_min: -6
position_max: 230
...
# 수정 후 설정
[stepper_x]
...
position_endstop: -13
position_min: -13
position_max: 223
...
변경 내용에 대한 해설
이 수정의 목표는 X축을 7mm만큼 더 오른쪽에서 시작하게 하는 것이다. position_endstop은 엔드스탑 스위치가 눌린 시점의 좌표를 무엇으로 해석할지를 의미한다. 기존 설정에서는 이 위치가 -6이었고 수정 후에는 -13이 된다. 즉, X=0으로 해석되는 위치가 기존보다 7mm 오른쪽으로 이동한다. 출력 가능한 영역을 동일하게 유지하려면 position_max도 마찬가지로 230에서 7을 뺀 223으로 수정하면 된다.
이 부분을 조정했다면 [bed_mesh] 섹션을 같이 조정해야 한다.
# 기존 설정
[bed_mesh]
...
mesh_max: 207,215.5
...
# 수정 후 설정
[bed_mesh]
...
mesh_max: 200,215.5
...
일단 나는 mesh_max만 수정했다. 여기를 수정하지 않으면 베드 메시를 생성할 때 가동 범위를 넘어가 오류가 나게 된다.
Z 오프셋 설정
Z 오프셋은 CRTouch가 트리거된 직후 얼마나 더 Z축으로 이동해야 하는지를 설정하는 값이다. 이 값이 정확하지 않으면 안착이 잘 안 되거나 베드를 노즐이 긁게 된다.
순정의 Marlin 기반 펌웨어는 베드에 달린 센서를 통해 노즐의 접촉을 감지해 자동으로 Z 오프셋을 설정한다. 여기서 사용한 Klipper의 포크도 이 기능이 구현되어 있다. Mainsail의 콘솔에 PRTOUCH_PROBE_ZOFFSET 명령을 입력해 Z 오프셋을 조정할 수 있다.
주의해야 할 점은, 먼저 아직 올바른 오프셋이 설정되지 않은 상태이니, 노즐이 베드를 찍을 가능성도 있다. 안 쓰는 베드를 잠시 장착하는 등, 만약의 상황에 대비하는 것을 추천한다.
또한 올바른 오프셋을 설정하려면 노즐과 베드를 예열해야 한다. 나는 노즐을 170℃, 베드를 약 50℃ 정도로 예열했더니 만족할 수준의 Z 오프셋을 얻을 수 있었다.
베드 메시
Klipper는 베드 메시 기능을 제공한다. 베드는 완벽하게 평평하지 않기 때문에, 이 기능을 통해 프린터가 자동으로 위치별로 Z축 높이를 보정하도록 할 수 있다. Mainsail 기준으로는 HEIGHTMAP 메뉴를 이용해 조절 가능하다.
다만 베드 메시를 생성했다고 해서 자동으로 적용되는 것은 아니다. 프린터 재시작 이후에도 항상 동일한 메시를 사용하려면 시작 G-code나 PRINT_START 매크로에서 명시적으로 로드해야 한다. 로드하는 명령어는 BED_MESH_PROFILE LOAD=default와 같다. 여기서 default는 메시 저장 시 사용한 프로파일 이름이다. 나는 슬라이서 설정의 시작 G-code에 이 부분을 넣었다.
다음에 다룰 내용
이번 글로 Ender 3 V3 SE를 Klipper 환경으로 전환하는 데 필요한 핵심 설정은 모두 정리했다. 이제 프린터는 네트워크를 통해 관리할 수 있고, 기본적인 출력 역시 문제없이 진행할 수 있는 상태가 되었다.
이후부터는 Klipper 설치기보다는 프린터 개조 및 운영 기록에 가까운 내용이 될 예정이다. 다음 글에서는 이 중 먼저 카메라 설치에 대해 다뤄 보도록 하겠다.