Méthodes de configuration des thermistances

Cette page récapitule les méthodes de configuration des capteurs de température courants dans Klipper, notamment la cartouche chauffante, le lit chauffant, la température de l'enceinte, la température de la carte mère, la température de l'hôte, le PT1000 en connexion directe, le MAX31865 et le thermocouple de type K. Les broches, les modèles de capteurs, les résistances de tirage et les plages de température indiqués dans les exemples doivent être modifiés en fonction du matériel réel.

Coupure de courant obligatoire

Avant de vérifier ou de remplacer une thermistance, un PT100/PT1000, un module de thermocouple, une cartouche chauffante, un lit chauffant, un cavalier ou une borne, éteignez complètement l'imprimante et débranchez l'alimentation électrique, puis attendez que la cartouche chauffante et le lit chauffant aient refroidi. Ne branchez pas, ne débranchez pas de faisceaux, ne réorganisez pas le câblage des connecteurs et ne touchez pas aux bornes lorsque l'appareil est sous tension.

Instructions d'utilisation

• sensor_type doit correspondre au capteur réel, ne vous contentez pas de copier l'exemple de configuration.
• sensor_pin doit être connecté à une interface ADC / thermistance prenant en charge l'échantillonnage de température, ne renseignez pas un port de ventilateur, un port de chauffage, un port de fin de course ou un port de sortie standard.
• Les PT100/PT1000, les thermocouples et les thermistances NTC standard utilisent des interfaces et des méthodes de configuration différentes ; un branchement incorrect entraînera des anomalies de température ou une erreur ADC out of range.
• Après avoir modifié la configuration du capteur de température ou du chauffage, vous devez revérifier les relevés de température et, si nécessaire, effectuer à nouveau l'étalonnage PID.

Structure de base

Les capteurs de température apparaissent généralement dans les sections de configuration suivantes :

Scénario	Section de configuration	Utilisation courante
Cartouche chauffante	[extruder]	Lit la température de la cartouche chauffante et contrôle le chauffage de celle-ci
Lit chauffant	[heater_bed]	Lit la température du lit chauffant et contrôle le chauffage de celui-ci
Température d'enceinte / température supplémentaire	[temperature_sensor xxx]	Affiche uniquement la température, ne contrôle pas directement le chauffage
Chauffage personnalisé	[heater_generic xxx]	Contrôle des équipements de chauffage supplémentaires tels que les enceintes chauffées, les boîtes de séchage, etc.
Température de la carte mère	[temperature_sensor xxx] + temperature_mcu	Affiche la température interne du MCU
Température de l'hôte	[temperature_sensor xxx] + temperature_host	Affiche la température du CPU de l'hôte

La structure de configuration la plus courante pour la cartouche chauffante est la suivante :

printer.cfg

[extruder]
heater_pin: <broche_chauffage_cartouche>
sensor_type: <type_capteur>
sensor_pin: <broche_capteur_cartouche>
min_temp: 0
max_temp: 300

La structure de configuration la plus courante pour le lit chauffant est la suivante :

printer.cfg

[heater_bed]
heater_pin: <broche_chauffage_lit>
sensor_type: <type_capteur>
sensor_pin: <broche_capteur_lit>
min_temp: 0
max_temp: 120

Thermistances NTC standard

Les cartouches chauffantes et lits chauffants courants utilisent souvent des thermistances NTC 100K. Ces capteurs sont généralement connectés aux interfaces de thermistance standard de la carte mère ou de la carte outil.

Exemple pour cartouche chauffante

printer.cfg

[extruder]
heater_pin: <broche_chauffage_cartouche>
sensor_type: Generic 3950
sensor_pin: <broche_capteur_cartouche>
min_temp: 0
max_temp: 300

Exemple pour lit chauffant

printer.cfg

[heater_bed]
heater_pin: <broche_chauffage_lit>
sensor_type: Generic 3950
sensor_pin: <broche_capteur_lit>
min_temp: 0
max_temp: 120

Exemple avec les ports C8P

Les exemples ci-dessous montrent uniquement les emplacements de ports courants pour le C8P. Pour une utilisation réelle, renseignez le port de thermistance et le port de chauffage en fonction de votre câblage.

Exemple cartouche chauffante C8P

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

Exemple lit chauffant C8P

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

Modèle de capteur

Les valeurs courantes de sensor_type sont Generic 3950, PT1000 ou d'autres modèles intégrés à Klipper. Veuillez vous référer à la désignation du modèle de la cartouche chauffante, du lit chauffant ou du capteur. En cas de doute, consultez en priorité la documentation du produit ou contactez le service après-vente pour confirmation.

Connexion directe PT1000

Le PT1000 peut être connecté directement à une interface thermistance prenant en charge le PT1000. La résistance de tirage (d'échantillonnage) utilisée par le port thermistance des différentes cartes mères n'est pas identique ; elle n'est pas nécessairement 1K, mais peut être couramment 4700, 2200, 1100, 1000, etc. Veuillez vous référer à la documentation de la carte mère ou au matériel lui-même. Certaines cartes mères permettent de basculer la résistance de tirage via un cavalier.

Les exemples ci-dessous utilisent une carte mère avec résistance de tirage 1K. pullup_resistor doit être modifié selon la résistance réelle de votre carte mère :

Exemple connexion directe PT1000 (carte mère avec tirage 1K)

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

Résistance de tirage

• pullup_resistor doit être renseigné selon la résistance de tirage réelle du port thermistance de la carte mère. Les valeurs courantes sont 4700, 2200, 1100, 1000, etc. Il n'y a pas de valeur unique ; consultez d'abord la documentation de la carte mère ou contactez le service après-vente pour confirmation.
• Si le port thermistance de la carte mère utilise le tirage par défaut 4.7K, vous pouvez omettre pullup_resistor ; Klipper applique par défaut 4700.
• Sur les cartes mères avec cavaliers, l'état du cavalier et la configuration doivent être cohérents, sinon la température sera nettement trop élevée, trop basse ou déclenchera une erreur ADC out of range.

Configuration MAX31865

Le MAX31865 est utilisé pour lire les capteurs de température à résistance de platine RTD, couramment divisés en deux catégories : PT100 et PT1000. Cette méthode n'utilise pas la broche ADC de thermistance standard, mais utilise la communication SPI et une broche de sélection de puce.

Capteur	Écriture courante	Exemple de résistance de référence	Description
PT100	rtd_nominal_r: 100	rtd_reference_r: 430	Résistance nominale de la sonde : 100 ohms
PT1000	rtd_nominal_r: 1000	rtd_reference_r: 4300	Résistance nominale de la sonde : 1000 ohms

Confirmez d'abord le type

Le PT100, le PT1000 et le thermocouple de type K ne sont pas le même type de capteur. Le MAX31865 est utilisé uniquement pour les capteurs RTD à résistance de platine tels que PT100/PT1000, et non pour les thermocouples de type K.

Exemple PT100

PT100 + MAX31865

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

Exemple PT1000

PT1000 + MAX31865

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

Précautions concernant le MAX31865

• Le MAX31865 ne peut être utilisé qu'avec le câblage PT100 / PT1000 pris en charge par la carte correspondante ; ne connectez pas une thermistance NTC standard au MAX31865.
• sensor_pin est la broche de sélection de puce du MAX31865, et non une broche ADC de thermistance standard.
• rtd_num_of_wires doit être renseigné selon le nombre réel de fils de la sonde ; les valeurs courantes sont 2, 3 ou 4.
• Pour les cartes avec interrupteurs DIP ou cavaliers, vous devez configurer PT100/PT1000 et le nombre de fils conformément à la documentation du produit, sinon les relevés de température seront anormaux.

Configuration du thermocouple de type K

Le thermocouple de type K doit être associé à une puce de conversion de thermocouple correspondante. Il ne peut pas être connecté directement à une interface thermistance ordinaire, ni à l'interface PT100/PT1000 du MAX31865. La configuration courante utilise le SPI :

Exemple de thermocouple de type 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

Si vous utilisez une autre puce de conversion pour thermocouple de type K, remplacez sensor_type par le modèle réel de la puce, par exemple MAX6675, MAX31855 ou MAX31856, et configurez le SPI selon les instructions du module. tc_type: K indique que la sonde actuelle est un thermocouple de type K.

Exemple avec MAX6675

Thermocouple de type 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

Remarques sur le MAX6675

• Le MAX6675 ne prend pas en charge le paramètre tc_type, il ne peut lire que les thermocouples de type K.
• sensor_pin est la broche de sélection de puce (CS) du MAX6675, et non une broche ADC de thermistance ordinaire.
• Pour les broches du bus SPI (MOSI/MISO/SCK), consultez le manuel de votre carte mère ou carte d'outils pour trouver l'interface SPI correspondante à connecter.

Configuration haute température

Vous ne pouvez augmenter max_temp que si la hotend, la cartouche de chauffe, la thermistance, la buse, la structure de fixation de la hotend et le filament supportent tous les hautes températures. Ne définissez pas max_temp à une valeur bien supérieure aux capacités du matériel simplement pour éliminer une erreur.

Affichage de température indépendant

Si vous souhaitez uniquement afficher la température, sans contrôler un chauffage, vous pouvez utiliser [temperature_sensor xxx].

Température d'enceinte / température ambiante

Exemple de température d'enceinte

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

Température de la carte mère

Exemple de température MCU

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

Température de l'hôte

Exemple de température Host

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

Nom d'affichage

chamber dans [temperature_sensor chamber] est le nom d'affichage côté interface. Vous pouvez le changer en box, toolboard, host, etc., selon l'utilisation réelle. Le nom ne doit pas être identique à une section de configuration existante.

Thermistors courants et thermistors personnalisés

Types de capteurs intégrés à Klipper

Les sensor_type suivants sont intégrés à Klipper et peuvent être utilisés directement sans définir de [thermistor xxx] personnalisé :

sensor_type	Résistance nominale	Méthode de définition	Utilisation courante
Loading...	100K @ 25°C	Méthode à trois points	Configuration par défaut des hotends / lits chauffants des cartes FLY, impression courante PLA/ABS et autres
Loading...	100K @ 25°C	Méthode à trois points	Hotends haute température, thermistances associées aux hotends de type E3D
Loading...	100K @ 25°C	Méthode à trois points	Hotend / lit chauffant universel, courant comme remplacement de NTC génériques
Loading...	100K @ 25°C	Valeur B 4100	Tapis chauffants en silicone, thermistances pour lits chauffants
Loading...	500K @ 25°C	Méthode à trois points	Hotends haute température (mesure jusqu'à 450°C), vérifier la tenue en température de l'ensemble du hotend
Loading...	100K @ 25°C	Méthode à trois points	Hotend / lit chauffant, courant comme remplacement de NTC en montage CMS
Loading...	100K @ 25°C	Valeur B 3974	Hotend / lit chauffant universel
Loading...	100K @ 25°C	Méthode à trois points	Hotend, thermistance à petit boîtier
Loading...	1000 Ω @ 0°C	RTD à résistance de platine	Hotend haute précision ; pullup_resistor doit être renseigné selon la résistance de tirage réelle de la carte mère (courantes : 4700, 2200, 1100, 1000, etc.), voir ci-dessus PT1000 en connexion directe
Loading...	—	Puce de conversion SPI pour thermocouple	Thermocouple type K, jusqu'à environ 1024°C, à utiliser avec un module MAX6675
Loading...	—	Puce de conversion SPI pour thermocouple	Thermocouple type K, jusqu'à environ 1024°C, à utiliser avec un module MAX31855

Conseils de choix

• La configuration d'usine des cartes FLY utilise généralement Generic 3950, vérifiez le modèle d'origine avant de remplacer la thermistance.
• Si vous utilisez un hotend haute température de type E3D ou sa thermistance associée, il s'agit généralement de ATC Semitec 104GT-2.
• En cas de doute sur le modèle, consultez en priorité la fiche produit ou contactez le service après-vente pour confirmation, ne changez pas sensor_type à la légère.

Thermistance personnalisée

Si le capteur ne figure pas dans la liste intégrée ci-dessus, vous pouvez définir une courbe de thermistance personnalisée avec [thermistor xxx].

Emplacement

[thermistor xxx] doit être placé au-dessus de la section de configuration qui l'utilise, c'est-à-dire avant le [extruder], [heater_bed], [temperature_sensor xxx] ou [heater_generic xxx] correspondant.

Il existe deux façons courantes de définir une thermistance personnalisée :

Type de données	Méthode recommandée	Description
Plusieurs points température/résistance	Méthode à trois points	À privilégier, la courbe de température est plus proche du capteur réel
Uniquement résistance nominale et valeur B	Méthode de la valeur B	Plus simple à écrire, mais la précision en plage haute température peut être inférieure à la méthode à trois points

Exemple de méthode à trois points

L'exemple ci-dessous utilise les paramètres de ATC Semitec 104GT-2 pour illustrer la méthode à trois points. On définit d'abord [thermistor semitec_104gt2], puis on l'utilise dans [extruder] :

ATC Semitec 104GT-2 méthode à trois points

[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

L'exemple ci-dessous utilise les paramètres de EPCOS 100K B57560G104F :

EPCOS 100K B57560G104F méthode à trois points

[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

Choix des trois points

Les trois points doivent couvrir autant que possible la plage de températures d'impression courante, par exemple la température ambiante, une température moyenne et la température maximale d'usage. Si la fiche technique fournit un tableau température/résistance, choisissez en priorité trois points dans ce tableau.

Méthode de la valeur B

Si le fabricant ne fournit que la résistance nominale et la valeur B, vous pouvez utiliser temperature1, resistance1 et beta :

100K B3950 méthode de la valeur 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 méthode de la valeur 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

Configuration de thermistance haute température

Les paramètres de thermistance haute température ci-dessous proviennent des tables de thermistances du code source du firmware Marlin, validées par les fiches techniques des fabricants, et conviennent aux hotends haute température nécessitant une mesure au-delà de 300°C. Avant utilisation, vérifiez que le hotend, la cartouche chauffante, la buse et le filament supportent la température correspondante.

ATC Semitec 204GT-2 (200K / 300°C)

# R25 = 200K, B25 = 4338, tirage 4.7K
# Source : Marlin thermistor_2.h, validé par fiche technique fabricant 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

Remarques sur le 204GT-2

• La résistance nominale de 200K offre une résistance plus élevée en plage haute température, ce qui procure une meilleure résolution ADC au-dessus de 250°C par rapport aux thermistances 100K.
• Adapté aux hotends haute température de niveau 300°C, pour l'impression de filaments haute température tels que PEI, PC, PA.
• Le tirage standard de 4.7 kΩ suffit, aucun changement de résistance de tirage nécessaire.

Formbot / Vivedino 100K B3950 version haute température (350°C)

# R25 = 100K, B25/50 = 3950, tirage 4.7K
# Source : 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

Limite de précision des 100K en haute température

Une thermistance 100K n'a qu'environ 63 Ω à 300°C, un écart considérable avec le tirage de 4.7 kΩ, ce qui donne une faible résolution ADC en plage haute température. Si vous imprimez régulièrement au-dessus de 300°C, il est conseillé de privilégier une thermistance 200K (204GT-2) ou 500K (SliceEngineering 450).

Dyze Design 2.5M B4500（500°C）

# R25 = 2.5M, B25 = 4500, doit être associé à une résistance de pull-up de grande valeur
# Source : paramètres commentés dans 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

Exigence de pull-up pour thermistance 2.5M

• La résistance nominale de 2.5 MΩ à température ambiante est bien supérieure au pull-up standard de 4.7 kΩ. Avec le pull-up par défaut, l'ADC est presque saturé dans la plage basse température, rendant la mesure imprécise.
• Il faut impérativement utiliser une résistance de pull-up de 470 kΩ ou plus, et définir pullup_resistor: 470000 dans la configuration.
• Si la carte mère ou la carte d'outil ne permet pas de changer la résistance de pull-up, n'utilisez pas cette thermistance. Utilisez plutôt un PT1000 + MAX31865 ou une solution à thermocouple de type K.
• Pour les mesures à 500°C, vérifiez également que la cartouche chauffante, la buse, la structure du hotend et le filament satisfont tous aux exigences de tenue en température.

Choix de solution haute température

Température cible	Solution recommandée	Remarques
≤ 300°C	Loading... ou Loading...	La configuration standard suffit
300°C ~ 350°C	Loading...	Nécessite d'ajouter d'abord la configuration [thermistor] personnalisée correspondante de cette page
350°C ~ 450°C	Loading...	Intégré à Klipper, renseigner directement sensor_type
450°C ~ 500°C	Loading... ou Loading...	Nécessite d'ajouter d'abord la configuration [thermistor] personnalisée correspondante de cette page, ou utiliser un thermocouple de type K
Au-dessus de 500°C	Loading...	Les thermistances NTC ne conviennent pas

Modèle générique à trois points

Si vous disposez d'une fiche technique mais pas de paramètres prêts à l'emploi, vous pouvez remplir le modèle ci-dessous :

Modèle à trois points

[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

Limites des thermistances haute température

max_temp ne peut être défini qu'en fonction de la capacité réelle de tenue en température du hotend, de la cartouche chauffante, de la thermistance, de la buse et du filament. Une configuration NTC haute température capable de lire des températures plus élevées ne signifie pas que l'ensemble du hotend peut chauffer en toute sécurité jusqu'à cette température.

Vérifications après modification

Après avoir enregistré la configuration et redémarré Klipper, procédez aux vérifications suivantes dans l'ordre :

1. Vérifiez si la température affichée sur l'interface est proche de la température ambiante.
2. Si ADC out of range, une température extrêmement élevée, extrêmement basse ou négative s'affiche, arrêtez d'abord le chauffage, coupez l'alimentation, puis vérifiez les connecteurs, les fils et le type de capteur.
3. Confirmez que sensor_pin n'est pas utilisé par une autre fonction.
4. Confirmez que sensor_type, pullup_resistor, rtd_nominal_r, rtd_reference_r correspondent au matériel réel.
5. Après avoir remplacé le capteur de la tête chaude ou du lit chauffant, effectuez à nouveau l'étalonnage PID et enregistrez les résultats.

Pour les erreurs courantes de température et de chauffage, consultez : Erreurs de température, chauffage et extrusion.