Ramaya Software

Plenitude Solar Panels · Home Assistant

La tua energia.
Una casa più
connessa.

La produzione dei tuoi pannelli Plenitude, direttamente in Home Assistant. Segui ogni pannello, porta i dati nella dashboard Energia e ritrova tutto in un unico posto.

Gratuito e open source Nessun abbonamento all’integrazione

01Un dispositivo
per ogni pannello
05Minuti tra le letture
intervallo consigliato
Dashboard Energia
i tuoi dati, insieme

Meno portali, più chiarezza

Il sole lavora.
Tu tieni tutto sotto controllo.

Un’integrazione pensata per portare i dati del portale nella tua casa connessa. Senza cambiare le tue abitudini.

01 / MONITORAGGIO

Un posto per ogni pannello

Potenza media, energia dell’intervallo di cinque minuti e produzione cumulativa. Anche l’irraggiamento, quando fornito dal servizio.

Scopri i sensori
02 / ENERGIA

Dentro la tua dashboard

Aggiungi il sensore Total Production alla dashboard Energia di Home Assistant e consulta la produzione insieme agli altri dati di casa.

Collega la dashboard
03 / CONTROLLO

Più controllo sui picchi

Un interruttore e una soglia di potenza per ogni pannello permettono di limitare le letture anomale prima che aggiornino i sensori.

Come funziona il limite
04 / CONTINUITÀ

Recupera i dati mancanti

Con il POD configurato, confronta i dati locali con gli aggregati del servizio. Recupero manuale, riparazione e annullamento con anteprima e conferma.

Requisiti e limiti del recupero

Il recupero può usare una ripartizione stimata per pannello: non equivale sempre a una misura effettiva della produzione.

Si parte da qui

Dal portale
alla tua casa connessa.

Ti servono Home Assistant, un account Plenitude con pannelli visibili nel portale e una sessione browser autenticata.

  1. 01

    Installa con HACS

    Aggiungi il repository personalizzato come Integrazione, cerca Plenitude Solar Panels, scaricalo e riavvia Home Assistant.

  2. 02

    Apri il portale

    Accedi a My Eni dal browser. Nella sezione pannelli, ricava Cookie, User-Agent, account ID e supply ID dalla stessa richiesta API riuscita.

  3. 03

    Collega i tuoi pannelli

    Vai in Impostazioni → Dispositivi e servizi → Aggiungi integrazione. Cerca Plenitude Solar Panels e inserisci i dati richiesti.

La prima connessione passa dal browser.

Il portale può richiedere CAPTCHA o OTP. Non è un accesso automatico con email e password: quando la sessione scade, devi effettuare un nuovo login e aggiornare insieme Cookie e User-Agent. Non condividerli mai nelle segnalazioni.

Preferisci l’installazione manuale?

Scarica il codice dalla release desiderata e copia solo custom_components/plenitude_panels/ nella cartella custom_components/ della configurazione di Home Assistant. Riavvia e aggiungi l’integrazione da Dispositivi e servizi.

Il percorso finale deve essere <config>/custom_components/plenitude_panels/manifest.json. Non servono Node.js, npm o modifiche a configuration.yaml.

Il quadro completo

La tua produzione,
insieme al resto.

Apri Impostazioni → Dashboard → Energia e aggiungi il sensore Total Production di ciascun pannello come sorgente di produzione solare.

Il totale parte dalla prima lettura utile: non è il contatore storico del portale. Mantieni le letture ogni cinque minuti e lascia che Recorder registri i sensori per generare le statistiche.

Leggi i dettagli sui dati

Prima di iniziare

Buono a sapersi.

Uno strumento indipendente, con requisiti e limiti chiari.

È un’integrazione ufficiale Plenitude?

No. È un progetto indipendente e open source, distribuito con licenza MIT, non affiliato a Eni o Plenitude. Il monitoraggio dipende dal cloud Plenitude: disponibilità, accesso e frequenza dei dati dipendono dal portale e dalle sue API.

Quali versioni di Home Assistant sono verificate?

I test coprono Home Assistant 2025.10.4 con Python 3.13 e Home Assistant 2026.9.4 con Python 3.14, non tutte le altre versioni. È richiesto Babel 2.18.0 o successivo; in caso di conflitto con altre integrazioni, aggiorna Home Assistant. Le icone locali sono supportate da Home Assistant 2026.3.

È già nel catalogo predefinito di HACS?

Per l’installazione segui la procedura del repository personalizzato: inserisci https://github.com/hierro1981/EniPlenitudeSolarPanels in HACS e scegli il tipo Integrazione. Il pulsante “Apri in HACS” è una scorciatoia verso la tua istanza, dove HACS deve essere già configurato. I nomi dei menu possono variare.

Il recupero ricostruisce tutta la produzione?

Non necessariamente. Richiede un POD configurato e, per le funzioni storiche, Recorder attivo. Il servizio fornisce dati aggregati: la ripartizione per pannello può essere stimata e non sempre distingue un guasto dalla telemetria assente. Leggi la guida al recupero prima di intervenire sulle statistiche.

Dove vengono salvati i dati di accesso?

La configurazione e i cookie vengono salvati da Home Assistant in .storage, senza cifratura applicativa. Non inserirli nelle issue, negli screenshot o nei log condivisi. Questo sito è solo una pagina informativa e non richiede credenziali.

La sessione resta valida per sempre?

No. L’integrazione mantiene la sessione all’avvio e ogni cinque minuti, ma il portale può comunque invalidarla. Quando viene richiesta la riautenticazione, accedi di nuovo dal browser e aggiorna Cookie e User-Agent insieme.

Pronto a collegare il sole?

Fai spazio alla tua energia.

Codice aperto. Documentazione a portata di mano. I tuoi pannelli, nella tua dashboard.