Instructions de remplacement des broches

Cette page est destinée à guider les utilisateurs pour modifier une configuration Klipper existante afin de l'adapter aux broches de la carte FLY actuelle. De nombreuses configurations trouvées en ligne ne peuvent être utilisées que comme référence structurelle et ne doivent pas être copiées directement. Avant de les utiliser, il est nécessaire de remplacer les broches correspondantes en fonction du modèle de carte réel, de l'emplacement des interfaces et de la méthode de câblage.

Déconnexion

Avant de commencer, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Ne branchez pas, ne débranchez pas les faisceaux de câbles, ne réorganisez pas l'ordre des fils des interfaces et ne touchez pas aux bornes lorsque l'appareil est sous tension.

Note d'application

• Cet article explique uniquement comment trouver et remplacer les broches dans la configuration, et ne fournit pas une configuration complète prête à l'emploi pour une machine spécifique.
• Des paramètres tels que position_max, rotation_distance, microsteps, run_current, sensor_type doivent être confirmés en fonction de la machine et du matériel réels. Ne les copiez pas aveuglément simplement parce que vous avez changé de carte mère.
• Pour les broches de la carte mère, veuillez vous référer à la documentation du produit FLY correspondante, au marquage sur la carte mère et à la configuration de référence officielle.

Approche de modification

Lors de la modification de la configuration, il est recommandé de procéder dans l'ordre suivant :

1. Identifiez le modèle de la carte mère FLY actuellement utilisée.
2. Ouvrez la documentation du produit correspondant à la carte mère pour trouver les descriptions des broches des connecteurs moteur, des fins de course, des ventilateurs, des cartouches chauffantes, des thermistances, etc. Vous pouvez également vous référer directement à la configuration de référence Klipper pour la carte mère correspondante.
3. Dans le fichier printer.cfg et tous les fichiers [include], trouvez les sections de fonctionnalités à modifier.
4. Recherchez la nouvelle broche que vous prévoyez d'utiliser et assurez-vous qu'elle n'est pas déjà occupée par une autre configuration activée.
5. Remplacez uniquement les éléments de broches liés aux interfaces de la carte mère, et conservez les symboles nécessaires !, ^, ~.
6. Enregistrez la configuration et redémarrez Klipper.
7. Testez chaque fonction individuellement, ne mettez pas tous les périphériques sous tension en même temps pour un test global.

Sections de fonctionnalités courantes

Fonction	Section de configuration courante	Éléments couramment remplacés
Moteurs X / Y / Z	[stepper_x], [stepper_y], [stepper_z]	step_pin, dir_pin, enable_pin, endstop_pin
Moteur d'extrudeuse	[extruder]	step_pin, dir_pin, enable_pin
Communication du driver TMC	[tmc2209 stepper_x], [tmc5160 stepper_x], etc.	uart_pin, cs_pin, spi_software_mosi_pin, spi_software_miso_pin, spi_software_sclk_pin, diag_pin
Cartouche chauffante	[extruder]	heater_pin, sensor_pin
Chauffage du lit	[heater_bed]	heater_pin, sensor_pin
Ventilateurs	[fan], [heater_fan xxx], [fan_generic xxx]	pin, tachometer_pin
Fin de course	[stepper_x], [stepper_y], [stepper_z]	endstop_pin
Palpeur	[probe], [bltouch]	pin, sensor_pin, control_pin
LED / Buzzer	[output_pin xxx], [neopixel xxx]	pin

Trouver la configuration correspondante

Si vous n'êtes pas sûr du fichier dans lequel se trouve la configuration, il est recommandé d'utiliser l'interface web de configuration.

1. Ouvrez l'interface web de l'imprimante dans un navigateur, par exemple Fluidd ou Mainsail.
2. Accédez à la page des fichiers de configuration et ouvrez printer.cfg.
3. Utilisez la fonction de recherche du navigateur ou de l'éditeur pour rechercher les mots-clés ci-dessous.
4. Si vous voyez [include xxx.cfg], cela signifie qu'une partie de la configuration se trouve dans un autre fichier ; vous devez ouvrir ce fichier include pour continuer la recherche.

Méthodes de recherche courantes :

• Rechercher l'axe X : recherchez [stepper_x]
• Rechercher l'axe Y : recherchez [stepper_y]
• Rechercher l'axe Z : recherchez [stepper_z]
• Rechercher l'extrudeuse : recherchez [extruder]
• Rechercher le lit chauffant : recherchez [heater_bed]
• Rechercher les ventilateurs : recherchez [fan], [heater_fan, [fan_generic
• Rechercher les drivers : recherchez [tmc2209, [tmc5160, [tmc2240
• Rechercher les éléments de broches : recherchez step_pin, dir_pin, enable_pin, heater_pin, sensor_pin, endstop_pin, uart_pin, cs_pin

Conseil de recherche

La configuration n'est généralement pas écrite entièrement dans un seul fichier printer.cfg. Si vous voyez des lignes comme [include mainsail.cfg], [include fluidd.cfg], [include printer/*.cfg], [include xxx.cfg], vous devez ouvrir le fichier correspondant pour voir la configuration réelle.

Vérifier les conflits de broches

Avant de remplacer une broche, recherchez d'abord la nouvelle broche que vous prévoyez d'utiliser pour vous assurer qu'elle n'est pas déjà utilisée par une autre fonction. Dans Klipper, une même broche GPIO physique ne peut généralement être assignée qu'à une seule fonction. Si elle est utilisée plusieurs fois, vous pourriez obtenir l'erreur pin xxx used multiple times in config.

Lors de la recherche, supprimez les modificateurs placés devant la broche. Par exemple, si vous prévoyez d'utiliser !PA15, recherchez PA15 ; si vous prévoyez d'utiliser ^PD9, recherchez PD9.

Emplacement trouvé	Doit-il être traité ?	Explication
Même élément dans la même section fonctionnelle	Généralement non	Par exemple, step_pin apparaissant dans la section [stepper_x] que vous modifiez
Ligne d'exemple commentée	Généralement non	Les lignes commençant par # ne sont pas actives
Autre section fonctionnelle activée	Oui	Une même broche ne peut pas être utilisée simultanément pour un ventilateur, un chauffage, une fin de course, un palpeur, etc.
diag_pin du driver TMC partagé avec la fin de course physique	Choisir l'un ou l'autre	Lorsque vous utilisez une fin de course physique, n'activez pas diag_pin sur la même broche. Lorsque vous utilisez le « sensorless homing », endstop_pin doit être changé pour virtual_endstop du driver correspondant.
Broches de plusieurs MCU	Vérifier le préfixe	toolboard:PA0 et PA0 de la carte mère ne sont pas sur le même MCU, mais le préfixe doit correspondre au nom [mcu toolboard]

Broche en conflit

Si après l'enregistrement, vous obtenez l'erreur pin xxx used multiple times in config, retournez à l'interface web de configuration, recherchez xxx (l'élément signalé dans l'erreur) dans printer.cfg et tous les fichiers include. Gardez la fonction correcte et supprimez, commentez ou modifiez les autres occurrences en conflit.

Explication des symboles de broches

Les broches Klipper peuvent être précédées de symboles spéciaux. Ne les supprimez pas lors du remplacement :

Symbole	Signification	Emplacement courant
!	Inversion du niveau logique	dir_pin, enable_pin, endstop_pin
^	Activation de la résistance de tirage (pull-up)	Entrée de fin de course mécanique, palpeur
~	Activation de la résistance de rappel (pull-down)	Quelques signaux d'entrée
mcu1:PA0	Spécifie une broche d'un MCU particulier	Configuration multi-MCU ou carte outil

Par exemple :

enable_pin: !PC3
endstop_pin: ^PA1
sensor_pin: toolboard:PA0

La broche réelle dans !PC3 est PC3, ! signifie simplement inverser le niveau logique. Lorsque vous la remplacez pour une nouvelle carte mère, vous devez l'écrire comme !<nouvelle_broche_enable>, ne supprimez pas simplement !.

Exemple de remplacement

Supposons que la configuration précédente pour l'axe X utilisait des broches d'une autre carte mère :

Avant modification

[stepper_x]
step_pin: PA3
dir_pin: PA2
enable_pin: !PA1
endstop_pin: ^PB10

Prenons l'exemple du connecteur moteur de l'axe X sur une FLY-C8P. Après avoir consulté la documentation de la carte C8P, vous pouvez modifier les broches du connecteur moteur X et du connecteur de fin de course X. Avant de modifier, recherchez PE5, PA8, PA15, PD9 pour vous assurer que ces broches ne sont pas déjà utilisées par d'autres configurations activées.

Après modification

[stepper_x]
step_pin: PE5
dir_pin: !PA8
enable_pin: !PA15
endstop_pin: ^PD9

Si l'axe X utilise un driver TMC2209, vous devez également vérifier les broches de communication du driver correspondant :

Après modification

[tmc2209 stepper_x]
uart_pin: PC9
run_current: 0.800

Note sur l'exemple

L'exemple ci-dessus montre uniquement la syntaxe pour le connecteur moteur X d'une FLY-C8P. Si votre moteur est connecté à un autre connecteur moteur, ou si vous n'utilisez pas une C8P, veuillez vous référer à la documentation de votre carte mère et à votre câblage réel, ne copiez pas directement.

Si le sens du moteur est inversé, il suffit généralement d'ajouter ou de supprimer ! devant dir_pin. Par exemple, si c'est dir_pin: !PA8, passez à dir_pin: PA8 ; et vice-versa.

Si l'état du fin de course est inversé, vérifiez généralement la présence et la combinaison de ! et ^ devant endstop_pin par rapport à votre méthode de câblage réelle :

endstop_pin: ^!PD9

Remplacement par fonction

Moteurs et drivers

Pour un même moteur, vous devez généralement vérifier les deux sections de configuration [stepper_x] et [tmc2209 stepper_x] (voir l'exemple complet dans la section « Exemple de remplacement » ci-dessus). Lors du remplacement des broches, faites également attention aux points suivants :

Type de driver

Les sections [tmc2209 stepper_x], [tmc5160 stepper_x], [tmc2240 stepper_x] doivent correspondre au type de driver réel. Lorsque vous changez de carte mère, ne modifiez pas seulement les broches, assurez-vous également que le type de driver, le mode de communication et les paramètres de résistance de shunt sont compatibles.

Homing sans fin de course

L'exemple pour le connecteur de fin de course X sur une C8P est PD9. Si vous utilisez le « sensorless homing », vous ne devez pas utiliser endstop_pin: ^PD9. Remplacez-le par virtual_endstop en fonction du type de driver et activez le diag_pin correspondant dans la configuration TMC. Ne mélangez pas une fin de course physique et le « sensorless homing » sur la même broche.

Exemple homing sans fin de course

[stepper_x]
endstop_pin: tmc2209_stepper_x:virtual_endstop
homing_speed: 40
homing_retract_dist: 0

[tmc2209 stepper_x]
uart_pin: PC9
diag_pin: ^PD9
run_current: 0.800

Chauffage et température

La cartouche chauffante se trouve généralement dans [extruder] :

printer.cfg

[extruder]
heater_pin: PD12
sensor_pin: PC2
sensor_type: Generic 3950

Le chauffage du lit se trouve généralement dans [heater_bed] :

printer.cfg

[heater_bed]
heater_pin: PB0
sensor_pin: PC5
sensor_type: Generic 3950

Ce qui précède est un exemple courant pour la cartouche et le lit sur une C8P. heater_pin correspond à la sortie de chauffage, sensor_pin à l'entrée de la thermistance. Ne les inversez pas et n'écrivez pas la même broche de thermistance dans plusieurs capteurs de température simultanément. L'exemple sensor_type est Generic 3950, mais utilisez le type réel de votre thermistance (d'autres types courants sont ATC Semitec 104GT-2, PT1000, etc.).

Ventilateurs

Écriture courante pour le ventilateur de refroidissement du modèle :

printer.cfg

[fan]
pin: PA0

Écriture courante pour le ventilateur de refroidissement du hotend :

printer.cfg

[heater_fan hotend_fan]
pin: PA1
heater: extruder
heater_temp: 50.0

Ce qui précède est un exemple pour les connecteurs de ventilateur sur une C8P. Avant de remplacer, recherchez PA0, PA1 pour vous assurer que ces broches ne sont pas déjà utilisées par [output_pin], [fan_generic] ou d'autres configurations de ventilateur. Si les connecteurs de ventilateur de votre carte mère sont divisés en « toujours allumé » et « contrôlable », vérifiez dans la documentation si le connecteur de ventilateur correspondant prend en charge la commande PWM.

Palpeur et fins de course

Écriture courante pour une fin de course mécanique :

printer.cfg

[stepper_x]
endstop_pin: ^PD9

Écriture courante pour un palpeur standard :

printer.cfg

[probe]
pin: ^PC0

Écriture courante pour un palpeur de type BLTouch :

printer.cfg

[bltouch]
sensor_pin: ^PC0
control_pin: PE6

Signaux d'entrée

Ce qui précède est un exemple pour les connecteurs de fin de course et de palpeur sur une C8P. N'utilisez qu'un seul type parmi [probe] standard et [bltouch], n'activez pas la même broche de signal de palpeur pour les deux en même temps. La nécessité d'ajouter ^ ou ! pour les signaux d'entrée comme les fins de course et les palpeurs dépend du type de module et de la méthode de câblage. Avant de modifier, recherchez PD9, PC0, PE6 pour confirmer qu'il n'y a pas de conflit ; après modification, utilisez d'abord les commandes QUERY_ENDSTOPS, QUERY_PROBE dans la console web pour vérifier l'état de déclenchement, avant d'effectuer un homing ou un nivellement.

Enregistrement et vérification

Une fois les modifications terminées, cliquez sur SAVE & RESTART dans le coin supérieur droit de la page web pour enregistrer et redémarrer Klipper. Si les modifications concernent des configurations bas niveau comme la connexion MCU, la communication des drivers, il peut être nécessaire d'exécuter FIRMWARE_RESTART dans la console au lieu d'un simple RESTART.

Il est recommandé de vérifier dans l'ordre suivant :

1. Vérifiez que Klipper démarre correctement, sans erreurs de configuration comme Unknown pin chip name, Pin is not a valid pin name, Unable to parse option.
2. Si vous obtenez l'erreur pin xxx used multiple times in config, recherchez et résolvez d'abord le conflit pour la broche xxx avant de continuer les tests.
3. Utilisez QUERY_ENDSTOPS dans la console web pour vérifier que l'état des fins de course est correct.
4. Testez individuellement les ventilateurs, le chauffage et le palpeur, ne testez pas plusieurs périphériques en même temps.
5. Testez la direction des moteurs avec de petits déplacements, par exemple 1mm ou 5mm.
6. Une fois que la direction, les fins de course, la température et les ventilateurs sont confirmés comme fonctionnant correctement, procédez aux tests de homing et d'impression.

Problèmes courants

Problème	Cause fréquente	Direction à prendre
Le moteur ne bouge pas	Niveau logique de enable_pin incorrect, broche de communication du driver erronée, type de driver configuré incompatible	Vérifiez si enable_pin a besoin du !, vérifiez la section de configuration TMC
Le sens du moteur est inversé	Niveau logique de dir_pin inadapté	Ajoutez ou supprimez ! devant dir_pin
Fin de course toujours déclenché	Configuration d'inversion ou de résistance de tirage endstop_pin inadaptée	Vérifiez ^ et !, exécutez QUERY_ENDSTOPS pour valider
Erreur de broche en conflit après enregistrement	Même GPIO utilisé par plusieurs fonctions	Recherchez le nom de la broche dans l'erreur, supprimez, commentez ou modifiez les occurrences en conflit
Erreur de communication TMC	Broche uart_pin / cs_pin / SPI erronée, ou type de driver différent	Revérifiez les broches de communication en fonction du connecteur du driver sur la carte mère
Aucune réaction du chauffage	heater_pin mal renseigné, ou connecté à une sortie non contrôlable	Vérifiez le numéro du connecteur de chauffage et la documentation de la carte mère
Température anormale	sensor_pin ou sensor_type inadapté	Vérifiez le connecteur de la thermistance et le type de thermistance
Ventilateur non contrôlable	pin mal renseigné, ou connecté à un ventilateur toujours allumé	Passez à un connecteur de ventilateur prenant en charge le contrôle et modifiez la configuration

Pour plus d'informations sur l'installation de la carte mère, veuillez consulter : Précautions courantes pour la carte mère.

Dépannage des erreurs de broche : Broche inconnue / broche utilisée plusieurs fois