Aller au contenu principal

Guide de connexion MCU

Instructions d'application

Ce guide est utilisé pour diagnostiquer et résoudre les problèmes de connexion entre le MCU et Klipper.

Préparations et précautions​

  • Équipement hôte non recommandé : Évitez d'utiliser des appareils tels que les téléphones Redmi, les clés WiFi, les boîtiers TV, etc. Ils utilisent souvent des systèmes personnalisés ou modifiés, ce qui peut empêcher la reconnaissance correcte du MCU.
  • Confirmer le nombre de sous-unités : Veuillez confirmer à l'avance le nombre de sous-unités utilisées (comme les cartes d'outillage), car plusieurs sous-unités peuvent affecter la connexion.
  • Simplifier le câblage : Il est recommandé de retirer temporairement tous les câbles à l'exception du câble de données sur la carte mère et la carte d'outillage, en ne conservant que la connexion de données nécessaire pour éliminer les interférences.
  • Interface recommandée : Il est recommandé d'utiliser l'interface Fluidd, qui affiche plus intuitivement l'état de connexion du MCU.

Première étape : Sauvegarder et réinitialiser la configuration​

1. Accéder à l'interface de l'ordinateur hôte​

Saisissez l'adresse IP de l'ordinateur hôte dans le navigateur (ex : 192.168.101.179) pour y accéder.

Loading...

2. Localiser le fichier de configuration​

Entrez dans l'interface WEB et trouvez l'option de configuration dans la barre latérale gauche :

Utilisateurs de Fluidd : Cliquez sur ..., puis trouvez printer.cfg.

Loading...

Utilisateurs de Mainsail : Cliquez sur Machine, puis trouvez printer.cfg.

Loading...

3. Sauvegarder le fichier de configuration​

Faites un clic droit sur le fichier printer.cfg, sélectionnez Duplicate pour le copier, et renommez la copie en :

printer_Backup.cfg

Exemple de manipulation Fluidd :

Loading...

Exemple de manipulation Mainsail :

Loading...

4. Réinitialiser le fichier de configuration​

Rouvrez le fichier printer.cfg, effacez tout son contenu et collez la configuration de base suivante :

[mcu]
serial: /tmp/klipper_host_mcu

[printer]
kinematics: none
max_velocity: 200
max_accel: 1000

5. Sauvegarder et redémarrer​

  • Cliquez sur SAVE & RESTART dans le coin supérieur droit. Klipper enregistrera la configuration et redémarrera le service.
  • Si une erreur apparaît, ignorez-la temporairement.
  • Ensuite, mettez tous les appareils hors tension (y compris l'ordinateur hôte et toutes les sous-unités).
  • Important : Assurez-vous que la coupure de courant est complète, sinon les étapes suivantes ne pourront pas être effectuées.

Deuxième étape : Détecter les appareils et confirmer le type de firmware​

Conditions préalables​

  • Ordre des appareils principaux : Le premier MCU doit être la carte mère, et non la carte d'outillage.
  • Type de firmware : Confirmez que le firmware de votre carte mère FLY est un firmware USB ou un firmware USB bridge CAN. Ce guide ne s'applique pas aux autres types.
  • Méthode de connexion : Veuillez d'abord vous connecter en SSH. Cette opération doit être effectuée via le réseau.

Procédure​

  1. Effectuer la détection des appareils

    • Après une connexion SSH réussie, exécutez la commande suivante : 
      lsusb
    • Le système listera tous les périphériques USB reconnus.

  2. Gérer les anomalies de commande

    • Si la commande lsusb n'est pas trouvée, installez-la d'abord : 
      sudo apt-get install usbutils
    • Si aucun appareil n'apparaît après l'exécution, il est recommandé de changer d'ordinateur hôte.

  3. Identifier les informations de l'appareil À l'aide des schémas ci-dessous, identifiez votre appareil dans la sortie de lsusb :

    Loading...
    Loading...

  4. Vérifier le type de firmware

    • En fonction du firmware que vous avez flashé, vérifiez les informations clés suivantes dans le résultat de lsusb :
      • Firmware USB : Doit afficher 1d50:614e
      • Firmware USB bridge CAN : Doit afficher 1d50:606f
      • Firmware USB Katapult : Doit afficher 1d50:6177
      • Adaptateur RS232 (avec UTOR ou carte mère D8/D8PRO) : Doit afficher 1a86:7523 (avec G2T, cette étape n'est pas nécessaire)

Troisième étape : Rechercher l'ID de l'appareil​

Remarques importantes​

  • Recherche d'ID USB : Applicable uniquement aux firmwares USB, ne peut pas être utilisée pour CAN ou RS232.
  • Recherche d'ID CAN : Applicable uniquement aux périphériques de bus CAN, ne peut pas être utilisée pour USB ou RS232.
  • Recherche d'ID RS232 : Applicable uniquement au firmware RS232, ne peut pas être utilisée pour USB ou CAN.
  • Spécificité du RS232 : Le firmware RS232 est généralement utilisé uniquement pour les cartes d'outillage, pas pour le MCU principal.

Choisir la méthode selon le type de firmware​

Périphérique avec firmware USB Exécutez la commande suivante pour rechercher l'ID USB :

ls /dev/serial/by-id/*

Périphérique USB bridge CAN Selon votre type de système, choisissez la commande correspondante pour rechercher l'ID CAN :

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

Périphérique avec firmware RS232 Exécutez la commande suivante pour rechercher le chemin du périphérique RS232 :

ls /dev/serial/by-path/*

Interprétation et traitement des résultats​

Résultat de la recherche d'ID USB​

Après exécution de la commande, le terminal affichera un ID de périphérique similaire à ceci (exemple) :

  • ✅ Utilisable directement : Si l'ID est marqué comme Klipper après le champ usb-

  • ⚠️ Nécessite un flash du firmware : Si l'ID est marqué comme katapult après le champ usb-

    Loading...

Résultat de la recherche d'ID CAN​

Après exécution de la commande, évaluez en fonction de la situation réelle :

  • ✅ Utilisable directement : Si l'ID affiché est marqué comme Klipper dans le champ Application: à la fin.
  • ⚠️ Nécessite un flash du firmware : Si l'ID affiché est marqué comme CANBOOT ou Katapult dans le champ Application: à la fin.
  • ❌ Appareil non trouvé : Si Total 0 uuids found s'affiche, les causes possibles incluent :
    • Erreur de configuration du réseau CAN
    • Inadéquation du débit CAN (assurez-vous que les débits de l'ordinateur hôte, de la carte mère et de la carte d'outillage sont identiques)
    • L'ID est déjà utilisé (doit être masqué dans la configuration, puis éteindre, couper l'alimentation et redémarrer)
Loading...

Résultat de la recherche d'ID RS232​

Après exécution de la commande, le terminal affichera le chemin du périphérique RS232 (exemple) :

  • /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
Exigences spéciales pour la configuration RS232

Les périphériques RS232 doivent obligatoirement spécifier le débit en bauds et la méthode de redémarrage lors de la configuration :

[mcu toolboard]
serial: <remplacez ici par le chemin du périphérique RS232 trouvé>
baud: 250000
restart_method: command

Quatrième étape : Configurer l'ID du MCU principal​

Préparation

Avant de commencer la configuration, assurez-vous que la connexion entre la carte d'outillage et l'ordinateur hôte ou la carte mère est débranchée pour éviter les conflits d'identification des appareils.

Rouvrez le fichier printer.cfg et trouvez la ligne de configuration serial: /tmp/klipper_host_mcu dans la section [mcu].

En fonction de votre méthode de connexion, référez-vous à la méthode correspondante ci-dessous pour la configuration :

Remplacez /tmp/klipper_host_mcu après serial: par l'ID USB trouvé.

Exemple de configuration :

# ID USB trouvé :
# /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

# Modifiez la configuration en :
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

Sauvegardez la configuration et redémarrez le service Klipper.

Cinquième étape : Vérifier la connexion du MCU principal​

Après avoir configuré le MCU principal, il est nécessaire de vérifier si la connexion a réussi :

  1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
  2. Consultez les informations du MCU : sous Mcu Information, trouvez les informations Micro-Controller
  3. Vérifiez le modèle du microcontrôleur : confirmez que le modèle affiché correspond au microcontrôleur réel de votre carte mère

:::point de vérification

  • Si votre microcontrôleur est un STM32H723, Micro-Controller doit afficher un modèle lié au H723
  • Si l'affichage est incorrect ou non reconnu, vérifiez les étapes de configuration précédentes :::
Loading...

Sixième étape : Ajouter le MCU de la carte d'outillage​

Une fois le MCU principal vérifié, vous pouvez ajouter la carte d'outillage :

  1. Rebranchez la carte d'outillage : rebranchez le câble de données de la carte d'outillage à l'ordinateur hôte ou à la carte mère
  2. Modifiez le fichier de configuration : ajoutez la configuration de la carte d'outillage en bas du fichier printer.cfg
  3. Configurez l'ID de la carte d'outillage : selon le type de firmware de la carte d'outillage, ajoutez l'ID correspondant dans la nouvelle section de configuration
Explication des noms de MCU

Les noms comme mcu1, mcu2 dans la configuration sont uniquement utilisés pour distinguer temporairement les différents appareils. Vous pouvez entièrement personnaliser ces noms, assurez-vous simplement qu'ils sont uniques dans le fichier de configuration.

Format de configuration :

[mcu mcu1]
# Ajoutez ici la configuration de l'ID de la carte d'outillage

Exemples de configuration :

[mcu mcu1]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

Remarques :

  • Chaque MCU doit utiliser un ID unique, assurez-vous que l'ID de la carte d'outillage est différent de celui du MCU principal et des autres appareils
  • Le nom du MCU peut être entièrement personnalisé (par exemple toolboard, extruder_mcu, etc.), assurez-vous simplement qu'il est unique dans la configuration
  • Veuillez utiliser un ID de carte d'outillage valide vérifié via les étapes précédentes
  • Les périphériques RS232 doivent obligatoirement inclure les paramètres baud: 250000 et restart_method: command
  • Lors de la configuration de plusieurs cartes d'outillage, donnez à chaque appareil un nom différent pour les distinguer

Une fois la configuration terminée, sauvegardez et redémarrez le service Klipper.

Septième étape : Vérifier toutes les connexions MCU​

Après avoir ajouté la carte d'outillage et redémarré Klipper, il est nécessaire de revérifier l'état de connexion de tous les MCU :

  1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
  2. Consultez les informations du MCU : sous Mcu Information, confirmez que tous les MCU sont correctement reconnus
  3. Vérifiez l'état de chaque MCU : assurez-vous que le MCU principal et la carte d'outillage affichent un état de connexion

:::point de vérification

  • Le MCU principal et toutes les cartes d'outillage doivent apparaître dans la liste
  • L'état de connexion de chaque MCU doit être "Connecté"
  • Si un MCU n'apparaît pas ou que la connexion échoue, vérifiez sa configuration et sa connexion physique :::
Loading...

Huitième étape : Vérifier la version du firmware​

Après avoir terminé toutes les connexions MCU, il est nécessaire de vérifier la compatibilité de la version du firmware :

  1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
  2. Consultez les informations de version : sous Mcu Information, trouvez le champ Version
  3. Vérifiez la cohérence des versions : confirmez que les versions du firmware de tous les MCU correspondent à la version Klipper de l'ordinateur hôte
Explications sur la compatibilité des versions
  • Firmware compilé personnalisé : À l'exception des appareils préconfigurés, tous les firmwares compilés manuellement doivent correspondre à la version Klipper de l'ordinateur hôte
  • Système Fly-FAST : La version du firmware du système FAST est cohérente avec la version du système, le firmware Klipper compilé correspond à la version du système
  • Conséquences d'une non-correspondance des versions : Des versions différentes du firmware peuvent entraîner des anomalies de fonctionnement, des échecs de communication ou une instabilité du système

Points de vérification :

  • Les informations Version du MCU principal et de toutes les cartes d'outillage doivent être affichées et identiques
  • Si les versions ne correspondent pas, il est nécessaire de reflasher le firmware correspondant

Neuvième étape : Restaurer et mettre à jour le fichier de configuration​

Après avoir confirmé que toutes les connexions MCU sont normales, il est nécessaire de restaurer le fichier de configuration d'origine et de mettre à jour la configuration MCU :

  1. Supprimer le fichier de configuration actuel

    • Dans l'interface de gestion des fichiers de configuration, trouvez et supprimez le fichier printer.cfg actuel

  2. Restaurer la configuration de sauvegarde

    • Renommez le fichier printer_Backup.cfg précédemment sauvegardé en printer.cfg

  3. Mettre à jour la configuration du MCU

    • Ouvrez le fichier printer.cfg restauré
    • Trouvez la section [mcu] d'origine et mettez-la à jour avec l'ID obtenu lors des étapes précédentes :

    Configuration connexion USB :

    [mcu]
    serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
    # Remplacez par l'ID USB du MCU principal réellement trouvé

    Configuration connexion CAN :

    [mcu]
    canbus_uuid: 688e89f0e401
    # Remplacez par l'UUID CAN du MCU principal réellement trouvé

  4. Mettre à jour la configuration de la carte d'outillage (si applicable)

    • Dans le fichier de configuration, trouvez la section [mcu] correspondant à la carte d'outillage
    • Mettez à jour avec l'ID de la carte d'outillage réellement trouvé en fonction du type de connexion :

    Carte d'outillage USB :

    [mcu toolboard]
    serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

    Carte d'outillage CAN :

    [mcu toolboard]
    canbus_uuid: 688e89f0e402

    Carte d'outillage RS232 :

    [mcu toolboard]
    serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
    baud: 250000
    restart_method: command

  5. Sauvegarder et redémarrer

    • Après avoir terminé toutes les mises à jour de configuration des MCU, cliquez sur SAVE & RESTART pour sauvegarder et redémarrer Klipper
    • Revenez à la page System pour confirmer que l'état de connexion de tous les MCU est normal

:::point important

  • Assurez-vous d'utiliser l'ID correct réellement trouvé lors de ce test de connexion
  • Si vous configurez plusieurs cartes d'outillage, mettez à jour l'ID de chaque section [mcu] une par une
  • La carte d'outillage RS232 doit obligatoirement inclure les paramètres baud: 250000 et restart_method: command
  • Après avoir restauré la configuration, les paramètres d'imprimante d'origine (comme les réglages des moteurs pas à pas, des fins de course, etc.) resteront inchangés :::

Ceci termine le diagnostic des problèmes de connexion MCU et la restauration de la configuration.

Loading...