Ajout et configuration multi-cartes de la MCU de la carte outil
Cette page est destinée à l'ajout d'une carte outil, à la vérification de l'état des MCU multiples et à la configuration des broches inter-cartes après la connexion réussie de la MCU principale. Si vous n'avez pas encore terminé la vérification de la connexion de la MCU principale, veuillez d'abord suivre le Guide de connexion MCU.
Prérequis
Avant de commencer à ajouter une carte outil, assurez-vous :
- Que la MCU principale a été vérifiée comme connectée selon le Guide de connexion MCU.
- Que le firmware de la carte outil a été flashé.
- Que le câble de données de la carte outil est connecté à l'interface correspondante (CAN/USB/RS232) de l'ordinateur hôte ou de la carte mère.
Recherche de l'ID de la carte outil
La méthode de recherche de l'ID de la carte outil dépend de son interface de communication. Pour les règles complètes de remplissage de l'ID MCU, veuillez consulter la Configuration de l'ID MCU. Voici un guide rapide :
Carte outil USB
Connectez-vous à l'ordinateur hôte via SSH et exécutez la commande suivante pour lister tous les périphériques série USB :
ls /dev/serial/by-id/*
Exemple de sortie :
/dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00
Les IDs en mode flashage contiennent généralement le terme katapult ou stm32duino (ex. usb-katapult_stm32f446xx_...). Assurez-vous d'utiliser l'ID du firmware Klipper, et non l'ID du mode de flashage.
Carte outil CAN
- Ligne de commande SSH
- FlyOS-FAST / Ordinateur hôte FLY
Connectez-vous à l'ordinateur hôte via SSH et exécutez la commande suivante pour rechercher les UUID des périphériques CAN :
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
Exemple de sortie :
Found canbus_uuid=688e89f0e402, Application: Klipper
Sur un ordinateur hôte FAST ou FLY, utilisez directement python3 pour effectuer la recherche :
python3 ~/klipper/scripts/canbus_query.py can0
Sur le système FAST, CAN0 est préconfiguré à un débit de 1M et un cache de 1024, une configuration manuelle n'est généralement pas nécessaire.
L'UUID du firmware Klipper d'une carte outil CAN est différent de l'UUID de flashage CANBoot. Si l'Application affiche CANBOOT ou Katapult, cela signifie que le périphérique est en mode flashage. Pour un dépannage détaillé, veuillez consulter le Réseau CAN et recherche d'ID.
Carte outil RS232
Connectez-vous à l'ordinateur hôte via SSH et exécutez la commande suivante pour voir le chemin du périphérique USB-série :
ls -l /dev/serial/by-path/
Exemple de sortie :
/dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
Les cartes outil communicant via RS232 nécessitent la configuration supplémentaire des paramètres baud: 250000 et restart_method: command, sinon la communication ne fonctionnera pas.
Ajout de la MCU de la carte outil
Après avoir obtenu l'ID de la carte outil, ajoutez la section de configuration MCU correspondante à la fin de printer.cfg :
- Carte outil USB
- Carte outil CAN
- Carte outil RS232
[mcu toolboard]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00
[mcu toolboard]
canbus_uuid: 688e89f0e402
[mcu toolboard]
serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
baud: 250000
restart_method: command
- Les noms des MCU sont entièrement personnalisables, par exemple
toolboard,tool,extruder_mcu, etc. Ils doivent simplement être uniques dans la configuration. - Le nom de la MCU sera utilisé comme préfixe pour les broches inter-cartes. Par exemple, avec
[mcu toolboard], on écriratoolboard:PA0. La casse du nom doit être cohérente. - Le nom et l'ID de chaque MCU doivent être uniques et ne pas dupliquer ceux de la MCU principale ou d'autres cartes outil.
- Lors de la configuration de plusieurs cartes outil, attribuez un nom différent à chaque périphérique pour les distinguer.
Une fois la configuration terminée, cliquez sur SAVE & RESTART pour sauvegarder et redémarrer Klipper.
Vérification de toutes les connexions MCU
Après avoir ajouté la carte outil et redémarré Klipper, confirmez que toutes les MCU sont en ligne :
- Ouvrez l'interface Fluidd, cliquez sur
Systemdans le menu de gauche. - Sous
Mcu Information, confirmez que la MCU principale et toutes les cartes outil sont correctement identifiées et affichées comme connectées.
Vérification des versions du firmware
Après avoir connecté toutes les MCU, vérifiez la compatibilité des versions du firmware :
- Ouvrez l'interface Fluidd, cliquez sur
Systemdans le menu de gauche. - Sous
Mcu Information, trouvez le champVersion. - Assurez-vous que la version du firmware de chaque MCU correspond à la version de Klipper sur l'ordinateur hôte.
- Sauf pour les appareils personnalisés préconfigurés, tout firmware compilé manuellement doit correspondre à la version de Klipper sur l'ordinateur hôte.
- Sur le système FAST, la version du firmware correspond à la version du système. Le firmware Klipper compilé sera donc cohérent avec la version du système.
- Des versions différentes du firmware peuvent entraîner des dysfonctionnements, des échecs de communication ou une instabilité du système.
Mise à jour du fichier de configuration principal
Si vous avez sauvegardé printer_Backup.cfg en suivant la procédure du Guide de connexion MCU, cette section sert à réécrire les ID MCU vérifiés dans la configuration complète. Si vous utilisez déjà un fichier de configuration officiel, vous pouvez sauter cette section.
Après avoir confirmé que toutes les connexions MCU sont correctes :
- Supprimez le fichier temporaire
printer.cfgactuel dans l'interface de gestion des fichiers de configuration. - Renommez le fichier
printer_Backup.cfgprécédemment sauvegardé enprinter.cfg. - Ouvrez le
printer.cfgrestauré, trouvez les sections[mcu]et[mcu <nom>]d'origine, et mettez à jour avec les ID réels vérifiés. - Cliquez sur SAVE & RESTART pour sauvegarder et redémarrer Klipper.
- Assurez-vous d'utiliser l'ID correct réellement trouvé lors de ce test de connexion.
- La carte outil RS232 doit inclure les paramètres
baud: 250000etrestart_method: command. - Après avoir restauré la configuration, les paramètres d'impression d'origine (comme les moteurs pas à pas, les fins de course, etc.) resteront inchangés.
Configuration des broches inter-cartes pour plusieurs cartes outil
Lorsque vous utilisez plusieurs cartes outil, vous pouvez avoir besoin d'attribuer des broches entre les cartes. Par exemple : utiliser la sortie de chauffe d'une première carte outil, mais connecter le capteur de température à la carte mère ou à une deuxième carte outil.
Dans la configuration multi-MCU de Klipper, les broches de n'importe quelle section de configuration peuvent être référencées sur n'importe quelle MCU définie en utilisant le format <nom_mcu>:<numéro_broche>. Aucune configuration supplémentaire n'est nécessaire. Klipper enverra automatiquement les commandes à la MCU correspondante via le bus de communication (CAN/USB/Série).
Scénario typique : Chauffage sur la carte outil, capteur de température sur la carte mère
Supposons la configuration système suivante :
- MCU principale : Exécute le firmware hôte Klipper de l'ordinateur hôte, le capteur de température est connecté à la carte mère.
- toolboard1 : Carte outil, la cartouche chauffante et le moteur pas à pas de l'extrudeuse sont connectés à la carte outil.
Étape 1 : Définir toutes les MCU
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
[mcu toolboard1]
canbus_uuid: e51d5c71a901
Étape 2 : Référencer directement les broches inter-cartes dans la configuration
[extruder]
# Le moteur pas à pas et le chauffage utilisent les broches de la carte outil
step_pin: toolboard1:<step_pin>
dir_pin: toolboard1:<dir_pin>
enable_pin: !toolboard1:<enable_pin>
heater_pin: toolboard1:<heater_pin>
# Le capteur de température utilise les broches de la carte mère
sensor_type: ATC Semitec 104GT-2
sensor_pin: <sensor_pin>
rotation_distance: 22.44
gear_ratio: 50:17
microsteps: 16
full_steps_per_rotation: 200
nozzle_diameter: 0.400
filament_diameter: 1.75
min_temp: -235
max_temp: 350
max_power: 1.0
min_extrude_temp: 170
control: watermark
- Le format pour une broche de carte outil est
<nom_mcu>:<numéro_broche>, par exempletoolboard1:<heater_pin>. - Les broches de la MCU principale peuvent être écrites directement avec le nom réel de la broche, sans préfixe.
- Les broches dans une même section de configuration peuvent provenir de différentes MCU, Klipper gère automatiquement la communication inter-cartes.
Exemples supplémentaires de configuration inter-cartes
- Capteur de température sur la deuxième carte outil
- Plusieurs extrudeuses sur différentes cartes outil
- Contrôle du ventilateur inter-cartes
La cartouche chauffante sur la première carte outil, le capteur de température sur la deuxième carte outil :
[extruder]
step_pin: toolboard1:<step_pin>
heater_pin: toolboard1:<heater_pin>
sensor_type: ATC Semitec 104GT-2
sensor_pin: toolboard2:<sensor_pin>
Deux extrudeuses connectées à des cartes outil différentes :
[extruder]
step_pin: toolboard1:<step_pin>
heater_pin: toolboard1:<heater_pin>
sensor_pin: toolboard1:<sensor_pin>
[extruder1]
step_pin: toolboard2:<step_pin>
heater_pin: toolboard2:<heater_pin>
sensor_pin: toolboard2:<sensor_pin>
L'extrudeuse sur la carte outil, le ventilateur de refroidissement du modèle sur la carte mère :
[fan]
pin: <fan_pin>
[heater_fan throat_fan]
pin: toolboard1:<fan_pin>
heater: extruder
heater_temp: 50
fan_speed: 1.0
- Lorsque vous référencez des broches inter-cartes, assurez-vous que la MCU correspondante est correctement définie dans le fichier de configuration via
[mcu <nom>]. - La casse du nom de la MCU doit être cohérente ;
[mcu ToolBoard]et la référencetoolboard:PA0provoqueront une erreur. - Il est recommandé de connecter les périphériques fonctionnellement liés (comme la cartouche chauffante et le capteur de température) sur la même carte outil pour obtenir les meilleures vitesse de réponse et fiabilité.
Problèmes courants
| Problème | Direction de dépannage |
|---|---|
| La carte outil n'est pas en ligne | Vérifiez la connexion du câble de données, confirmez que l'ID est correct, faites la distinction entre l'ID du firmware Klipper et l'ID du mode flashage |
| Conflit de noms/ID entre plusieurs cartes outil | Le nom et l'ID de chaque [mcu] doivent être uniques, référez-vous à la Configuration de l'ID MCU |
| Non-correspondance du préfixe de broche | Le préfixe de broche pour [mcu toolboard] doit être toolboard:, la casse du nom doit être cohérente |
| Version du firmware incompatible | Recompilez le firmware pour qu'il corresponde à la version de Klipper sur l'ordinateur hôte |
| UUID CAN introuvable | Référez-vous au Réseau CAN et recherche d'ID |
| Échec de la communication RS232 | Vérifiez que baud: 250000 et restart_method: command sont bien configurés |