TapHome

Wake on LAN

Packet Parser → UDP
Inviato da
Ultimo aggiornamento: 03. 2026

Wake on LAN (WoL) è uno standard di rete che consente di risvegliare un dispositivo in standby o spento tramite un messaggio di rete speciale chiamato magic packet. Il protocollo è stato sviluppato congiuntamente da AMD e Hewlett-Packard nel 1995 ed è supportato da praticamente tutti i moderni adattatori di rete Ethernet.

Il template TapHome invia un magic packet WoL tramite UDP al dispositivo di destinazione. Espone un singolo pulsante — premendolo, il magic packet viene assemblato e inviato all’indirizzo IP configurato. Si tratta di un template di sola scrittura senza polling né lettura dello stato, poiché Wake on LAN è un protocollo unidirezionale senza conferma di consegna.

Configurazione

Durante l’importazione del template, TapHome richiede due parametri:

ParametroDescrizioneEsempio
Indirizzo IPIndirizzo broadcast della rete di destinazione192.168.0.255
MACIndirizzo MAC del dispositivo di destinazione (hex separato da spazi)12 34 56 78 9a bc

L’indirizzo IP dovrebbe essere tipicamente l’indirizzo broadcast della sottorete (ad es. 192.168.0.255 per una rete /24), non l’IP unicast del dispositivo di destinazione. Poiché il dispositivo è spento, non ha un IP attivo — il magic packet viene inviato in broadcast e l’adattatore di rete del dispositivo riconosce il proprio indirizzo MAC nel contenuto del pacchetto.

L’indirizzo MAC viene memorizzato come variabile del modulo e utilizzato per costruire il magic packet. Deve essere inserito in formato hex separato da spazi (ad es. 12 34 56 78 9a bc).

Il dispositivo di destinazione deve avere Wake on LAN abilitato nelle impostazioni BIOS/UEFI e sull’adattatore di rete. Senza questa configurazione, il magic packet verrà inviato ma il dispositivo non si risveglierà.

Preparazione del dispositivo di destinazione

Wake on LAN richiede una configurazione sul dispositivo di destinazione prima che risponda ai magic packet:

  1. BIOS/UEFI — abilitare Wake on LAN (tipicamente nella sezione Power Management o Network Boot)
  2. Sistema operativo — abilitare WoL sull’adattatore di rete:
    • Windows: Gestione dispositivi > proprietà NIC > “Wake on Magic Packet”
    • Linux: ethtool -s eth0 wol g
  3. Alimentazione — l’adattatore di rete deve ricevere alimentazione in standby quando il sistema è spento

WoL funziona dagli stati di sospensione ACPI S1 (Standby), S3 (Sleep), S4 (Hibernate) e S5 (Shutdown). Non funziona dallo stato G3 (Mechanical Off), in cui l’adattatore di rete non riceve alimentazione.

Funzionalità del dispositivo

Pulsante di risveglio

Il template espone un singolo dispositivo pulsante. Premendolo, viene inviato un pacchetto UDP contenente il magic packet WoL all’indirizzo IP configurato sulla porta 9999. Il magic packet è composto da 6 byte FF (flusso di sincronizzazione) seguiti da 16 ripetizioni dell’indirizzo MAC di destinazione — 102 byte in totale.

Non è disponibile lettura dello stato né polling. Il pulsante è di sola scrittura — attiva l’invio del pacchetto e ritorna immediatamente. Poiché WoL è un protocollo unidirezionale, non esiste conferma che il dispositivo si sia effettivamente risvegliato.

Funzionalità aggiuntive

Lo standard WoL definisce anche una funzione SecureOn password, in cui una password di 4 o 6 byte viene aggiunta dopo le ripetizioni del MAC per un’autenticazione aggiuntiva. Il subnet-directed broadcast (invio a un indirizzo broadcast di sottorete specifico come 192.168.1.255) può essere utilizzato per raggiungere dispositivi in altre sottoreti, se i router sono configurati per inoltrare i directed broadcast. Queste funzionalità possono essere aggiunte in un futuro aggiornamento del template.

Risoluzione dei problemi

Il dispositivo non si risveglia
  1. Verificare che Wake on LAN sia abilitato nelle impostazioni BIOS/UEFI del dispositivo di destinazione
  2. Verificare che l’adattatore di rete abbia WoL abilitato a livello di sistema operativo
  3. Confermare che l’indirizzo MAC in TapHome corrisponda all’adattatore Ethernet del dispositivo (non Wi-Fi)
  4. Controllare che l’indirizzo IP sia impostato sull’indirizzo broadcast corretto per la sottorete di destinazione
  5. Assicurarsi che l’alimentatore del dispositivo fornisca alimentazione in standby all’adattatore di rete
Dispositivi Wi-Fi

Wake on LAN è progettato per connessioni Ethernet cablate. La maggior parte degli adattatori Wi-Fi non mantiene il collegamento in stati a basso consumo, quindi i magic packet WoL standard non li raggiungeranno. Alcuni dispositivi supportano Wake on Wireless LAN (WoWLAN), ma si tratta di uno standard separato che potrebbe richiedere una configurazione diversa.

Wake on LAN è un protocollo unidirezionale — non esiste un meccanismo integrato per confermare se il dispositivo si sia effettivamente risvegliato. Per la verifica, considera l’aggiunta di un controllo ping di rete separato o il monitoraggio della disponibilità del dispositivo tramite un’altra integrazione TapHome.

Dispositivi disponibili

Wake on LAN Modulo
Variabili personalizzate
MAC (string)MAC address of the target device in space-separated hex format (e.g. 12 34 56 78 9a bc)
Wake on LAN Pulsante

Invia un magic packet per risvegliare un dispositivo di rete in standby — premi per inviare, senza feedback di stato

action

Wake on LAN

Scrittura stato pulsante
VAR magicPacket := BYTECOLLECTION("FF FF FF FF FF FF " + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC);
SENDDATA(magicPacket);
Connessione: Packet Parser → UDP
Possibili miglioramenti (2)
  • SecureOn Password — Some NICs support a 6-byte SecureOn password appended after the 16x MAC repetitions for additional security
  • Subnet-Directed Broadcast — Template sends to a specific IP address; subnet-directed broadcast (e.g. 192.168.0.255) could reach devices whose IP is unknown after shutdown

Fonti