열민감 구성 방법

이 페이지는 Klipper에서 일반적인 온도 센서 구성 방식을 정리한 것으로, 핫엔드, 히트베드, 챔버 온도, 메인보드 온도, 호스트 온도, PT1000 직결, MAX31865 및 K형 열전대를 포함합니다. 예시의 핀, 센서 모델, 풀업 저항 및 온도 범위는 실제 하드웨어에 맞게 수정해야 합니다.

전원 차단 작업

열민감, PT100/PT1000, 열전대 모듈, 히터봉, 히트베드, 점퍼 캡 또는 터미널을 점검하거나 교체하기 전에 프린터를 완전히 끄고 전원 공급을 차단한 후, 핫엔드와 히트베드가 냉각될 때까지 기다리십시오. 전원이 켜진 상태에서 배선 하네스를 연결/분리하거나, 인터페이스 배선 순서를 정리하거나, 터미널을 만지지 마십시오.

사용 설명

• sensor_type은 실제 센서와 일치해야 하며, 구성 예시를 그대로 복사해서는 안 됩니다.
• sensor_pin은 온도 샘플링을 지원하는 ADC/열민감 인터페이스에 연결해야 하며, 팬 포트, 히터 포트, 엔드스톱 포트 또는 일반 출력 포트에 연결할 수 없습니다.
• PT100/PT1000, 열전대 및 일반 NTC 서미스터는 사용하는 인터페이스와 구성 방식이 다르므로, 인터페이스를 잘못 연결하면 온도 이상 또는 ADC out of range가 발생할 수 있습니다.
• 온도 센서 또는 히터 구성을 변경한 후에는 온도 판독값을 다시 확인하고 필요에 따라 PID 캘리브레이션을 다시 수행해야 합니다.

기본 구조

온도 센서는 일반적으로 다음 구성 섹션에 나타납니다:

시나리오	구성 섹션	일반적인 용도
핫엔드	[extruder]	핫엔드 온도를 읽고 핫엔드 가열 제어
히트베드	[heater_bed]	히트베드 온도를 읽고 히트베드 가열 제어
챔버 온도 / 추가 온도	[temperature_sensor xxx]	온도만 표시, 가열 직접 제어 안 함
사용자 정의 히터	[heater_generic xxx]	가열 챔버, 건조 상자 등 추가 가열 장치 제어
메인보드 온도	[temperature_sensor xxx] + temperature_mcu	MCU 내부 온도 표시
호스트 온도	[temperature_sensor xxx] + temperature_host	호스트 CPU 온도 표시

가장 일반적인 핫엔드 구성 구조는 다음과 같습니다:

printer.cfg

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: <sensor_type>
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

가장 일반적인 히트베드 구성 구조는 다음과 같습니다:

printer.cfg

[heater_bed]
heater_pin: <bed_heater_pin>
sensor_type: <sensor_type>
sensor_pin: <bed_sensor_pin>
min_temp: 0
max_temp: 120

일반 NTC 서미스터

일반적인 핫엔드와 히트베드에는 100K NTC 서미스터가 흔히 사용됩니다. 이러한 센서는 일반적으로 메인보드 또는 툴보드의 일반 열민감 인터페이스에 연결됩니다.

핫엔드 예시

printer.cfg

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: Generic 3950
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

히트베드 예시

printer.cfg

[heater_bed]
heater_pin: <bed_heater_pin>
sensor_type: Generic 3950
sensor_pin: <bed_sensor_pin>
min_temp: 0
max_temp: 120

C8P 핀 위치 예시

아래는 C8P의 일반적인 핀 위치 작성법만 보여줍니다. 실제 사용 시에는 배선한 열민감 포트와 히터 포트에 맞게 작성하십시오.

C8P 핫엔드 예시

[extruder]
heater_pin: PD12
sensor_type: Generic 3950
sensor_pin: PC2
min_temp: 0
max_temp: 300

C8P 히트베드 예시

[heater_bed]
heater_pin: PB0
sensor_type: Generic 3950
sensor_pin: PC5
min_temp: 0
max_temp: 120

센서 모델

일반적인 sensor_type에는 Generic 3950, PT1000 또는 기타 Klipper 내장 모델이 있습니다. 핫엔드, 히트베드 또는 센서의 명판 사양을 기준으로 하되, 확실하지 않은 경우 제품 자료를 우선 확인하거나 애프터 서비스에 문의하여 확인하십시오.

PT1000 직결

PT1000은 PT1000을 지원하는 열민감 인터페이스에 직접 연결할 수 있습니다. 메인보드마다 열민감 포트에 사용되는 풀업(샘플링) 저항이 다르며, 반드시 1K가 아니라 4700, 2200, 1100, 1000 등이 흔하므로 메인보드 설명서나 실물을 기준으로 하십시오. 일부 메인보드는 점퍼 캡으로 풀업 저항을 전환할 수 있습니다.

아래 예시는 1K 풀업 메인보드를 기준으로 하며, pullup_resistor는 반드시 사용 중인 메인보드의 실제 저항에 맞게 수정해야 합니다:

PT1000 직결 예시 (1K 풀업 메인보드)

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: PT1000
sensor_pin: <pt1000_sensor_pin>
pullup_resistor: 1000
min_temp: 0
max_temp: 350

풀업 저항

• pullup_resistor는 메인보드 열민감 포트의 실제 풀업 저항에 맞게 작성해야 하며, 4700, 2200, 1100, 1000 등이 흔하고 통일된 값이 없으므로 먼저 메인보드 설명서를 확인하거나 애프터 서비스에 문의하십시오.
• 메인보드 열민감 포트가 기본 4.7K 풀업이면 pullup_resistor를 작성하지 않아도 되며, Klipper는 기본적으로 4700으로 처리합니다.
• 점퍼 캡이 있는 메인보드의 경우 점퍼 상태와 구성이 일치해야 합니다. 그렇지 않으면 온도가 눈에 띄게 높거나 낮아지거나 ADC out of range가 발생할 수 있습니다.

MAX31865 구성

MAX31865는 RTD 백금 저항 온도 센서를 읽는 데 사용되며, 일반적으로 PT100과 PT1000 두 가지로 구분됩니다. 이 방식은 일반 열민감 ADC 핀을 사용하지 않고 SPI 통신과 칩 선택 핀을 사용합니다.

센서	일반적인 작성법	기준 저항 예시	설명
PT100	rtd_nominal_r: 100	rtd_reference_r: 430	프로브 공칭 저항 100옴
PT1000	rtd_nominal_r: 1000	rtd_reference_r: 4300	프로브 공칭 저항 1000옴

유형 먼저 확인

PT100, PT1000 및 K형 열전대는 동일한 센서가 아닙니다. MAX31865는 PT100/PT1000과 같은 RTD 백금 저항 센서에만 사용되며, K형 열전대에는 사용되지 않습니다.

PT100 예시

PT100 + MAX31865

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: MAX31865
sensor_pin: <max31865_cs_pin>
spi_bus: <spi_bus>
rtd_nominal_r: 100
rtd_reference_r: 430
rtd_num_of_wires: 2
min_temp: 0
max_temp: 350

PT1000 예시

PT1000 + MAX31865

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: MAX31865
sensor_pin: <max31865_cs_pin>
spi_bus: <spi_bus>
rtd_nominal_r: 1000
rtd_reference_r: 4300
rtd_num_of_wires: 2
min_temp: 0
max_temp: 350

MAX31865 주의사항

• MAX31865는 해당 보드가 지원하는 PT100 / PT1000 연결 방식으로만 사용해야 하며, 일반 NTC 서미스터를 MAX31865에 연결하지 마십시오.
• sensor_pin은 MAX31865의 칩 선택 핀이지 일반 열민감 ADC 핀이 아닙니다.
• rtd_num_of_wires는 실제 프로브 라인 수에 맞게 작성해야 하며, 일반적으로 2, 3 또는 4입니다.
• 딥 스위치나 점퍼가 있는 보드는 제품 문서에 따라 PT100/PT1000과 라인 수를 설정해야 합니다. 그렇지 않으면 온도 판독값이 비정상적일 수 있습니다.

K형 열전대 구성

K형 열전대는 해당 열전대 변환 칩과 함께 사용해야 하며, 일반 서미스터 인터페이스에 직접 연결할 수 없고 MAX31865의 PT100/PT1000 인터페이스에도 연결할 수 없습니다. 일반적인 구성은 SPI를 사용합니다:

K형 열전대 예시

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: MAX31856
sensor_pin: <thermocouple_cs_pin>
spi_bus: <spi_bus>
tc_type: K
min_temp: 0
max_temp: 500

다른 K형 열전대 변환 칩을 사용하는 경우 sensor_type을 실제 칩 모델로 변경하십시오. 예를 들어 MAX6675, MAX31855 또는 MAX31856으로 설정하고 모듈 설명에 따라 SPI를 구성하십시오. tc_type: K는 현재 프로브가 K형 열전대임을 나타냅니다.

MAX6675 예시

K형 열전대 + MAX6675

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: MAX6675
sensor_pin: <max6675_cs_pin>
spi_bus: <spi_bus>
min_temp: 0
max_temp: 500

MAX6675 주의사항

• MAX6675는 tc_type 파라미터를 지원하지 않으며, K형 열전대만 읽을 수 있습니다.
• sensor_pin은 MAX6675의 칩 선택 핀(CS)이며, 일반 서미스터 ADC 핀이 아닙니다.
• SPI 버스 핀(MOSI/MISO/SCK)은 사용 중인 메인보드 또는 툴보드 제품 설명서를 참조하여 해당 SPI 인터페이스를 찾아 연결하십시오.

고온 구성

핫엔드, 히터 카트리지, 서미스터, 노즐, 핫엔드 고정 구조 및 필라멘트가 모두 고온을 지원하는 경우에만 max_temp를 높일 수 있습니다. 오류를 없애기 위해 하드웨어 능력보다 훨씬 높은 값으로 max_temp를 임의로 설정하지 마십시오.

독립 온도 표시

온도만 표시하고 히터를 제어할 필요가 없는 경우 [temperature_sensor xxx]를 사용할 수 있습니다.

챔버 온도 / 환경 온도

챔버 온도 예시

[temperature_sensor chamber]
sensor_type: Generic 3950
sensor_pin: <chamber_sensor_pin>
min_temp: 0
max_temp: 100

메인보드 온도

MCU 온도 예시

[temperature_sensor MCU]
sensor_type: temperature_mcu
min_temp: 0
max_temp: 100

호스트 온도

Host 온도 예시

[temperature_sensor Host]
sensor_type: temperature_host
min_temp: 0
max_temp: 100

표시 이름

[temperature_sensor chamber]의 chamber는 프런트엔드 표시 이름으로, 실제 용도에 따라 box, toolboard, host 등으로 변경할 수 있습니다. 이름은 기존 구성 섹션과 중복되지 않아야 합니다.

일반 서미스터 및 사용자 정의 서미스터

Klipper 내장 sensor_type

다음 sensor_type은 Klipper에 내장되어 있어 바로 입력하여 사용할 수 있으며, [thermistor xxx]를 사용자 정의할 필요가 없습니다:

sensor_type	정격 저항	정의 방식	일반적인 용도
Loading...	100K @ 25°C	삼점법	FLY 메인보드 핫엔드 / 히트베드 기본 설정, 일반 PLA/ABS 등 출력 시나리오
Loading...	100K @ 25°C	삼점법	고온 핫엔드, E3D 계열 핫엔드 호환 서미스터
Loading...	100K @ 25°C	삼점법	핫엔드 / 히트베드 범용, 일반형 NTC 교체품에 흔히 사용
Loading...	100K @ 25°C	B값 4100	실리콘 히팅 패드, 히트베드 호환 서미스터
Loading...	500K @ 25°C	삼점법	고온 핫엔드(450°C급 측온), 전체 핫엔드의 내열 온도 확인 필요
Loading...	100K @ 25°C	삼점법	핫엔드 / 히트베드, 흔한 칩 타입 NTC 교체품
Loading...	100K @ 25°C	B값 3974	핫엔드 / 히트베드 범용
Loading...	100K @ 25°C	삼점법	핫엔드, 소형 패키지 서미스터
Loading...	1000 Ω @ 0°C	백금 저항 RTD	고정밀 핫엔드; pullup_resistor는 메인보드의 실제 풀업 저항에 맞게 입력해야 합니다(일반적으로 4700, 2200, 1100, 1000 등), 위의 PT1000 직결 참조
Loading...	—	SPI 열전대 변환 칩	K형 열전대, 최대 약 1024°C, MAX6675 모듈과 함께 사용 필요
Loading...	—	SPI 열전대 변환 칩	K형 열전대, 최대 약 1024°C, MAX31855 모듈과 함께 사용 필요

선택 가이드

• FLY 메인보드의 출하 설정은 보통 Generic 3950을 사용하므로, 서미스터를 교체하기 전에 원래 모델을 먼저 확인하세요.
• E3D 계열 고온 핫엔드나 호환 서미스터를 사용하는 경우, 일반적으로 ATC Semitec 104GT-2입니다.
• 모델을 확실히 모를 때는 제품 자료를 확인하거나 A/S에 문의하여 확인하고, 함부로 sensor_type을 변경하지 마세요.

사용자 정의 서미스터

센서가 위 내장 목록에 없으면 [thermistor xxx]로 사용자 정의 서미스터 곡선을 정의할 수 있습니다.

배치 위치

[thermistor xxx]는 이를 참조하는 설정 섹션 위에 작성해야 합니다. 즉, 해당 [extruder], [heater_bed], [temperature_sensor xxx] 또는 [heater_generic xxx] 앞에 작성해야 합니다.

사용자 정의 서미스터에는 일반적으로 두 가지 작성 방법이 있습니다:

자료 유형	권장 방법	설명
여러 온도/저항 지점이 있는 경우	삼점법	우선 사용, 온도 곡선이 실제 센서에 더 근접
정격 저항과 B값만 있는 경우	B값법	작성이 더 간단하지만, 고온 구간 정밀도가 삼점법보다 떨어질 수 있음

삼점법 예시

아래에서는 ATC Semitec 104GT-2의 파라미터를 예로 들어 삼점법으로 사용자 정의 서미스터를 작성하는 방법을 보여줍니다. 먼저 [thermistor semitec_104gt2]를 정의한 후, [extruder]에서 사용합니다:

ATC Semitec 104GT-2 삼점법

[thermistor semitec_104gt2]
temperature1: 20
resistance1: 126800
temperature2: 150
resistance2: 1360
temperature3: 300
resistance3: 80.65

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: semitec_104gt2
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

아래에서는 EPCOS 100K B57560G104F의 파라미터를 예로 듭니다:

EPCOS 100K B57560G104F 삼점법

[thermistor epcos_100k]
temperature1: 25
resistance1: 100000
temperature2: 150
resistance2: 1641.9
temperature3: 250
resistance3: 226.15

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: epcos_100k
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

삼점 선택

세 지점은 일반적인 출력 온도 범위를 최대한 포괄해야 합니다. 예를 들어 실온, 중간 온도, 최고 사용 온도 부근입니다. 규격서에 온도/저항 표가 제공되면 표에서 세 지점을 선택하는 것이 우선입니다.

B값법

제조사가 정격 저항과 B값만 제공하는 경우, temperature1, resistance1, beta 방식으로 정의할 수 있습니다:

100K B3950 B값법

[thermistor ntc_100k_b3950]
temperature1: 25
resistance1: 100000
beta: 3950

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: ntc_100k_b3950
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

100K B4500 B값법

[thermistor ntc_100k_b4500]
temperature1: 25
resistance1: 100000
beta: 4500

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: ntc_100k_b4500
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 350

고온 서미스터 설정

아래 고온 서미스터 파라미터는 Marlin 펌웨어 소스 코드에서 제조사 규격서로 검증된 서미스터 표에서 가져온 것으로, 300°C 이상 측온이 필요한 고온 핫엔드에 적합합니다. 사용 전 핫엔드, 히터 카트리지, 노즐, 필라멘트가 모두 해당 온도를 지원하는지 확인하세요.

ATC Semitec 204GT-2（200K / 300°C）

# R25 = 200K, B25 = 4338, 4.7K 풀업
# 출처: Marlin thermistor_2.h, Mouser 제조사 규격서로 검증
[thermistor semitec_204gt2]
temperature1: 25
resistance1: 200000
temperature2: 150
resistance2: 2520
temperature3: 300
resistance3: 142

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: semitec_204gt2
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

204GT-2 설명

• 200K 정격 저항은 고온 구간에서 저항값이 더 높아, 100K 서미스터보다 250°C 이상에서 ADC 분해능이 더 우수합니다.
• 300°C급 고온 핫엔드에 적합하며, PEI, PC, PA 등 고온 소재 출력 시나리오에 알맞습니다.
• 표준 4.7 kΩ 풀업을 사용하면 되며, 풀업 저항을 교체할 필요가 없습니다.

Formbot / Vivedino 100K B3950 고온 버전（350°C）

# R25 = 100K, B25/50 = 3950, 4.7K 풀업
# 출처: Marlin thermistor_61.h, 100KR13950181203
[thermistor formbot_3950_350]
temperature1: 25
resistance1: 100000
temperature2: 150
resistance2: 509
temperature3: 300
resistance3: 63.5

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: formbot_3950_350
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 350

100K 고온 정밀도 제한

100K 서미스터는 300°C에서 저항값이 약 63 Ω에 불과하여 4.7 kΩ 풀업과의 차이가 매우 커서 고온 구간 ADC 분해능이 낮습니다. 300°C 이상에서 장기간 출력하려면 200K(204GT-2) 또는 500K(SliceEngineering 450) 서미스터를 우선 선택하는 것이 좋습니다.

Dyze Design 2.5M B4500（500°C）

# R25 = 2.5M, B25 = 4500, 큰 저항값 풀업과 함께 사용해야 함
# 출처: Marlin thermistor_66.h 주석 파라미터
[thermistor dyze_500]
temperature1: 25
resistance1: 2500000
beta: 4500

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: dyze_500
sensor_pin: <hotend_sensor_pin>
pullup_resistor: 470000
min_temp: 0
max_temp: 500

2.5M 서미스터 풀업 요구 사항

• 2.5MΩ 정격 저항은 실온에서 표준 4.7 kΩ 풀업보다 훨씬 크므로, 기본 풀업 사용 시 저온 구간에서 ADC가 거의 포화되어 정확한 온도 측정이 불가능합니다.
• 반드시 470 kΩ 이상의 풀업 저항과 함께 사용하고, 설정에서 pullup_resistor: 470000을 지정해야 합니다.
• 메인보드 또는 툴보드가 풀업 저항 교체를 지원하지 않는 경우, 이 서미스터를 사용하지 말고 PT1000 + MAX31865 또는 K형 열전대 방식을 사용하십시오.
• 500°C급 온도 측정 시에는 히터 카트리지, 노즐, 핫엔드 구조 및 필라멘트가 모두 내열 요구 사항을 충족하는지 동시에 확인하십시오.

고온 방식 선택

목표 온도	권장 방식	설명
≤ 300°C	Loading... 또는 Loading...	표준 구성으로 충분
300°C ~ 350°C	Loading...	먼저 이 페이지의 해당 사용자 정의 [thermistor] 설정을 추가해야 함
350°C ~ 450°C	Loading...	Klipper 내장, sensor_type에 바로 입력
450°C ~ 500°C	Loading... 또는 Loading...	먼저 이 페이지의 해당 사용자 정의 [thermistor] 설정을 추가하거나 K형 열전대를 사용해야 함
500°C 이상	Loading...	NTC 서미스터는 부적합

3점법 범용 템플릿

데이터시트는 있지만 기성 파라미터가 없는 경우, 아래 템플릿에 따라 작성할 수 있습니다:

3점법 템플릿

[thermistor my_custom_thermistor]
temperature1: 25
resistance1: <resistance_at_25c>
temperature2: 150
resistance2: <resistance_at_150c>
temperature3: 250
resistance3: <resistance_at_250c>

[extruder]
heater_pin: <hotend_heater_pin>
sensor_type: my_custom_thermistor
sensor_pin: <hotend_sensor_pin>
min_temp: 0
max_temp: 300

고온 서미스터 제한

max_temp는 핫엔드, 히터 카트리지, 서미스터, 노즐 및 필라멘트의 실제 내열 능력에 따라 설정해야 합니다. 고온 NTC 설정이 더 높은 온도를 읽을 수 있다고 해서 전체 핫엔드가 해당 온도까지 안전하게 가열할 수 있는 것은 아닙니다.

수정 후 점검

설정을 저장하고 Klipper를 재시작한 후 다음 순서대로 점검하십시오:

1. 프런트엔드 온도가 실온에 가까운지 확인합니다.
2. ADC out of range, 극고온, 극저온 또는 음의 온도가 표시되면 먼저 가열을 중지하고 전원을 차단한 후 커넥터, 배선 및 센서 유형을 점검합니다.
3. sensor_pin이 다른 기능과 중복 사용되지 않는지 확인합니다.
4. sensor_type, pullup_resistor, rtd_nominal_r, rtd_reference_r이 실제 하드웨어와 일치하는지 확인합니다.
5. 핫엔드 또는 베드 센서를 교체한 경우 PID 보정을 다시 실행하고 결과를 저장합니다.

일반적인 온도 및 가열 오류는 다음을 참조하십시오: 온도, 가열 및 압출 오류.