Come collegare sonnenBatterie a Reduxi Controller
Collegare la sonnenBatterie al Reduxi Controller e lasciare che le strategie Reduxi la carichino e la scarichino ai prezzi migliori. Questa guida riguarda il collegamento tramite JSON API e indica quando si applica la guida REST API per Gen. 8 o superiore.
Descrizione testuale di questa immagine
Foto di una sonnenBatterie, immagine del produttore. Parete di cemento grigio scuro in una stanza poco illuminata. Sulla parete a sinistra è appeso un modulo rettangolare grigio con la parte anteriore nervata o forata, che secondo la didascalia è l'inverter ibrido. Accanto, a destra, c'è un armadio alto grigio chiaro con un anello luminoso azzurro, rotondo, vicino alla parte superiore. Sui dispositivi non c'è testo leggibile.
1 Documentazione tecnica
Pagine del produttore per sonnenBatterie:
- sonnenBatterie 10 – Pagina del prodotto del produttore
- Manuali d'uso di Sonnen – Manuali d'uso del produttore
Video tutorial:
2 Attrezzatura necessaria
Preparare quanto segue:
- Reduxi Controller (installato e online)
- sonnenBatterie con la JSON API in Software Integration
- Indirizzo IP locale di sonnenBatterie
- Computer nella stessa rete locale di sonnenBatterie
- Laptop o tablet con accesso a internet per configurare il dispositivo in Reduxi
3 Accesso locale a sonnenBatterie
Collegare la sonnenBatterie alla rete locale tramite LAN. Il Reduxi Controller deve trovarsi nella stessa rete.
sonnenBatterie riceve il proprio indirizzo IP da:
- il router,
- uno switch di rete,
- oppure un server DHCP locale.
Per trovare l'indirizzo IP o il nome DNS di sonnenBatterie, usare find-my.sonnen-batterie.com e seguire le istruzioni di Sonnen.
Aprire un browser web e inserire l'indirizzo IP locale di sonnenBatterie per aprirne l'interfaccia web. Esempio: http://<IP>
4 Configurazione del dispositivo su sonnenBatterie
Accedere all'interfaccia web della sonnenBatterie (vedere punto 3). Servono il token API e l'indirizzo IP per il Reduxi Controller (vedere punto 6).
4.1 Aprire Software Integration
Descrizione testuale di questa immagine
Schermata dell'interfaccia web della sonnenBatterie in un browser, pagina Software-Integration, scheda JSON API. La barra degli indirizzi mostra un indirizzo IP locale seguito dal percorso dash/software-integration/json-api; l'indirizzo IP è contrassegnato da un riquadro rosso e da una freccia con l'etichetta SonnenBatterie IP. Menu a sinistra: Dashboard, System, Inverter, Settings, Network e Software-Integration (evidenziato). Schede: JSON API (attiva), Webhook API e sonnenKNX Module. Due interruttori sono attivi: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) e Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Sotto di essi il campo API Token con un valore del token, contrassegnato da un riquadro rosso e dall'etichetta API Token, e un pulsante Create New. Una riga di esempio ripete il token e l'indirizzo IP con gli stessi contrassegni. In fondo: link sonnenBatterie JSON API v2 documentation.
4.2 Attivare Read API e Write API
Attivare Read API e Write API. Servono entrambe: Reduxi legge le misurazioni con la Read API e invia i comandi di carica e scarica con la Write API.
Descrizione testuale di questa immagine
Schermata ritagliata della scheda JSON API con le schede JSON API, Webhook API e sonnenKNX Module. L'interruttore Read API è attivo. Sotto di esso un avviso azzurro riporta This functionality is disabled while VPP is active, seguito da un interruttore Write API in grigio nella posizione disattivata con il testo Send requests to charge/discharge the sonnenBatterie and set configuration values. Un rettangolo blu evidenzia l'avviso e l'interruttore Write API.
4.3 Impostare la modalità operativa
Aprire il menu Settings sul lato sinistro e impostare la modalità operativa su Manual. Solo così il Reduxi Controller può assumere il controllo della batteria.
Descrizione testuale di questa immagine
Schermata della pagina Settings della sonnenBatterie (software 1.15.6). Menu a sinistra: Dashboard, System, Inverter, Settings (evidenziato), Network e Software-Integration. La scheda Operating Mode contiene un menu a discesa che mostra Manual; l'elenco aperto sotto offre Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) e Time-Of-Use. Sotto la scheda è visibile un interruttore con l'etichetta Surplus fullcharge.
5 Accedere all'interfaccia web di Reduxi
L'interfaccia web di Reduxi si può aprire in due modi:
Descrizione testuale di questa immagine
Screenshot di tre schermate dell'app mobile Reduxi affiancate, con riquadri ciano e badge numerici da 2 a 4. Schermata a sinistra (dashboard, tema scuro): icona del menu in alto a sinistra evidenziata da un riquadro e dal badge 2; logo 'reduxi'; schede 'Real time data' (attiva) e 'Statistics'; prezzo 5.79 € e temperatura 3.2 °C; diagramma del flusso di energia con una casa al centro (-1.25 kW) e icone con valori 69.0 W, 1.3 kW, 1.1 kW (anello rosso), -165.0 W con 97 % (anello rosso) e valori 0.0 W in basso; schede 'Power' e 'Energy'; navigazione in basso: Dashboard, Diagnostics, Device control, Settings. Schermata centrale (menu laterale): logo 'reduxi', 'Number of locations: 1233', titolo 'Reduxi device management', voci '+ Add Reduxi location' e 'Reduxi devices' (evidenziata da un riquadro e dal badge 3), poi 'My profile' e 'About app'. Schermata a destra (pagina del dispositivo): Back; immagine di un Reduxi controller nero con due porte Ethernet; stato 'Connected'; scheda 'Update available': 'New update is available for your Reduxi device.' con pulsante 'Download and install update'; scheda 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' con pulsante 'Activate tunnel connection' (evidenziato da un riquadro e dal badge 4); scheda 'Unit details' con campo 'Unit ID'.
Descrizione testuale di questa immagine
Screenshot composto da due parti affiancate. Parte sinistra: schermata dell'app mobile Reduxi su sfondo scuro. In alto: pulsante Back; immagine di un Reduxi controller nero con due porte Ethernet e una morsettiera; stato 'Connected' con un'icona Wi-Fi. Scheda 'Update available': 'New update is available for your Reduxi device.' con pulsante 'Download and install update'. Scheda 'Connect to configurator' con un'icona di chiave: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' e pulsante 'Open configurator', evidenziato da un riquadro ciano e dal badge numerico 5. Sotto: scheda 'Unit details' con un campo 'Unit ID' (valore non visibile). Parte destra: Reduxi Configurator aperto in un browser, evidenziato da una cornice ciano e dal badge numerico 6. Intestazione: freccia indietro, 'Tunnel connection', icona di ricarica. Barra laterale sinistra con icone (fulmine, chip, fulmine, grafico a barre, ingranaggio). Pagina 'Home' con un'icona di collegamento verde. Avviso verde: 'New patch available. Click here to apply.' con una X di chiusura. Ora 09:12:56. Diagramma del flusso di energia con una casa al centro (1.700 kW) e icone per rete (0.000 kW), solare (1.700 kW), batteria (verde, 0.000 kW e 0.800 kW), un dispositivo a sinistra (0.900 kW), veicolo elettrico e un caricatore o dispositivo in basso. Etichetta 'Energy manager' in basso.
http://reduxi.local. L'indirizzo IP del controller si trova nell'elenco dei dispositivi del router o nell'app Reduxi in Reduxi devices.admin · Password: admin (impostazione di fabbrica)Descrizione testuale di questa immagine
Screenshot della pagina di accesso del Reduxi Configurator in una finestra del browser Chrome. La barra degli indirizzi mostra 'Not secure' e 'reduxi.local'; la barra degli indirizzi è evidenziata da un riquadro ciano e una sua copia ingrandita (riquadro ciano, testo 'Not secure reduxi.local') è mostrata a sinistra, collegata da una linea ciano. Sfondo della pagina: disegno a linee grigio chiaro di una casa con pannelli solari (verdi), una wallbox, un inverter, un'auto e un caricatore. In alto a sinistra: logo 'reduxi configurator'. Al centro un riquadro di accesso con il titolo 'Login', un selettore della lingua (bandiera inglese, 'English'), un campo per il nome utente e un campo password, e un pulsante scuro 'Login'.
Descrizione testuale di questa immagine
Screenshot dell'interfaccia web del Reduxi Configurator dopo l'accesso, tema chiaro. In alto a sinistra: logo 'reduxi configurator'. Barra di intestazione: 'Home' a sinistra, stato verde 'Connected' in alto a destra. Barra laterale sinistra: sezione espansa 'Devices' con un elenco di voci, poi sezioni compresse 'Manager', 'Configuration' e 'Settings'. Area principale: diagramma del flusso di energia. Casa al centro con un anello, valore 24.20 kW. Icona della rete in alto a sinistra, 24.20 kW (punto rosso sulla linea). Icona del solare in alto a destra, valore '-'. Icona a sinistra (batteria o dispositivo), 6.700 kW (punto verde sulla linea). Icone a destra (accumulo a batteria e un dispositivo), valori '-'. Icona dell'EV charger in basso a sinistra, 31.00 kW. Un'altra icona di dispositivo in basso a destra. Etichetta 'Energy manager' sotto la casa.
6 Aggiungere sonnenBatterie a Reduxi
Seguire questi passaggi per aggiungere la sonnenBatterie come nuovo dispositivo sul Reduxi Controller.
6.1 Impostazioni di base
Accedere al Reduxi Configurator (vedere punto 5; vedere anche How to log in to Reduxi Configurator via browser) e fare clic su + Add device.
Descrizione testuale di questa immagine
Screenshot del menu a sinistra del Reduxi Configurator sotto il logo reduxi Configurator. Voci di menu: Devices (espansa, con un segno meno) contenente il pulsante '+ Add device' (con contorno); Strategies (segno più); Utility Rate Plan; Settings (segno più). Il lato destro è bianco e vuoto.
Nel primo passaggio, definire le impostazioni di base:
- Device type: Hybrid Inverter
- Type: Sonnen
- Name: un nome a scelta
Descrizione testuale di questa immagine
Screenshot del modulo del Reduxi Configurator intitolato Basic settings. Campi: Device type (menu a tendina, valore in caratteri piccoli); Type (menu a tendina, il valore sembra riportare Sonnen, caratteri piccoli); Name (campo di testo, il valore sembra riportare sonnen, caratteri piccoli). Sotto c'è una sezione Include in Strategy con una tabella: colonne Strategy, Measurement Device, Regulated Device; due righe, entrambe denominate Energy manager, ciascuna con un piccolo indicatore nelle colonne Measurement Device e Regulated Device. Pulsanti: Back (in basso a sinistra, bianco), Next (in basso a destra, nero). L'immagine ha una risoluzione bassa e la maggior parte del testo è piccola.
Fare clic su Next.
6.2 Impostazioni di comunicazione
Inserire i parametri di connessione tra il Reduxi Controller e la sonnenBatterie. Usare l'indirizzo IP e il token API del punto 4.
| Parametro | Valore |
|---|---|
| Collegamento | TCP/IP |
| IP | Indirizzo IP di sonnenBatterie |
| Porta | 80 |
| Token API | Il token API dalla scheda JSON API (punto 4, punto 4.1) |
| Potenza nominale | Selezionare la potenza nominale corrispondente alla propria sonnenBatterie |
| PV | Selezionare Yes se è installato un contatore FV, altrimenti No |
Descrizione testuale di questa immagine
Schermata del modulo Communication channel and device configuration di Reduxi Configurator. Campi dall'alto in basso: Connection (TCP/IP), IP (vuoto, con una freccia azzurra che indica il campo), Port (80), API token (vuoto, con una freccia azzurra; suggerimento: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) e PV (Yes; suggerimento: Is PV meter installed?). Pulsanti in basso: Back, Test communication e Next.
6.3 Testare la comunicazione
Fare clic su Test communication in fondo alla procedura guidata. Il test legge la sonnenBatterie una volta e non salva nulla. Se il test riesce, fare clic su Next.
Il test restituisce uno di due risultati:
Descrizione testuale di questa immagine
Screenshot della barra dei pulsanti in basso di una pagina del Reduxi Configurator. A sinistra: pulsante 'Back'. A destra: pulsante 'Test communication' (evidenziato da un riquadro ciano) e pulsante scuro 'Done'.
Descrizione testuale di questa immagine
Screenshot della finestra Test communication del Reduxi Configurator con un'icona di chiusura (x) in alto a destra. Riquadro bianco del risultato, testo verde: Successful readout from device. Valori: Battery active power: 5.0 W; Battery current: 0.0229 A; Battery export active energy: 0 Wh; Battery import active energy: 0 Wh; Battery min. active power: -9600.0 W; Battery min. state of charge: 10.0 %; Battery state of charge: 100.0 %; Battery voltage: 218.0 V; Grid active power: 1456.0 W; Grid export active energy: 0 Wh; Grid import active energy: 0 Wh; Load active power: 1454.0 W; Load import active energy: 0 Wh; Off-grid: false; PV active power: 0.0 W; PV export active energy: 0 Wh; State name: GRID_ON; Additional parameter - CAPACITY_MAX_WH: 19531.0; Additional parameter - FREQUENCY: 49.965. Pulsante: Close (scuro, in basso a destra).
Descrizione testuale di questa immagine
Screenshot di una finestra intitolata Test communication (X di chiusura in alto a destra). Primo riquadro: Unable to communicate with device. Secondo riquadro con testo rosso: Unable to communicate with null on port 502. Check if service is enabled on device, port number is correct and device is reachable on the network. ping: null: Name or service not known. Pulsante: Close (scuro).
Se compare il messaggio “Unable to communicate with device”, controllare le impostazioni (vedere Punto 8).
6.4 Impostazioni avanzate
Le impostazioni avanzate sono facoltative e dipendono dalle esigenze del sito. Al termine, fare clic su Done: solo Done crea il dispositivo.
Descrizione testuale di questa immagine
Schermata della procedura guidata di Reduxi Configurator, passo 3 di 3 Advanced settings; la barra di avanzamento mostra Basic settings, Communication channel e Advanced settings. Interruttori Yes/No, tutti su No: set data saving interval (predefinito 1 min), set reading delay (predefinito 1000 ms), set writing delay (predefinito 1000 ms), set power generation limits and capabilities, set power consumption limits and capabilities, limit communication with the device to read-only (predefinito No), invert direction for energy import and export (predefinito No), exclude device from summary (predefinito No). Tre menu a discesa L1, L2 e L3 is connected to main feed sono impostati su L1, L2 e L3. Pulsanti: Back a sinistra e Done a destra.
7 Controllare le letture e configurare le strategie
7.1 Last measurements
Dopo aver stabilito la comunicazione, controllare i valori misurati in Devices – il proprio dispositivo Sonnen – Last measurements nel Reduxi Configurator.
7.2 Control type
Aprire Devices – il proprio dispositivo Sonnen nel Reduxi Configurator e impostare il control type su AUTO. I comandi della strategia agiscono poi sulla batteria.
7.3 Reduxi Cloud
Come aggiungere e collegare il controller a Reduxi Cloud: Reduxi Cloud
Dopo aver aggiunto il dispositivo, è possibile monitorarlo e controllarlo anche nell'app Reduxi.
7.4 Strategie
Per configurare le strategie e AI Energy Manager, utilizzare la documentazione seguente.
8 Checklist
Consultare questa checklist per una configurazione corretta e un funzionamento affidabile.
8.1 Su Reduxi Controller
-
Indirizzo IP e porta: Sono inseriti l'indirizzo IP della sonnenBatterie e la porta
80. - Token API: è inserito un token API valido.
- Potenza nominale e FV: La potenza nominale e la selezione FV corrispondono all'impianto.
- Test di comunicazione: il test di comunicazione si conclude con successo.
- Control type: Il control type del dispositivo è impostato su AUTO.
- Raggiungibilità: l'indirizzo IP del dispositivo è raggiungibile da Reduxi Controller.
8.2 Sull'interfaccia web di sonnenBatterie
- Permessi API: sono attivati sia Read API sia Write API.
- VPP: La batteria è scollegata dalla VPP.
- Modalità operativa: la modalità operativa è Manual.
8.3 Strategia
- Strategia attiva: la strategia selezionata è impostata su Active.
- Ottimizzazione energetica con IA: nella strategia è attivata l'ottimizzazione di AI Energy Manager.
- Una sola strategia attiva: è attiva una sola strategia alla volta.
- Limiti di prelievo/immissione: i limiti di prelievo e di immissione sono definiti e configurati.
✓ Riepilogo
Preparazione (punti 1–3): Preparare l'indirizzo IP locale e un computer nella stessa rete. Aprire l'interfaccia web della sonnenBatterie.
sonnenBatterie (punto 4): Aprire Software-Integration, scheda JSON API. Attivare Read API e Write API (prima scollegare la batteria dalla VPP), copiare o creare il token API e impostare la modalità operativa su Manual.
Aggiunta a Reduxi (punti 5–6): Aprire il Configurator e aggiungere il dispositivo con tipo Sonnen. Inserire indirizzo IP, porta 80, token API, potenza nominale e FV. Eseguire Test communication, poi fare clic su Done.
Messa in servizio (punti 7–8): Controllare le letture, impostare il control type su AUTO, configurare le strategie e seguire la checklist.
→ Problemi comuni
| Problema | Soluzione |
|---|---|
| Test communication mostra “Unable to communicate with device” | Verificare l'indirizzo IP, la porta 80, il token API e che l'indirizzo IP sia raggiungibile dal controller (vedere punto 8). |
| Non è possibile attivare la Write API | Viene mostrato l'avviso “This functionality is disabled while VPP is active”. Scollegare la batteria dalla VPP, poi attivare la Write API (vedere punto 4.2). |
| Nessun token API disponibile | Aprire Software-Integration, scheda JSON API, nell'interfaccia web della sonnenBatterie e fare clic su Create New. |
| I comandi di Reduxi non hanno alcun effetto sulla batteria | Verificare che la modalità operativa sia Manual, che Read API e Write API siano attive, che il control type sia AUTO, che la strategia sia Active e che sia attiva una sola strategia (vedere punto 8). |
| Open configurator non si apre o rimane vuoto | Il tunnel non è ancora attivo. Attendere circa 30 secondi e verificare che il controller sia online. |
| L'accesso con admin viene rifiutato | La password è stata modificata durante l'installazione. Chiedere all'installatore. La password dell'account Reduxi qui non funziona. |
| reduxi.local non si carica | Il dispositivo non si trova nella stessa rete del controller. Usare l'indirizzo IP o la connessione tunnel. |
| Il test di comunicazione non riesce, il dispositivo risulta offline | Verificare la raggiungibilità, l'indirizzo IP e la porta e che l'API sia attiva sul dispositivo. |