Aller au contenu principal

Erreurs de configuration

Cette page rassemble les problèmes liés aux conflits de sections de configuration, aux fautes d'orthographe des paramètres, aux fichiers include et à SAVE_CONFIG. Après avoir modifié la configuration, veuillez d'abord consulter la première erreur de configuration dans klippy.log, puis traiter les problèmes un par un.

homing override method always homes X and Y before homing Z​

Message d'erreur : Conflit entre le retour à l'origine Z sécurisé et la configuration de remplacement du retour à l'origine.

Loading...

Cause de l'erreur : [safe_z_home] et [homing_override] sont tous deux configurés, ce qui empêche Klipper de déterminer la logique de retour à l'origine à utiliser.

Solution :

  1. Recherchez [safe_z_home] et [homing_override] dans le fichier de configuration.
  2. Ne conservez qu'un seul élément en fonction de la logique de retour à l'origine réelle de la machine.
  3. Enregistrez et redémarrez Klipper.

Références de configuration associées : Guide de retour à l'origine et d'orientation, Configuration de référence pour le remplacement du retour à l'origine.

Option 'xxx' is not valid in section 'yyy'​

Message d'erreur : Option 'xxx' is not valid in section 'yyy', un nom d'option non reconnu existe dans la section de configuration spécifiée.

Causes courantes :

  • Faute d'orthographe du nom de l'option, par exemple sensor_pin écrit comme sensor_ping.
  • Coller par erreur une option d'une autre section de configuration dans la section actuelle, par exemple écrire une option de [probe] dans [stepper_z].
  • Après une mise à niveau de Klipper, une option prise en charge par une version antérieure a été supprimée ou renommée.
  • Utilisation de contenu de commentaire qui n'est pas un paramètre réel, par exemple default_parameter_z.

Solution :

  1. Vérifiez attentivement la section de configuration et le nom de l'option indiqués dans l'erreur, et confirmez l'orthographe.
  2. Référez-vous au document de référence de configuration Klipper pour confirmer à quelle section de configuration cette option appartient.
  3. Si vous avez récemment mis à niveau Klipper, consultez le journal des modifications de configuration pour voir si l'option a changé.
  4. Supprimez ou déplacez les options invalides vers la section de configuration correcte.

Référence de configuration associée : Instructions de modification de configuration.

Section 'xxx' is not a valid config section​

Message d'erreur : Section 'xxx' is not a valid config section, Unknown config object, ou une section de configuration ne peut pas être reconnue par Klipper.

Causes courantes :

  • Faute d'orthographe du nom de la section de configuration, par exemple [bed_mesh] écrit comme [bedmesh].
  • La version actuelle de Klipper ne prend pas en charge cette section de configuration, ou le format de configuration n'est pas compatible après une mise à jour/une rétrogradation.
  • Copie de la configuration d'un plugin tiers, mais le plugin, le module d'extension ou la branche Klipper correspondant n'est pas installé.
  • Le fichier include conserve des sections de configuration d'une autre machine ou d'une autre carte mère.

Solution :

  1. En fonction du nom de la section de configuration dans l'erreur, localisez le paragraphe correspondant dans printer.cfg et tous les fichiers include.
  2. Confirmez que l'orthographe est cohérente avec la référence de configuration Klipper. N'utilisez pas de parenthèses chinoises ou de signes pleine largeur pour les noms de sections de configuration.
  3. Si la configuration provient d'un plugin tiers ou d'un package de macros personnalisé, confirmez que le plugin correspondant est installé et compatible avec la version actuelle de Klipper.
  4. Si vous n'êtes pas sûr de l'utilité de ce paragraphe, commencez par commenter cette section de configuration, redémarrez pour tester, puis restaurez-la élément par élément.

Référence de configuration associée : Instructions de modification de configuration.

Unable to open config file / Include file does not exist​

Message d'erreur : Unable to open config file /home/xxx/printer_data/config/printer.cfg ou Include file 'xxx.cfg' does not exist.

Causes courantes :

  • Le chemin du fichier printer.cfg est incorrect ou le fichier a été supprimé par erreur.
  • Le fichier de sous-configuration référencé par [include] n'existe pas ou le nom du fichier ne correspond pas.
  • Des outils d'installation comme KIAUH génèrent automatiquement une référence [include], mais le fichier .cfg correspondant n'est pas installé.
  • Un problème de permissions empêche Klipper de lire le fichier de configuration.

Solution :

  1. Confirmez que printer.cfg existe dans le répertoire de configuration de Klipper, généralement ~/printer_data/config/printer.cfg.
  2. Vérifiez toutes les lignes [include xxx.cfg] et confirmez que les fichiers référencés existent réellement.
  3. Si fluidd.cfg ou mainsail.cfg manque, référez-vous à la documentation d'installation de l'interface Web correspondante pour compléter la configuration.
  4. Assurez-vous que les permissions du fichier de configuration sont correctes : ls -la ~/printer_data/config/.

Unable to parse option / option must be specified​

Message d'erreur : Unable to parse option 'xxx' in section 'yyy', Option 'xxx' in section 'yyy' must be specified, ou must have minimum/maximum, must be above/below.

Causes courantes :

  • Un paramètre obligatoire est manquant, par exemple [extruder] manque step_pin, dir_pin, heater_pin ou sensor_type.
  • Format de paramètre incorrect, par exemple un nombre est attendu mais du texte est saisi, ou une liste de coordonnées manque de virgules.
  • La valeur du paramètre dépasse la plage autorisée par Klipper, par exemple run_current, max_temp, position_max défini de manière déraisonnable.
  • Laisser des signes de ponctuation chinois, des signes pleine largeur ou des caractères invisibles lors de la copie de la configuration.

Solution :

  1. En fonction de la section de configuration et du nom du paramètre dans l'erreur, revenez au fichier .cfg correspondant et vérifiez chaque élément.
  2. Pour les paramètres numériques, de coordonnées et de liste, confirmez que le format est cohérent avec l'exemple, par exemple mesh_min: 20, 20.
  3. Pour must be above/below ou minimum/maximum, restaurez d'abord la valeur recommandée par l'exemple officiel ou le tutoriel de la carte mère.
  4. Après avoir enregistré, exécutez RESTART. Si l'échec persiste, consultez la première erreur de configuration dans klippy.log.

Référence de configuration associée : Instructions de modification de configuration.

Unknown pin chip name / pin used multiple times​

Message d'erreur : Unknown pin chip name 'xxx', Invalid pin description 'xxx', pin xxx used multiple times in config.

Causes courantes :

  • Dans une configuration multi-MCU, le préfixe de broche est mal écrit, par exemple EBBCan:PB0 devrait être écrit mais un nom de MCU inexistant est utilisé.
  • Faute d'orthographe du nom de la broche, ou copier directement la broche du tutoriel de la carte mère vers une autre carte mère.
  • Une même broche physique est occupée par plusieurs fonctions, par exemple un ventilateur, un chauffage et une butée utilisent la même broche.
  • L'inversion de broche !, la résistance de tirage ^, la résistance de rappel ~ sont écrites à la mauvaise position.

Solution :

  1. Vérifiez si le nom de [mcu xxx] est exactement le même que le préfixe de la broche, y compris la casse.
  2. En vous référant au diagramme des broches de la carte mère, confirmez que chaque pin:, step_pin:, dir_pin: et heater_pin: appartient à la carte mère actuelle.
  3. Recherchez la broche signalée dans tous les fichiers include et supprimez ou remplacez les éléments en double.
  4. Les modificateurs de broche doivent être écrits avant le nom de la broche, par exemple ^PB7, !PC13, mcu2:^PB7.

Références de configuration associées : Instructions de modification de configuration, Configuration de référence du ventilateur.

gcode command XXX already registered​

Message d'erreur : Error: gcode command XXX already registered.

Cause de l'erreur : Deux macros ou modules système différents enregistrent le même nom de commande G-code, par exemple deux macros définissent toutes deux [gcode_macro NEXT].

Scénarios courants :

  • Conflit entre une macro personnalisée de l'utilisateur et un module système Klipper ou une configuration tierce.
  • Plusieurs définitions [gcode_macro M600].

Solution :

  1. Recherchez les définitions en double dans printer.cfg et tous les fichiers [include].
  2. Supprimez ou renommez le [gcode_macro] en conflit.
  3. Vérifiez les macros courantes telles que [homing_override], [gcode_macro PAUSE], [gcode_macro RESUME], [gcode_macro CANCEL_PRINT].

Référence de configuration associée : Introduction aux macros.

Échec de SAVE_CONFIG ou conflit de configuration​

Message d'erreur : Après avoir exécuté SAVE_CONFIG, un message indique Unable to write config, Option conflict, Cannot save config, ou l'imprimante ne peut pas démarrer après l'enregistrement.

Causes courantes :

  • Permissions insuffisantes sur le fichier printer.cfg, le processus Klipper ne peut pas écrire, ce qui est courant après avoir édité le fichier de configuration avec sudo.
  • Conflit entre un élément de configuration dans la zone de sauvegarde automatique (bloc marqué #*#) et la même option dans un fichier [include] manuel.
  • Le MCU est déjà en état d'arrêt (shutdown), SAVE_CONFIG ne peut pas envoyer correctement la nouvelle configuration.
  • Erreur de syntaxe ou troncature à la fin du fichier printer.cfg, entraînant un échec d'écriture de la zone de sauvegarde automatique.
  • Plusieurs fichiers include définissent de manière redondante des paramètres qui ne doivent pas être automatiquement sauvegardés par SAVE_CONFIG, comme PID, Z offset.

Solution :

  1. Confirmez les permissions du fichier de configuration :

    ls -la ~/printer_data/config/printer.cfg

    Si le propriétaire n'est pas l'utilisateur actuel, exécutez : sudo chown $USER:$USER ~/printer_data/config/printer.cfg

  2. Si l'imprimante ne peut pas démarrer après SAVE_CONFIG, ouvrez printer.cfg et vérifiez la zone de sauvegarde automatique #*# en bas.

  3. Si la même option existe également dans le fichier include, supprimez le doublon dans la zone de sauvegarde automatique, ou gérez-la de manière centralisée dans le fichier include.

  4. Si le MCU est en état d'arrêt, exécutez d'abord FIRMWARE_RESTART, puis réexécutez SAVE_CONFIG.

  5. Si les permissions sont normales mais que l'écriture est toujours impossible, vérifiez l'espace disque : df -h ~/printer_data/.

Référence de configuration associée : Instructions de modification de configuration.

Loading...