Documentação
Novidades Abrir a app Suporte

Home Assistant

Em resumo

Se já usas o Home Assistant, ele pode ser o teu recolector — e também consegue controlar o teu inversor.

Isto é uma integração personalizada, não um add-on

Procura-a em Settings → Devices & services, e não em Add-ons. Documentação mais antiga e algumas publicações da comunidade chamam-lhe add-on; esse nome está errado e leva-te ao menu errado.

Instalar

  1. No HACS, adiciona https://github.com/svitgrid/home-assistant-svitgrid como repositório personalizado do tipo Integration.
  2. Instala Svitgrid a partir do HACS.
  3. Reinicia o Home Assistant.
  4. Vai a Settings → Devices & services → Add integration e escolhe Svitgrid.
  5. Segue as indicações para o ligar à tua conta Svitgrid.

Não copies ficheiros à mão

Copiar a pasta para custom_components funciona uma vez e depois nunca mais se atualiza sozinha. É a instalação através do HACS que o mantém atual.

Mantê-la atualizada

A integração verifica se há uma nova versão de 12 em 12 horas e instala-a. Nunca reinicia a meio do envio de um comando. Podes desligar isto em Configure → Settings.

Se o Svitgrid mostrar uma faixa de "integração desatualizada", a tua versão está abaixo do mínimo que suportamos — atualiza-a pelo HACS.

O que ela consegue fazer

  • Ler o teu inversor através dos sensores que já tens no Home Assistant, ou falando Modbus diretamente com ele.
  • Controlar o teu inversor: carregamento da bateria, modo de funcionamento, venda de solar, carregamento pela rede, forçar gerador, modo da porta do gerador e limite de exportação.
  • Guardar dados localmente, na sua própria base de dados, mantendo cerca de duas semanas de detalhe e cerca de dois anos de histórico horário.
  • Correr o teu horário localmente, para que os eventos disparem mesmo sem internet.

O controlo funciona, apesar do que diz a documentação antiga

Versões anteriores desta documentação diziam que o Home Assistant era só de leitura. Isso deixou de ser verdade há já algum tempo — são suportados sete comandos de controlo.

Com que inversores funciona

A integração traz mapeamentos prontos para dezenas de modelos — Deye, Victron, Anenji/EASUN, Huawei, Solplanet, Solis e mais, atualizados automaticamente a partir do Svitgrid. Se o teu modelo não estiver coberto, podes mapear as entidades tu mesmo nas opções da integração.

O que ela não consegue fazer

  • Nada de tomadas Zigbee nem carregadores de carros. Isso exige um Svitgrid Gateway.
  • Não lê o BMS da bateria. O Home Assistant não tem um rádio que o Svitgrid comande; usa um Gateway ou o telemóvel.