Aller au contenu

Guides

Gravure laser OctoPrint : votre laser piloté par OctoPrint ou une Duet

La gravure laser OctoPrint expliquée : ce qui fonctionne avec Marlin, GRBL et les cartes Duet, les limites de l'envoi ligne par ligne, et comment cadrer et graver via OctoPrint depuis un logiciel laser gratuit.

Un porte-nom pour une Sculpfun S9 dans Bernie : le panneau Laser avec la liaison Serveur, OctoPrint ou Duet, l'adresse du serveur et la clé d'API.

La gravure laser OctoPrint fonctionne, à quelques conditions. OctoPrint est un serveur pour imprimantes 3D : il envoie le G-code à la machine par son port USB, ligne par ligne, sans se soucier de savoir si l’outil est une tête d’impression ou un laser. Une machine Marlin dont la fonction laser est activée fonctionne telle quelle ; un laser GRBL demande un plugin ; une carte Duet fait le même travail sans OctoPrint. Vous préparez le G-code dans un logiciel laser, vous l’envoyez au serveur et vous le lancez, et certains logiciels laser, dont Bernie, s’occupent de tout cela pour vous.

Au programme : ce que gère OctoPrint, les limites à connaître avant de graver une photo par son intermédiaire, comment préparer OctoPrint ou une Duet pour un laser, un tutoriel complet pour cadrer et graver depuis Bernie, et la même chose en ligne de commande.

OctoPrint peut-il piloter un graveur laser ?

OctoPrint est un logiciel libre et open source (AGPL-3.0), créé et maintenu par Gina Häußge et financé par les dons. La version stable actuelle est la 1.11.8, sortie en juin 2026 ; la version 2.0 est en test. La plupart des utilisateurs le font tourner sur un Raspberry Pi avec OctoPi, une image de carte SD toute prête : le projet recommande un Pi 3B, 3B+, 4B ou Zero 2.

OctoPrint se présente comme une interface pour imprimantes 3D et ne gère ni le laser ni GRBL de lui-même. Ce qui décide si votre laser fonctionne derrière lui, c’est le firmware de la machine :

FirmwareDerrière OctoPrintCe qu’il faut
Marlin avec un laserOui : c’est un firmware d’imprimanteLASER_FEATURE activé ; puissance du laser par M3, M4 et M5
GRBL (la plupart des lasers diode)Avec un pluginLe plugin Better Grbl Support, qui adapte la séquence de connexion et le G-code qu’envoie OctoPrint
RepRapFirmware (Duet)InutileLa carte exécute les jobs depuis sa propre carte SD, par Duet Web Control ou son API HTTP ; mode laser réglé par M452

La documentation laser de Marlin décrit un mode « inline » (M3 I), où la puissance accompagne chaque déplacement au lieu d’arrêter la tête pour la changer. Sur une Duet, M452 règle la sortie du laser, la fréquence PWM et la valeur S qui correspond à la pleine puissance.

Les limites à connaître avant de graver via OctoPrint

  • La vitesse d’envoi. Par défaut, OctoPrint envoie une ligne et attend le « ok » de la machine avant d’envoyer la suivante. La documentation de GRBL elle-même présente ce simple envoi-réponse comme la méthode d’envoi la plus lente, et recommande le comptage de caractères pour les machines rapides comme les lasers. Les découpes vectorielles et les contours passent sans souci ; une photo faite de milliers de minuscules déplacements peut saccader : baissez la vitesse ou la résolution, ou préférez une connexion USB directe pour les gravures d’images.
  • Une Duet évite le problème. Elle exécute tout le fichier depuis sa carte SD : rien n’est envoyé ligne par ligne pendant le job.
  • Sécurité. La documentation d’OctoPrint déconseille de rendre accessible depuis Internet une machine équipée de moteurs et d’éléments chauffants, même avec un contrôle d’accès : passez par un VPN. Un laser mérite les mêmes précautions.
  • OctoPrint 2.0. La prochaine version majeure change la façon dont les imprimantes sont connectées, et le projet a demandé aux auteurs de plugins de vérifier les leurs. Si vous comptez sur Better Grbl Support, vérifiez qu’il prend en charge votre version d’OctoPrint avant de mettre à jour.

Préparer OctoPrint ou une Duet pour un laser

OctoPrint

  1. Écrivez OctoPi sur une carte microSD avec Raspberry Pi Imager (Other specific-purpose OS › 3D printing), démarrez le Pi et terminez l’assistant de configuration dans votre navigateur, à l’adresse http://octopi.local.
  2. Branchez le laser au Pi en USB. Pour un laser GRBL, installez Better Grbl Support depuis le Plugin Manager : il règle la séquence de connexion, désactive les sommes de contrôle et accepte les fichiers .nc.
  3. Créez une clé pour le logiciel laser. La documentation d’OctoPrint recommande les clés d’application (Settings › Application Keys) ; l’ancienne clé globale de Settings › API est obsolète.
  4. Seulement si vous pilotez OctoPrint depuis une page web : cochez Allow Cross Origin Resource Sharing (CORS) dans Settings › API, puis redémarrez OctoPrint.

Duet (RepRapFirmware)

Configurez le mode laser avec M452 dans config.g, avec la broche de sortie et l’échelle de puissance de votre carte. Depuis RepRapFirmware 3.7, HTTP n’est plus activé par défaut : ajoutez M586 P0 S1. Un mot de passe défini par M551 protège l’accès, même si la documentation de Duet précise qu’il circule en clair. Pour une page web, M586 C"*" autorise les requêtes d’une autre origine (CORS). Bernie dialogue avec une Duet en mode autonome, la carte étant reliée seule au réseau.

Gravure laser OctoPrint depuis Bernie, étape par étape

Bernie, le logiciel laser gratuit, peut envoyer le job directement à OctoPrint ou à une carte Duet : il prépare le G-code pour votre machine, le transfère sous forme de fichier, le lance après une question de sécurité et en suit l’avancement. Ici, un porte-nom en contreplaqué de 80 × 30 mm sur un Sculpfun S9, un laser diode GRBL derrière OctoPrint.

  1. Installez Bernie. Prenez l’app Mac, l’app Windows ou l’application de bureau pour Linux sur la page de téléchargement. Bernie Studio fonctionne aussi dans un navigateur, mais seulement quand la page est servie en http, par Bernie Link ou sur votre ordinateur : la version en ligne, en https, ne peut pas joindre un serveur en http.
  2. Choisissez votre machine. Sélectionnez-la dans le catalogue, ici le Sculpfun S9, pour que le G-code corresponde à son firmware, à sa zone de travail et à ses vitesses. La page machines compatibles liste les 125 modèles.
  3. Choisissez la liaison Serveur. Dans le panneau Laser, réglez Liaison sur Serveur, puis choisissez OctoPrint. Tapez l’Adresse (http://octopi.local) et la Clé d’API, puis cliquez sur Se connecter. Sur Mac et iPad, la clé est gardée dans le trousseau.
  4. Placez le dessin. Le serveur n’indique pas où se trouve la tête : partez de coordonnées absolues ou de votre origine utilisateur.
  5. Cadrez. Cliquez sur Cadrer : la tête fait le tour du job, laser éteint. Ajustez le contreplaqué jusqu’à ce que le contour tombe là où vous le voulez.
  6. Gravez. Cliquez sur Démarrer et répondez à la question de sécurité : Bernie transfère le job sous forme de fichier, OctoPrint le lance, et le panneau affiche l’avancement. Pause, Reprendre et Arrêter restent disponibles.
  7. Gardez un œil sur l’entretien. Ces jobs comptent dans le compteur d’heures comme les autres ; voir notre planning d’entretien du graveur laser.
Un porte-nom pour une Sculpfun S9 dans Bernie : le panneau Laser avec la liaison Serveur, OctoPrint ou Duet, l'adresse du serveur et la clé d'API.
Un porte-nom de 80 × 30 mm pour un Sculpfun S9 dans Bernie : le panneau Laser avec la liaison Serveur, OctoPrint ou Duet, l’adresse du serveur et la clé d’API.

Pour une Duet, choisissez Duet au lieu d’OctoPrint et tapez le Mot de passe défini par M551, ou laissez-le vide s’il n’y en a pas. La section connexion du manuel décrit chaque mode de liaison, et la page connexion et pilotage les résume.

Gravez via OctoPrint, gratuitement

Refaites ces étapes avec votre propre laser : Bernie est gratuit, sans compte ni abonnement, sur Mac, Windows, Linux et dans votre navigateur avec Bernie Studio.

En ligne de commande

La commande bernie fait la même chose sans fenêtre, depuis un terminal ou un script. Elle est livrée avec Bernie Link : sur un Raspberry Pi ou un PC Linux après l’installation en une ligne, et sous forme de bernie.exe dans l’archive Windows. Sur le porte-nom ci-dessus, elle donne :

$ bernie verifier porte-nom.bernie --appareil sculpfun-s9
Appareil : Sculpfun S9
✓ Prêt à graver.
$ bernie estimer porte-nom.bernie --appareil sculpfun-s9
Durée estimée : 1 min 39 s
Laser allumé : 39 s
Longueur gravée : 3914 mm

Pour graver via OctoPrint, ajoutez le serveur et sa clé : bernie graver porte-nom.bernie --appareil sculpfun-s9 --octoprint http://octopi.local --cle VOTRE_CLÉ --oui. Pour une Duet, utilisez --duet http://duet.local --mot-de-passe MOT_DE_PASSE. Sans --oui, rien n’est envoyé : la commande répond que graver allume le laser et vous demande de confirmer, capot fermé et extraction en marche. Elle suit ensuite le job jusqu’au bout, et Ctrl-C l’arrête.

Pour les petites séries, --serie 42 place un numéro de série dans un texte variable, et --csv noms.csv prend les valeurs d’un export de tableur ; --json donne des résultats lisibles par un script, avec le code de sortie 0 quand le job est terminé, 1 quand il est refusé. La section commande bernie du manuel liste toutes les options, et la page fichiers et automatisation montre les autres façons de piloter Bernie depuis un autre programme.

Restez prudent quand le laser n’est pas sous vos yeux

Avec un serveur d’impression, il est tentant de lancer un job depuis une autre pièce. Ne le faites pas : un laser ne doit jamais fonctionner sans surveillance. Lancez les jobs seulement quand vous êtes à côté de la machine, avec des lunettes adaptées à sa longueur d’onde, l’extraction en marche et un extincteur à portée de main. Bernie pose une question de sécurité avant chaque job, mais il ne voit pas la machine ; vous, si. Ne gravez jamais de PVC ni de vinyle, qui dégagent du chlore.

Avant un job via OctoPrint ou une Duet

  • Vous êtes près de la machine, lunettes sur le nez, extraction en marche.
  • La machine a fait son retour à l’origine (homing) et le dessin part de coordonnées absolues ou de votre origine utilisateur.
  • Le job a été cadré, laser éteint.
  • OctoPrint n’est accessible que sur votre réseau local ou par un VPN.

Questions fréquentes

OctoPrint est-il compatible avec les graveurs laser ?

Pas officiellement : OctoPrint est conçu pour les imprimantes 3D. Mais il envoie n’importe quel G-code : une machine Marlin avec sa fonction laser fonctionne, et un laser GRBL aussi, avec le plugin Better Grbl Support. Préparez le G-code dans un logiciel laser, ou laissez un logiciel comme Bernie le transférer et le lancer pour vous.

OctoPrint peut-il piloter un laser GRBL ?

Oui, avec le plugin Better Grbl Support, qui adapte la séquence de connexion, désactive les sommes de contrôle et accepte les fichiers .nc. Sans lui, la séquence de connexion par défaut d’OctoPrint est une commande d’imprimante que GRBL ne comprend pas.

Comment obtenir une clé d’API OctoPrint ?

Créez une clé d’application dans Settings › Application Keys, ou laissez le logiciel en demander une. L’ancienne clé globale de Settings › API fonctionne encore, mais elle est obsolète. La clé accompagne chaque requête ; dans Bernie, tapez-la dans le champ Clé d’API de la liaison Serveur.

OctoPrint convient-il à la gravure de photos ?

Il peut saccader. OctoPrint envoie une ligne à la fois et attend une réponse, et une photo représente des milliers de minuscules déplacements. Baissez la vitesse ou la résolution, ou passez par une connexion USB directe ou par une Duet, qui exécute le fichier depuis sa carte SD. Notre guide pour graver une photo au laser vous aide à choisir les réglages.

Peut-on utiliser une carte Duet pour la gravure laser ?

Oui. RepRapFirmware a un mode laser, réglé par M452, et une Duet exécute le job depuis sa propre carte SD. Bernie envoie le job à une Duet en mode autonome, avec cadrage, pause, reprise et arrêt ; depuis RepRapFirmware 3.7, activez HTTP avec M586 P0 S1.

OctoPrint ou une Duet peuvent bien piloter un laser, à condition d’en connaître les limites. Bernie y ajoute le côté laser : réglages par matériau, contrôle avant envoi et question de sécurité avant chaque job. Téléchargez Bernie, choisissez la liaison Serveur et cadrez votre premier job.