Conectar tu primera máquina
Esta guía te dice qué datos pide NOPAL para cada tipo de máquina y dónde conseguirlos.
Dar de alta una máquina requiere el rol Administrador. Un operador puede ver y operar las máquinas ya registradas, pero no registrarlas. Ver Usuarios y roles.
Las máquinas deben estar en la misma red local que NOPAL. Las altas se hacen en Configuración → Dispositivos. Las secciones de cada familia en el menú lateral te lo recuerdan: "Agrega la impresora desde Configuración → Dispositivos."
Elige tu caso:
| Tengo… | Ir a |
|---|---|
| Una impresora con Klipper y Moonraker | Klipper |
| Una impresora con Marlin (USB o placa MKS WiFi) | Marlin |
| Un láser o una CNC con GRBL | Láser y CNC |
| Una Bambu Lab | Bambu Lab |
| Una Elegoo | Elegoo |
| Una FlashForge | FlashForge |
Klipper
NOPAL busca Moonraker en el mismo equipo donde corre NOPAL, en los puertos 7125, 7126 y 7127. Si tu Moonraker está en esos puertos, la impresora aparece sola, sin alta manual.
Si usas otros puertos, el administrador del servidor debe declararlos en la variable de entorno NOPAL_KLIPPER_PORTS (lista de puertos separados por comas) y reiniciar NOPAL:
sudo systemctl edit nopal
Añade en el editor:
[Service]
Environment=NOPAL_KLIPPER_PORTS=7130,7131
sudo systemctl restart nopal
Hoy NOPAL no descubre Klipper en otros equipos de la red: busca Moonraker en el propio servidor.
Marlin
Marlin se conecta por USB o por WiFi (módulos MKS WiFi).
Por USB
- Conecta la impresora al equipo donde corre NOPAL.
- En Configuración → Dispositivos, elige el puerto USB detectado. Si no aparece ninguno, verás "No se detectaron puertos compatibles."
- NOPAL prueba la velocidad de conexión (baudios) automáticamente y sugiere un nombre a partir de lo que responde la impresora.
- Pon un nombre. Opcionalmente elige un perfil de máquina y, si aplica, la variante de placa y el número de extrusores.
- Pulsa Agregar impresora.
Por WiFi (MKS)
- En Configuración → Dispositivos, deja que NOPAL descubra el módulo en la red, o usa Agregar por IP.
- Si lo agregas por IP, indica el puerto TCP. NOPAL se conecta al puente de G-code de la placa, que por defecto usa el puerto 8080.
- Pon un nombre y confirma.
Láser y CNC
Controladoras GRBL, incluidas las placas ESP3D y FluidNC.
- Por USB: aparecen en Puertos USB detectados (controladoras CH340, CP210x o ESP32 conectadas directo al servidor). Si no hay ninguna verás "No se detectaron controladoras láser por USB."
- Por WiFi: NOPAL escanea la red local. Si tu máquina está en otra subred, usa Buscar por IP y escribe su dirección.
Después de detectarla, ponle un nombre y regístrala. Cada láser o CNC es independiente: puedes tener varios a la vez.
Bambu Lab
Solo en modo LAN. Datos necesarios:
| Dato | Dónde encontrarlo |
|---|---|
| IP | En tu router o en la pantalla de la impresora |
| Número de serie | En la impresora |
| Access code | En la pantalla de la impresora: Configuración → Red → Modo LAN |
| Nombre | El que tú elijas |
| Modelo | Opcional |
NOPAL comprueba el access code con una conexión real (MQTT) antes de confirmar el alta.
Una Bambu Lab solo se ve cuando ella misma se anuncia en la red, así que el escaneo puede no encontrarla a la primera. Repite el escaneo o escribe su IP a mano.
Elegoo
Impresoras con el protocolo SDCP (por ejemplo Centauri Carbon o la serie Neptune 4).
- Pulsa el escaneo de red. Si no detecta nada verás "No se detectaron impresoras Elegoo en la red. Prueba a escanear de nuevo."
- Datos que pide el alta: IP, identificador de la placa (
mainboard_id, que el escaneo detecta), nombre y, opcionalmente, modelo.
FlashForge
Solo la línea moderna (HTTP), como Adventurer 5M o AD5X. Las Adventurer 3 y 4 no están soportadas.
| Dato | Dónde encontrarlo |
|---|---|
| IP | En tu router o en la impresora |
| Número de serie | En la impresora |
| Check code | En la pantalla de la impresora: Ajustes → Red o Información |
| Nombre | El que tú elijas |
Asistente guiado
Si eres administrador, puedes añadir Hellbot (Marlin), Bambu Lab, Elegoo y FlashForge con un asistente de 6 pasos. Ver Centro de ayuda y recorrido guiado.
Después del alta
Comprueba: la máquina aparece en el Panel de control con un punto de estado:
- Idle: conectada y sin trabajo.
- Run: tiene un trabajo en curso.
- Error: reporta una falla.
- Sin conexión: NOPAL no puede comunicarse; revisa la red o el USB.
Si algo no funciona, ve a Solución de problemas. Para saber qué puede hacer NOPAL con tu máquina, consulta la matriz de compatibilidad.