Come collegare sonnenBatterie (Gen. 8 o superiore, connessione REST API) a Reduxi Controller
Collegare sonnenBatterie Gen. 8 o superiore a Reduxi Controller tramite la REST API.
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.
- Documentazione tecnica
- Attrezzatura necessaria
- Accesso locale a sonnenBatterie
- Configurazione del dispositivo su sonnenBatterie
- Accedere all'interfaccia web di Reduxi
- Aggiungere sonnenBatterie a Reduxi
- Controllare le letture e configurare le strategie
- Checklist
- Riepilogo
- Problemi comuni
- Articoli correlati
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 Gen. 8 o superiore (REST API)
- Indirizzo IP locale di sonnenBatterie
- Password dell'installatore di sonnenBatterie (vedere Punto 4)
- 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
Prima di iniziare, assicurarsi di avere l'indirizzo IP locale di sonnenBatterie e che il computer sia collegato alla stessa rete locale.
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
4.1 Accesso come installatore
Dopo aver aperto l'indirizzo IP nel browser, compare una schermata di accesso. Selezionare Installer come tipo di accesso e inserire la password dell'installatore.
Se serve l'accesso, contattare l'installatore che ha messo in servizio l'impianto oppure l'assistenza Sonnen. L'assistenza Sonnen può verificare la richiesta, sbloccare l'accesso o eseguire per conto dell'utente le modifiche necessarie.
Descrizione testuale di questa immagine
Screenshot della schermata di accesso dell'interfaccia web di sonnenBatterie, finestra ampia con il logo sonnen nella barra scura in alto. Riquadro di accesso centrato con il titolo Dashboard. Testo: Please choose a login. Menu a tendina con il valore selezionato Installer. Etichetta del campo Password, campo vuoto. Pulsante azzurro Login.
4.2 Dashboard
Dopo l'accesso, viene mostrato Menu / Dashboard.
Descrizione testuale di questa immagine
Screenshot dell'interfaccia web di sonnenBatterie, pagina Dashboard, con il logo sonnen nella barra scura in alto. Menu a sinistra: Dashboard (evidenziata in azzurro), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Titolo dell'area principale: Dashboard. Schema del flusso di energia con quattro riquadri: production 3145 W (giallo, icona di pannello solare); consumption 1875 W (blu, icona di casa); FeedIn 1273 W (grigio, icona di traliccio); active power con stato idle, rSOC: 16% e uSOC: 9% (verde, icona di batteria). Una freccia gialla va dalla produzione al riquadro della batteria, una freccia verde va dal riquadro della batteria verso l'alto fino al consumo.
4.3 Abilitare la REST API di sonnenBatterie
Nella dashboard, procedere come segue:
Descrizione testuale di questa immagine
Screenshot dell'interfaccia web di sonnenBatterie, pagina Software-Integration (logo sonnen nella barra scura in alto; numero di serie e versione del software mostrati in alto a destra in caratteri piccoli). Menu a sinistra: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (evidenziata da un riquadro rosso). Schede: JSON API (selezionata), WebSocket API, Generated Docs (caratteri piccoli). Due interruttori, entrambi attivi (blu) e ciascuno contrassegnato da un riquadro rosso: Read API (testo sotto: allows to request the current status of the sonnenBatterie, measurements and configuration values) e Write API (testo sotto: send requests to change or discharge the sonnenBatterie and set configuration values). Un riquadro rosso contrassegna la riga API Token: un valore del token (non mostrato qui, oscurato) e un pulsante Create New. Sotto: un esempio di comando curl con un'intestazione Auth-Token e un URL che termina con /api/v2/latestdata. Titolo Documentation con un link alla documentazione della JSON API di sonnenBatterie.
4.4 Impostare la modalità operativa
Aprire il menu Settings sul lato sinistro e selezionare la modalità operativa Manual.
Descrizione testuale di questa immagine
Screenshot dell'interfaccia web di sonnenBatterie, pagina Settings (in alto a destra: Software: 1.15.6, il resto è tagliato). Menu a sinistra: Dashboard, System, Inverter, Settings (evidenziata in blu), Network, Software-Integration. Titolo dell'area principale: Settings. Sezione: Operating Mode. Un menu a tendina è aperto con la voce selezionata Manual (evidenziata in grigio). Le opzioni elencate sono: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Sotto il menu a tendina è visibile un interruttore denominato Surplus fullcharge, disattivato (grigio).
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 un nuovo dispositivo a Reduxi Controller.
6.1 Impostazioni di base
Accedere al Reduxi Configurator (vedere Punto 5; vedere anche Come accedere al Reduxi Configurator tramite 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
| Parametro | Valore |
|---|---|
| Collegamento | TCP/IP |
| IP | Indirizzo IP di sonnenBatterie |
| Token API | Il token API ottenuto al Punto 4, punto 4.3 |
| PV | Scegliere il tipo di inverter: AC‑coupled (batteria e inverter sono separati) oppure Hybrid (batteria e inverter sono integrati in un unico sistema) |
Descrizione testuale di questa immagine
Screenshot del modulo del Reduxi Configurator intitolato Communication channel and device configuration. L'immagine ha una risoluzione bassa. Campi: Connection type (menu a tendina); IP (campo di testo, vuoto) con un pulsante nero Scan for IP; Port: 80; Reconnect IP recovery (interruttore, con etichetta Yes, attivo); API token (campo di testo, vuoto); un secondo interruttore con un breve titolo e il testo Yes/No; Number of AC system units: 1; What is type of inverter (menu a tendina): AC coupled system. Pulsanti: Back (in basso a sinistra), Test communication e Done (in basso a destra, Done è nero).
6.3 Testare la comunicazione
Fare clic su Test communication in fondo alla procedura guidata. Il test legge una volta sonnenBatterie e non salva nulla. Se il test riesce, fare clic su Done: solo Done crea il dispositivo.
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 pagina 'Communication channel and device configuration' del Reduxi Configurator. Connection *: TCP/IP (menu a discesa). IP *: 192.168.50.243, con il pulsante 'Scan for IP'. Port *: 502, con il pulsante 'Test port'. Modbus unit ID *: 1. Pulsanti in basso: Back (a sinistra), Test communication e Done (a destra). Il pulsante Done è evidenziato da un riquadro ciano.
Il test restituisce uno di due risultati:
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).
7 Controllare le letture e configurare le strategie
7.1 Last measurements
Dopo aver stabilito la comunicazione, controllare i valori misurati in Devices – il dispositivo Sonnen – Last measurements nel Reduxi Configurator.
7.2 Reduxi Cloud
Come aggiungere e collegare il controller a Reduxi Cloud: Reduxi Cloud
7.3 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: per il dispositivo collegato è inserito l'indirizzo IP corretto.
- Token API: è inserito un token API valido.
- Tipo di sistema: è selezionato il tipo di sistema corretto: AC‑coupled oppure Hybrid.
- Test di comunicazione: il test di comunicazione si conclude con successo.
- 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.
- 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, la password dell'installatore e un computer nella stessa rete. Aprire l'interfaccia web di sonnenBatterie.
sonnenBatterie (punto 4): accedere come Installer, attivare Read API e Write API, 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, token API e tipo di inverter (AC‑coupled o Hybrid). Eseguire Test communication.
Messa in funzione (punti 7–8): controllare le letture, configurare le strategie e ripassare la checklist.
→ Problemi comuni
| Problema | Soluzione |
|---|---|
| Test communication mostra “Unable to communicate with device” | Il sistema non è configurato correttamente. Controllare l'indirizzo IP, il token API, il tipo di sistema (AC‑coupled o Hybrid) e che l'indirizzo IP sia raggiungibile dal controller (vedere Punto 8). |
| L'accesso come installatore non è possibile | La password dell'installatore non è disponibile per gli utenti finali. Contattare l'installatore che ha messo in servizio l'impianto oppure l'assistenza Sonnen (vedere Punto 4). |
| Nessun token API disponibile | Aprire Software Integration nell'interfaccia web di sonnenBatterie e fare clic su Create new in fondo alla pagina. |
| I comandi di Reduxi non hanno alcun effetto sulla batteria | Verificare che la modalità operativa sia Manual, che Read API e Write API siano attivate, 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 | Controllare la raggiungibilità, indirizzo IP / porta / unit ID e che il protocollo sia abilitato sul dispositivo. |