Le integrazioni per lo STREAM
Per gli STREAM esistono quattro integrazioni della community, tutte da installare con HACS. EcoFlow non ne pubblica una propria e fra le integrazioni di base di Home Assistant il marchio manca. Le quattro si distinguono per la strada dei dati. Tre passano dal cloud di EcoFlow, una parla con il box via Bluetooth.
| Integrazione | Collegamento | Modelli STREAM | Installazione | Versione a ottobre 2026 |
|---|---|---|---|---|
| EcoFlow Cloud (tolwi) | cloud, con chiavi API o accesso dell’app | AC, Pro, Ultra, Ultra X, Microinverter | HACS, repository personalizzato | 1.7.2 dell’8 ottobre |
| EcoFlow Energy (shuette42) | cloud, con chiavi API (Standard) o accesso dell’app (Enhanced) | AC, AC Pro, Max, Ultra, Ultra X, Microinverter, STREAM 5000 e AC 5000 | HACS, store predefinito | 1.25.0 del 16 ottobre |
| EcoFlow BLE (rabits) | Bluetooth, in rete locale | AC, AC Pro, Max, Pro, Ultra, Ultra X, Microinverter | HACS, store predefinito | 1.3.0 del 20 ottobre |
| EcoFlow API (TarasKhust) | cloud, chiavi API più MQTT | Ultra e Ultra X, gli altri STREAM in elenco | HACS, repository personalizzato | 1.10.26 del 10 ottobre |
EcoFlow Cloud è la più diffusa, con oltre 900 stelle su GitHub. EcoFlow Energy è oggi l’unica che legge anche i due modelli da 5 kWh. EcoFlow API ha una licenza che consente solo l’uso personale e non commerciale, un dettaglio che conta per chi installa Home Assistant per altri.

Le chiavi dell’API EcoFlow
L’accesso ufficiale ai dati passa dalla piattaforma per sviluppatori di EcoFlow, con un portale per l’Europa (developer-eu.ecoflow.com) e uno globale. Le chiavi sono gratuite.
- Registrati sul portale con l’account EcoFlow a cui è associato lo STREAM e chiedi l’accesso come sviluppatore.
- Aspetta l’approvazione. Secondo gli utenti dei forum servono da qualche giorno a circa una settimana.
- Copia le due chiavi dalla console, la access key e la secret key.
- Installa l’integrazione da HACS, riavvia Home Assistant e aggiungila da Impostazioni, Dispositivi e servizi. Inserisci le chiavi e, dove richiesto, il numero di serie dello STREAM, che si legge nell’app.
Con un account europeo conta anche il server. EcoFlow separa gli account per regione, e in EcoFlow Cloud il campo api_host va portato su api-e.ecoflow.com. Con il server globale l’accesso fallisce con il messaggio «Account doesn’t exist or incorrect password».
In alternativa le stesse integrazioni accettano email e password dell’app. EcoFlow Cloud la chiama modalità private_api, EcoFlow Energy Enhanced Mode. Le chiavi non servono, i valori arrivano più spesso e coprono più modelli. Si tratta però di un canale non documentato, ricostruito osservando il traffico dell’app, che un aggiornamento di EcoFlow può interrompere da un giorno all’altro.
Cosa si legge e cosa si comanda
Le letture sono ricche con tutte le integrazioni. Per lo STREAM Ultra, EcoFlow Cloud in modalità API crea 55 sensori: livello e stato di salute della batteria, energia caricata e scaricata, potenza di ciascuno dei quattro ingressi fotovoltaici con tensione e corrente, potenza verso la rete, consumo della casa diviso per fonte e temperatura delle celle. EcoFlow Energy aggiunge per i modelli con prese la potenza di ogni presa e la tensione di rete.
I comandi sono un’altra storia. La documentazione per sviluppatori di EcoFlow prevede per lo STREAM Ultra solo la riserva di backup, l’interruttore dell’immissione in rete e le due prese AC. Un valore in watt per la potenza verso casa manca. A marzo 2026 un utente ha chiesto a EcoFlow Cloud il cursore del carico di base che l’app offre, e i collaboratori del progetto hanno verificato nella documentazione che l’API non lo prevede. La richiesta è ancora aperta.
| Comando | API ufficiale (EcoFlow Cloud) | Accesso app (EcoFlow Energy) | Bluetooth (EcoFlow BLE) |
|---|---|---|---|
| Riserva di backup | sì | sì, 3–95 % | sì |
| Immissione in rete sì/no | sì | non prevista | sì |
| Limite di immissione in watt | no | no | sì |
| Carico di base in watt | no | no | sì, con una sola fascia oraria nell’app |
| Limiti di carica e scarica | solo lettura | solo STREAM AC Pro | sì |
| Prese del box | AC1 e AC2 | solo STREAM AC Pro | sì, secondo il modello |
| Modalità di funzionamento | autoconsumo o AI | non prevista | strategia energetica |
| Strada dei dati | cloud, chiavi API | cloud, accesso app, circa 3 s | Bluetooth, senza internet |
Con l’accesso dell’app la situazione cambia da integrazione a integrazione. EcoFlow Cloud in modalità private_api legge 42 sensori per gli STREAM e nessun comando. EcoFlow Energy in Enhanced Mode scrive la riserva di backup su tutti gli STREAM che riconosce e sullo STREAM AC Pro anche i limiti di carica e scarica, la luminosità del LED e le due prese. Con le chiavi API (Standard Mode) la stessa integrazione legge ogni 30 secondi circa e non scrive.
Senza cloud: EcoFlow BLE via Bluetooth
EcoFlow BLE si collega allo STREAM con il Bluetooth del server Home Assistant e funziona senza internet. Il progetto nasce per tenere sotto controllo le batterie anche quando il cloud di EcoFlow non risponde, ed è l’unica integrazione che arriva ai comandi in watt.
Per lo STREAM mette a disposizione:
- interruttore e limite dell’immissione in rete, in watt;
- carico di base in watt, se nell’app è impostata una sola fascia oraria di carico di base;
- riserva di backup e limiti di carica e scarica;
- limite di prelievo dalla rete e strategia energetica;
- le prese del box, AC1 su Max, Pro, Ultra e AC Pro, AC2 su Pro, Ultra e AC Pro;
- le potenze dei singoli ingressi fotovoltaici, della batteria e della rete.
Prima della configurazione lo STREAM deve essere associato all’account nell’app. Durante l’installazione l’integrazione chiede un accesso per leggere l’ID utente e poi lavora da sola. Il box accetta una sola connessione Bluetooth alla volta, quindi per aprire l’app bisogna disattivare l’integrazione e riattivarla dopo. Il server deve anche essere a portata di Bluetooth dal balcone. Se è lontano, Home Assistant può usare un proxy Bluetooth ESPHome sistemato vicino alla finestra.
Due avvertenze vengono dagli stessi autori. Il protocollo è ricostruito dalla community e un aggiornamento del firmware può renderlo incompatibile, per cui consigliano di non aggiornare un box che funziona finché l’integrazione non ha recepito la nuova versione. E a metà settembre 2026 EcoFlow li ha contattati chiedendo di fermare il progetto, perché considera rischioso l’uso del suo protocollo Bluetooth. Gli autori hanno accettato di non aggiungere nuovi apparecchi dopo la versione 1.3.0 del 20 ottobre. Gli STREAM già supportati restano nell’elenco.
Esiste un’API locale per lo STREAM?
Per gli STREAM da 1,92 kWh oggi no. Il box comunica con il cloud e con lo smartphone, e l’unico accesso diretto è il Bluetooth descritto sopra. Secondo gli sviluppatori di EcoFlow BLE, EcoFlow ha dichiarato di lavorare a un’API locale sicura per i propri apparecchi, senza indicare modelli né date.
La serie da 5 kWh è un passo avanti. Per STREAM 5000 e STREAM AC 5000 EcoFlow descrive una modalità locale. Con uno smart meter compatibile l’app comunica con l’apparecchio dentro la rete di casa e i dati restano sul posto. Questa modalità serve all’app, e nessuna delle integrazioni la usa per Home Assistant.
Il confronto con Anker mostra la direzione possibile. Per i Solarbank più recenti Anker pubblica un’integrazione propria che lavora in rete locale via Modbus TCP, come spiegato nella guida ad Anker SOLIX e Home Assistant.
STREAM 5000 e AC 5000 in Home Assistant
I modelli da 5 kWh trasmettono dati in un formato diverso dagli altri STREAM, e per Home Assistant li legge oggi solo EcoFlow Energy. Funziona in Enhanced Mode, con email e password dell’account, perché con le chiavi dell’API per sviluppatori i due modelli non risultano raggiungibili. L’aggiornamento arriva ogni 2 secondi circa.
Ogni apparecchio porta 64 sensori, due sensori binari, due interruttori, sette valori impostabili e una selezione. Fra questi ci sono i valori di potenza per carica e scarica, che l’integrazione scrive nella batteria come operazioni programmate, nello stesso modo dell’app. Il README del progetto racconta che i comandi per lo STREAM 5000 sono stati attivati solo dopo che un proprietario ha registrato il suo apparecchio mentre accettava una modifica dall’app. Il supporto si allarga così, una registrazione alla volta.
Le automazioni che servono con un kit da balcone
Lo STREAM regola già da solo l’immissione sul consumo della casa, se nell’app è abbinato un contatore. Per lo STREAM AC Pro il manuale elenca lo smart meter EcoFlow, lo Shelly 3EM, lo Shelly Pro 3EM anche nella versione EcoFlow e il Tibber Pulse IR. Home Assistant serve quindi per il resto:
- pannello Energia, con produzione, carica e scarica della batteria accanto ai consumi degli altri apparecchi;
- riserva di backup variabile, alzata prima di un temporale annunciato o di notte, sui modelli che alimentano in isola le prese del box;
- prese del box accese e spente da un’automazione, per esempio per una pompa o una luce del giardino;
- fasce orarie, per concentrare la scarica della batteria nelle ore F2 e F3 di una tariffa a fasce.
Con un kit da balcone il surplus immesso in rete di norma non viene pagato, quindi ogni kWh trattenuto vale. Chi vuole costruire in Home Assistant una regolazione propria dell’immissione, al posto di quella del box, ha bisogno di un comando in watt. Oggi lo offre solo EcoFlow BLE. Le strade per limitare l’immissione con o senza batteria sono raccolte nella guida al fotovoltaico plug and play senza immissione in rete.
Fuori da Home Assistant esiste anche evcc, il programma per la ricarica dell’auto con il fotovoltaico. Legge lo STREAM con le chiavi API come contatore, produzione o batteria e lo comanda attraverso la riserva di backup, che evcc alza durante la ricarica forzata dalla rete.
Quale integrazione usare
- Vuoi solo i dati, nel modo più stabile: EcoFlow Cloud o EcoFlow Energy con le chiavi dell’API ufficiale. I valori arrivano ogni 30 secondi circa e il canale è quello che EcoFlow supporta.
- Vuoi valori veloci e qualche comando: EcoFlow Energy in Enhanced Mode, con aggiornamento ogni 3 secondi e la riserva di backup impostabile. È anche la sola strada per STREAM 5000 e AC 5000.
- Vuoi regolare l’immissione in watt o restare senza cloud: EcoFlow BLE, con il server a portata di Bluetooth e senza l’app aperta in parallelo.
- Hai più STREAM e uno smart meter: lascia la regolazione al box e usa Home Assistant per il monitoraggio, così app e integrazione non si contendono gli stessi parametri.
Prima di scegliere un modello STREAM con Home Assistant in mente conviene controllare queste liste, perché decidono quanto controllo resta in casa. Le differenze hardware fra Ultra, Pro e Max, dalle porte per i moduli alla presa d’emergenza, sono nella recensione dello STREAM Ultra.
Domande frequenti
Esiste un'integrazione ufficiale EcoFlow per Home Assistant?
No. A ottobre 2026 EcoFlow non pubblica un'integrazione propria, e fra quelle di base di Home Assistant EcoFlow manca. Il produttore offre però un'API per sviluppatori con chiavi gratuite, su cui si appoggiano integrazioni della community come EcoFlow Cloud ed EcoFlow Energy. Altre leggono lo STREAM con l'accesso dell'app oppure via Bluetooth.
Quali modelli STREAM si possono collegare a Home Assistant?
Tutti, con integrazioni diverse. EcoFlow Cloud legge STREAM AC, Pro, Ultra, Ultra X e il Microinverter. EcoFlow Energy copre AC, AC Pro, Max, Ultra, Ultra X, il Microinverter e i due STREAM 5000. EcoFlow BLE, via Bluetooth, gestisce AC, AC Pro, Max, Pro, Ultra, Ultra X e il Microinverter, mentre la serie 5000 resta fuori.
Si può regolare la potenza immessa dallo STREAM con Home Assistant?
Con l'API ufficiale solo in parte. Per lo STREAM Ultra la documentazione per sviluppatori prevede la riserva di backup, l'interruttore dell'immissione in rete e le prese AC1 e AC2, senza un valore in watt per la potenza verso casa. Il limite di immissione e il carico di base in watt si impostano con EcoFlow BLE, che parla con il box via Bluetooth.
Come si ottengono le chiavi dell'API EcoFlow?
Ci si registra sulla piattaforma per sviluppatori di EcoFlow, che ha un portale europeo, e si chiede l'accesso. Dopo l'approvazione la console mostra una access key e una secret key gratuite, da inserire nell'integrazione. Secondo gli utenti l'attesa va da qualche giorno a circa una settimana.
Lo STREAM funziona con Home Assistant senza internet?
Solo via Bluetooth. EcoFlow BLE comunica con il box senza cloud, dopo un unico accesso in fase di configurazione per leggere l'ID utente. Il box accetta però una sola connessione Bluetooth alla volta, quindi per usare l'app bisogna sospendere l'integrazione. Tutte le altre integrazioni passano dal cloud di EcoFlow.
Lo STREAM 5000 si collega a Home Assistant?
Sì, con EcoFlow Energy in Enhanced Mode, che usa email e password dell'account EcoFlow e aggiorna i valori ogni 2 secondi circa, con due interruttori, sette valori impostabili e una selezione. Con le chiavi dell'API per sviluppatori i due STREAM 5000 non sono supportati, ed EcoFlow BLE non li elenca. La modalità locale descritta da EcoFlow per la serie 5000 riguarda l'app e richiede uno smart meter.
Serve Home Assistant per non regalare energia alla rete?
No. Lo STREAM regola da solo l'immissione sul consumo della casa se nell'app è abbinato un contatore compatibile, come lo smart meter EcoFlow o uno Shelly 3EM. Home Assistant aggiunge la vista d'insieme con gli altri apparecchi e le automazioni che l'app non prevede, per esempio una riserva di backup più alta prima di un temporale.