---
title: "Wake on LAN"
description: "Risveglia PC, NAS e server dalle automazioni TapHome: un pulsante invia il magic packet WoL via UDP all'indirizzo broadcast della rete."
url: "https://taphome.com/it/compatibility/wake-on-lan/"
language: it
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["data-pp","other","udp","wake-on-lan","network-utility"]
  questions: ["Come risvegliare un PC da TapHome usando Wake on LAN?","Come configurare Wake on LAN in TapHome?","Qual è il formato del magic packet Wake on LAN?","Come trovare l'indirizzo MAC per Wake on LAN?","TapHome può risvegliare un NAS o un server da remoto?"]
---

# Wake on LAN

Comunicazione: Packet Parser → UDP

> Indirizzo di rete
> 
> TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo.
> 
> [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/)

## Guida all'integrazione

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:

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| Indirizzo IP | Indirizzo broadcast della rete di destinazione | `192.168.0.255` |
| MAC | Indirizzo 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`).

> [!WARNING]
> 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.

> [!NOTE]
> 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 1

Questi dispositivi compaiono in TapHome dopo l'importazione.

Wake on LAN Modulo

Variabili personalizzate

|                |                                                                                                        |
|----------------|--------------------------------------------------------------------------------------------------------|
| `MAC` (string) | Indirizzo MAC del dispositivo di destinazione in formato hex separato da spazi (es. 12 34 56 78 9a bc) |

Wake on LAN Pulsante Lettura e scrittura

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

action

Scrittura stato pulsante

```taphome
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

## Parametri di importazione

Inserisci questi valori quando importi l'XML.

| Richiesto nell'app | Predefinito         |
|--------------------|---------------------|
| Indirizzo IP       | `192.168.0.1`       |
| MAC                | `12 34 56 78 9a bc` |

## Fonti

- Wake-on-LAN — Wikipedia
  
  [en.wikipedia.org](https://en.wikipedia.org/wiki/Wake-on-LAN) 2026-03-29
- WakeOnLAN — Wireshark Protocol Reference
  
  [wiki.wireshark.org](https://wiki.wireshark.org/WakeOnLAN) 2026-03-29
- Wake on LAN — Home Assistant Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/wake_on_lan/) 2026-03-29
- Wake on LAN — ManageEngine Technical Overview
  
  [www.manageengine.com](https://www.manageengine.com/products/oputils/tech-topics/what-is-wake-on-lan.html) 2026-03-29

## Documentazione correlata

- [Integrazione Packet Parser](https://taphome.com/it/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/)
- [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/)
- [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/)