Cómo conectar sonnenBatterie con el Reduxi Controller
Conecte su sonnenBatterie al Reduxi Controller y deje que las estrategias de Reduxi la carguen y la descarguen a los mejores precios. Esta guía cubre la conexión mediante la JSON API e indica dónde se aplica la guía de la REST API para la Gen. 8 o superior.
Descripción en texto de esta imagen
Foto de una sonnenBatterie, imagen del fabricante. Pared de hormigón gris oscuro en una habitación con poca luz. En la pared, a la izquierda, cuelga un módulo rectangular gris con el frontal acanalado o perforado, que según el pie de foto es el inversor híbrido. A su lado, a la derecha, hay un armario alto gris claro con un anillo luminoso redondo de color azul claro cerca de la parte superior. No hay texto legible en los dispositivos.
1 Documentación técnica
Páginas del fabricante de la sonnenBatterie:
- sonnenBatterie 10 – Página de producto del fabricante
- Manuales de uso de Sonnen – Manuales de uso del fabricante
Tutoriales en vídeo:
2 Equipo necesario
Prepare lo siguiente:
- Reduxi Controller (instalado y en línea)
- sonnenBatterie con la JSON API en Software Integration
- Dirección IP local de la sonnenBatterie
- Ordenador en la misma red local que la sonnenBatterie
- Portátil o tableta con acceso a internet para configurar el dispositivo en Reduxi
3 Acceso local a la sonnenBatterie
Conecte la sonnenBatterie a la red local mediante LAN. El Reduxi Controller debe estar en la misma red.
La sonnenBatterie recibe su dirección IP de:
- el router,
- un switch de red,
- o un servidor DHCP local.
Para averiguar la dirección IP o el nombre DNS de la sonnenBatterie, utilice find-my.sonnen-batterie.com y siga las instrucciones de Sonnen.
Abra un navegador web e introduzca la dirección IP local de la sonnenBatterie para abrir su interfaz web. Ejemplo: http://<IP>
4 Configuración del dispositivo en la sonnenBatterie
Inicie sesión en la interfaz web de la sonnenBatterie (consulte el punto 3). Necesita el token de la API y la dirección IP para el Reduxi Controller (consulte el punto 6).
4.1 Abrir Software Integration
Descripción en texto de esta imagen
Captura de pantalla de la interfaz web de la sonnenBatterie en un navegador, página Software-Integration, pestaña JSON API. La barra de direcciones muestra una dirección IP local seguida de la ruta dash/software-integration/json-api; la dirección IP está marcada con un recuadro rojo y una flecha con la etiqueta SonnenBatterie IP. Menú izquierdo: Dashboard, System, Inverter, Settings, Network y Software-Integration (resaltado). Pestañas: JSON API (activa), Webhook API y sonnenKNX Module. Dos interruptores están activados: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) y Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Debajo, el campo API Token con un valor de token, marcado con un recuadro rojo y la etiqueta API Token, y un botón Create New. Una línea de ejemplo repite el token y la dirección IP con las mismas marcas. Abajo: enlace sonnenBatterie JSON API v2 documentation.
4.2 Activar Read API y Write API
Active Read API y Write API. Ambas son necesarias: Reduxi lee las mediciones con la Read API y envía los comandos de carga y descarga con la Write API.
Descripción en texto de esta imagen
Captura de pantalla recortada de la pestaña JSON API con las pestañas JSON API, Webhook API y sonnenKNX Module. El interruptor Read API está activado. Debajo, un aviso azul claro dice This functionality is disabled while VPP is active, seguido de un interruptor Write API en gris en posición desactivada con el texto Send requests to charge/discharge the sonnenBatterie and set configuration values. Un rectángulo azul resalta el aviso y el interruptor Write API.
4.3 Establecer el modo de funcionamiento
Abra el menú Settings del lado izquierdo y establezca el modo de funcionamiento en Manual. Solo entonces puede el Reduxi Controller asumir el control de la batería.
Descripción en texto de esta imagen
Captura de pantalla de la página Settings de la sonnenBatterie (software 1.15.6). Menú izquierdo: Dashboard, System, Inverter, Settings (resaltado), Network y Software-Integration. La tarjeta Operating Mode contiene una lista desplegable que muestra Manual; la lista abierta debajo ofrece Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) y Time-Of-Use. Debajo de la tarjeta se ve un interruptor con la etiqueta Surplus fullcharge.
5 Iniciar sesión en la interfaz web de Reduxi
Puede abrir la interfaz web de Reduxi de dos formas:
Descripción en texto de esta imagen
Captura de pantalla de tres pantallas de la Reduxi app móvil, una junto a otra, con recuadros cian e insignias numeradas del 2 al 4. Pantalla izquierda (panel, tema oscuro): icono de menú arriba a la izquierda marcado con un recuadro y la insignia 2; logotipo 'reduxi'; pestañas 'Real time data' (activa) y 'Statistics'; precio 5.79 € y temperatura 3.2 °C; diagrama de flujo de energía con una casa en el centro (-1.25 kW) e iconos con los valores 69.0 W, 1.3 kW, 1.1 kW (anillo rojo), -165.0 W con 97 % (anillo rojo) y valores de 0.0 W en la parte inferior; pestañas 'Power' y 'Energy'; navegación inferior: Dashboard, Diagnostics, Device control, Settings. Pantalla central (menú lateral): logotipo 'reduxi', 'Number of locations: 1233', encabezado 'Reduxi device management', entradas '+ Add Reduxi location' y 'Reduxi devices' (marcada con un recuadro y la insignia 3), después 'My profile' y 'About app'. Pantalla derecha (página del dispositivo): Back; imagen de un controlador Reduxi negro con dos puertos Ethernet; estado 'Connected'; tarjeta 'Update available': 'New update is available for your Reduxi device.' con el botón 'Download and install update'; tarjeta 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' con el botón 'Activate tunnel connection' (marcado con un recuadro y la insignia 4); tarjeta 'Unit details' con el campo 'Unit ID'.
Descripción en texto de esta imagen
Captura de pantalla compuesta por dos partes, una junto a otra. Parte izquierda: pantalla de la Reduxi app móvil sobre fondo oscuro. Arriba: botón Back; imagen de un controlador Reduxi negro con dos puertos Ethernet y un bloque de terminales; estado 'Connected' con un icono de Wi-Fi. Tarjeta 'Update available': 'New update is available for your Reduxi device.' con el botón 'Download and install update'. Tarjeta 'Connect to configurator' con un icono de llave: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' y el botón 'Open configurator', marcado con un recuadro cian y la insignia numérica 5. Debajo: tarjeta 'Unit details' con un campo 'Unit ID' (valor no visible). Parte derecha: Reduxi Configurator abierto en un navegador, marcado con un marco cian y la insignia numérica 6. Cabecera: flecha de retroceso, 'Tunnel connection', icono de recarga. Barra lateral izquierda con iconos (rayo, chip, rayo, gráfico de barras, engranaje). Página 'Home' con un icono de enlace verde. Aviso verde: 'New patch available. Click here to apply.' con una X de cierre. Hora 09:12:56. Diagrama de flujo de energía con una casa en el centro (1.700 kW) e iconos de red (0.000 kW), solar (1.700 kW), batería (verde, 0.000 kW y 0.800 kW), un dispositivo a la izquierda (0.900 kW), un vehículo eléctrico y un cargador o dispositivo en la parte inferior. Etiqueta 'Energy manager' en la parte inferior.
http://reduxi.local. La dirección IP del controlador figura en la lista de dispositivos de su router o en la Reduxi app, en Reduxi devices.admin · Contraseña: admin (valor de fábrica)Descripción en texto de esta imagen
Captura de pantalla de la página de inicio de sesión del Reduxi Configurator en una ventana del navegador Chrome. La barra de direcciones muestra 'Not secure' y 'reduxi.local'; la barra de direcciones está marcada con un recuadro cian y una copia ampliada (recuadro cian, texto 'Not secure reduxi.local') aparece a la izquierda, unida por una línea cian. Fondo de la página: dibujo de líneas gris claro de una casa con paneles solares (verdes), una wallbox, un inversor, un coche y un cargador. Arriba a la izquierda: logotipo 'reduxi configurator'. Cuadro de inicio de sesión en el centro con el título 'Login', un selector de idioma (bandera inglesa, 'English'), un campo de nombre de usuario, un campo de contraseña y un botón oscuro 'Login'.
Descripción en texto de esta imagen
Captura de pantalla de la interfaz web del Reduxi Configurator tras iniciar sesión, tema claro. Arriba a la izquierda: logotipo 'reduxi configurator'. Barra de cabecera: 'Home' a la izquierda, estado verde 'Connected' arriba a la derecha. Barra lateral izquierda: sección desplegada 'Devices' con una lista de entradas, después las secciones plegadas 'Manager', 'Configuration' y 'Settings'. Área principal: diagrama de flujo de energía. Casa en el centro con un anillo, valor 24.20 kW. Icono de red arriba a la izquierda, 24.20 kW (punto rojo en su línea). Icono solar arriba a la derecha, valor '-'. Icono de la izquierda (batería o dispositivo), 6.700 kW (punto verde en su línea). Iconos de la derecha (almacenamiento en batería y un dispositivo), valores '-'. Icono de cargador de VE abajo a la izquierda, 31.00 kW. Otro icono de dispositivo abajo a la derecha. Etiqueta 'Energy manager' debajo de la casa.
6 Añadir la sonnenBatterie a Reduxi
Siga estos pasos para añadir la sonnenBatterie como dispositivo nuevo en el Reduxi Controller.
6.1 Ajustes básicos
Inicie sesión en el Reduxi Configurator (consulte el punto 5; consulte también How to log in to Reduxi Configurator via browser) y haga clic en + Add device.
Descripción en texto de esta imagen
Captura de pantalla del menú izquierdo del Reduxi Configurator bajo el logotipo de reduxi Configurator. Entradas del menú: Devices (desplegada, con un signo menos) que contiene el botón '+ Add device' (con contorno); Strategies (signo más); Utility Rate Plan; Settings (signo más). El lado derecho está en blanco.
En el primer paso, defina los ajustes básicos:
- Device type: Hybrid Inverter
- Type: Sonnen
- Name: un nombre a su elección
Descripción en texto de esta imagen
Captura de pantalla del formulario Basic settings del Reduxi Configurator. Campos: Device type (desplegable, valor en texto pequeño); Type (desplegable, el valor parece decir Sonnen, texto pequeño); Name (campo de texto, el valor parece decir sonnen, texto pequeño). Debajo, una sección Include in Strategy con una tabla: columnas Strategy, Measurement Device, Regulated Device; dos filas, ambas con la etiqueta Energy manager, cada una con un pequeño indicador en las columnas Measurement Device y Regulated Device. Botones: Back (abajo a la izquierda, blanco), Next (abajo a la derecha, negro). La imagen es de baja resolución y la mayor parte del texto es pequeño.
Haga clic en Next.
6.2 Ajustes de comunicación
Introduzca los parámetros de conexión entre el Reduxi Controller y la sonnenBatterie. Utilice la dirección IP y el token de la API del punto 4.
| Parámetro | Valor |
|---|---|
| Conexión | TCP/IP |
| IP | Dirección IP de la sonnenBatterie |
| Puerto | 80 |
| API token | El token de la API de la pestaña JSON API (punto 4, punto 4.1) |
| Potencia nominal | Seleccione la potencia nominal que corresponda a su sonnenBatterie |
| PV | Seleccione Yes si hay instalado un contador FV; en caso contrario, No |
Descripción en texto de esta imagen
Captura de pantalla del formulario Communication channel and device configuration del Reduxi Configurator. Campos de arriba abajo: Connection (TCP/IP), IP (vacío, con una flecha azul claro que señala el campo), Port (80), API token (vacío, con una flecha azul claro; ayuda: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) y PV (Yes; ayuda: Is PV meter installed?). Botones en la parte inferior: Back, Test communication y Next.
6.3 Probar la comunicación
Haga clic en Test communication en la parte inferior del asistente. Lee la sonnenBatterie una vez y no guarda nada. Si la prueba es correcta, haga clic en Next.
La prueba devuelve uno de dos resultados:
Descripción en texto de esta imagen
Captura de pantalla de la barra de botones inferior de una página del Reduxi Configurator. Izquierda: botón 'Back'. Derecha: botón 'Test communication' (marcado con un recuadro cian) y botón oscuro 'Done'.
Descripción en texto de esta imagen
Captura de pantalla del cuadro de diálogo Test communication del Reduxi Configurator con un icono de cierre (x) arriba a la derecha. Recuadro blanco de resultado, texto verde: Successful readout from device. Valores: 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. Botón: Close (oscuro, abajo a la derecha).
Descripción en texto de esta imagen
Captura de pantalla de un cuadro de diálogo titulado Test communication (X de cierre arriba a la derecha). Primer recuadro: Unable to communicate with device. Segundo recuadro con texto rojo: 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. Botón: Close (oscuro).
Si aparece el mensaje “Unable to communicate with device”, compruebe los ajustes (véase el punto 8).
6.4 Ajustes avanzados
Los ajustes avanzados son opcionales y dependen de las necesidades de la instalación. Cuando termine, haga clic en Done: solo Done crea el dispositivo.
Descripción en texto de esta imagen
Captura de pantalla del asistente del Reduxi Configurator, paso 3 de 3 Advanced settings; la barra de progreso muestra Basic settings, Communication channel y Advanced settings. Interruptores Yes/No, todos en No: set data saving interval (default 1 min), set reading delay (default 1000 ms), set writing delay (default 1000 ms), set power generation limits and capabilities, set power consumption limits and capabilities, limit communication with the device to read-only (default No), invert direction for energy import and export (default No), exclude device from summary (default No). Tres listas desplegables L1, L2 y L3 is connected to main feed están establecidas en L1, L2 y L3. Botones: Back a la izquierda y Done a la derecha.
7 Comprobar las lecturas y configurar las estrategias
7.1 Last measurements
Una vez establecida la comunicación, compruebe los valores medidos en Devices – su dispositivo Sonnen – Last measurements en el Reduxi Configurator.
7.2 Control type
Abra Devices – su dispositivo Sonnen en el Reduxi Configurator y establezca el control type en AUTO. Los comandos de la estrategia afectan entonces a la batería.
7.3 Reduxi Cloud
Cómo añadir y conectar el controlador a Reduxi Cloud: Reduxi Cloud
Una vez añadido el dispositivo, también puede supervisarlo y controlarlo en la aplicación Reduxi.
7.4 Estrategias
Para configurar estrategias y el AI Energy Manager, utilice la documentación siguiente.
8 Lista de comprobación
Revise esta lista de comprobación para una configuración correcta y un funcionamiento fiable.
8.1 En el Reduxi Controller
-
Dirección IP y puerto: Se introducen la dirección IP de la sonnenBatterie y el puerto
80. - Token de API: se ha introducido un token de API válido.
- Potencia nominal y FV: La potencia nominal y la selección de FV corresponden a la instalación.
- Prueba de comunicación: la prueba de comunicación se ha completado correctamente.
- Control type: El control type del dispositivo está establecido en AUTO.
- Accesibilidad: la dirección IP del dispositivo es accesible desde el Reduxi Controller.
8.2 En la interfaz web de la sonnenBatterie
- Permisos de API: están activadas tanto Read API como Write API.
- VPP: La batería está desconectada de la VPP.
- Modo de funcionamiento: el modo de funcionamiento es Manual.
8.3 Estrategia
- Estrategia activa: la estrategia seleccionada está en Active.
- Optimización de energía con IA: el modo de optimización AI Energy Manager está activado en la estrategia.
- Una sola estrategia activa: solo hay una estrategia activa a la vez.
- Límites de importación/exportación: los límites de importación y exportación están definidos y configurados.
✓ Resumen
Preparación (puntos 1–3): Prepare la dirección IP local y un ordenador en la misma red. Abra la interfaz web de la sonnenBatterie.
sonnenBatterie (punto 4): Abra Software-Integration, pestaña JSON API. Active Read API y Write API (desconecte antes la batería de la VPP), copie o cree el token de la API y establezca el modo de funcionamiento en Manual.
Añadir a Reduxi (puntos 5–6): Abra el Configurator y añada el dispositivo con el tipo Sonnen. Introduzca la dirección IP, el puerto 80, el token de la API, la potencia nominal y FV. Ejecute Test communication y haga clic en Done.
Puesta en marcha (puntos 7–8): Compruebe las lecturas, establezca el control type en AUTO, configure las estrategias y repase la lista de comprobación.
→ Problemas frecuentes
| Problema | Solución |
|---|---|
| Test communication muestra “Unable to communicate with device” | Compruebe la dirección IP, el puerto 80, el token de la API y que la dirección IP es accesible desde el controlador (consulte el punto 8). |
| No se puede activar la Write API | Se muestra el aviso “This functionality is disabled while VPP is active”. Desconecte la batería de la VPP y active después la Write API (consulte el punto 4.2). |
| No hay ningún token de API disponible | Abra Software-Integration, pestaña JSON API, en la interfaz web de la sonnenBatterie y haga clic en Create New. |
| Los comandos de Reduxi no tienen efecto en la batería | Compruebe que el modo de funcionamiento es Manual, que Read API y Write API están activadas, que el control type es AUTO, que la estrategia está Active y que solo hay una estrategia activa (consulte el punto 8). |
| Open configurator no se abre o se queda vacío | El túnel aún no está activo. Espere unos 30 segundos y compruebe que el controlador está en línea. |
| Se rechaza el inicio de sesión con admin | La contraseña se cambió durante la instalación. Consulte al instalador. La contraseña de la cuenta de Reduxi no sirve aquí. |
| reduxi.local no se carga | Su dispositivo no está en la misma red que el controlador. Use la dirección IP o la conexión de túnel. |
| Falla la prueba de comunicación, el dispositivo aparece sin conexión | Compruebe la accesibilidad, la dirección IP y el puerto, y que la API está activada en el dispositivo. |