Solução de software
Home Assistant no servidor local: uma aplicação para qualquer telemóvel, tablet ou navegador, acessos com direitos limitados e avisos que chegam mesmo com o telemóvel em silêncio.
O que escolhemos da nossa stack, e porquê
Da stack que já funciona no nosso servidor local são necessários poucos elementos. O resto — análise de IA, arquivo cifrado, gravações — fica fora do Home Assistant.
- 1
Home Assistant
O centro único do sistema: recebe os eventos do perímetro, gere os utilizadores e os seus direitos, envia os avisos para os telemóveis. Software livre, funciona em local no nosso servidor.
- 2
MQTT (Mosquitto)
O canal local de mensagens entre os nós de campo (ESP32), a análise de IA e o Home Assistant. Os eventos viajam como breves mensagens de texto, sem imagens.
- 3
NUT (estado da UPS)
Leva para o Home Assistant o estado da fonte de alimentação ininterrupta: um corte de energia ou uma bateria que se descarrega torna-se de imediato um aviso técnico.
- 4
Aplicação Home Assistant Companion
O cliente oficial para Android e para iPhone/iPad: com ela chegam os avisos e abre-se o painel aprovado.
- 5
WireGuard
O canal protegido já previsto pelo projeto para a ligação: onde é necessário, permite usar a aplicação também fora do edifício, sem subscrições na nuvem.
Esquema: do servidor aos clientes, às funções e aos direitos
Ponto de campo
Câmara ou módulos Wi-Fi CSI, com sinalização
Servidor local
Análise de IA, cifragem, arquivo, UPS e backup dos dados
Home Assistant
Eventos, utilizadores, direitos, avisos
Clientes
Uma aplicação ou o navegador
- Android
- iPhone / iPad
- Navegador (computador)
- Tablet
Funções e direitos
Cada um vê apenas o que está aprovado
- Administrador técnico
- Pessoa designada
- Residente
O Home Assistant recebe apenas o evento (texto, hora, troço da vedação): nenhuma foto nem vídeo. O que não está no Home Assistant não se vê na aplicação.
Um cliente para qualquer dispositivo
O cliente é a aplicação oficial Home Assistant Companion ou simplesmente o navegador: escolha o que tem.
Android
Aplicação Home Assistant Companion da loja de aplicações: avisos, painel aprovado, ações rápidas.
iPhone e iPad
Aplicação Home Assistant Companion para iOS e iPadOS: avisos, também críticos, e painel aprovado.
Navegador no computador
Basta abrir o endereço do Home Assistant: sem instalação.
Tablet
Aplicação ou navegador; com um utilizador dedicado pode ficar na parede como painel fixo, por exemplo na entrada.
Acesso com direitos limitados
Cada um entra com o seu próprio nome de utilizador e palavra-passe (com verificação em dois passos, se ativada) e vê apenas o que foi aprovado para a sua função. As funções abaixo são uma proposta a discutir.
- Administrador do Home Assistant
Administrador técnico
Configura o sistema, os utilizadores e as automações. Poucas contas, com verificação em dois passos; pode permitir-se o acesso apenas a partir da rede local.
- Utilizador sem direitos de administrador
Pessoa designada
Recebe os alarmes com botões de ação para confirmar o evento. Para as imagens do arquivo aplica-se o procedimento reservado às pessoas designadas, com registo de acessos.
- Utilizador sem direitos de administrador
Residente
Recebe os avisos (apenas texto) e vê um painel aprovado com o estado do sistema. Sem acesso à câmara, ao arquivo nem às definições.
| Quem pode fazer o quê | Administrador técnico | Pessoa designada | Residente |
|---|---|---|---|
| Receber os avisos de alarme | |||
| Ver o estado do sistema (painel aprovado) | |||
| Confirmar o evento com os botões de ação | |||
| Ver as imagens do arquivo (apenas pessoas designadas, com registo) | |||
| Gerir a lista de destinatários e as definições dos avisos | |||
| Alterar definições, utilizadores e automações |
Como se obtém a limitação
- Os utilizadores sem direitos de administrador não acedem às Definições e não podem gerir utilizadores, dispositivos, automações nem painéis.
- Cada painel pode ser reservado aos administradores; aos residentes atribui-se um painel separado e aprovado.
- Para cada utilizador pode permitir-se o acesso apenas a partir da rede local e ativar a verificação em dois passos.
- Cada dispositivo pode ser desligado eliminando o seu token de acesso do perfil; a conta de um utilizador pode ser desativada.
- O limite mais forte é de conceção: o Home Assistant não oferece permissões por entidade na interface, pelo que só entra a informação aprovada (evento de alarme, estado do sistema, estado da UPS). Imagens e arquivo ficam de fora.
Avisos que chegam mesmo com o telemóvel em silêncio
Em caso de violação perigosa do perímetro o aviso é enviado como crítico: com a configuração descrita abaixo toca mesmo com o telemóvel em silêncio e com «Não incomodar» ativo, ou seja, também quando todas as chamadas recebidas estão bloqueadas (por exemplo, de noite).
Atenção! Foi detetada uma pessoa no troço de vedação controlado.
Atenção! Foi detetada uma pessoa no troço de vedação controlado.
Exemplo de configuração (da documentação oficial do Home Assistant Companion)
iPhone e iPad: aviso crítico
- Os avisos críticos (Critical Alerts) do iOS aparecem no topo do ecrã de bloqueio acima de todas as outras notificações e tocam mesmo com «Não incomodar» ativo ou com o iPhone em silêncio.
- Além disso, podem ultrapassar os limites de frequência das notificações da aplicação.
1× Uma só vez: nas definições do iOS da aplicação Home Assistant permitir as notificações, incluindo os avisos críticos.
data:
push:
sound:
name: "default"
critical: 1
volume: 1.0Android: prioridade alta e canal de alarme
- Com prioridade alta e duração 0 a notificação chega de imediato, mesmo que o telemóvel esteja parado ou tenha o ecrã apagado há muito tempo.
- Usando o fluxo de áudio «despertador» (alarm stream) o telemóvel toca mesmo em modo silencioso ou vibração.
1× Uma só vez: nas definições do sistema da aplicação abrir o canal de alarme e permitir que ignore «Não incomodar» (por predefinição não o ignora).
data:
ttl: 0
priority: high
channel: alarm_streamO que é preciso ter presente
- O aviso foi concebido para chegar mesmo com o telemóvel em silêncio, mas não se pode prometer uma entrega absoluta: o telemóvel tem de estar ligado e contactável (rede de dados ou Wi-Fi) e a configuração única tem de ser feita em cada telemóvel.
- A mensagem é apenas texto, sem fotografias nem vídeos nem dados pessoais.
- Por norma, o envio para o telemóvel passa pela infraestrutura de notificações push da Apple ou da Google, como em qualquer aplicação. Na rede local do edifício está também disponível a entrega local (Local Push) através de WebSocket, sem passar pela Apple nem pela Google.
- Recomendamos um aviso periódico de verificação, para perceber a tempo se um telemóvel deixou de receber os avisos.
Não só o perímetro: outros avisos importantes
O mesmo canal pode transportar também outras mensagens importantes, com diferentes níveis de urgência. A escolha de toque e prioridade faz-se para cada nível.
- Crítico
Violação perigosa do perímetro: toca sempre, mesmo com o telemóvel em silêncio.
- Urgente (técnico)
Corte de energia ou bateria da UPS a descarregar, perda da ligação ao ponto de campo, servidor inacessível.
- Informativo
Temperatura ou humidade anómalas ou fuga de água na caixa, outras mensagens acordadas com o condomínio. Podem permanecer silenciosos.
No iOS o nível «crítico» ultrapassa até o silêncio, o «time-sensitive» (urgente) ultrapassa os modos de concentração, o «passivo» nem sequer acende o ecrã.
Tudo local, cifrado, sem nuvem
A análise, o arquivo e os acessos permanecem no servidor local, de forma cifrada e sem serviços na nuvem. Em caso de alarme o acesso ao arquivo fecha-se de imediato e as gravações do evento ficam protegidas contra alteração e eliminação, como descrito no projeto.
Perguntas ou observações?
Escreva-nos: responderemos com gosto. Pode também usar o formulário do projeto.
Ir para o formulário do projeto
Documento de projeto a discutir com os residentes e com a administração do condomínio: a realização só é possível após as aprovações necessárias.