Pular para o conteúdo
SHCDocumentação SHC
Conteúdo técnicopara integradores e desenvolvedores. Para usar o sistema no dia a dia, veja os manuais dos apps e equipamentos.

/aa/wol: Wake-on-LAN

A ação /aa/wol liga um computador pela rede local, a partir do endereço MAC dele. O equipamento envia o pacote Wake-on-LAN por UDP: 6 bytes FF seguidos do MAC repetido 16 vezes.

Parâmetros

Seção intitulada “Parâmetros”
Firmware Parâmetros
3.1.0 ou mais novo mac: endereço MAC em hexadecimal, 6 bytes (001B44112233 ou 00:1B:44:11:22:33). ip: endereço de broadcast; vazio envia para 255.255.255.255. Se o roteador bloquear esse endereço, use o broadcast da sua rede (ex.: 192.168.0.255). port: porta UDP; 0 envia para a porta 9. _su: identificador livre, de até 8 caracteres (veja os parâmetros de controle).
2.4.x mac0 a mac5: os 6 bytes do MAC, em decimal.

Enviar

Seção intitulada “Enviar”

Com @0 e os parâmetros, o equipamento envia o pacote na hora. Exemplo: ligar o computador de MAC 00:1B:44:11:22:33.

$72B0>/aa/wol@0?mac=001B44112233&ip=192.168.0.255&port=9<48231# — Dispositivo: $72B0, Ação: >/aa/wol, Protocolo: @0, Valores: ?mac=001B44112233&ip=192.168.0.255&port=9, Sequência: <48231, Fim: #
$72B0>/aa/wol@0?code=1111&mac=001B44112233&ip=192.168.0.255&port=9&_su=&err=0<3400980# — Dispositivo: $72B0, Ação: >/aa/wol, Protocolo: @0, Valores: ?code=1111&mac=001B44112233&ip=192.168.0.255&port=9&_su=&err=0, Sequência: <3400980, Fim: #
Parâmetro da resposta Conteúdo
err 0 = pacote aceito para envio. 1 = mac inválido (menos de 6 bytes ou caractere que não é hexadecimal). Com erro, nada é enviado.

Parâmetro que não vai na mensagem fica com o último valor usado. Envie sempre mac, ip e port.

Usar numa cena

Seção intitulada “Usar numa cena”

Para o envio acontecer quando um botão é pressionado, grave a ação como item da cena do botão (/cs/btN). No item, path é /aa/wol e query traz os parâmetros separados por ;, como em /aa/tcp.

Consultar

Seção intitulada “Consultar”
$72B0>/aa/wol@0?_to=192.168.0.10<99999# — Dispositivo: $72B0, Ação: >/aa/wol, Protocolo: @0, Valores: ?, Destino: _to=192.168.0.10, Sequência: <99999, Fim: #

Resposta

Seção intitulada “Resposta”

A consulta não envia nada. Ela devolve code=1001 e os parâmetros da ação:

$72B0>/aa/wol@0?code=1001&mac=001B44112233&ip=192.168.0.255&port=9&_su=&err=0&_to=192.168.0.10<3382230# — Dispositivo: $72B0, Ação: >/aa/wol, Protocolo: @0, Valores: ?code=1001&mac=001B44112233&ip=192.168.0.255&port=9&_su=&err=0, Destino: &_to=192.168.0.10, Sequência: <3382230, Fim: #