Aller au contenu principal

Configuration Initiale

Après avoir installé Rayforge, vous devrez configurer votre découpeuse ou graveuse laser. Ce guide vous accompagne dans la création de votre première machine avec l'assistant de configuration et l'établissement d'une connexion.

Étape 1 : Lancer Rayforge​

Démarrez Rayforge depuis votre menu d'applications ou en exécutant rayforge dans un terminal. Vous devriez voir l'interface principale avec un canevas vide.

Étape 2 : Créer une Machine avec l'Assistant​

Naviguez vers Paramètres → Machines ou appuyez sur ctrl+comma pour ouvrir la boîte de dialogue des paramètres, puis sélectionnez la page Machines.

Paramètres Machine

Cliquez sur Add Machine pour ouvrir le sélecteur de machine.

Boîte de dialogue Add Machine

L'assistant de configuration s'ouvre et adapte les étapes qu'il affiche à vos choix :

  • Choisir un profil intégré préremplit le contrôleur, la zone de travail et la tête — l'assistant passe directement aux étapes rotatif, caméra et récapitulatif
  • Importer un profil conserve les étapes matériel et tête afin de corriger ce que l'importation a mal configuré
  • Device Not Listed vous guide à travers toutes les étapes, y compris les étapes contrôleur et recherche de spécifications IA

Choisir un Point de Départ​

Choisissez un profil d'appareil intégré pour préremplir les paramètres du contrôleur, de la zone de travail et de la tête, ou cliquez sur Device Not Listed pour tout configurer manuellement. Vous pouvez aussi Import from File… un profil précédemment exporté ou un profil d'appareil LightBurn (.lbdev) avec le calibrage de caméra et les paramètres laser.

Assistant — Choisir un Point de Départ

Choisir un Contrôleur​

Choisissez la famille de firmware ou de protocole qui correspond à la carte contrôleur de votre machine (GRBL, Marlin, Smoothie, Ruida, OctoPrint, …). Choisissez None — G-code export only si vous souhaitez uniquement exporter le G-code vers des fichiers et ne jamais piloter de machine physique. Cette étape est ignorée lorsque vous partez d'un profil intégré ou d'une importation.

Assistant — Choisir un Contrôleur

Connexion​

Saisissez les paramètres de connexion requis par votre machine. Les champs exacts dépendent du contrôleur que vous avez choisi :

  • Pilotes série — chemin du périphérique USB (ex. /dev/ttyUSB0 sur Linux, COM3 sur Windows) et débit en bauds
  • Pilotes réseau — adresse hôte et port (ex. 192.168.1.100)
  • OctoPrint — URL du serveur et clé API

Assistant — Connexion

Découvrir l'Appareil​

Lorsque votre contrôleur le prend en charge, l'assistant propose de se connecter à l'appareil et de lire automatiquement sa configuration — zone de travail, vitesses, accélération et capacités du firmware. Cliquez sur Probe Now pour détecter automatiquement ces valeurs, ou utilisez Next pour les saisir manuellement dans les étapes suivantes.

Assistant — Découvrir l'Appareil

Fournisseur IA​

Affiché uniquement lorsqu'aucun fournisseur IA n'est encore configuré. Saisissez un endpoint compatible OpenAI (URL de base et clé API) afin que l'étape suivante puisse rechercher les spécifications des machines commerciales connues. Ignorez cette étape pour saisir les valeurs manuellement.

Assistant — Fournisseur IA

Recherche de Spécifications IA​

Si votre machine est un modèle commercial connu, l'IA peut préremplir ses spécifications à partir de la documentation du fabricant. Saisissez le fabricant et le modèle, puis cliquez sur Look Up Specs. Les valeurs suggérées apparaissent sous forme de lignes à bascule et démarrent acceptées — désactivez ce que vous ne souhaitez pas appliquer.

Assistant — Recherche de Spécifications IA

Matériel​

Configurez la configuration physique de la machine :

  • Axes — étendues X/Y de la zone de travail et coin d'origine des coordonnées (0,0)
  • Direction des axes — inversez un axe si les coordonnées deviennent négatives
  • Axe Z — si la machine a un axe Z (moteur de mise au point, lit mobile) ; lorsqu'il est absent, aucun mouvement Z n'est généré et le canevas 3D dispose le contenu sur le plan de gravure
  • Orientation du panneau — fait pivoter l'espace de travail plat tel qu'il est présenté à l'écran (Natif, Pivoter à gauche, Pivoter à droite) ; les couches rotatives nécessitent Natif
  • Zone de Travail — marges autour de l'espace inutilisable de la surface de travail
  • Limites Logicielles — limites de sécurité facultatives pour le déplacement
  • Vitesses — vitesse de déplacement max, vitesse de coupe max et accélération
  • Comportement — retour à l'origine au démarrage et homing mono-axe

Assistant — Matériel

Tête​

Déclarez ce qui est fixé au portique — une tête laser ou une tête de broche — et définissez ses paramètres. Pour un laser : puissance max (valeur S), taille du spot, fréquence PWM et distance focale. Pour une broche : RPM max et min.

Assistant — Tête

Module Rotatif​

Configurez facultativement un accessoire rotatif : type (mandrins ou rouleaux), axe (A/B/C), mode (vrai 4e axe vs. remplacement d'axe), géométrie et indicateur d'inversion de direction. Ignorez cette étape pour ajouter un module rotatif plus tard depuis les paramètres de la machine.

Assistant — Module Rotatif

Caméras​

Activez facultativement les caméras que vous souhaitez utiliser pour la prévisualisation et l'alignement. Lorsque vous activez une caméra et continuez, l'assistant de caméra s'ouvre pour vous guider à travers les paramètres d'image, la calibration d'objectif et l'alignement d'image. Vous pouvez ignorer cette étape et configurer les caméras plus tard depuis les paramètres caméra de la machine.

Assistant — Caméras

Récapitulatif et Nom​

Donnez un nom à la machine et consultez un récapitulatif de tout ce que vous avez configuré — pilote, connexion, zone de travail, vitesses, têtes, modules rotatifs et caméras. L'assistant fait également remonter tout avertissement, comme un pilote manquant ou une zone de travail non définie.

Assistant — Récapitulatif et Nom

Cliquez sur Create Machine pour finaliser. La boîte de dialogue Paramètres Machine s'ouvre pour votre nouvelle machine, où vous pouvez ajuster tous les paramètres préremplis par l'assistant. Consultez les pages Configuration Machine pour plus de détails.

Étape 3 : Connexion Automatique​

Rayforge se connecte automatiquement à votre machine au démarrage de l'application (si la machine est allumée et connectée). Vous n'avez pas besoin de cliquer manuellement sur un bouton de connexion.

Le statut de connexion est affiché dans le coin inférieur gauche de la fenêtre principale avec une icône de statut et une étiquette montrant l'état actuel (Connecté, Connexion, Déconnecté, Erreur, etc.).

Connecté !

Si votre machine affiche le statut "Connecté", vous êtes prêt à utiliser Rayforge !

Dépannage des Problèmes de Connexion​

Appareil Non Trouvé​

  • Linux (Série) : Ajoutez votre utilisateur au groupe dialout. Ceci est requis pour les installations Snap et non-Snap sur les distributions basées sur Debian pour éviter les messages AppArmor DENIED :

    sudo usermod -a -G dialout $USER

    Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.

  • Paquet Snap : En plus du groupe dialout ci-dessus, assurez-vous d'avoir accordé les permissions de port série :

    sudo snap connect rayforge:serial-port

  • Windows : Vérifiez le Gestionnaire de Périphériques pour confirmer que l'appareil est reconnu et notez le numéro de port COM.

Connexion Refusée​

  • Vérifiez que l'adresse IP et le numéro de port sont corrects
  • Assurez-vous que votre machine est allumée et connectée au réseau
  • Vérifiez les paramètres du pare-feu si vous utilisez une connexion réseau

Machine Ne Répond Pas​

  • Essayez un débit différent (certains appareils utilisent 9600 ou 57600)
  • Vérifiez les câbles desserrés ou les mauvaises connexions
  • Éteignez et rallumez votre découpeuse laser et réessayez

Pour plus d'aide, voir Problèmes de Connexion.

Suivant : Guide de Démarrage Rapide →