Cómo conectar sonnenBatterie (Gen. 8 o superior, conexión REST API) con el Reduxi Controller
Conecte la sonnenBatterie Gen. 8 o superior al Reduxi Controller mediante la REST API.
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.
- Documentación técnica
- Equipo necesario
- Acceso local a la sonnenBatterie
- Configuración del dispositivo en la sonnenBatterie
- Iniciar sesión en la interfaz web de Reduxi
- Añadir la sonnenBatterie a Reduxi
- Comprobar las lecturas y configurar las estrategias
- Lista de comprobación
- Resumen
- Problemas frecuentes
- Artículos relacionados
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 Gen. 8 o superior (REST API)
- Dirección IP local de la sonnenBatterie
- Contraseña de instalador de la sonnenBatterie (véase el punto 4)
- 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
Antes de empezar, asegúrese de tener la dirección IP local de la sonnenBatterie y de que su ordenador está conectado a la misma red local.
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
4.1 Inicio de sesión como instalador
Después de abrir la dirección IP en el navegador, aparece una pantalla de inicio de sesión. Seleccione Installer como tipo de inicio de sesión e introduzca la contraseña de instalador.
Si necesita acceso, póngase en contacto con el instalador que puso en marcha el sistema o con el soporte de Sonnen. El soporte de Sonnen puede verificar la solicitud, desbloquear el acceso o realizar por usted los cambios necesarios.
Descripción en texto de esta imagen
Captura de pantalla de la pantalla de inicio de sesión de la interfaz web de la sonnenBatterie, ventana ancha con el logotipo de sonnen en la barra superior oscura. Cuadro de inicio de sesión centrado con el título Dashboard. Texto: Please choose a login. Desplegable con el valor seleccionado Installer. Etiqueta de campo Password, campo vacío. Botón azul claro Login.
4.2 Dashboard
Tras iniciar sesión correctamente, se muestra Menu / Dashboard.
Descripción en texto de esta imagen
Captura de pantalla de la interfaz web de la sonnenBatterie, página Dashboard, con el logotipo de sonnen en la barra superior oscura. Menú izquierdo: Dashboard (resaltado en azul claro), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Título del área principal: Dashboard. Diagrama de flujo de energía con cuatro recuadros: production 3145 W (amarillo, icono de panel solar); consumption 1875 W (azul, icono de casa); FeedIn 1273 W (gris, icono de torre eléctrica); active power con estado idle, rSOC: 16% y uSOC: 9% (verde, icono de batería). Una flecha amarilla va de production al recuadro de la batería y una flecha verde va del recuadro de la batería hacia arriba, a consumption.
4.3 Activar la REST API de la sonnenBatterie
En el dashboard, haga lo siguiente:
Descripción en texto de esta imagen
Captura de pantalla de la interfaz web de la sonnenBatterie, página Software-Integration (logotipo de sonnen en la barra superior oscura; número de serie y versión de software en texto pequeño arriba a la derecha). Menú izquierdo: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (resaltado con un recuadro rojo). Pestañas: JSON API (seleccionada), WebSocket API, Generated Docs (texto pequeño). Dos interruptores, ambos activados (azul) y cada uno marcado con un recuadro rojo: Read API (texto debajo: allows to request the current status of the sonnenBatterie, measurements and configuration values) y Write API (texto debajo: send requests to change or discharge the sonnenBatterie and set configuration values). Un recuadro rojo marca la fila API Token: un valor de token (no se muestra aquí, ocultado) y un botón Create New. Debajo: un comando curl de ejemplo con una cabecera Auth-Token y una URL que termina en /api/v2/latestdata. Título Documentation con un enlace a la documentación de la JSON API de la sonnenBatterie.
4.4 Establecer el modo de funcionamiento
Abra el menú Settings en el lado izquierdo y seleccione el modo de funcionamiento Manual.
Descripción en texto de esta imagen
Captura de pantalla de la interfaz web de la sonnenBatterie, página Settings (arriba a la derecha se lee Software: 1.15.6, el resto está cortado). Menú izquierdo: Dashboard, System, Inverter, Settings (resaltado en azul), Network, Software-Integration. Título del área principal: Settings. Sección: Operating Mode. Hay un desplegable abierto con la entrada seleccionada Manual (resaltada en gris). Las opciones de la lista son: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Debajo del desplegable se ve un interruptor con la etiqueta Surplus fullcharge, desactivado (gris).
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 un dispositivo nuevo al Reduxi Controller.
6.1 Ajustes básicos
Inicie sesión en el Reduxi Configurator (véase el punto 5; véase también Cómo iniciar sesión en el Reduxi Configurator desde el navegador) 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
| Parámetro | Valor |
|---|---|
| Conexión | TCP/IP |
| IP | Dirección IP de la sonnenBatterie |
| API token | El token de API del punto 4, punto 4.3 |
| PV | Elija el tipo de inversor: AC-coupled (la batería y el inversor son independientes) o Hybrid (la batería y el inversor están integrados en un solo sistema) |
Descripción en texto de esta imagen
Captura de pantalla del formulario Communication channel and device configuration del Reduxi Configurator. La imagen es de baja resolución. Campos: Connection type (desplegable); IP (campo de texto, vacío) con un botón negro Scan for IP; Port: 80; Reconnect IP recovery (interruptor, con la etiqueta Yes, activado); API token (campo de texto, vacío); un segundo interruptor con un título corto y el texto Yes/No; Number of AC system units: 1; What is type of inverter (desplegable): AC coupled system. Botones: Back (abajo a la izquierda), Test communication y Done (abajo a la derecha, Done es negro).
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 se supera, haga clic en Done: solo Done crea el dispositivo.
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 de la página 'Communication channel and device configuration' del Reduxi Configurator. Connection *: TCP/IP (menú desplegable). IP *: 192.168.50.243, con el botón 'Scan for IP'. Port *: 502, con el botón 'Test port'. Modbus unit ID *: 1. Botones en la parte inferior: Back (izquierda), Test communication y Done (derecha). El botón Done está marcado con un recuadro cian.
La prueba devuelve uno de dos resultados:
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).
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 Reduxi Cloud
Cómo añadir y conectar el controlador a Reduxi Cloud: Reduxi Cloud
7.3 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: se ha introducido la dirección IP correcta del dispositivo conectado.
- Token de API: se ha introducido un token de API válido.
- Tipo de sistema: se ha seleccionado el tipo de sistema correcto: AC-coupled o Hybrid.
- Prueba de comunicación: la prueba de comunicación se ha completado correctamente.
- 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.
- 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, la contraseña de instalador y un ordenador en la misma red. Abra la interfaz web de la sonnenBatterie.
sonnenBatterie (punto 4): inicie sesión como Installer, active Read API y Write API, copie o cree el token de 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 token de API y el tipo de inversor (AC-coupled o Hybrid). Ejecute Test communication.
Puesta en marcha (puntos 7–8): compruebe las lecturas, configure las estrategias y repase la lista de comprobación.
→ Problemas frecuentes
| Problema | Solución |
|---|---|
| Test communication muestra “Unable to communicate with device” | El sistema no está bien configurado. Compruebe la dirección IP, el token de API, el tipo de sistema (AC-coupled o Hybrid) y que la dirección IP es accesible desde el controlador (véase el punto 8). |
| No es posible iniciar sesión como instalador | Los usuarios finales no disponen de la contraseña de instalador. Póngase en contacto con el instalador que puso en marcha el sistema o con el soporte de Sonnen (véase el punto 4). |
| No hay ningún token de API disponible | Abra Software Integration en la interfaz web de la sonnenBatterie y haga clic en Create new, en la parte inferior de la página. |
| 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 la estrategia está en Active y que solo hay una estrategia activa (véase 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 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 / el puerto / el unit ID, y que el protocolo esté activado en el dispositivo. |