A01. [A Savoir] Maîtriser KIAUH et les instances multiples

KIAUH est un outil de ligne de commande conçu par la communauté pour automatiser la gestion des composants de votre imprimante 3D. Il agit comme un pont sécurisé entre votre Raspberry Pi et les différents dépôts GitHub officiels.

Ce qu'il permet de faire (liste non exhaustive) :

• Installation automatisée : Installer Klipper, Moonraker, Mainsail, Fluidd, et bien d'autres modules sans erreur de dépendances.
• Gestion des mises à jour : Vérifier en un coup d'œil quel composant est obsolète et lancer la mise à jour globale.
• Réparation rapide : Corriger les problèmes courants (fichiers corrompus ou services qui ne démarrent plus).
• Déploiement multi-instances : Gérer plusieurs imprimantes sur une seule carte Raspberry Pi.
• Nettoyage : Supprimer proprement des plugins inutilisés pour libérer de l'espace sur la carte SD.

Avant de commencer, connectez-vous en SSH. Vérifiez que l'outil git est présent sur votre système :

Vérifiez si l'outil est déjà installé :

Si le dossier est absent, exécutez :

L'une des fonctionnalités les plus puissantes de KIAUH est la capacité de créer des "instances multiples".

Qu'est-ce qu'une instance ? C'est une copie isolée de Klipper et de Moonraker fonctionnant indépendamment sur le même matériel. Chaque instance possède ses propres fichiers de configuration et ses propres macros.

Pourquoi utiliser des instances multiples ?

• Centralisation : Pilotez plusieurs imprimantes depuis une seule interface web (Mainsail) via des onglets.
• Indépendance : Si une instance rencontre un problème, les autres imprimantes continuent de fonctionner.
• Optimisation : Réduisez vos coûts matériels en utilisant un seul Raspberry Pi robuste (comme votre 3B+).

Avec KIAUH, le déploiement multi-instances se fait directement lors de la phase d'installation de Klipper. Le script va vous guider à travers une série de questions précises.

La procédure pas à pas pour Klipper :

1. Lancement : Ouvrez votre terminal SSH et exécutez ./kiauh/kiauh.sh.
2. Menu d'installation : Tapez 1 pour accéder au menu [1] Install.
3. Sélection du composant : Tapez 1 pour sélectionner [1] Klipper.
4. Définir le nombre d'instances : Le script détecte si Klipper est déjà présent. Il vous demande alors combien d'instances vous souhaitez installer au total (ex: tapez 2 si vous voulez gérer deux imprimantes).
5. Le choix du nommage : KIAUH vous propose deux options cruciales :
   • Nom générique (Recommandé) : Si vous refusez le nom personnalisé, il nommera les instances klipper-1, klipper-2, etc. C'est le choix le plus propre pour la structure des dossiers.
   • Nom personnalisé : Vous pouvez attribuer un nom unique à chaque instance (ex: neptune4max). Attention à ne pas utiliser d'espaces ni de caractères spéciaux.

À ce stade, KIAUH télécharge les dépendances, crée les répertoires isolés dans votre dossier utilisateur et configure les services système correspondants.

Avoir plusieurs instances de Klipper ne suffit pas. Pour que votre interface web (Mainsail ou Fluidd) puisse piloter chaque imprimante séparément, vous devez impérativement créer le même nombre d'instances pour Moonraker.

La procédure pour Moonraker :

1. Retour au menu : Depuis le menu [1] Install de KIAUH, tapez cette fois 2 pour sélectionner [2] Moonraker.
2. Sélection groupée : Le script va détecter vos instances Klipper existantes. Plutôt que de les configurer une à une, il vous suffit de taper a (pour All) afin de sélectionner automatiquement toutes les instances.
3. Attribution des ports réseau : C'est ici que la magie opère. KIAUH va associer chaque instance Moonraker à un port HTTP unique :
   • La première instance utilisera le port standard 7125.
   • La deuxième instance se verra attribuer le port 7126, la troisième le 7127, et ainsi de suite.

Gérer plusieurs imprimantes sur une seule carte demande un peu plus de rigueur, tant sur le plan matériel que logiciel :

• Identifiants USB uniques : C'est le piège le plus classique. Si vous connectez deux imprimantes identiques, le système peut inverser les ports au redémarrage. Vous devez impérativement identifier vos cartes mères par leur ID unique en utilisant la commande ls /dev/serial/by-id/ dans votre fichier de configuration.
• Ressources CPU et charge système : Votre Raspberry Pi 3B+ est une excellente machine, mais elle a ses limites. Chaque instance Klipper/Moonraker consomme de la mémoire RAM et des cycles processeur. Surveillez la charge globale avec la commande top lorsque vos machines impriment simultanément.
• Méthode itérative : Ne tentez pas de tout configurer en même temps. Assurez-vous que votre première instance (votre imprimante principale) est parfaitement stable, calibrée et fonctionnelle avant de lancer l'installation et le paramétrage de la seconde.

Une fois la configuration en ligne de commande terminée avec KIAUH, tout le reste de la gestion se passe directement dans votre navigateur via l'interface Mainsail.

L'écran d'accueil multi-instances :

Désormais, à chaque fois que vous accéderez à la page web de votre Mainsail OS, l'interface affichera une fenêtre centrale vous demandant de **choisir l'imprimante** à piloter. Cet écran propose également un bouton rapide "Ajouter une imprimante" en bas de page.

La méthode recommandée : Gestion via les Paramètres

Pour une gestion plus claire et structurée de vos différentes machines, il est préférable de passer par le menu de configuration complet de l'interface :

1. Cliquez sur l'icône d'engrenage Settings (Paramètres) en bas à gauche de votre écran.
2. Allez dans la section Imprimantes (Printers). C'est ici que vous pouvez centraliser, renommer ou supprimer vos accès.
3. Cliquez sur le bouton Ajouter une imprimante.
4. Renseignez le nom de votre choix et l'adresse de l'instance sous la forme : IP_DU_RASPBERRY:PORT (ex: 192.168.1.X:7126 pour votre seconde machine).

Une fois vos machines enregistrées, un menu déroulant situé tout en haut à gauche de l'interface Mainsail vous permettra de centraliser la gestion de votre parc et de basculer instantanément d'une imprimante rattachée à l'autre, sans jamais avoir à recharger la page ou à changer d'onglet dans votre navigateur.