Central de DocumentaçãoGuias do cliente e conhecimento CloudPelizzon Versão 0.9.9
CP-ENERGY • GUIA FUNCIONAL

Geração e Consumo de Energia

Documentação funcional completa do módulo CP-ENERGY: instalação, lógica de detecção automática, interpretação dos indicadores e leitura operacional do dashboard.

O que o módulo faz

O CP-ENERGY cria uma camada padronizada entre os sensores reais do Home Assistant e o dashboard CloudPelizzon. Isso permite consolidar geração, consumo, rede elétrica e quadros sem depender diretamente da marca dos equipamentos.

Foco do produto
O cliente final não deve precisar conhecer nomes técnicos de entidades para utilizar o módulo. A configuração padrão deve ser feita pela detecção automática e apenas revisada antes do salvamento.

Arquitetura lógica

  1. O Home Assistant recebe telemetrias de inversores, microinversores, medidores e quadros.
  2. O CP-ENERGY classifica essas entidades por função: geração, consumo, rede e distribuição.
  3. As entidades escolhidas passam a alimentar sensores normalizados do CloudPelizzon.
  4. O dashboard “Malha Energética” consome apenas a camada normalizada.

Fluxo recomendado de implantação

  1. Acesse Energia → Configuração.
  2. Execute Detectar e configurar automaticamente.
  3. Revise o bloco Instalação detectada.
  4. Confirme Nome da instalação, Concessionária e Número de fases.
  5. Salve e ative o módulo.

Princípios de autodetecção

  • Geração: prioriza entidades com alta afinidade com inversor, microinversor, solar e produção.
  • Consumo: prioriza medição total da residência; na ausência dela, usa quadros confiáveis.
  • Rede: procura potência líquida, importação e exportação; se necessário, calcula modo derivado.
  • Energia acumulada: prioriza sensores diários/operacionais, evitando entidades de vida útil para cards do período.
  • Telemetrias auxiliares: CTs, fases, L1/L2 e sinais muito técnicos recebem menor prioridade.

O que você encontra neste manual

SeçãoConteúdo
Visão GeralLeitura operacional do dashboard principal.
GeraçãoFontes solares, participação e desempenho.
ConsumoDemanda da casa, pico e distribuição.
Rede ElétricaImportação, exportação e saldo com a concessionária.
QuadrosSetorização do consumo por quadro.
HistóricoEvolução temporal e comparações.
AnálisesAutoconsumo, autossuficiência e leitura analítica.
ConfiguraçãoGuia completo da configuração assistida.
CP-ENERGY•manual•Atualizado 02-10-2026