Configuración Inicial
Después de instalar Rayforge, necesitarás configurar tu cortador o grabador láser. Esta guía te guiará en la creación de tu primera máquina y el establecimiento de una conexión.
Paso 1: Iniciar Rayforge
Inicia Rayforge desde el menú de aplicaciones o ejecutando rayforge en una terminal. Deberías ver la interfaz principal con un lienzo vacío.
Paso 2: Crear una Máquina
Ve a Configuración → Máquinas o presiona ctrl+coma para abrir el diálogo de configuración, luego selecciona la página Máquinas.
Haz clic en Añadir Máquina para crear una nueva máquina. Puedes:
- Elegir un perfil integrado - Selecciona entre plantillas de máquina predefinidas
- Seleccionar "Personalizada" - Comienza con una configuración en blanco
Después de seleccionar, se abre el diálogo de Configuración de Máquina para tu nueva máquina.

Paso 3: Configurar Ajustes Generales
La página General contiene información básica de la máquina, selección de controlador y configuración de conexión.

Información de la Máquina
- Nombre de Máquina: Dale a tu máquina un nombre descriptivo (ej., "K40 Laser", "Ortur LM2")
Selección de Controlador
Selecciona el controlador apropiado para tu dispositivo del menú desplegable:
- GRBL (Serial) - Para dispositivos GRBL conectados vía USB/puerto serie
- GRBL (Network) - Para dispositivos GRBL con conectividad WiFi/Ethernet
- Smoothie - Para dispositivos basados en Smoothieware
Configuración del Controlador
Dependiendo del controlador seleccionado, configura los parámetros de conexión:
GRBL (Serial) - USB
- Puerto: Elige tu dispositivo del menú desplegable (ej.,
/dev/ttyUSB0en Linux,COM3en Windows) - Velocidad de Transmisión: Selecciona
115200(estándar para la mayoría de dispositivos GRBL)
Si tu dispositivo no aparece en la lista, verifica que esté conectado y que tengas los permisos necesarios. En Linux, puede que necesites añadir tu usuario al grupo dialout.
GRBL (Network) / Smoothie - WiFi/Ethernet
- Host: Ingresa la dirección IP de tu dispositivo (ej.,
192.168.1.100) - Puerto: Ingresa el número de puerto (típicamente
23o8080)
Velocidades y Aceleración
Estos ajustes se usan para la estimación de tiempo de trabajo y optimización de trayectorias:
- Velocidad Máxima de Desplazamiento: Velocidad máxima de movimiento rápido
- Velocidad Máxima de Corte: Velocidad máxima de corte
- Aceleración: Usada para estimaciones de tiempo y cálculos de overscan
Paso 4: Configurar Ajustes de Hardware
Cambia a la pestaña Hardware para configurar las dimensiones físicas de tu máquina.

Dimensiones
- Ancho: Ingresa el ancho máximo de tu área de trabajo en milímetros
- Alto: Ingresa el alto máximo de tu área de trabajo en milímetros
Ejes
- Origen de Coordenadas (0,0): Selecciona dónde está ubicado el origen de tu máquina:
- Abajo Izquierda (más común para GRBL)
- Arriba Izquierda
- Arriba Derecha
- Abajo Derecha
Desplazamiento de Ejes (Opcional)
Configura los desplazamientos X e Y si tu máquina los requiere para un posicionamiento preciso.
Paso 5: Conexión Automática
Rayforge se conecta automáticamente a tu máquina cuando se inicia la aplicación (si la máquina está encendida y conectada). No necesitas hacer clic manualmente en un botón de conexión.
El estado de conexión se muestra en la esquina inferior izquierda de la ventana principal con un ícono de estado y etiqueta mostrando el estado actual (Conectado, Conectando, Desconectado, Error, etc.).
Si tu máquina muestra el estado "Conectado", ¡estás listo para empezar a usar Rayforge!
Opcional: Configuración Avanzada
Múltiples Láseres
Si tu máquina tiene múltiples módulos láser (ej., diodo y CO2), puedes configurarlos en la página Láser.

Ver Configuración de Láser para más detalles.
Configuración de Cámara
Si tienes una cámara USB para alineación y posicionamiento, configúrala en la página Cámara.

Ver Integración de Cámara para más detalles.
Configuración de Dispositivo
La página Dispositivo te permite leer y modificar configuraciones de firmware directamente en tu dispositivo conectado (como parámetros GRBL). Esta es una función avanzada y debe usarse con precaución.
¡Editar la configuración del dispositivo puede ser peligroso y puede dejar tu máquina inoperativa si se aplican valores incorrectos!
Solución de Problemas de Conexión
Dispositivo No Encontrado
-
Linux (Serial): Añade tu usuario al grupo
dialout. Esto es requerido para instalaciones Snap y no Snap en distribuciones basadas en Debian para evitar mensajes AppArmor DENIED:sudo usermod -a -G dialout $USERCierra sesión y vuelve a entrar para que los cambios surtan efecto.
-
Paquete Snap: Además del grupo
dialoutarriba, asegúrate de haber otorgado permisos de puerto serie:sudo snap connect rayforge:serial-port -
Windows: Revisa el Administrador de Dispositivos para confirmar que el dispositivo es reconocido y anota el número de puerto COM.
Conexión Rechazada
- Verifica que la dirección IP y el número de puerto sean correctos
- Asegúrate de que tu máquina esté encendida y conectada a la red
- Revisa la configuración del firewall si usas conexión de red
La Máquina No Responde
- Prueba con una velocidad de transmisión diferente (algunos dispositivos usan
9600o57600) - Revisa si hay cables sueltos o conexiones deficientes
- Apaga y enciende tu cortador láser y vuelve a intentarlo
Para más ayuda, ver Problemas de Conexión.
Siguiente: Guía de Inicio Rápido →