> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Wake-on-LAN

> Acorde PCs, TVs e NAS na rede local via magic packet

# Wake-on-LAN

A integração Wake-on-LAN envia **magic packets UDP** para acordar dispositivos na rede local — PCs, TVs, NAS, servidores. É útil para acionar equipamentos que ficam em standby a partir de automações ou botões no dashboard.

## Pre-requisitos

* Dispositivo alvo com **Wake-on-LAN habilitado** na BIOS e/ou na configuração da placa de rede
* **MAC address** do dispositivo (pode estar em `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF` ou `aabbccddeeff`)
* Dispositivo conectado por cabo (WoL sobre WiFi depende do adaptador e nem sempre funciona)

## Configurar

<Steps>
  <Step title="Habilite WoL no dispositivo">
    Ative Wake-on-LAN na BIOS e nas propriedades da interface de rede do sistema operacional.
  </Step>

  <Step title="Descubra o MAC">
    Consulte o MAC pelo próprio dispositivo (`ipconfig /all` no Windows, `ip link` no Linux) ou pelo painel do roteador.
  </Step>

  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → Wake-on-LAN** e informe nome e MAC.
  </Step>
</Steps>

## Recursos

* **`button`** — uma entidade única por dispositivo. Ao ser pressionada, dispara o magic packet.

## Como Funciona

O MAC informado é normalizado (sem `:` e em lowercase) e usado como `unique_id`. Não há probe — o Portal não tem como verificar se o dispositivo alvo aceitou o pacote, então valide o funcionamento executando o botão logo após adicionar.

<Info>
  WoL só funciona dentro da **mesma rede** do edge (broadcast UDP). Para acordar dispositivos remotos você precisa de suporte no roteador (WoL over WAN / port forwarding).
</Info>