본문으로 건너뛰기

펌웨어: Marlin, Klipper, RepRapFirmware

📍 현재 위치: 2부 · 기계 스택 — 16장 중 4장. 3장은 기계 구조를 설명했습니다. 이 장은 모터와 히터가 G-code에 따르도록 만드는 프로그램을 살펴봅니다.

쉽게 말하면

펌웨어는 프린터 오케스트라의 지휘자입니다. 악보는 G-code("여기로 이동", "이 온도로 가열")이고, 지휘자는 초당 수천 번, 각 모터가 정확히 언제 다음 스텝을 밟을지와 각 히터를 얼마나 세게 가동할지 결정합니다. Marlin은 지휘자와 연주자를 작은 보드 하나에 둡니다. Klipper는 지휘자의 계획 부분을 더 큰 컴퓨터에 두고, 작은 보드는 음을 제때 연주하는 일만 맡깁니다.

이 장에서 다루는 내용​

펌웨어가 하는 일을 살펴본 뒤 세 가지 주요 오픈 프로젝트인 Marlin, Klipper, RepRapFirmware를 다룹니다. 각각이 어떻게 설정되는지, 프로세서 사이에 일을 어떻게 나누는지, 라이선스가 무엇인지 말하고, 마지막에 장단점을 정리합니다. 버전 관련 사실은 2026년 11월에 확인했습니다.

펌웨어가 하는 일​

프린터 펌웨어의 일은 네 가지입니다. G-code 명령을 해석합니다. 동작 계획(motion planning)을 하여, 속도와 가속도 한계를 지키면서 밀리미터 단위 경로를 모터 스텝으로 바꿉니다. 기구학(kinematics)을 수행하여 요청된 위치를 모터 위치로 대응시킵니다(3장의 대응식). 그리고 제어 루프와 안전을 담당하는데, 주로 히터의 온도 제어이며 5장에서 다룹니다.

계획된 이동을 숫자로​

대부분의 펌웨어는 각 이동을 속도의 사다리꼴로 만듭니다. 가속, 순항, 감속입니다. Klipper 코드 개요는 이를 각 이동을 가속, 순항, 감속 단계로 나누는 것으로 설명합니다 [7]. 아래 코드는 소요 시간을 계산합니다. Python 표준 라이브러리만 사용하며 Python 3로 실행했습니다. 속도와 가속도는 예시일 뿐이며 프린터에서 측정한 값이 아닙니다.

import math

def trapezoid(dist, v_max, accel):
"""(t_accel, t_cruise, t_total) for a move that starts and ends at rest."""
d_acc = v_max**2 / (2 * accel)
if 2 * d_acc >= dist: # too short to reach v_max: triangle
t = math.sqrt(dist / accel)
return t, 0.0, 2 * t
t_acc = v_max / accel
t_cruise = (dist - 2 * d_acc) / v_max
return t_acc, t_cruise, 2 * t_acc + t_cruise

for d in (2, 50, 200):
ta, tc, tt = trapezoid(d, 200, 3000) # 200 mm/s, 3000 mm/s^2
print(f"{d:>4} mm: accel {ta:.3f}s cruise {tc:.3f}s total {tt:.3f}s")
2 mm: accel 0.026s cruise 0.000s total 0.052s
50 mm: accel 0.067s cruise 0.183s total 0.317s
200 mm: accel 0.067s cruise 0.933s total 1.067s

2 mm 이동은 200 mm/s에 도달하지 못하고 전부 가속 구간입니다. 그래서 짧은 구간(곡선, 세밀한 부분)은 슬라이서에 설정한 최고 속도가 아니라 가속도에 의해 제한됩니다.

Marlin​

Marlin 저장소는 이를 "8비트와 32비트 마이크로컨트롤러 모두에 최적화된 RepRap 3D 프린터용 펌웨어"라 소개하며 GPL-3.0입니다. README는 Erik van der Zalm을 창립자, Scott Lahteine을 프로젝트 리더로 적고, AVR 보드(RAMPS, Melzi, RAMBo)에서 STM32, LPC176x, SAMD, Teensy, ESP32, RP2040까지의 대상을 나열합니다 [1]. 소스 헤더는 "Sprinter와 grbl에 기반"한다고 밝힙니다 [2].

Marlin은 컴파일 시 설정됩니다. Configuration.h와 Configuration_adv.h를 편집하고 빌드해서 플래시합니다. 아래 줄은 릴리스 2.1.2.10의 기본 예제 Configuration.h에서 그대로 가져온 것이며 컴파일하지는 않았습니다 [2].

#define MOTHERBOARD BOARD_RAMPS_14_EFB
#define SERIAL_PORT 0
#define BAUDRATE 250000
#define X_DRIVER_TYPE A4988
#define TEMP_SENSOR_0 1
#define THERMAL_PROTECTION_HOTENDS // Enable thermal protection for all extruders
#define DEFAULT_AXIS_STEPS_PER_UNIT { 80, 80, 400, 500 }

선택 기능은 고급 설정 파일에 있습니다. LIN_ADVANCE(압출기의 압력 보정. LIN_ADVANCE_K나 M900으로 설정)는 기본적으로 꺼져 있습니다 [3] [4]. 같은 파일에 INPUT_SHAPING_X와 INPUT_SHAPING_Y가 있으며, 기본 주파수 40 Hz와 감쇠비 0.15를 갖고 M593으로 조정합니다 [3].

Klipper​

Klipper는 GPL-3.0이며 스스로를 "범용 컴퓨터의 힘과 하나 이상의 마이크로컨트롤러"를 결합한 것이라 설명합니다 [5]. 확인했을 때 GitHub에는 정식 릴리스가 없었고, 최신 태그는 2025년 4월의 v0.13.0이었습니다 [5].

핵심 아이디어는 호스트/MCU 분리입니다. 호스트(예: 라즈베리 파이)가 Klippy를 실행합니다. Klippy는 대부분 Python으로, C 보조 코드와 함께 작성되어 G-code를 계획된 이동으로 바꾸고, 룩어헤드를 하고, 사다리꼴 생성기를 돌리고, 반복 해법기로 스텝 시각을 계산합니다. 이를 마이크로컨트롤러용 queue_step 명령으로 압축해 보내면, 마이크로컨트롤러의 C 코드는 이를 큐에 추가하고 하드웨어 타이머 인터럽트로 각 스텝을 발생시킵니다 [7]. Features 페이지는 각 스테퍼 이벤트가 25마이크로초 이하의 정밀도로 스케줄된다고 주장하며, 설정은 텍스트 설정 파일에 있어 재플래시가 필요 없다고 말합니다 [6].

Marlin, Klipper, RepRapFirmware를 계획, 스텝 생성, 설정이 어디에 있는지 기준으로 비교한 세 열. Marlin은 한 보드에서 계획과 스텝 생성을 하고 컴파일 시 설정합니다. Klipper는 계획(호스트, Python)과 스텝 타이밍(마이크로컨트롤러, C)을 나눕니다. RepRapFirmware는 Duet급 보드에서 실행되며 config.g의 G-code로 설정합니다. 저자가 AI의 도움을 받아 직접 제작한 그림입니다.

일반적인 설치는 호스트에서 마이크로컨트롤러 이미지를 빌드한 다음 printer.cfg를 편집합니다 [10].

cd ~/klipper/
make menuconfig
make
ls /dev/serial/by-id/* # find the board's serial path
cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg

이 명령들은 하드웨어에서 실행하지 않았으며 설치 문서에서 그대로 인용했습니다. [input_shaper] 섹션도 비슷합니다. 문서는 대부분의 프린터에 mzv를 권하고, 인쇄한 링잉 타워 또는 라즈베리 파이에 연결한 ADXL345 가속도계와 SHAPER_CALIBRATE로 공진을 측정하는 방법을 설명합니다 [8] [9].

[input_shaper]
shaper_freq_x: ... # from the ringing test model
shaper_freq_y: ...
shaper_type: mzv

RepRapFirmware​

RepRapFirmware(RRF)는 GPLv3 라이선스의 C++ 프로젝트로 ARM Cortex-M 보드(ATSAM4E, ATSAM4S, SAME70, SAME5x)를 대상으로 하며 Duet3D 조직이 관리합니다. 2026년 11월에 릴리스 3.7.0이 올라 있는 것을 확인했습니다 [11]. 위키는 "G-code everywhere" 원칙을 설명합니다. 설정은 config.g의 G-code로 하며, 대부분의 변경은 재시작 없이 즉시 적용됩니다. 웹 설정 도구가 이 파일을 생성해 줍니다 [12]. Duet 3 계열의 확장 보드와 툴 보드는 별도의 펌웨어(Duet3Expansion, GPL-3.0)를 실행하며 RRF 릴리스에 포함되어 배포됩니다 [13]. Prusa의 프린터는 또 다른 GPLv3 펌웨어인 Prusa-Firmware-Buddy를 씁니다 [14].

어떻게 고를까​

MarlinKlipperRepRapFirmware
설정헤더 편집, 재빌드, 플래시텍스트 파일, 재시작config.g의 G-code
프로세서보드 하나호스트와 MCU 하나 이상Duet급 ARM 보드
추가 컴퓨터 필요아니오예(호스트)핵심 펌웨어에는 불필요
하드웨어 범위AVR, STM32, LPC, SAMD, ESP32, RP2040 등(README 목록)ARM, AVR 등(Features 페이지)ARM Cortex-M 보드, 주로 Duet

표는 각 프로젝트의 자체 문서를 따랐습니다. 세 펌웨어를 중립적으로 비교한 벤치마크는 찾지 못했으므로 속도나 품질의 순위는 매기지 않습니다.

왜 중요한가​

펌웨어는 기계의 성격이 사는 곳입니다. 같은 프레임도 펌웨어에 따라 다르게 동작합니다. 오픈 펌웨어는 안전 기능을 감사하고 버그를 직접 고칠 수 있다는 뜻이지만, 올바른 설정의 부담도 여러분에게 있다는 뜻입니다.

실제 현장에서는​

프린터를 구입한다면 어떤 펌웨어가 돌아가는지, 그리고 정확한 소스를 업체가 공개하는지 확인하십시오. Marlin의 README는 이를 탑재해 판매하는 업체가 소스를 공개 상태로 유지해야 한다고 밝힙니다 [1].

핵심 용어​

  • 펌웨어(firmware) — 프린터의 마이크로컨트롤러에서 모터와 히터를 제어하는 프로그램.
  • 동작 계획(motion planning) — 속도와 가속도 한계 안에서 경로를 시간이 지정된 스텝으로 바꾸는 것.
  • 룩어헤드(look-ahead) — 뒤따르는 이동을 알고 이동을 계획하여 이동 사이에 멈출 필요가 없게 하는 것.
  • MCU — 마이크로컨트롤러 유닛. 펌웨어를 실행하고 핀을 구동하는 작은 칩.
  • 호스트(host) — Klipper의 계획 코드를 실행하는 라즈베리 파이 같은 범용 컴퓨터.
  • 입력 성형(input shaping) — 지령된 움직임을 성형해 공진을 상쇄하고 링잉(가장자리의 고스팅)을 줄이는 기법.
  • Linear Advance — Marlin의 압출기 압력 보정 기능(LIN_ADVANCE).
  • config.g — RepRapFirmware의 G-code 설정 파일.

다음 이야기​

펌웨어에는 명령을 내릴 하드웨어가 필요합니다. 전자부품, 스테퍼 드라이버, 제어 보드로 이어집니다.