Automações
Uma automação é uma regra executada autonomamente pela instalação: Quando ocorre um evento, Se as condições estiverem reunidas, Então executa estas ações. Aceda através de Configuração → Automações.
O modelo de regras
- Quando — os desencadeadores (triggers). Se existirem vários, qualquer um deles inicia a regra (OU).
- Se — as condições, verificadas antes da execução das ações. Opcional: sem condições, a automação é executada a cada desencadeamento. Em Todas as condições devem ser: selecione se todas as condições têm de ser verdadeiras (E) ou apenas uma delas (OU).
- Então — as ações, executadas sequencialmente.
Desencadeadores — o que inicia a automação
Prima Adicionar um desencadeador e selecione:
| Desencadeador | Função |
|---|---|
| Horário | Executa segundo um agendamento: Todos os dias a uma hora, Dias selecionados, Numa data específica ou num Intervalo em minutos. |
| Estado do Dispositivo | Executa quando um parâmetro de um dispositivo se altera: selecione o dispositivo, o parâmetro e a condição (Torna-se igual a um valor, diferente, superior, inferior ou simplesmente altera-se). Durante pelo menos define um tempo de filtragem para evitar falsos disparos. |
| Astronómico | Executa num evento solar — Nascer do Sol, Pôr do Sol, Alvorada, Crepúsculo, Meio-dia Solar, Hora Dourada, Alvorada Náutica e outros eventos solares — com um Desvio em ± minutos. O editor apresenta a hora calculada para o dia atual ("Próxima execução hoje às 21:14"). |
| Previsão Meteorológica | Executa quando uma previsão ultrapassa um limiar (temperatura, vento, precipitação, nebulosidade…). |
| Preço da Energia | Executa com base no preço da eletricidade (consulte o artigo correspondente para detalhes da curva). |
| Manual | Sem início automático — executado manualmente a partir da lista ou de uma vista. |
📘 Nota: Os desencadeadores Previsão Meteorológica e Preço da Energia só são exibidos quando o respetivo serviço estiver ativo no servidor (consulte “Serviço Meteorológico”, “Serviço de Preço da Energia”).
Condições — verificadas antes da execução das ações
Prima Adicionar uma condição e selecione:
- Estado do Dispositivo — valor atual de um dispositivo comparado com um limiar.
- Intervalo Horário — apenas entre uma hora de início e de fim, opcionalmente em dias selecionados.
- Intervalo de Datas — um período do ano ("uma estação — de 15 de junho a 15 de setembro"). Se a data final for anterior à data inicial, o intervalo transita para o ano seguinte. Selecione Repetir todos os anos ou limite a um único ano.
- Astronómico — apenas entre dois eventos solares, por exemplo após o pôr do sol e antes da alvorada (selecione um evento inicial e final). O editor apresenta os horários calculados para o dia.
- Previsão Meteorológica — verificação da previsão numa janela temporal (Atual, Próximas 1/3/6/12/24 horas, Amanhã) com uma Agregação (Média, Mínimo, Máximo, Qualquer, Todas).
- Preço da Energia — o preço numa janela temporal (Hora Atual, próximas horas, Hoje, Amanhã), em modo Absoluto (superior/inferior/entre um valor) ou Estatístico (Abaixo da Média, Nas N Horas Mais Baratas, percentil…).
Ações — o que a automação executa
Prima Adicionar uma ação e selecione:
- Controlo de Dispositivo — define o parâmetro de um dispositivo para um valor pretendido. Num termóstato, o parâmetro Boost ativa um reforço de 30 min, 1 h, 2 h ou 3 h (ou Parar boost).
- Cenário — executa um cenário existente.
- Comando Geral — comanda iluminação ou estores de uma Divisão ou Categoria completa em simultâneo.
- Notificação — envia uma notificação push para a aplicação.
- E-mail — envia um e-mail com assunto e mensagem personalizados aos utilizadores do HyperVisu. Requer o serviço de E-mail (consulte “Serviço de E-mail”) — a opção surge desativada até à respetiva configuração. Permite selecionar destinatários, canal (push ou e-mail) e prioridade.
Cada ação dispõe de um Atraso antes da execução opcional em segundos, visível num indicador sobre a ação ("atrasa esta ação após a anterior").
Gestão de automações
A partir da lista de Automações:
- Seletor Ativo — ativa ou desativa uma regra sem a eliminar.
- Desencadear Automação — teste de funcionamento: executa apenas as ações, ignorando todas as condições.
- Duplicar — duplica uma regra para criar uma variante.
- Cada linha apresenta o número de desencadeadores/condições/ações, a próxima execução (para desencadeadores horários) e a última execução.
- Cada automação pode ter o seu próprio ícone (Escolher um ícone).
Tabela de referência: vocabulário de automações e cenários
Resumo técnico da terminologia utilizada no editor de regras e nos agendamentos de cenários (consulte “Cenários”).
Desencadeadores (QUANDO)
Uma regra dispara quando qualquer um dos seus desencadeadores for acionado — múltiplos desencadeadores funcionam com lógica OU.
| Desencadeador | Dispara quando | Parâmetros |
|---|---|---|
| Estado do dispositivo | O valor de um dispositivo cumpre o critério | Dispositivo + objeto, operador: igual · diferente · superior · inferior · altera-se |
| Horário | O relógio atinge a hora definida | Diário, semanal (dias selecionados) ou data específica |
| Astronómico | Ocorre um evento solar | Um dos 13 eventos solares ± desvio em minutos |
| Manual | O utilizador executa a regra manualmente | — (a regra é apresentada como um botão na aplicação) |
| Previsão meteorológica | A previsão ultrapassa um limiar | Variável meteorológica, operador, limiar |
| Preço da energia | O preço da eletricidade atinge um limiar | Operador de preço + limiar |
Condições (SE)
As condições são verificadas após o disparo de um desencadeador; a regra apenas é executada se forem validadas. As condições combinam-se com os operadores E / OU.
| Condição | Valida quando | Parâmetros |
|---|---|---|
| Estado do dispositivo | O valor do dispositivo cumpre o critério | Dispositivo + objeto, operador, valor |
| Intervalo horário | A hora atual está dentro do intervalo | Hora de início–fim + dias da semana |
| Período do ano | A data atual cumpre a regra | Intervalo de datas, operador: é · não é · é anterior a · é posterior a |
| Estado astronómico | A posição solar cumpre a condição (ex. após pôr do sol) | Evento / estado solar |
| Previsão meteorológica | A previsão na janela temporal cumpre o critério | Janela: agora · 1 h · 3 h · 6 h · 12 h · 24 h; agregação: média · mínimo · máximo; operador + limiar |
| Preço da energia | O preço atual cumpre o critério | Operador + limiar |
Ações (ENTÃO)
Cada ação pode incluir um atraso opcional em segundos antes da sua execução.
| Ação | Função | Parâmetros |
|---|---|---|
| Controlo de dispositivo | Define o valor de um dispositivo | Dispositivo + valor pretendido |
| Boost de termóstato | Ativa (ou cancela) o Boost num termóstato | Duração em minutos; 0 cancela um boost ativo e restaura o setpoint e o modo anteriores |
| Cenário | Executa um cenário | Cenário a executar |
| Comando geral | Executa comando de divisão ou categoria | Divisão ou categoria; iluminação ou estores; ligar/desligar, subir/descer |
| Notificação push | Envia uma notificação para smartphones | Texto da mensagem |
| Envia um e-mail aos utilizadores HyperVisu | Destinatários (utilizadores), assunto, mensagem — requer serviço de E-mail (ver “Serviço de E-mail”) |
Eventos astronómicos
Os 13 eventos solares, calculados diariamente a partir das coordenadas do servidor (consulte “Definições de Rede e Hora”). Cada desencadeador astronómico aceita um desvio de ± minutos.
| Evento | Significado |
|---|---|
| dawn | Início do crepúsculo civil matutino (sol −6°) |
| sunrise | O topo do disco solar atinge o horizonte |
| sunriseEnd | O disco solar completo está acima do horizonte |
| goldenHourEnd | Fim da hora dourada matutina |
| solarNoon | O sol no seu ponto mais alto (zénite) |
| goldenHour | Início da hora dourada vespertina |
| sunsetStart | O disco solar toca o horizonte |
| sunset | O disco solar está totalmente abaixo do horizonte |
| dusk | Fim do crepúsculo civil vespertino (sol −6°) |
| nauticalDusk | Crepúsculo náutico vespertino (sol −12°) |
| night | Início da noite astronómica (sol −18°) |
| nightEnd | Fim da noite astronómica |
| nauticalDawn | Crepúsculo náutico matutino (sol −12°) |
Agendamentos de cenários
| Propriedade | Valor |
|---|---|
| Agendamentos por cenário | Até 3 |
| Tipos de agendamento | Semanal (dias selecionados + hora) ou data e hora específicas |
| Controlo individual | Cada agendamento pode ser ativado ou desativado individualmente |