TapHome

Wake on LAN

Packet Parser → UDP
Eingereicht von
Zuletzt aktualisiert: 03. 2026

Wake on LAN (WoL) ist ein Netzwerkstandard, der es ermöglicht, ein schlafendes oder ausgeschaltetes Gerät durch eine spezielle Netzwerknachricht namens Magic Packet aufzuwecken. Das Protokoll wurde 1995 gemeinsam von AMD und Hewlett-Packard entwickelt und wird von praktisch allen modernen Ethernet-Netzwerkadaptern unterstützt.

Das TapHome-Template sendet ein WoL Magic Packet über UDP an ein Zielgerät. Es stellt einen einzelnen Taster bereit — beim Drücken wird das Magic Packet zusammengestellt und an die konfigurierte IP-Adresse gesendet. Es handelt sich um ein reines Schreib-Template ohne Polling oder Rücklesen, da Wake on LAN ein unidirektionales Protokoll ohne Zustellbestätigung ist.

Konfiguration

Beim Template-Import fordert TapHome zwei Parameter an:

ParameterBeschreibungBeispiel
IP-AdresseBroadcast-Adresse des Zielnetzwerks192.168.0.255
MACMAC-Adresse des Zielgeräts (hex, durch Leerzeichen getrennt)12 34 56 78 9a bc

Die IP-Adresse sollte typischerweise die Subnetz-Broadcast-Adresse sein (z. B. 192.168.0.255 für ein /24-Netzwerk), nicht die Unicast-IP des Zielgeräts. Da das Gerät ausgeschaltet ist, hat es keine aktive IP — das Magic Packet wird per Broadcast gesendet und der Ziel-Netzwerkadapter erkennt seine eigene MAC-Adresse im Paketinhalt.

Die MAC-Adresse wird als Modulvariable gespeichert und zum Aufbau des Magic Packets verwendet. Sie muss im durch Leerzeichen getrennten Hex-Format eingegeben werden (z. B. 12 34 56 78 9a bc).

Das Zielgerät muss Wake on LAN in den BIOS/UEFI-Einstellungen und am Netzwerkadapter aktiviert haben. Andernfalls wird das Magic Packet zwar gesendet, das Gerät wird aber nicht aufgeweckt.

Vorbereitung des Zielgeräts

Wake on LAN erfordert eine Konfiguration am Zielgerät, bevor es auf Magic Packets reagiert:

  1. BIOS/UEFI — Wake on LAN aktivieren (typischerweise unter Power Management oder Network Boot)
  2. Betriebssystem — WoL am Netzwerkadapter aktivieren:
    • Windows: Geräte-Manager > NIC-Eigenschaften > „Wake on Magic Packet"
    • Linux: ethtool -s eth0 wol g
  3. Stromversorgung — der Netzwerkadapter muss im ausgeschalteten Zustand Standby-Strom erhalten

WoL funktioniert aus den ACPI-Schlafzuständen S1 (Standby), S3 (Sleep), S4 (Hibernate) und S5 (Shutdown). Es funktioniert nicht aus dem Zustand G3 (Mechanical Off), bei dem der Netzwerkadapter keinen Strom erhält.

Gerätefunktionen

Wake-Taste

Das Template stellt ein einzelnes Taster-Gerät bereit. Beim Drücken wird ein UDP-Paket mit dem WoL Magic Packet an die konfigurierte IP-Adresse auf Port 9999 gesendet. Das Magic Packet besteht aus 6 Bytes FF (Synchronisationsstrom), gefolgt von 16 Wiederholungen der Ziel-MAC-Adresse — insgesamt 102 Bytes.

Es gibt kein Rücklesen und kein Status-Polling. Die Taste ist rein schreibend — sie löst den Paketversand aus und kehrt sofort zurück. Da WoL ein unidirektionales Protokoll ist, gibt es keine Bestätigung, dass das Zielgerät tatsächlich aufgeweckt wurde.

Weitere Möglichkeiten

Der WoL-Standard definiert auch eine SecureOn-Passwort-Funktion, bei der ein 4- oder 6-Byte-Passwort nach den MAC-Wiederholungen für zusätzliche Authentifizierung angehängt wird. Subnet-Directed Broadcast (Senden an eine bestimmte Subnetz-Broadcast-Adresse wie 192.168.1.255) kann verwendet werden, um Geräte in anderen Subnetzen zu erreichen, wenn Router für die Weiterleitung von Directed Broadcasts konfiguriert sind. Diese Funktionen können in einem zukünftigen Template-Update hinzugefügt werden.

Fehlerbehebung

Gerät wacht nicht auf
  1. Überprüfen Sie, ob Wake on LAN in den BIOS/UEFI-Einstellungen des Zielgeräts aktiviert ist
  2. Überprüfen Sie, ob der Netzwerkadapter WoL auf Betriebssystemebene aktiviert hat
  3. Bestätigen Sie, dass die MAC-Adresse in TapHome dem Ethernet-Adapter des Zielgeräts entspricht (nicht Wi-Fi)
  4. Prüfen Sie, ob die IP-Adresse auf die korrekte Broadcast-Adresse für das Zielsubnetz eingestellt ist
  5. Stellen Sie sicher, dass die Stromversorgung des Zielgeräts dem Netzwerkadapter Standby-Strom bereitstellt
Wi-Fi-Geräte

Wake on LAN ist für kabelgebundene Ethernet-Verbindungen ausgelegt. Die meisten Wi-Fi-Adapter halten im Energiesparmodus keine Verbindung aufrecht, sodass Standard-WoL-Magic-Packets sie nicht erreichen. Einige Geräte unterstützen Wake on Wireless LAN (WoWLAN), aber dies ist ein separater Standard, der möglicherweise eine andere Konfiguration erfordert.

Wake on LAN ist ein unidirektionales Protokoll — es gibt keinen eingebauten Mechanismus zur Bestätigung, ob das Zielgerät tatsächlich aufgeweckt wurde. Zur Überprüfung können Sie eine separate Netzwerk-Ping-Prüfung hinzufügen oder die Verfügbarkeit des Geräts über eine andere TapHome-Integration überwachen.

Verfügbare Geräte

Wake on LAN Modul
Benutzerdefinierte Variablen
MAC (string)MAC address of the target device in space-separated hex format (e.g. 12 34 56 78 9a bc)
Wake on LAN Taster

Sendet ein Magic Packet zum Aufwecken eines schlafenden Netzwerkgeräts — zum Senden drücken, keine Statusrückmeldung

action

Wake on LAN

Tastenstatus schreiben
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);
Verbindung: Packet Parser → UDP
Mögliche Verbesserungen (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

Quellen