Configuration de l'ID MCU

Cette page explique les règles de remplissage des ID pour les cartes mères, les cartes d'outillage, les périphériques CAN et les MCU de l'ordinateur hôte dans Klipper. Pour les problèmes de configuration de connexion, veuillez d'abord confirmer la méthode de communication, puis remplir le serial: ou canbus_uuid: correspondant.

Recherche de l'ID MCU

Avant de remplir l'ID, connectez-vous à l'ordinateur hôte via SSH et exécutez les commandes correspondantes pour obtenir l'identifiant réel du périphérique.

Périphériques USB

ls /dev/serial/by-id/*

Exemple de sortie (usb-Klipper_... est l'ID en mode firmware Klipper) :

/dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

Distinguer l'ID du firmware de l'ID de flashage

• Exemple d'ID du firmware Klipper : usb-Klipper_stm32h723xx_12345-if00
• Exemple d'ID en mode flashage : usb-katapult_stm32h723xx_12345-if00 (contient katapult)
• Exemple d'ID en mode flashage : usb-STM32_Bootloader_xxxxxxxxxxxx (contient Bootloader)

Dans le fichier de configuration, l'ID du mode firmware Klipper doit être utilisé. Si seul l'ID du mode flashage est visible, cela signifie que la carte d'outillage n'est pas en mode d'exécution du firmware Klipper.

Périphériques CAN

• Ligne de commande SSH
• FlyOS-FAST / Ordinateur hôte FLY

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

Exemple de sortie :

Found canbus_uuid=688e89f0e402, Application: Klipper

L'ordinateur hôte FAST ou FLY utilise directement python3 pour la recherche :

python3 ~/klipper/scripts/canbus_query.py can0

Le CAN0 du système FAST est préréglé à une vitesse de 1M et un cache de 1024, aucune configuration manuelle n'est généralement nécessaire.

Plusieurs UUID CAN

Les UUID dont l'Application est CANBOOT ou Katapult sont des ID en mode flashage et ne peuvent pas être utilisés directement dans printer.cfg. Pour un dépannage détaillé, reportez-vous à Réseau CAN et recherche d'ID.

MCU de l'ordinateur hôte

Si vous utilisez un processus Linux de l'ordinateur hôte pour simuler un MCU ([mcu host]), son port série est fixe :

[mcu host]
serial: /tmp/klipper_host_mcu

Périphériques RS232

ls -l /dev/serial/by-path/

Exemple de sortie :

/dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0

Configuration de la carte d'outillage : Ajout de MCU de carte d'outillage et configuration multi-cartes

Explication de la configuration de l'ID MCU

Dans Klipper, l'ID MCU fait référence aux informations d'identification utilisées dans la section de configuration [mcu] ou [mcu xxx] pour connecter la carte de contrôle. Les différentes méthodes de communication ont des formats différents :

Méthode de connexion	Élément de configuration	Exemple
Firmware USB	serial:	serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
Firmware CAN	canbus_uuid:	canbus_uuid: xxxxxxxxxxxx
MCU hôte	serial:	serial: /tmp/klipper_host_mcu

Règles de remplissage :

1. La carte mère utilise par défaut [mcu], tandis que les cartes d'outillage ou d'extension utilisent des noms personnalisés comme [mcu tool], [mcu toolboard], etc.
2. Pour le firmware USB, remplissez uniquement serial: ; pour le firmware CAN, remplissez uniquement canbus_uuid:. Ne conservez pas les deux éléments dans un même [mcu].
3. Dans une machine multi-MCU, chaque [mcu xxx] doit utiliser son propre ID réel. Ne copiez pas le même ID USB ou UUID CAN.
4. Le nom de [mcu xxx] affecte le préfixe des broches. Par exemple, les broches de [mcu tool] doivent être écrites comme tool:gpio13 ; la casse du nom doit être cohérente.
5. Les xxxxxxxx dans les exemples de documents ne peuvent pas être utilisés directement. Ils doivent être remplacés par l'ID réellement trouvé.

Erreurs courantes :

• Utiliser l'ID en mode de flashage (comme les ID contenant katapult, canboot) comme ID du firmware Klipper.
• Configurer canbus_uuid: pour un firmware USB, ou conserver l'ancien serial: pour un firmware CAN.
• Configurer la carte d'outillage comme [mcu], ce qui remplace la configuration MCU de la carte mère.
• Incohérence entre le préfixe des broches et le nom du MCU. Par exemple, la configuration est [mcu toolboard], mais les broches sont écrites tool:gpio13.

Recherche d'ID USB : Pour le firmware USB, exécutez ls /dev/serial/by-id/* pour obtenir l'ID.

Recherche d'ID CAN : Réseau CAN et recherche d'ID

Configuration de la carte d'outillage : Ajout d'un MCU de carte d'outillage et configuration multi-cartes

Exemples de configuration multi-MCU

Carte mère USB + Carte d'outillage CAN

La carte mère USB se connecte via serial:, la carte d'outillage CAN se connecte via canbus_uuid: :

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

[mcu tool]
canbus_uuid: xxxxxxxxxxxx

[temperature_sensor ToolBoard]
sensor_type: temperature_mcu
sensor_mcu: tool

Carte mère USB + Carte d'outillage USB

Les deux utilisent serial: et sont différenciées par des ID différents :

[mcu]
serial: /dev/serial/by-id/usb-Klipper_mainboard_xxxxxxxxxxxx

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

Carte mère CAN + Carte d'outillage CAN

Les deux utilisent canbus_uuid:, chaque UUID doit être différent :

[mcu]
canbus_uuid: aabbccddeeff

[mcu toolboard]
canbus_uuid: 112233445566

MCU hôte + Carte mère USB

L'ordinateur hôte exécute un processus Linux MCU, la carte mère se connecte via USB :

[mcu host]
serial: /tmp/klipper_host_mcu

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

Idées reçues courantes

Mauvaise pratique	Bonne pratique
Utiliser l'ID du mode flashage comme ID Klipper	S'assurer que le périphérique est en mode firmware Klipper avant de rechercher l'ID
Remplir à la fois serial: et canbus_uuid: pour le firmware USB	Le firmware USB ne doit contenir que serial:, le firmware CAN ne doit contenir que canbus_uuid:
Écrire [mcu] pour la carte d'outillage et écraser la configuration de la carte mère	La carte d'outillage doit utiliser un nom personnalisé comme [mcu toolboard]
Plusieurs MCU partagent le même ID	Chaque MCU doit utiliser son propre ID unique
Incohérence entre le préfixe de broche et le nom du MCU	Pour [mcu toolboard], écrire toolboard:PA0 pour les broches, avec la casse du nom identique
Copier directement xxxxxxxx depuis la documentation	Doit être remplacé par l'ID réel trouvé lors de la recherche

Points d'entrée pour le dépannage

Problème	Point d'entrée
ID USB introuvable ou [Errno 2]	Aperçu des erreurs courantes
UUID CAN invalide ou périphérique hors ligne	Réseau CAN et recherche d'ID
Déconnexion de plusieurs MCU, impossibilité de mettre à jour la configuration	Erreurs système, de performance et de service
Ajout de carte d'outillage, configuration de broches multi-cartes	Ajout de MCU de carte d'outillage et configuration multi-cartes
Préfixe de broche, broche en double ou nom de MCU incorrect	Erreurs de configuration