Perché Lùmen non si connette al mio laser via WiFi?

Fai quattro verifiche: la macchina deve avere un controller con WiFi (classe ESP32/ESP3D — le classiche schede GRBL solo-USB non hanno WiFi), Mac e incisore devono essere sulla stessa rete (oppure il Mac collegato all'hotspot della macchina), indirizzo IP e porta devono essere corretti (la maggior parte dei controller usa la porta TCP 23, e l'IP può cambiare dopo un riavvio del router), e Lùmen deve avere il permesso Rete locale di macOS (Impostazioni di Sistema → Privacy e Sicurezza → Rete locale).

Il mio incisore laser supporta il WiFi?

Solo le macchine con controller di classe ESP32/ESP3D e firmware di rete — come l'Algolaser Pixie — espongono GRBL via WiFi (una connessione TCP diretta, tipicamente sulla porta 23). Le classiche schede GRBL solo-USB con chip seriale CH340/CP210x non hanno la radio, e nessun adattatore può aggiungere il WiFi. Se la tua macchina è solo USB, collegala via USB.

← FAQ

Non riesco a connettermi al laser via WiFi

Connessione e configurazione · Aggiornato: 21 luglio 2026

Il WiFi in Lùmen è GRBL over TCP: lo stesso flusso di comandi dell'USB, inviato via rete all'indirizzo IP e alla porta del controller. Quando Connetti fallisce o va in timeout, il problema è quasi sempre uno di questi quattro. Verificali in ordine.

1. Verifica che la macchina supporti davvero il WiFi

Solo le macchine con un controller di classe ESP32/ESP3D e firmware di rete — l'Algolaser Pixie è l'esempio tipico — espongono GRBL via WiFi. Le classiche schede GRBL solo-USB (quelle con chip seriale CH340 o CP210x) non hanno la radio: nessun adattatore può aggiungere il WiFi. Se la tua macchina è solo USB, non è un bug — collegala via USB.

Non sai quale tipo hai? La guida agli incisori laser WiFi spiega come riconoscerlo e come funziona tutta la configurazione.

2. Metti Mac e macchina sulla stessa rete

Il Mac deve poter raggiungere l'indirizzo IP del controller:

Stessa rete WiFi — la configurazione più comune: incisore e Mac entrambi collegati alla rete di casa o del laboratorio.
Hotspot della macchina — alcuni controller creano un proprio access point (es. ALA1-AP-xxxx). Collegati dal menu WiFi del Mac. Nota che mentre sei sull'hotspot il Mac di solito non ha internet.

3. Controlla indirizzo IP e porta

La maggior parte dei controller laser ESP32/ESP3D espone il flusso GRBL sulla porta TCP 23 (alcuni firmware ne usano una diversa — controlla la documentazione della macchina). L'indirizzo IP è mostrato dall'app o dal display della macchina, oppure si legge via USB con il comando $WRS nella console.

Tieni presente che l'IP può cambiare dopo un riavvio del router (DHCP). Se una connessione che funzionava smette di colpo, ricontrolla prima l'IP — e valuta di assegnare all'incisore un IP riservato/statico nelle impostazioni del router, così smette di spostarsi.

4. Consenti il permesso Rete locale di macOS

La prima volta che un'app si connette a un dispositivo sulla rete locale, macOS mostra la richiesta di permesso “Rete locale”. Se è stata negata (o ignorata), le connessioni agli indirizzi 192.168.x.x falliscono o restano appese. Sistemalo in Impostazioni di Sistema → Privacy e Sicurezza → Rete locale: verifica che Lùmen sia abilitato, poi riprova.

Fallisce ancora? Altre due cose da provare

Spegni e riaccendi l'incisore. I controller ESP32 ogni tanto smettono di accettare connessioni finché non vengono riavviati.
Chiudi gli altri software. La maggior parte di questi controller accetta un solo client TCP alla volta — una sessione LightBurn rimasta aperta o una finestra Telnet può occupare il posto.

Se la connessione cade a metà lavoro

Il WiFi può cadere in silenzio dove l'USB fallirebbe in modo evidente — segnale debole, riavvii del router, reboot del controller. Il watchdog di Lùmen ti avvisa quando un lavoro in corso resta muto. Dopo una disconnessione, riconnetti e rifai l'homing prima di rilanciare il lavoro: il controller perde lo stato di posizione. Per i lavori lunghi preferisci un segnale forte o il cavo USB, e guarda la guida WiFi per la modalità di streaming affidabile.

Ancora bloccato?

Contatta il supporto indicando modello di incisore e controller/firmware, IP e porta che stai usando, e come la macchina è in rete (WiFi di casa o hotspot) — di solito basta per individuare il problema rapidamente.