Portare i suoi dati in PVOutput

Una volta creato un account PVOutput, definito un sistema e richiesta una chiave API, comincia il vero lavoro: come porta automaticamente i dati di produzione del suo impianto su quell'account? Questo articolo ripercorre le opzioni pratiche nel 2026, raggruppate per tipo di impianto, con i vantaggi e gli inconvenienti pratici di ciascuna.

Prima di iniziare, una precisazione importante. PVOutput è progettato per ricevere dati ripetutamente, non per raccogliere dati dall'inverter. È sempre il lato della sua configurazione a spingere verso PVOutput, mai viceversa. È una decisione di progettazione che rende l'intera piattaforma molto più affidabile: PVOutput non deve autenticarsi presso centinaia di migliaia di inverter né mantenere conoscenze specifiche del produttore. Ma significa che da qualche parte nel suo setup deve esserci un componente che dice: "Ecco lo stato attuale del mio impianto, per favore registralo".

Quel componente può essere:

1. L'inverter stesso, se ha supporto PVOutput integrato (raro).
2. Un servizio cloud del produttore, che spinge regolarmente verso PVOutput tramite un ponte integrato.
3. Un ponte che gira sulla sua rete domestica, come Home Assistant, Solar Assistant o IoTaWatt, che raccoglie i dati localmente e li trasmette.
4. Uno script o utility su un server o computer, che interroga il cloud del produttore e spinge esso stesso verso PVOutput.
5. Inserimento manuale, tramite l'interfaccia web, come ultima risorsa.

Quale sia il migliore dipende dalla marca del suo inverter, da quanto si sente tecnico, e da se fa già girare altre cose di domotica. Ripercorriamo gli scenari più comuni.

Opzione 1: push diretto dall'inverter

Alcuni inverter hanno supporto PVOutput nativo. Non è una caratteristica comune, ma è bella quando è presente. Fronius l'ha integrata nel suo vecchio hardware Datamanager 2.0: riempie il suo ID di sistema e la chiave API nell'interfaccia web dell'inverter, e l'apparecchio spinge ogni cinque minuti senza ulteriore intervento. Tutto avviene direttamente dall'inverter verso pvoutput.org, senza intermediario cloud.

I modelli Fronius recenti (Symo GEN24, Primo GEN24) non hanno più quella funzione integrata, ironicamente. La motivazione è che Fronius vuole portare i suoi clienti verso Solar.web. La funzione può essere recuperata tramite una soluzione intermedia come un ponte Home Assistant, ma il tempo del puro "clicca e spingi" è purtroppo passato per i Fronius più recenti.

Altre marche con push PVOutput diretto, per quanto so: vecchi inverter SMA Webconnect, vecchi modelli Enphase Envoy. Per la maggior parte degli inverter moderni nel 2026, non è più un'opzione realistica, e deve ricorrere a una delle altre soluzioni.

Opzione 2: un cloud produttore che spinge a PVOutput

Questa è la soluzione più pulita quando è disponibile. PVOutput mette a disposizione il PVOutput Auto Uploader, un servizio gratuito che raccoglie i dati di alcuni cloud di produttori e li colloca sul suo account PVOutput. Le marche supportate al momento di scrivere questo: SolarEdge, Enphase, GoodWe SEMS, Solis SolisCloud, SMA Sunny Portal, Huawei FusionSolar (parzialmente), e alcune marche più piccole.

L'installazione passa tipicamente così: si collega alla pagina PVOutput Auto Uploader, aggiunge il suo sistema, fornisce le credenziali del cloud produttore (il suo login o token API in SolarEdge per esempio), e lo collega a un sistema PVOutput. Da quel momento, funziona automaticamente. Nessuno script, nessuna gestione di server, nessuna preoccupazione.

Ci sono alcuni punti pratici. SolarEdge limita l'accesso API a 300 chiamate al giorno, il che è ampiamente sufficiente per un solo accoppiamento PVOutput ma può diventare un problema se attinge anche da Home Assistant sulla stessa API. Enphase ha i suoi limiti e particolarità. L'Auto Uploader è un servizio gratuito, ma alcune funzioni avanzate come caricare la temperatura dell'inverter richiedono una donazione PVOutput. La maggior parte degli utenti se la cava bene con il tier gratuito.

Per la maggior parte degli impianti residenziali con un inverter di marca mainstream, l'Auto Uploader è la risposta giusta. Chiede mezz'ora di configurazione, funziona per anni senza manutenzione, e fa esattamente quello che vorrebbe che facesse.

Opzione 3: un ponte sulla sua rete domestica

Qui diventa più interessante per chi vuole qualcosa di più di solo PVOutput. Un ponte locale sulla sua rete estrae dati dal suo inverter (spesso tramite Modbus TCP locale, API locale o altro protocollo), li raccoglie, e li invia a PVOutput. Il grande vantaggio sull'opzione 2 è che i dati sono localmente a casa e non dipende dal cloud del produttore. Se quel cloud cade o il produttore decide domani di tagliare il suo accesso, ha ancora i dati.

Home Assistant è il gigante open-source in questo spazio. Quasi ogni grande marca di inverter ha un'integrazione ufficiale o comunitaria: SolarEdge (Modbus TCP locale, senza bisogno di cloud), Enphase (Envoy locale, aggiornamenti sub-minuto), Fronius (API locale, molto veloce), SMA (Speedwire), Huawei FusionSolar, GoodWe, Growatt, Solis, Victron, e molti altri. Una volta che Home Assistant ha i dati, li invia a PVOutput tramite un add-on comunitario che posta ogni alcuni minuti all'API, o tramite una semplice automazione che gira su pianificazione. È l'opzione che uso personalmente, e il vantaggio è che ha una copia locale di tutti i suoi dati accanto al caricamento PVOutput, più la possibilità di reagire in tempo reale su quei dati (accendere la lavastoviglie, caricare l'auto, far funzionare la pompa di calore). Per chi fa già girare Home Assistant per altre ragioni, integrare il solare è un progetto di un pomeriggio di sabato.

Solar Assistant è un'alternativa commerciale orientata agli impianti solari DIY, soprattutto inverter ibridi di LuxPower, Deye, Growatt, MPP Solar e marche simili. Gira su un Raspberry Pi, costa circa 54 € una volta, e offre una bella dashboard web più un'uscita MQTT per integrazione in Home Assistant. Solar Assistant non ha attualmente un Uploader PVOutput integrato, sebbene sia nella lista dei desideri da anni, quindi la configurazione tipica è Solar Assistant verso MQTT verso Home Assistant verso PVOutput. Più componenti, ma ogni componente è affidabile in sé.

IoTaWatt è un misuratore open-source con pinze amperometriche che installa nel suo quadro elettrico. Misura produzione e consumo simultaneamente e invia i dati a PVOutput. L'hardware costa circa 350 € senza le pinze CT o 450 € con le pinze per una casa trifase. È una soluzione distinta dall'opzione 2 perché IoTaWatt parla direttamente con l'impianto elettrico, non con l'inverter. Vantaggio: ha anche il monitoraggio del consumo in un colpo solo, di cui parliamo in dettaglio in un altro articolo.

Opzione 4: uno script personale

Per chi sia abbastanza tecnico per scrivere Python o un altro linguaggio di script, PVOutput offre un'API HTTP aperta che permette di spingere i dati da soli. L'API è documentata su pvoutput.org/help. Una configurazione tipica: uno script gira ogni cinque minuti su un server (un Raspberry Pi, un VPS, un NAS Synology), tira i dati dal cloud del produttore o da un dispositivo Modbus locale, e posta a addstatus.jsp su pvoutput.org.

Per le marche senza supporto Auto Uploader, è spesso la via più pragmatica. Per il software SBFspot (open source, originariamente per inverter SMA tramite Bluetooth, ora anche per Speedwire), c'è un'integrazione PVOutput che funziona out-of-the-box. Per gli inverter Growatt esistono diversi script comunitari che interrogano l'API cloud Growatt e spingono a PVOutput. Lo stesso per Deye, Sungrow, e altre marche senza supporto Auto Uploader ufficiale.

Quella via chiede manutenzione. Gli script si rompono, le API cloud dei produttori cambiano senza preavviso, i certificati scadono. Chi non abbia voglia di passare alcune ore all'anno su qualcosa che è caduto, sceglie meglio l'opzione 2 o 3. Chi trovi ok scrivere lo script e apprezzi il controllo, può con l'opzione 4 spesso avere una configurazione che funziona senza intervento per anni.

Opzione 5: inserimento manuale

PVOutput permette anche di inserire semplicemente le cifre quotidianamente tramite l'interfaccia web. Molte persone pensano che sia una perdita di tempo, e per la maggior parte delle configurazioni è anche il caso. Ma se ha un impianto molto vecchio senza alcuna lettura intelligente, o un inverter per cui non esiste alcuna integrazione, può semplicemente una volta al giorno o una volta a settimana leggere le cifre sullo schermo dell'inverter e inserirle.

Non c'è vergogna in questo. I dati sono meno dettagliati in questo modo (non ottiene curva di potenza, solo i totali giornalieri), ma è sufficiente per le tendenze a lungo termine, i confronti anno su anno, e lo specific yield. Per alcuni proprietari, in particolare di impianti più vecchi, è semplicemente come fanno da anni, e funziona.

Alcuni errori comuni

Alcune cose che ho visto più volte nelle persone:

Confusione tra "system size" e potenza installata. PVOutput chiede nella configurazione la capacità di picco DC (in W) del suo sistema. È la potenza dei pannelli, non la potenza dell'inverter. Un impianto da 6 kWp con un inverter da 5 kVA si inserisce come dimensione del sistema 6000, non 5000. PVOutput usa questo per i calcoli di Specific Yield spiegati in Reading your solar charts: what the numbers actually mean.

Problemi di fuso orario. PVOutput funziona con UTC o con il fuso dell'account. Se il fuso è impostato male, ottiene curve che hanno un aspetto strano (produzione di notte, ore vuote di giorno). Verifichi l'impostazione sulla sua pagina di account e verifichi che i timestamp che carica sono sulla stessa base.

Errori di rate limit. Se cerca di caricare molti dati storici in un colpo solo, può raggiungere i rate limit. Il tier gratuito ha 60 chiamate all'ora, i donatori 300. Uno script che fa un bulk-upload di un anno intero raggiunge quel tetto in secondi. Estenda i bulk-upload su diverse ore se non ha donato.

Sistemi doppi. Chi sperimenta può accidentalmente lasciare che due client diversi carichino gli stessi dati simultaneamente (per esempio l'Auto Uploader E uno script personale). PVOutput accetta entrambi, e i dati sono semplicemente sovrascritti da chi spinge per ultimo, il che a volte porta a effetti strani dove gli stessi valori sembrano fluttuare. Fermi uno dei due.

Quale opzione per chi?

L'albero decisionale è più breve di quanto l'articolo lasci pensare. Se ha un vecchio Fronius con Datamanager 2.0, usi il push integrato e smetta di leggere. Se ha un SolarEdge o un Enphase, usi l'Auto Uploader. Se fa già girare Home Assistant per altre ragioni, colleghi la sua integrazione di inverter e invii a PVOutput. Se è un appassionato del solare DIY con un inverter ibrido e un Raspberry Pi, guardi verso Solar Assistant o uno script personale. Se ha un inverter che data da prima di internet, inserisca le cifre.

Per la maggior parte degli impianti residenziali italiani, belgi e olandesi nel 2026, l'Auto Uploader o un ponte Home Assistant sarà la via giusta. Entrambi funzionano per anni senza molta attenzione, e entrambi portano i suoi dati in un formato leggibile da qualsiasi app sul suo telefono, tablet o computer. Una volta che questo funziona, effettivamente ha finito. Può allora passare alla parte di cui si tratta davvero: leggere e capire i dati.