Kbuca Ecoflow funciona con Shelly

Propuesta de colaboración para una integración más profunda entre EcoFlow y Shelly, basada en los comentarios de los instaladores, las pruebas reales de STREAM Ultra, la información pública de EcoFlow y Shelly, y una vía práctica para la orquestación energética dirigida por EcoFlow, con Shelly como capa distribuida de medición y control.

Qué es EcoFlow

EcoFlow es un ecosistema de almacenamiento de energía y energía inteligente centrado en facilitar la implementación de la generación solar, el almacenamiento en baterías, la energía de respaldo y el control energético del hogar. Para este artículo, los sistemas EcoFlow más importantes son EcoFlow STREAM, EcoFlow PowerStream y DELTA with Smart Home Panel. Se pueden mencionar otros sistemas EcoFlow cuando resulte útil, pero no son el foco principal de esta propuesta de colaboración.

El patrón común en los productos EcoFlow relevantes es claro: EcoFlow se encarga de la plataforma energética. Es donde el usuario ve la producción solar, el estado de la batería, el comportamiento del almacenamiento, el funcionamiento de respaldo, el consumo y las decisiones energéticas. El primer punto de contacto para el usuario debe seguir siendo la aplicación de EcoFlow.

Shelly encaja en el otro lado del sistema: distribución de energía, control de cargas y supervisión a nivel de dispositivo o circuito. Los instaladores y usuarios finales ya utilizan ampliamente los dispositivos Shelly porque ofrecen API estándar y cubren muchas clases de dispositivos: enchufes inteligentes, dispositivos Pro para carril DIN, contadores de energía, relés, contactores y sensores. Esto convierte a Shelly en una capa distribuida de dispositivos natural para los sistemas energéticos de EcoFlow.

Principales sistemas EcoFlow incluidos

EcoFlow STREAM

EcoFlow STREAM es el foco principal de la experiencia actual en campo. La configuración probada consiste en una batería EcoFlow STREAM Ultra con paneles solares en Alemania.

EcoFlow describe públicamente STREAM Ultra como una batería solar todo en uno con un microinversor conectado a la red integrado, entrada solar, almacenamiento en batería, supervisión mediante la aplicación y compatibilidad con un contador inteligente. Esta es la familia de productos en la que la compatibilidad con Shelly es importante de inmediato, porque el sistema depende de datos precisos sobre el consumo del hogar y del comportamiento inteligente de las cargas para mejorar el autoconsumo.

Por qué STREAM es importante para Shelly:

• Está directamente relacionada con el problema del autoconsumo.

• Se beneficia de datos precisos sobre el consumo del home.

• Se beneficia de cargas controlables.

• Es relevante para los mercados plug-and-play y de modernización.

• Es la familia de productos en la que los instaladores ya informan de que los nuevos dispositivos Shelly no aparecen de forma fiable.

EcoFlow PowerStream

EcoFlow PowerStream también es importante porque conecta la energía solar de balcón, las estaciones de energía portátiles, los enchufes inteligentes y la supervisión mediante la aplicación de EcoFlow. Es muy relevante para usuarios finales plug-and-play y clientes de modernización, especialmente en los mercados europeos donde la energía solar de balcón es común.

La información oficial del producto de EcoFlow presenta PowerStream como un sistema de energía solar para balcones con una estación de energía portátil, enchufes inteligentes y monitorización mediante la aplicación de EcoFlow. La página oficial también describe la monitorización en tiempo real, el control remoto de los appliances y la asignación automática de energía, donde los enchufes inteligentes monitorizan el consumo de los appliances y el microinversor asigna la electricidad disponible al appliance o almacena el excedente en una estación de energía portátil.

Referencia:

• https://www.ecoflow.com/eu/powerstream

Por qué PowerStream es importante para Shelly:

• Lo utilizan habitualmente quienes buscan una forma sencilla de iniciarse en la energía solar.

• El funcionamiento de un enchufe inteligente es fácil de entender para los usuarios finales.

• El control a nivel de carga es fundamental en la propuesta del producto.

• Es un puente natural entre la energía solar y el almacenamiento de EcoFlow y los dispositivos plug-and-play de Shelly.

DELTA + Smart Home Panel

DELTA con Smart Home Panel es importante para el respaldo de todo el home y la gestión energética a nivel de circuito. EcoFlow describe Smart Home Panel como una parte fundamental de un sistema de respaldo del home que se integra con el ecosistema DELTA Pro y permite a los usuarios monitorizar la energía, programar la carga, establecer la prioridad de los circuitos y gestionar el comportamiento del respaldo desde la aplicación de EcoFlow.

La información oficial de EcoFlow sobre Smart Home Panel describe el panel como el heart del sistema de respaldo del home. Se integra con el ecosistema DELTA Pro, admite hasta 10 circuitos conectados, ofrece monitorización energética mediante la aplicación y permite a los usuarios programar la carga y establecer la prioridad de los circuitos. Esto lo hace directamente relevante para Shelly, ya que los dispositivos Shelly pueden ampliar este mismo enfoque basado en circuitos y cargas para la monitorización y el control distribuidos.

Referencia:

• https://www.ecoflow.com/us/smart-home-panel

Por qué DELTA + Smart Home Panel es importante para Shelly:

• Es relevante para sistemas residenciales de mayor tamaño.

• Introduce una perspectiva a nivel de circuito.

• Necesita un comportamiento claro de prioridad de las cargas.

• Puede beneficiarse de la medición de Shelly, los relés inteligentes y el control de contactores.

• Es relevante para situaciones de respaldo y funcionamiento en modo isla.

EcoFlow OASIS y otros sistemas de EcoFlow

EcoFlow OASIS y otros productos de energy-management de EcoFlow deberían mencionarse como parte de la dirección general, no como el foco principal del artículo, a menos que se confirme el alcance de la integración.

EcoFlow presenta públicamente OASIS como un sistema de gestión energética del hogar con monitorización en tiempo real, paneles, información energética e integración de dispositivos entre plataformas. La página pública de OASIS menciona dispositivos de terceros compatibles con los protocolos Tiber, Matter y Shelly. Esto respalda la dirección estratégica: EcoFlow quiere ser la capa de orquestación energética, y Shelly puede ser la capa distribuida de ejecución y medición.

La información oficial de EcoFlow sobre OASIS describe la monitorización en tiempo real las 24 horas del día, los 7 días de la semana, widgets personalizables, paneles para la generación y el consumo, e integración de dispositivos entre plataformas. La página pública de OASIS menciona explícitamente dispositivos de terceros compatibles con los protocolos Tiber, Matter y Shelly, lo que respalda la propuesta de que Shelly debería tratarse como una capa de dispositivos más amplia dentro de la experiencia de energy-management de EcoFlow.

Referencia:

• https://www.ecoflow.com/uk/oasis-home-energy-management-system

Por qué esto es importante para la integración de Shelly

Los comentarios de los instaladores muestran una brecha práctica. Los instaladores quieren planificar soluciones EcoFlow + Shelly, pero la visibilidad y compatibilidad actuales con los dispositivos Shelly no son lo bastante amplias para planificar con confianza.

En intentos de instalación reales:

• Los nuevos dispositivos Shelly Gen3 y Gen4 no aparecieron en el escaneo de dispositivos de EcoFlow.

• No se mostraron dispositivos Gen3/Gen4 durante el flujo de detección probado.

• Aparecieron algunos modelos Shelly, principalmente dispositivos antiguos.

Esto bloquea a tres grupos importantes de clientes:

1. Nuevas instalaciones profesionales Los instaladores quieren utilizar dispositivos Shelly Pro, contadores para carril DIN, relés y contactores en sistemas EcoFlow planificados.

2. Instalaciones de modernización Los clientes que ya tienen dispositivos Shelly quieren añadir EcoFlow sin sustituir su capa existente de hogar inteligente o distribución energética.

3. Usuarios finales plug-and-play Los clientes quieren empezar con dispositivos Shelly tipo enchufe sencillos y evolucionar con el tiempo hacia un sistema energético EcoFlow más amplio.

La oportunidad no consiste únicamente en admitir uno o dos accessories con marcas compartidas. La oportunidad más amplia es ofrecer compatibilidad con Shelly basada en capacidades: EcoFlow detecta el dispositivo Shelly, comprende las capacidades disponibles y las integra en la experiencia de energy-management de EcoFlow.

Shelly ya forma parte del ecosistema de EcoFlow

EcoFlow y Shelly ya están conectados públicamente. El punto importante es que esta relación existe, pero la compatibilidad actual a nivel de producto parece más limitada de lo que los instaladores necesitan en proyectos reales.

Las pruebas visibles públicamente incluyen:

• Referencias de producto EcoFlow x Shelly Smart Plug / Plug S Gen3.

• Referencias al contador inteligente EcoFlow x Shelly Pro 3EM.

• Material de EcoFlow STREAM que describe la compatibilidad con contadores inteligentes.

• Material de EcoFlow OASIS que hace referencia a dispositivos de terceros compatibles con los protocolos de Shelly.

• Material de EcoFlow PowerInsight que menciona enchufes inteligentes Shelly y Shelly 3EM / Shelly Pro 3EM como dispositivos de terceros.

• Material de soporte de Shelly que menciona EcoFlow como plataforma de terceros que integra dispositivos Shelly.

Esta es una base sólida. El problema no es si EcoFlow y Shelly deben estar juntos. El problema es el nivel de integración.

Dirección pública confirmada

La dirección confirmada es que EcoFlow valora la integración de dispositivos de terceros y la compatibilidad con Shelly. Esto coincide con el mensaje más amplio de EcoFlow sobre energy-management: una sola plataforma, supervisión energética gestionada desde la aplicación y una experiencia más sencilla para el usuario.

El posicionamiento público de OASIS es especialmente importante porque describe la integración de dispositivos entre plataformas como parte de la experiencia de energy-management de EcoFlow. Ahí es precisamente donde Shelly puede contribuir: supervisión y control a nivel de dispositivo, conectados de nuevo a las decisiones energéticas de EcoFlow.

Problema práctico actual

El problema práctico es sencillo:

> Los instaladores y los clientes no pueden ver ni añadir de forma fiable dispositivos Shelly más recientes en el flujo de EcoFlow.

Esto crea un ciclo de planificación:

• Los instaladores quieren especificar EcoFlow + Shelly.

• Necesitan tener la certeza de que los dispositivos Shelly serán visibles y compatibles.

• La integración actual no muestra de forma fiable los dispositivos Shelly modernos.

• Como los dispositivos no son visibles, los instaladores no pueden planificar soluciones completas.

• Al no estar previstas soluciones completas, EcoFlow pierde una vía práctica hacia escenarios profesionales, de modernización y plug-and-play.

Compatibilidad confirmada actual frente a compatibilidad deseada

El artículo debe separar dos aspectos:

Compatibilidad pública actual

La compatibilidad pública actual debe describirse con cuidado y vincularse a las páginas de productos de EcoFlow/Shelly y a las páginas de dispositivos compatibles que sean visibles.

Elementos confirmados o visibles públicamente:

• EcoFlow x Shelly Smart Plug / Plug S Gen3

• EcoFlow x Shelly Pro 3EM

• Enchufes inteligentes Shelly y medidores Shelly incluidos en el material de energy-management/dispositivos de EcoFlow

Compatibilidad deseada

La dirección deseada es más amplia:

• Admite todos los dispositivos Shelly según sus capacidades, de forma similar a la dirección que ha adoptado Victron.

• Utiliza las API estándar de Shelly para evitar integraciones específicas para cada dispositivo.

• Detecta capacidades como interruptor, medidor, entrada, relé, sensor y salida multicanal.

• Deja que EcoFlow decida qué capacidades son relevantes en el contexto energético.

Esto no significa que todos los dispositivos Shelly deban aparecer como el mismo tipo de carga. Significa que EcoFlow debería desarrollar la integración en torno al modelo de capacidades de Shelly.

Coexistencia de aplicaciones

EcoFlow y Shelly Smart Control deberían seguir existiendo.

El modelo esperado:

• La aplicación de EcoFlow muestra el sistema energético completo.

• La aplicación de EcoFlow orquesta las decisiones energéticas.

• Shelly Smart Control detecta y gestiona los dispositivos Shelly.

• Shelly Smart Control sigue siendo útil para la configuración y el diagnóstico a nivel de dispositivo.

Este no es un modelo de aplicaciones excluyente.

EcoFlow ofrece la perspectiva del sistema energético. Shelly Smart Control ofrece la perspectiva de los dispositivos Shelly.

Filosofía de control

EcoFlow debería iniciar y controlar el flujo de orquestación energética porque el usuario parte de EcoFlow al planificar el comportamiento energético. Shelly debería actuar como capa distribuida de control y medición.

El principio:

• EcoFlow gestiona la producción y el almacenamiento de energía.

• Shelly gestiona la redistribución, el control y la supervisión a nivel del dispositivo o de la carga.

• EcoFlow decide el objetivo energético.

• Shelly ejecuta y mide en el extremo.

La integración no debería enfrentarse al usuario en silencio. Si un usuario controla un dispositivo Shelly desde Shelly Smart Control o mediante una entrada física, EcoFlow no debería anular inmediatamente al usuario sin dar explicaciones. Si EcoFlow debe imponer un estado por motivos de seguridad, tarifa, respaldo, límites del inversor o energy-management, esto debería hacerse de forma explícita y basada en modos.

Cómo se compara EcoFlow con Victron en la integración con Shelly

Esta comparación es intencionadamente limitada. Compara únicamente el comportamiento de la integración con Shelly. No compara la calidad de las baterías, la calidad de los inversores, la estrategia de la empresa ni la calidad general de los productos.

La comparación se mantiene intencionadamente en forma de tabla para que siga siendo precisa y fácil de actualizar.

Conclusión principal de la comparación

Victron demuestra que es posible una integración más amplia de Shelly. EcoFlow no necesita copiar la arquitectura de Victron, pero debería aprender del principio de integración:

• el descubrimiento debería ser fiable;

• deberían admitirse las generaciones modernas de Shelly;

• las capacidades de los devices deberían mapearse en lugar de codificarse mediante listas de modelos antiguos;

• el control manual debería coexistir con la automatización energética;

• Los instaladores profesionales necesitan un modelo de planificación predecible.

Para EcoFlow, esto es especialmente importante porque el primer punto de contacto es la aplicación. Si la aplicación no puede ver los devices Shelly modernos, el instalador no puede pasar del concepto a una solución implementada.

Problemas conocidos de la integración actual

Esta sección describe los bloqueos y riesgos actuales basados en comentarios reales de instaladores y en la instalación alemana probada.

Problema 1 - Los devices Shelly new no aparecen

Comportamiento observado:

• El Shelly Plug S Gen3 no apareció.

• El Shelly Plug S Gen4 no apareció.

• Los devices Shelly 1 Gen4 no aparecieron.

• Aparecieron principalmente devices Shelly antiguos.

Impacto:

• Los instaladores no pueden planificar de forma fiable una instalación moderna de EcoFlow + Shelly.

• Los clientes con devices Shelly new no pueden usarlos dentro del flujo de EcoFlow.

• La integración parece desactualizada, aunque las API de Shelly son estándar y modernas y hay disponibles familias de dispositivos nuevas.

Solución recomendada:

• Pasar de la compatibilidad basada en listas de modelos al descubrimiento basado en capacidades.

• Mantener la compatibilidad con las familias de dispositivos Gen3/Gen4.

• Exponer una matriz clara de devices compatibles y capacidades compatibles.

Problema 2 - El método de descubrimiento no está claro

El método de descubrimiento actual de EcoFlow se desconoce externamente.

Posibles métodos que podrían utilizarse:

• Descubrimiento/aprovisionamiento mediante Bluetooth

• Aprovisionamiento mediante punto de acceso Wi-Fi

• Escaneo de IP de la LAN

• Descubrimiento mediante mDNS

• Importación desde la cuenta o la nube de Shelly

• Añadir IP manualmente

• Método combinado

Impacto:

• Los instaladores no saben cómo solucionar los fallos de descubrimiento.

• Los problemas de red no pueden separarse de los problemas de la lista de compatibilidad.

• Los clientes no pueden entender por qué aparecen algunos dispositivos y otros no.

Solución recomendada:

• Hacer visible el comportamiento del descubrimiento.

• Mostrar el estado y el método de escaneo.

• Permitir reintentar.

• Permitir añadir la IP manualmente para usuarios e instaladores avanzados.

• Usar mDNS y el escaneo de IP para instalaciones existentes.

• Usar BLE o el punto de acceso Wi-Fi para devices nuevos no aprovisionados.

Problema 3 - La compatibilidad es demasiado limitada para la planificación

La propuesta pública de EcoFlow/Shelly es prometedora, pero si la compatibilidad práctica se limita a un pequeño número de productos antiguos o de marca compartida, los instaladores no pueden diseñar sistemas completos.

Impacto:

• Las instalaciones profesionales no pueden especificarse con confianza.

• Las instalaciones adaptadas no pueden reutilizar las flotas de devices Shelly existentes.

• Los usuarios plug-and-play no pueden ampliar el sistema de forma natural.

Solución recomendada:

• Publicar una matriz de compatibilidad por capacidad y generación.

• Compatibilidad con dispositivos Shelly Pro para nuevas instalaciones.

• Compatibilidad con dispositivos Shelly existentes para adaptaciones.

• Compatibilidad con dispositivos enchufables para usuarios finales.

Problema 4 - La coexistencia del control manual debe ser clara

El control debe ser posible desde ambos sistemas:

• aplicación de EcoFlow

• Shelly Smart Control

• entrada/botón físico cuando sea compatible

• API local de Shelly cuando la utilicen instaladores avanzados

Impacto si no se resuelve:

• Los usuarios pueden sentir que EcoFlow «rompe» sus devices Shelly.

• Las homes existentes con Shelly son más difíciles de adaptar.

• Los controles físicos se vuelven confusos.

Solución recomendada:

• Modelo de control cooperativo.

• Prioridad clara de las reglas energéticas.

• Motivo visible cuando EcoFlow aplica un estado.

• Anulación basada en el modo solo cuando sea necesario.

Problema 5 - La lógica de integración existe externamente, pero no de forma nativa

En la instalación probada, un único archivo JavaScript de Shelly que utiliza la API de EcoFlow puede gestionar el equilibrado de potencia. Esto demuestra que la lógica es técnicamente posible.

El problema es la propiedad del producto:

• La lógica no debe residir en un script personalizado oculto.

• Debe estar integrada en EcoFlow, donde el cliente espera que se tomen las decisiones energéticas.

Solución recomendada:

• Trasladar la lógica de equilibrado validada a la capa de automatización nativa de EcoFlow.

• Usar Shelly devices como puntos de ejecución y medición.

Oportunidad de negocio

La combinación de EcoFlow + Shelly puede ofrecer a instaladores y socios una propuesta más clara de energía inteligente.

EcoFlow conoce:

• generación solar;

• estado de la batería;

• comportamiento del almacenamiento;

• importación/exportación de la red;

• contexto de tarifas o de Time-of-Use;

• modo de respaldo;

• límites del sistema;

• objetivos energéticos.

Shelly devices conocen:

• consumo a nivel de dispositivo;

• consumo a nivel de circuito;

• mediciones por fase;

• estado del relé;

• estado de la entrada física;

• comportamiento de la carga local;

• potencia del enchufe inteligente;

• estado distribuido de los dispositivos.

En conjunto, el sistema puede mejorar el autoconsumo, priorizar las cargas, evitar importaciones o exportaciones innecesarias, controlar electrodomésticos grandes y hacer visible al cliente el comportamiento energético.

Perfil 1: nuevas instalaciones profesionales

Las nuevas instalaciones profesionales son el caso más sólido para los dispositivos Shelly Pro.

Dispositivos Shelly relevantes:

• Shelly Plug S Gen4

• Shelly Pro 3EM

• dispositivos de relé Shelly Pro

• dispositivos Shelly Pro PM

• relés/contactores controlados mediante Shelly

• futuros dispositivos Shelly Pro

Cargas habituales:

• calentador de agua;

• bomba de calor;

• cargador de vehículos eléctricos;

• bomba de piscina;

• circuitos de respaldo/no críticos;

• electrodomésticos grandes.

Por qué EcoFlow ofrece ventajas:

• Los instaladores pueden diseñar una solución completa de energy-management.

• Shelly proporciona medición y control a nivel de circuito.

• EcoFlow sigue siendo el cerebro energético.

• La instalación resulta más fácil de explicar al cliente.

Perfil 2: modernización de homes Shelly existentes

Muchos clientes ya tienen dispositivos Shelly instalados antes de comprar EcoFlow. Es posible que ya utilicen Shelly para lighting, heating, bombas, enchufes, relés, sensors y medición energética.

Para estos clientes, EcoFlow no debería exigir la sustitución de la capa de dispositivos existente.

El flujo ideal:

1. El cliente añade el sistema EcoFlow. 2. EcoFlow detecta o importa los dispositivos Shelly existentes. 3. EcoFlow asigna los dispositivos útiles a categorías energéticas. 4. Las rutinas existentes de la aplicación Shelly siguen funcionando. 5. EcoFlow añade inteligencia energética.

Por qué EcoFlow ofrece ventajas:

• Menos barreras para la adopción.

• Mayor confianza del cliente.

• Una propuesta de modernización más atractiva.

• Menos desperdicio de hardware.

• Entrega más rápida por parte del instalador.

Perfil 3: usuarios finales plug-and-play

Los usuarios que buscan una instalación plug-and-play necesitan dispositivos sencillos y un lenguaje sencillo.

Dispositivos Shelly relevantes:

• Dispositivos probados/disponibles:

• Shelly Plug S Gen3

• otros dispositivos de enchufe compatibles

Cargas habituales:

• calefactor;

• fan;

• deshumidificador;

• lavadora;

• calentador de agua pequeño;

• equipos de office;

• cargas de electrodomésticos.

Por qué EcoFlow ofrece ventajas:

• Un usuario puede empezar poco a poco.

• El cliente ve el impacto energético de inmediato.

• El mensaje de la aplicación es sencillo: «Usa más energía solar propia».

• El sistema puede crecer desde el control de enchufes hasta una instalación energética completa de EcoFlow.

Casos de uso compatibles

Todos estos casos de uso son relevantes en las regiones y para los perfiles objetivo:

Calentador de agua con excedente solar

Cuando hay excedente solar disponible, EcoFlow puede activar un calentador de agua controlado por Shelly. Cuando disminuye el excedente o cambia la prioridad de la batería, EcoFlow puede pausar o detener la carga.

Cargador de vehículos eléctricos / control de cargas grandes

EcoFlow puede coordinar las cargas grandes según la energía solar disponible, el SOC de la batería, los límites de importación de la red y los requisitos de respaldo.

Bomba de calor

Las bombas de calor pueden programarse o activarse en función de la disponibilidad energética, las franjas tarifarias y las condiciones de confort.

Bomba de piscina

Las bombas de piscina son cargas flexibles adecuadas. EcoFlow puede trasladar su funcionamiento a periodos con abundante energía solar o tarifas bajas.

Control de electrodomésticos mediante enchufes inteligentes

Los enchufes inteligentes son la prueba visible más sencilla del valor para los usuarios finales.

Monitorización trifásica

Shelly Pro 3EM y los medidores relacionados pueden proporcionar visibilidad a nivel de fase. Esto es importante en instalaciones profesionales y para diagnosticar problemas de cableado o desequilibrios de carga.

Prioridad de cargas en modo de respaldo / isla

Cuando la energía de respaldo es limitada, EcoFlow puede utilizar relés controlados por Shelly para desconectar cargas no críticas y conservar la autonomía de la batería.

Programación de tarifas / franjas horarias de uso

Las cargas pueden trasladarse a periodos de bajo coste o con abundante energía solar.

Conclusión empresarial

La oportunidad de hacer que EcoFlow sea más fácil de elegir.

La amplia compatibilidad con Shelly ofrece a EcoFlow:

• una historia más sólida para instaladores;

• una historia más sólida de modernización;

• una historia más sólida de plug-and-play;

• una historia más sólida del ecosistema de aplicaciones;

• una vía creíble hacia la gestión distribuida de la energía.

El obstáculo no es la falta de API de Shelly. El obstáculo es el nivel actual de integración.

Equipo de integración

Descripción general de la integración de EcoFlow con Shelly

Esta sección explica qué funciona, qué no funciona y qué debe corregirse para ofrecer una experiencia fluida al instalador.

Sistema de prueba utilizado para esta evaluación

solar:

• Alemania

Red:

• Red IP local estándar

• router TP-Link

Sistema EcoFlow:

• batería EcoFlow STREAM Ultra

• paneles solares

devices Shelly disponibles/probados:

• Dispositivos probados/disponibles:

• Shelly Plug S Gen3

• Shelly Plug S Gen4

• Shelly Pro 3EM

• Shelly EM-50

varios dispositivos Shelly 1 Gen4

• 1.5.7

• 2.0.0

Problema observado en la aplicación de EcoFlow:

• No se mostraron los devices Shelly new Gen3 y Gen4.

• Aparecieron algunos devices Shelly antiguos.

Solución alternativa personalizada funcional:

• Un archivo JavaScript de Shelly que utilice la API de EcoFlow puede gestionar el equilibrio de potencia.

Dirección de producto deseada:

• La lógica de equilibrio y control debería residir dentro de EcoFlow.

• Shelly debería proporcionar la capa de medición y control.

Cómo debería funcionar el descubrimiento de devices

Actualmente se desconoce desde el exterior el método de descubrimiento de EcoFlow. El artículo no debe afirmar un método específico actual a menos que EcoFlow lo confirme.

Lo importante es la arquitectura de descubrimiento deseada.

aplicación de EcoFlow | +-- device Shelly new | +-- descubrimiento mediante Bluetooth | +-- configuración mediante punto de acceso Wi-Fi | +-- lectura de capacidades | +-- asignación de funciones de EcoFlow | +-- instalación Shelly existente | +-- descubrimiento mediante mDNS | +-- escaneo de IP de la LAN | +-- adición manual de IP | +-- importación opcional de la cuenta o la nube de Shelly | +-- lectura de capacidades | +-- asignación de funciones de EcoFlow | +-- capa energética de EcoFlow +-- función de medidor +-- función de carga controlable +-- función de solo monitorización +-- función de prioridad de respaldo 

Ruta de descubrimiento 1 - Bluetooth

Bluetooth es útil para devices new cerca del instalador.

Más adecuado para:

• devices nuevos de fábrica;

• configuración inicial;

• usuarios plug-and-play;

• incorporación sencilla.

Limitaciones:

• no es ideal para instalaciones existentes grandes;

• el instalador puede tener que situarse cerca de cada device;

• no es eficiente para docenas de devices Shelly;

• puede generar fricción si es la única ruta predeterminada.

Ruta de descubrimiento 2 - configuración mediante punto de acceso Wi-Fi

la configuración mediante el punto de acceso Wi-Fi es útil cuando un device Shelly aún no está conectado a la red del cliente.

Más adecuado para:

• configuración de devices new;

• usuarios plug-and-play;

• instalaciones en las que el device aún está recién salido de fábrica.

Limitaciones:

• redundante para devices ya conectados a la LAN;

• puede ser lento para instalaciones profesionales;

• puede fallar si la actualización de la lista de Wi-Fi o la gestión de credenciales es deficiente.

Ruta de descubrimiento 3 - escaneo de IP de la LAN

el escaneo de IP de la LAN es útil para devices ya instalados en la red local.

Más adecuado para:

• instalaciones de modernización;

• homes Shelly existentes;

• instalaciones profesionales con rangos de red conocidos;

• casos en los que mDNS no es fiable.

Limitaciones:

• puede ser lento en redes grandes;

• puede requerir permisos del firewall;

• puede requerir limitar la velocidad;

• puede requerir seleccionar manualmente la subred.

Ruta de detección 4 - mDNS

mDNS es útil porque los devices Shelly pueden anunciarse en la red.

Más adecuado para:

• detección en la misma LAN;

• devices existentes;

• experiencia de usuario automática de «new device found»;

• detección en segundo plano.

Limitaciones:

• las VLAN y el filtrado multicast pueden bloquearlo;

• el aislamiento de Wi-Fi puede interrumpirlo;

• los routers pueden limitar el tráfico multicast;

• los escaneos repetidos pueden no detectar algunos devices.

Ruta de detección 5 - flujo de detección combinado

La ruta recomendada es un flujo combinado.

La aplicación debería admitir:

1. Detección mDNS para devices ya conectados. 2. Escaneo de IP como alternativa. 3. Bluetooth o punto de acceso Wi-Fi para devices nuevos. 4. Introducción manual de IP para instaladores avanzados. 5. Importación opcional de la cuenta o la nube de Shelly para flotas adaptadas, si se admite comercialmente.

Esto es importante porque EcoFlow atiende a varias personas:

• new installations;

• homes con adaptación de instalaciones;

• usuarios finales plug-and-play.

Un solo método de detección no puede atender bien los tres casos.

Problemas de incorporación conocidos observados en una instalación real

Problema 1 - Los devices Shelly Gen3/Gen4 nuevos no aparecen

Observación:

• El Shelly Plug S Gen3 no apareció.

• El Shelly Plug S Gen4 no apareció.

• Los devices Shelly 1 Gen4 no aparecieron.

• Aparecieron principalmente devices antiguos.

Impacto:

• Las familias modernas de devices Shelly no se pueden planificar con confianza.

• Los instaladores no pueden especificar soluciones EcoFlow + Shelly.

• Los clientes que ya compraron devices Shelly más nuevos no pueden usarlos en EcoFlow.

Solución recomendada:

• Actualizar la compatibilidad de los devices para Gen3/Gen4.

• Pasar a un sistema de compatibilidad basado en capacidades.

• No depender únicamente de listas antiguas de modelos.

Problema 2 - El usuario no puede distinguir un fallo de red de un fallo de compatibilidad

Observación:

• Cuando un device no aparece, no queda claro si la causa es la detección de red, el firmware, una generación no compatible, un modelo no compatible o la lógica de la aplicación.

Impacto:

• Los instaladores no pueden solucionar problemas rápidamente.

• Los clientes pierden la confianza en la integración.

Solución recomendada:

• Mostrar el método de escaneo.

• Mostrar el progreso del escaneo.

• Mostrar sugerencias para solucionar problemas.

• Permitir probar manualmente la IP.

• Registrar los intentos de detección de devices.

Problema 3 - Las instalaciones existentes no se tratan como una prioridad

Observación:

• El caso más importante de adaptación es una instalación Shelly existente.

• Si EcoFlow espera únicamente un flujo limitado de accessory compatible, adaptar instalaciones existentes se vuelve difícil.

Impacto:

• EcoFlow pierde clientes que ya tienen Shelly.

• Los instaladores no pueden vender EcoFlow como una actualización para un home inteligente.

Solución recomendada:

• Añadir una ruta de «existing Shelly devices».

• Importar y mostrar los devices ya instalados.

• Conservar los nombres asignados por el usuario.

• Permitir asignar el rol del device.

Problema 4 - Los nombres de los devices deben ser fáciles de usar

Observación:

• Los instaladores y clientes necesitan que los devices se muestren con nombres significativos, no solo con códigos de modelo.

Impacto:

• Diez enchufes idénticos se vuelven imposibles de identificar.

• Los devices multicanal resultan confusos.

Solución recomendada:

• Leer el nombre asignado por el usuario al device Shelly.

• Leer los nombres de los canales cuando estén disponibles.

• Permitir cambiar los nombres dentro de EcoFlow sin modificar los nombres de la aplicación Shelly.

Problema 5 - El comportamiento del control manual debe ser explícito

Observación:

• Los usuarios deberían poder controlar los devices Shelly tanto desde EcoFlow como desde Shelly Smart Control.

Impacto:

• Si EcoFlow anula silenciosamente el control de Shelly/manual, la experiencia del usuario empeora.

Solución recomendada:

• Modelo de control cooperativo.

• Reglas energéticas mostradas claramente.

• Anulación manual mostrada en la aplicación.

• Las anulaciones de seguridad o de respaldo deberían basarse en modos y explicarse.

Arquitectura del sistema

Componentes de hardware

Componentes EcoFlow incluidos:

• batería EcoFlow STREAM Ultra

• paneles solares

• EcoFlow PowerStream

• DELTA + Smart Home Panel

• aplicación de EcoFlow

• EcoFlow OASIS / PowerInsight cuando corresponda

Componentes Shelly incluidos:

• Dispositivos probados/disponibles:

• Shelly Plug S Gen3

• Shelly Plug S Gen4

• Shelly Pro 3EM

• Shelly 1 Gen4

• dispositivos Shelly Pro

• relés y contactores Shelly

• sensores Shelly cuando resulten útiles para futuras lógicas energéticas

Conectividad

Conocido a partir de la configuración probada:

• red IP local estándar;

• router TP-Link;

• EcoFlow STREAM Ultra con paneles solares;

• dispositivos Shelly en la red local.

Desconocido / por confirmar:

• método exacto de detección de EcoFlow a Shelly;

• si EcoFlow utiliza comunicación local, en la nube o híbrida con los dispositivos;

• si EcoFlow puede importar dispositivos mediante la autorización de la cuenta de Shelly;

• si EcoFlow puede utilizar directamente las API locales de Shelly;

• si está disponible la adición manual de IP;

• si se utiliza mDNS.

Modelo de aplicación

Modelo de aplicación previsto:

• La aplicación de EcoFlow es la aplicación del sistema energético.

• Shelly Smart Control sigue siendo la aplicación para dispositivos Shelly.

• Ambas aplicaciones coexisten.

• EcoFlow ve la imagen energética completa.

• Shelly Smart Control detecta los dispositivos Shelly.

Modelo de control

Modelo de control previsto:

• EcoFlow establece objetivos energéticos.

• Los dispositivos Shelly ejecutan el control local.

• Los dispositivos Shelly notifican el estado y las mediciones a nivel del dispositivo.

• Se permite el control manual.

• EcoFlow solo anula el control manual cuando existe una regla energética clara o un motivo de seguridad.

Lo que funciona actualmente mediante scripts personalizados de Shelly

Controlador JavaScript de Shelly | +-- lecturas RPC locales de Shelly | +-- EM1.GetStatus -> act_power | +-- Switch.GetStatus -> apower | +-- agregar la carga total medida | +-- API en la nube firmada de EcoFlow | +-- leer el estado de STREAM Ultra | +-- escribir parámetros de control de STREAM Ultra | +-- Lógica de decisión +-- ventana nocturna -> cargar +-- carga diurna por encima del umbral -> descargar +-- carga diurna por debajo o igual al umbral -> inactividad 

La solución temporal personalizada actual demuestra que la lógica de integración es técnicamente posible hoy. La implementación real se encuentra en:

load_balancing_static.shelly.js 

También existe una variante de Virtual Components orientada a producción:

load_balancing_static_vc.shelly.js 

El escenario real utiliza load_balancing_static.shelly.js. Se ejecuta directamente en un dispositivo Shelly y cierra el circuito entre las mediciones locales de Shelly y el control de EcoFlow STREAM Ultra mediante la API en la nube de EcoFlow.

El script combina:

• SOC de la batería EcoFlow;

• producción fotovoltaica de EcoFlow;

• importación/exportación de la red o estado de balance;

• potencia de carga cuando está disponible;

• mediciones locales de Shelly EM / Plug S;

• comandos firmados de la API de EcoFlow;

• lógica de carga nocturna;

• lógica de descarga cuando la carga total medida está por encima del umbral;

• lógica de inactividad cuando la carga está por debajo del umbral.

Esto es importante porque cambia el enfoque de la conversación. La cuestión no es «¿Se puede hacer?». La respuesta es sí. La verdadera pregunta es dónde debería residir la lógica.

La respuesta debería ser:

> La lógica debería residir dentro de EcoFlow.

La programación de Shelly es potente, pero un script personalizado no es la capa de producto adecuada a largo plazo para clientes y técnicos instaladores habituales.

Por qué es importante la solución alternativa

La solución alternativa demuestra:

• Los datos de EcoFlow pueden utilizarse para tomar decisiones de equilibrado.

• Los dispositivos Shelly pueden proporcionar datos de medición locales y rápidos.

• El control distribuido de la carga es práctico.

• El comportamiento principal del producto puede prototiparse fuera de EcoFlow.

• Un dispositivo Shelly puede actuar como puente sin un servidor externo.

• STREAM Ultra de EcoFlow puede controlarse mediante la API de EcoFlow desde un script de Shelly.

Comportamiento real del script

El script estático tiene tres modos de funcionamiento:

El patrón de configuración predeterminado es:

var CONFIG = { accessKey : "YOUR_ACCESS_KEY", secretKey : "YOUR_SECRET_KEY", serial : "YOUR_DEVICE_SERIAL", region : "eu", nightStart : 23, nightEnd : 6, nightSoc : 95, threshold : 600, pollMs : 5000 }; 

Los dispositivos de medición Shelly configurados son entradas de IP/host estáticas:

var DEVICES_CFG = [ { type: "em", host: "192.168.1.10", channel: 0, name: "EM principal canal 0" }, { type: "em", host: "192.168.1.10", channel: 1, name: "EM principal canal 1" }, { type: "plug", host: "192.168.1.20", channel: 0, name: "Enchufe sur" } ]; 

Para las mediciones de Shelly, el script utiliza RPC local:

• EM1.GetStatus para los canales de medidor de estilo Shelly EM Gen4, leyendo act_power;

• Switch.GetStatus para los canales de enchufe de estilo Shelly Plug S Gen3, leyendo apower.

Para el control de EcoFlow, el script utiliza:

• GET /iot-open/sign/device/quota/all?sn= para leer el estado de STREAM Ultra;

• PUT /iot-open/sign/device/quota para enviar cambios de configuración/despacho de STREAM Ultra.

Las solicitudes a la API de EcoFlow se firman dentro del script de Shelly mediante HMAC-SHA256 con:

• accessKey;

• secretKey;

• nonce;

• marca de tiempo;

• parámetros de solicitud ordenados;

• firma encabezado.

Esto es importante: la prueba de concepto no requiere un portátil, Home Assistant, ioBroker, Cloudflare Worker ni otro servidor. Es un puente alojado en Shelly entre la medición local de Shelly y el control de EcoFlow en la nube.

Por qué la solución alternativa no es suficiente

La solución alternativa no es suficiente porque:

• está oculto para los usuarios habituales;

• requiere conocimientos técnicos;

• no es un flujo de trabajo oficial para instaladores;

• es difícil ofrecer compatibilidad a nivel global;

• no resuelve el descubrimiento en la aplicación;

• no proporciona a EcoFlow una experiencia de producto completa;

• no resuelve la confianza en la lista de compatibilidad.

• la configuración de IP estática no resuelve el descubrimiento ni la puesta en servicio a gran escala;

• las credenciales deben estar integradas en el script;

• El comportamiento de la API, los límites de solicitudes y la gestión de errores necesitan compatibilidad a nivel de producto.

Conclusión del producto

EcoFlow debe integrar la lógica comprobada en la aplicación y en la capa de energy-management.

Shelly debe seguir siendo la capa distribuida de dispositivos.

Notas sobre la configuración en condiciones reales

País y mercado

El contexto de prueba confirmado es Alemania. Las regiones objetivo son más amplias:

• UE

• Reino Unido

• Australia

• África

• relevancia global donde se venden EcoFlow y Shelly

El conjunto de test utilizó una combinación de estas versiones de firmware en los dispositivos Shelly. No se registró la correspondencia exacta entre firmware y modelo, por lo que no debe afirmarse.

La red probada es una red IP local estándar con un router TP-Link.

Preguntas importantes sobre la red para futuras pruebas:

• ¿Funciona el descubrimiento en una LAN plana?

• ¿Funciona el descubrimiento entre VLAN?

• ¿Depende el descubrimiento de mDNS?

• ¿Funciona el descubrimiento cuando el multicast está bloqueado?

• ¿Funciona el descubrimiento si los devices Shelly tienen IP estáticas?

• ¿Pueden los instaladores añadir manualmente un device mediante su IP?

Firmware

varios dispositivos Shelly 1 Gen4

• 1.5.7

• 2.0.0

La futura actualización del artículo debería aclarar:

• qué firmware corresponde a cada device Shelly;

• Versiones del firmware/aplicación de EcoFlow;

• si los fallos de Gen3/Gen4 están relacionados con el firmware o con la compatibilidad de la aplicación.

Patrón de comentarios de los instaladores

Este no es solo un problema de una instalación. Instaladores de distintas regiones informan de comentarios similares.

El mensaje recurrente:

• los clientes no pueden ver los devices new Shelly;

• los instaladores no pueden planificar soluciones completas de EcoFlow + Shelly;

• la compatibilidad no es suficientemente predecible;

• la integración debe continuar y profundizarse.

El resumen aprobado de los comentarios de los instaladores es:

• Instaladores de varias regiones informan de que los devices new Shelly no aparecen de forma fiable en el flujo de descubrimiento de EcoFlow.

• En la configuración probada, los devices Shelly Gen3 y Gen4 no aparecieron en el escaneo de EcoFlow.

• Aparecieron algunos devices Shelly antiguos, lo que sugiere una brecha en la lista de descubrimiento/compatibilidad, más que una limitación general de la API de Shelly.

• Esto limita la confianza de los instaladores al planificar, porque no pueden especificar sistemas EcoFlow + Shelly si la visibilidad de los devices no está clara.

• El problema afecta tanto a instalaciones reales como a proyectos planificados.

Regiones afectadas:

• UE

• Reino Unido

• Australia

• África

• Los comentarios globales también son relevantes cuando aparecen patrones similares entre instaladores.

Principal preocupación de los instaladores:

Los instaladores quieren usar EcoFlow como capa de producción y almacenamiento de energía, y Shelly como capa distribuida de medición y control.

El bloqueo actual no es la posibilidad técnica de la integración, sino el nivel de compatibilidad nativa de EcoFlow con el descubrimiento, la visibilidad y el control de Shelly.

Recursos

Recursos de EcoFlow:

• EcoFlow STREAM Ultra:

• EcoFlow PowerStream:

• EcoFlow Smart Home Panel:

• EcoFlow OASIS:

• Lista de devices EcoFlow PowerInsight:

• EcoFlow Developer:

Recursos de Shelly:

• Documentación de la API de Shelly:

• API de integrador de Shelly:

• Artículo sobre integrations de terceros de Shelly:

Archivos de soporte adjuntos:

• load_balancing_static.shelly.js

• load_balancing_static_vc.shelly.js

• README.md

• screenshot.png

• ecoflow-api-notes.md

• installer-feedback-summary.md

No disponible:

• Captura de pantalla de devices Shelly antiguos visibles en EcoFlow. La configuración de test actual no incluye devices Shelly antiguos.

• Captura de pantalla independiente de la lista completa de devices Shelly. La evidencia de test disponible es el resultado del escaneo de EcoFlow de Gen3/Gen4 y las fotos de la instalación y de los devices reales.

Desarrolladores

Descripción general

Esta sección documenta la dirección técnica para hacer que la integración de EcoFlow + Shelly sea lo bastante robusta para instaladores y usuarios finales.

El objetivo es identificar qué enfoques son:

• posible hoy;

• bloqueado por el comportamiento actual del producto;

• adecuado para una propuesta a un partner;

• adecuado para instalaciones reales;

• útil únicamente como solución alternativa personalizada;

• candidatos para una implementación nativa de EcoFlow.

El punto técnico más importante:

> Los devices Shelly no son la parte difícil. Los devices Shelly exponen API estándar. La parte difícil es que EcoFlow convierta en producto las capas de descubrimiento, asignación y control de la energía.

Configuración de test

Esquema de conexión de EcoFlow x Shelly

EcoFlow STREAM Ultra en la configuración de test alemana

• Sistema EcoFlow

• Producto:

• solar:

• País:

• Aplicación:

• Firmware:

Acceso a la api:

• Código fuente del script:

• Script estático del caso real:

• Variante de producción de componentes virtuales:

README:

Dispositivos Shelly

• Dispositivos probados/disponibles:

• Shelly Plug S Gen3

• Shelly Plug S Gen4

• Shelly Pro 3EM

• Shelly EM-50

varios dispositivos Shelly 1 Gen4

• 1.5.7

• 2.0.0

Versiones de firmware mencionadas:

El conjunto de test utilizó una combinación de estas versiones de firmware en los dispositivos Shelly. No se registró la correspondencia exacta entre firmware y modelo, por lo que no debe afirmarse.

• Red IP local estándar

• router TP-Link

• dispositivos Shelly en la LAN/Wi-Fi

• Dispositivo/aplicación EcoFlow en el mismo entorno de usuario

Diseño virtual/de datos para la pantalla de Shelly

La variante de producción load_balancing_static_vc.shelly.js crea componentes virtuales en la aplicación de Shelly. Crea un grupo llamado EcoFlow STREAM Ultra y utiliza componentes numéricos/booleanos para visualizar los datos de EcoFlow y de equilibrado.

Acceso a la api y para developers de EcoFlow

EcoFlow cuenta con una plataforma para developers, y el trabajo público de integrations de terceros y de código abierto indica que los sistemas externos utilizan el acceso a la api en la nube. La solución alternativa probada también utiliza el acceso a la api de EcoFlow desde un controlador JavaScript de Shelly.

El script real ahora proporciona detalles concretos de la api para la ruta de control del STREAM Ultra.

Acceso al portal

Portal:

https://developer.ecoflow.com/us/ 

Conocido por el ecosistema público:

• El acceso para developers está disponible.

• Algunas integrations de terceros utilizan credenciales de la api en la nube.

• La documentación oficial para developers se basa en una aplicación web y puede requerir iniciar sesión y JavaScript.

Para documentar:

• Tipo de account: account de desarrollador de EcoFlow.

• Estado de aprobación del desarrollador: pendiente.

• La clave de acceso y la clave secreta proceden del Portal de desarrolladores de EcoFlow y son obligatorias para el script.

• El número de serie del STREAM Ultra es obligatorio para el script.

• Región de test real: eu.

• El script permite seleccionar la región como eu o us.

Autenticación

El script real firma las solicitudes a la api en la nube de EcoFlow dentro del script de Shelly mediante HMAC-SHA256.

Los encabezados de la solicitud incluyen:

accessKey:  nonce:  timestamp:  sign:  

La firma se construye a partir de:

• parámetros de solicitud aplanados en pares clave/valor;

• cadenas de parámetros ordenadas;

• accessKey;

• nonce;

• marca de tiempo;

• EcoFlow secretKey como clave HMAC.

El script implementa SHA-256 y HMAC-SHA256 directamente en mJS porque el entorno de ejecución de scripts de Shelly no proporciona un asistente de HMAC de alto nivel.

Hosts de la api

El script utiliza hosts de EcoFlow específicos por región:

var ECO_HOSTS = { eu: "https://api-e.ecoflow.com", us: "https://api-a.ecoflow.com" }; 

Puntos de conexión de la api utilizados por el script

Leer todos los valores de cuota/estado de STREAM Ultra:

GET /iot-open/sign/device/quota/all?sn= 

Escribir valores de configuración/control de STREAM Ultra:

PUT /iot-open/sign/device/quota 

El cuerpo de escritura incluye:

{ "sn": "", "cmdId": 17, "cmdFunc": 254, "dirDest": 1, "dirSrc": 1, "dest": 2, "needAck": true, "params": {} } 

Límites de frecuencia

Los límites de frecuencia del servidor de la API oficial de EcoFlow no se documentan aquí. El artículo actual puede documentar los intervalos de implementación utilizados por los scripts.

Distinción importante:

• Se conocen los intervalos del script.

• Aún es necesario confirmar con la documentación de EcoFlow o con la aprobación de un developer los límites del servidor de la API oficial de EcoFlow.

Identificadores de dispositivos

Documentar cómo el script operativo identifica los dispositivos:

• Número de serie de EcoFlow:

• ID del dispositivo:

• Tipo de producto:

• IP/ID de Shelly:

Datos clave y puntos de control

El script personalizado operativo demuestra que los siguientes datos/acciones son útiles.

Datos de EcoFlow

Datos de Shelly

Acciones de control

Modos de funcionamiento y señales de automatización

EcoFlow debería exponer el control de Shelly de forma diferente según el modo.

Modo de autoconsumo

Objetivo:

• maximizar el uso de la energía solar generada localmente;

• reducir la importación/exportación de la red según se desee;

• utilizar las cargas flexibles cuando haya energía disponible.

Comportamiento de Shelly:

• encender las cargas de enchufes inteligentes cuando haya excedente disponible;

• activar relés/contactores para el calentador de agua o la bomba de la piscina;

• pausar las cargas cuando la batería necesite prioridad;

• supervisar el consumo de los electrodomésticos.

Modo de tarifa / uso por periodos

Objetivo:

• desplazar las cargas flexibles a intervalos de bajo coste;

• evitar utilizar cargas grandes durante los periodos de coste elevado;

• coordinar la carga y descarga de la batería con la tarifa.

Comportamiento de Shelly:

• programar el calentador de agua;

• programar el apoyo de la bomba de calor;

• controlar la bomba de la piscina;

• retrasar las cargas de los electrodomésticos cuando sea práctico.

Modo de respaldo / reserva

Objetivo:

• preservar la capacidad de la batería;

• mantener disponibles los circuitos críticos;

• desconectar las cargas no críticas.

Comportamiento de Shelly:

• apagar las cargas no críticas;

• desactivar el cargador de vehículos eléctricos o el calentador de agua;

• mantener visibles las cargas críticas;

• permitir el control manual de emergencia únicamente con una advertencia clara.

Modo isla / corte de suministro

Objetivo:

• proteger la capacidad limitada de respaldo;

• evitar la sobrecarga del inversor;

• priorizar las cargas esenciales.

Comportamiento de Shelly:

• desconectar las cargas grandes no críticas;

• secuenciar las cargas en lugar de activarlas todas a la vez;

• evitar picos simultáneos de cargas grandes;

• mostrar al usuario por qué una carga está bloqueada.

Modo manual

Objetivo:

• permitir el control del usuario.

Comportamiento de Shelly:

• la aplicación de Shelly y el control físico siguen siendo utilizables;

• EcoFlow supervisa el resultado;

• EcoFlow solo interviene si una regla energética o un modo de seguridad lo requiere.

Base de la API de Shelly

Las API estándar de Shelly son la razón por la que esta integración debería ser amplia, no limitada.

Los devices Shelly exponen conceptos comunes:

• estado del device;

• estado del componente;

• estado del interruptor;

• datos del medidor;

• estado de entrada;

• configuración;

• HTTP/RPC local;

• WebSocket/RPC;

• MQTT cuando esté configurado;

• scripts en devices compatibles;

• API en la nube o del integrador, cuando corresponda.

Asignación basada en capacidades

EcoFlow no debería tener que tratar cada modelo de Shelly como un proyecto de integración independiente.

En su lugar:

1. Detectar el device Shelly. 2. Leer las capacidades del device y de sus componentes. 3. Identificar los componentes: - interruptor - medidor - entrada - sensor - canal de relé - regulador de intensidad 4. Asignar los componentes a funciones energéticas de EcoFlow: - carga inteligente - medidor de toda la vivienda - medidor de circuito - relé controlable - carga con prioridad de respaldo - device de solo monitorización 5. Permitir que el usuario o instalador asigne la función y la prioridad.

devices multicanal

Los devices multicanal no deberían convertirse en un único device genérico.

Ejemplo de comportamiento:

• Shelly Pro 4PM debería exponer cada canal.

• Cada canal debería tener un nombre.

• Cada canal debería poder asignarse a una carga.

• Cada canal debería tener su propio estado de alimentación y medición, cuando estén disponibles.

Nombres de los devices

EcoFlow debería utilizar nombres fáciles de entender:

• nombre del dispositivo;

• nombre del canal;

• habitación/ubicación cuando esté disponible;

• nombre de Shelly asignado por el usuario.

Esto es fundamental para las instalaciones de modernización.

Opciones de descubrimiento local

Inicio: Añadir dispositivo Shelly en EcoFlow | +-- ¿El dispositivo es new / aún no está conectado a Wi-Fi? | +-- sí -> configuración mediante Bluetooth o punto de acceso Wi-Fi | +-- no -> continuar | +-- ¿El dispositivo ya está en la misma LAN? | +-- sí -> mDNS + escaneo de IP en la LAN | +-- no -> IP manual, escaneo de subred o importación de la cuenta | +-- EcoFlow lee las capacidades de Shelly | +-- El instalador/usuario asigna la función energética +-- medidor +-- carga controlable +-- relé/contactor +-- solo monitorización +-- prioridad de respaldo 

Flujo para dispositivos nuevos

Mejores métodos de descubrimiento:

• Bluetooth;

• Configuración mediante punto de acceso Wi-Fi;

• Copia de seguridad mediante QR/manual cuando esté disponible.

Flujo:

1. El usuario abre la aplicación de EcoFlow. 2. El usuario selecciona «Añadir dispositivo Shelly». 3. EcoFlow detecta un dispositivo Shelly cercano. 4. EcoFlow configura el Wi-Fi si es necesario. 5. EcoFlow lee las capacidades del dispositivo. 6. El usuario asigna la función energética.

Flujo para instalaciones existentes

Mejores métodos de descubrimiento:

• mDNS;

• escaneo de IP en la LAN;

• añadir IP manualmente;

• importación opcional desde la cuenta/la nube.

Flujo:

1. El instalador selecciona «Usar devices de Shelly existentes». 2. EcoFlow escanea la red. 3. EcoFlow muestra los dispositivos descubiertos por nombre de usuario. 4. EcoFlow destaca las capacidades compatibles. 5. El instalador asigna las funciones. 6. EcoFlow valida el control y la medición.

Flujo avanzado para instaladores

Mejores métodos de descubrimiento:

• IP manual;

• escaneo de subred;

• importación de JSON;

• Autorización de la cuenta de Shelly si es compatible.

Flujo:

1. El instalador proporciona la IP/subred/account. 2. EcoFlow escanea y lee las capacidades. 3. El instalador asigna los dispositivos a las cargas. 4. EcoFlow guarda el informe de puesta en servicio.

Enfoques de integración investigados

Enfoque 1: Descubrimiento actual mediante la aplicación de EcoFlow

Arquitectura:

Aplicación de EcoFlow -> añadir/descubrir dispositivo Shelly -> aparecen los dispositivos compatibles -> faltan los dispositivos no compatibles/más recientes 

Estado:

• Funcionamiento parcial.

Resultado observado:

• Aparecieron algunos devices Shelly antiguos.

• No aparecieron dispositivos Shelly Gen3/Gen4.

Conclusión:

• La ruta actual de descubrimiento/soporte no es suficiente para una planificación profesional.

Enfoque 2: JavaScript de Shelly + solución alternativa mediante la API de EcoFlow

Arquitectura:

Controlador de JavaScript de Shelly -> lecturas RPC locales de Shelly desde dispositivos EM / Plug S configurados -> agregación de la carga medida -> lecturas de cuota/estado de STREAM Ultra mediante la API en la nube firmada de EcoFlow -> escritura de parámetros de control de STREAM Ultra mediante la API en la nube firmada de EcoFlow -> selección del modo de carga / descarga / inactividad 

Estado:

• Existe una variante estática para casos reales y se utiliza:

• Existe una variante de Virtual Components orientada a producción:

Qué hace:

• Consulta periódicamente los canales de Shelly EM mediante EM1.GetStatus.

• Consulta periódicamente los canales de Shelly Plug S mediante Switch.GetStatus.

• Suma las lecturas de los devices configurados.

• Utiliza la ventana nocturna y la lógica del umbral de carga.

• Envía comandos a EcoFlow STREAM Ultra mediante /iot-open/sign/device/quota.

• Lee el estado de EcoFlow mediante /iot-open/sign/device/quota/all.

Limitación:

• Es demasiado técnico para los clientes habituales.

• No es un flujo de trabajo oficial de EcoFlow.

• No es suficiente para ofrecer soporte global a instaladores.

• La configuración estática requiere editar las direcciones IP, las credenciales y el número de serie en el script.

• Las credenciales de EcoFlow están en el script de Shelly.

• No resuelve los problemas de descubrimiento de la aplicación de EcoFlow ni de las listas de compatibilidad.

Conclusión:

• Demuestra que la lógica es posible.

• Debería convertirse en una funcionalidad nativa de EcoFlow.

Enfoque 3: integración de Shelly basada en capacidades nativas de EcoFlow

Arquitectura:

Aplicación de EcoFlow / OASIS / capa de energy-management -> descubrir dispositivo Shelly -> leer capacidades -> asignar rol energético -> controlar y supervisar mediante EcoFlow -> permitir la coexistencia con Shelly Smart Control 

Estado:

• Dirección de producto recomendada.

Limitación:

• Requiere la implementación del producto y de ingeniería de EcoFlow.

Conclusión:

• Mejor vía a largo plazo.

Enfoque 4: API de integrador de Shelly / importación basada en la cuenta

Arquitectura:

El usuario autoriza la cuenta de Shelly -> EcoFlow importa los devices compartidos -> EcoFlow recibe la lista de dispositivos, el estado y la capacidad de control -> el instalador asigna roles energéticos 

Estado:

• Recomendación conceptual.

Por qué es útil:

• Sólido para instalaciones de modernización.

• Conserva los devices existentes.

• Puede importar los nombres de usuario.

• Evita la incorporación dispositivo por dispositivo.

Limitación:

• Requiere un acuerdo comercial/de API y un modelo de consentimiento del usuario.

Conclusión:

• Vía útil para una integración de nivel empresarial con socios.

Enfoque 5: integración con la API de LAN local

Arquitectura:

Controlador/aplicación/gateway local de EcoFlow -> descubrimiento mediante mDNS/IP -> RPC/HTTP local de Shelly -> estado y control 

Estado:

• Recomendado cuando EcoFlow dispone de un controlador local o una ruta de gateway capaz.

Por qué es útil:

• Baja latencia.

• Funciona sin depender de la nube para el control local.

• Adecuado para la lógica de respaldo y del modo isla.

Limitación:

• Requiere un dispositivo local de EcoFlow o una arquitectura de aplicación capaz de comunicarse localmente.

Conclusión:

• Importante para un comportamiento serio de energy-management.

Enfoque 6: retransmisión en la nube / servicio externo

Arquitectura:

Servicio externo -> API de EcoFlow -> Shelly Cloud o endpoint local -> actualizar cargas/valores 

Estado:

• Es posible, pero no es la arquitectura de producto preferida.

Limitación:

• Añade una dependencia de terceros.

• No es ideal para un control rápido de la carga.

• Más difícil de explicar a los instaladores.

Conclusión:

• Útil para prototipos, no para la experiencia del producto final.

Solución alternativa con JavaScript de Shelly

Entradas | +-- API de EcoFlow | +-- cmsBattSoc | +-- cmsMinDsgSoc | +-- powGetPvSum | +-- powGetSysGrid | +-- powGetSysLoad | +-- RPC local de Shelly | +-- EM act_power | +-- Plug/Switch apower | +-- Configuración del script +-- nightStart / nightEnd +-- nightSoc +-- threshold +-- pollMs Motor de decisiones | +-- carga +-- descarga +-- inactividad Salidas a EcoFlow | +-- cfgFeedGridMode +-- cfgBackupReverseSoc +-- cfgEnergyStrategyOperateMode 

El script para casos reales está disponible en:

load_balancing_static.shelly.js 

La variante de componentes virtuales orientada a producción está disponible en:

load_balancing_static_vc.shelly.js 

El README de la implementación es:

README.md 

Propósito del script

El script demuestra el comportamiento de equilibrio de carga para EcoFlow STREAM Ultra mediante:

• control mediante la API en la nube de EcoFlow;

• mediciones de potencia locales de Shelly EM / Plug S;

• configuración estática;

• selección del modo de carga / descarga / inactividad;

• ventana de carga nocturna;

• lógica del umbral de carga.

Entradas

Entradas reales en CONFIG:

• accessKey

• secretKey

• número de serie

• región

• cmdId

• cmdFunc

• dirDest

• dirSrc

• dest

• nightStart

• nightEnd

• nightSoc

• threshold

• pollMs

Entradas reales del dispositivo en DEVICES_CFG:

• tipo: em o enchufe

• host: dirección IP o nombre de host de Shelly

• canal: índice del canal EM o ID del Switch

• nombre: etiqueta descriptiva para los registros

Salidas

Salidas reales de control de EcoFlow:

• cfgFeedGridMode

• cfgBackupReverseSoc

• cfgEnergyStrategyOperateMode.operateSelfPoweredOpen

• cfgEnergyStrategyOperateMode.operateIntelligentScheduleModeOpen

Salidas reales del lado de Shelly:

• salida de log;

• modo seleccionado: charge, discharge o idle;

• en la variante VC, Virtual Components para el estado y el estado de equilibrado de EcoFlow.

Modos

Consulta local de Shelly

El script lee los devices Shelly configurados mediante HTTP local:

http:///rpc/EM1.GetStatus?id= http:///rpc/Switch.GetStatus?id= 

Utiliza:

• act_power para los canales EM;

• apower para los canales Plug/Switch.

Llamadas a la API de EcoFlow

Leer el estado de STREAM Ultra:

GET https://api-e.ecoflow.com/iot-open/sign/device/quota/all?sn= 

Escribir valores de control de STREAM Ultra:

PUT https://api-e.ecoflow.com/iot-open/sign/device/quota 

Para la región de EE. UU., el script utiliza:

https://api-a.ecoflow.com 

Fragmento representativo del script

El script completo debe consultarse en el archivo fuente en lugar de duplicar las 503 líneas en este artículo. La lógica central de modos es:

si (es de noche) { solicitarCarga(...); } si no, si (totalW > CFG.threshold) { solicitarDescarga(...); } si no { solicitarInactividad(...); } 

Interpretación del producto

El script debe considerarse una prueba de concepto, no la solución final.

La solución final debería ser:

• visible en la aplicación EcoFlow;

• compatible con EcoFlow;

• explicable para los instaladores;

• robusto en las familias de devices Shelly compatibles;

• seguro para los usuarios finales.

Siguiente enfoque previsto

Fase 1: estabilizar la integración actual -> lista de devices compatibles -> comportamiento claro del escaneo -> mejores errores y reintentos Fase 2: añadir familias Shelly modernas -> visibilidad de Gen3 / Gen4 -> modelo basado en capacidades -> validación del firmware Fase 3: admitir flujos de trabajo del instalador -> importar instalaciones Shelly existentes -> asignación de roles -> nomenclatura de canales -> confianza en la puesta en servicio Fase 4: convertir la lógica energética en un producto -> reglas para excedentes solar -> programación de tarifas -> prioridad de cargas de respaldo -> equilibrado nativo de EcoFlow 

Siguiente enfoque técnico/de producto recomendado:

1. Confirmar la lista actual de devices Shelly compatibles con EcoFlow. 2. Probar la detección de devices Gen3 y Gen4 con EcoFlow. 3. Identificar por qué no aparecen los devices new: - lista de modelos; - método de detección; - firmware; - cambio de protocolo; - configuración regional de la aplicación. 4. Añadir detección basada en capacidades. 5. Añadir una ruta de instalación para instalaciones Shelly existentes. 6. Añadir un comportamiento cooperativo de control manual. 7. Trasladar a EcoFlow la lógica de equilibrado probada.

Fase 1: estabilizar la integración actual

Objetivo:

• Hacer fiables los devices compatibles actualmente.

Tareas:

• documentar los modelos compatibles;

• mostrar el progreso del escaneo;

• mejorar los mensajes de error;

• conservar los nombres de usuario;

• ofrecer opciones para eliminar/reintentar.

Fase 2 - Añadir las familias modernas de Shelly

Objetivo:

• Hacer que los dispositivos Gen3/Gen4 sean visibles y utilizables.

Tareas:

• probar las generaciones actuales de Shelly;

• mapear las capacidades;

• evitar el filtrado exclusivo por modelos antiguos;

• validar las versiones de firmware.

Fase 3 - Compatibilidad con los flujos de trabajo de los instaladores

Objetivo:

• Hacer que la integración sea utilizable por profesionales.

Tareas:

• importación de instalaciones existentes de Shelly;

• asignación de roles;

• asignación de nombres a las cargas;

• informe de puesta en servicio;

• compatibilidad con múltiples canales;

• matriz de compatibilidad.

Fase 4 - Convertir la lógica energética en un producto

Objetivo:

• Trasladar la lógica de equilibrio externa a EcoFlow.

Tareas:

• reglas de excedente solar;

• programación de tarifas;

• reglas de reserva de batería;

• prioridad de las cargas de respaldo;

• monitorización de fases;

• comportamiento de la anulación manual.

Estado actual

Funcionamiento:

• EcoFlow y Shelly tienen referencias públicas de integración/producto.

• Las páginas públicas de EcoFlow OASIS y PowerInsight muestran una orientación más amplia hacia dispositivos de terceros.

• Las API estándar de Shelly hacen que una integración amplia sea técnicamente realista.

• Una solución alternativa basada en JavaScript personalizado de Shelly y la API de EcoFlow puede gestionar el equilibrio de carga de STREAM Ultra.

• El script estático para casos reales existe como el archivo adjunto load_balancing_static.shelly.js.

• La variante de producción de componentes virtuales existe como el archivo adjunto load_balancing_static_vc.shelly.js.

• El script estático consulta los dispositivos Shelly EM / Plug S locales y controla EcoFlow STREAM Ultra mediante llamadas firmadas a la API en la nube de EcoFlow.

Funcionamiento parcial:

• Algunos dispositivos Shelly antiguos aparecen en el flujo de EcoFlow.

No funciona / bloqueo observado:

• Los dispositivos Shelly Gen3 y Gen4 no aparecieron en el escaneo probado de EcoFlow.

Desconocido:

• método exacto de detección de Shelly por parte de EcoFlow;

• lista exacta de dispositivos compatibles por región/versión de la aplicación;

• comportamiento actual de la anulación manual de EcoFlow;

• si EcoFlow puede importar dispositivos existentes de Shelly account;

• si EcoFlow utiliza rutas locales o en la nube para dispositivos Shelly;

• detalles completos de la API de EcoFlow para STREAM.

Listo para añadir más adelante:

• capturas de pantalla reales de la aplicación EcoFlow;

• capturas de pantalla de detecciones fallidas de Gen3/Gen4;

• capturas de pantalla de dispositivos Shelly antiguos que aparecen;

• ejemplos de solicitudes/respuestas de API;

• ejemplos de comentarios de instaladores por región.

Siguiente paso recomendado:

Ejecutar una prueba de detección específica con:

• EcoFlow STREAM Ultra;

• versión registrada de la aplicación EcoFlow;

• Shelly Plug S Gen3;

• Shelly Plug S Gen4;

• Shelly Pro 3EM;

• Shelly EM-50;

• Shelly 1 Gen4;

• un dispositivo Shelly antiguo que aparece correctamente;

• notas sobre paquetes/red, si es posible.

El objetivo es separar:

• problema de detección de red;

• problema de compatibilidad del modelo;

• problema de firmware;

• problema regional de la aplicación;

• limitación del producto.

Fuentes de investigación

EcoFlow:

• Página del producto EcoFlow STREAM Ultra:

• Página del producto EcoFlow PowerStream:

• Página del producto EcoFlow Smart Home Panel:

• Página del producto EcoFlow OASIS:

• Lista de dispositivos de terceros de EcoFlow PowerInsight:

• Plataforma para desarrolladores de EcoFlow:

Shelly:

• Documentación de la API de Shelly:

• API de integrador de Shelly:

• Artículo de soporte sobre integraciones de terceros de Shelly:

Referencia comparativa de Victron:

• Anuncio de Victron Venus OS v3.70:

• dbus-shelly de Victron:

Código fuente de implementación adjunto:

• Script de equilibrio de carga estático de EcoFlow STREAM Ultra:

• Script de equilibrio de carga mediante componentes virtuales de EcoFlow STREAM Ultra:

• README del script de EcoFlow STREAM Ultra:

• Captura de pantalla de los componentes virtuales de EcoFlow STREAM Ultra: