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 instaladores, las pruebas reales de STREAM Ultra, la información pública de EcoFlow/Shelly y un enfoque práctico para una 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 de EcoFlow más importantes son EcoFlow STREAM, EcoFlow PowerStream y DELTA with Hogar inteligente Panel. Se pueden mencionar otros sistemas de EcoFlow cuando resulte útil, pero no son el foco principal de esta propuesta de colaboración.

El patrón común entre los productos relevantes de EcoFlow 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: la distribución de energía, el control de cargas y la supervisión a nivel de dispositivo o circuito. Los dispositivos Shelly ya son ampliamente utilizados por instaladores y usuarios finales 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 natural de dispositivos para los sistemas energéticos de EcoFlow.

Principales sistemas de EcoFlow incluidos

EcoFlow STREAM

EcoFlow STREAM es el foco principal de la experiencia de campo actual. 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 un consumo doméstico preciso y del comportamiento inteligente de las cargas para mejorar el autoconsumo.

Por qué STREAM es importante para Shelly:

• Está directamente relacionado con el problema del autoconsumo.

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

• 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 dispositivos Shelly más recientes no aparecen de forma fiable.

EcoFlow PowerStream

EcoFlow PowerStream también es importante porque conecta la 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 los usuarios finales plug-and-play y los clientes de modernización, especialmente en los mercados europeos donde la solar de balcón es habitual.

La información oficial del producto EcoFlow presenta PowerStream como un sistema 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 aparatos y la asignación automática de energía, donde los enchufes inteligentes monitorizan el consumo de los aparatos y el microinversor asigna la electricidad disponible al aparato 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 los usuarios que buscan una forma sencilla de iniciarse en solar.

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

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

• Es un puente natural entre solar/almacenamiento de EcoFlow y los dispositivos plug-and-play de Shelly.

DELTA + Hogar inteligente Panel

DELTA con Hogar inteligente Panel es importante para el respaldo de todo el hogar y la gestión energética a nivel de circuito. EcoFlow describe Hogar inteligente Panel como una parte fundamental de un sistema de respaldo del hogar 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 Hogar inteligente Panel describe el panel como el heart del sistema de respaldo del hogar. 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 ofrecer monitorización y control distribuidos.

Referencia:

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

Por qué DELTA + Hogar inteligente Panel es importante para Shelly:

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

• Introduce un enfoque basado en circuitos.

• Necesita un comportamiento claro en cuanto a la prioridad de las cargas.

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

• Es relevante para escenarios 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 una dirección más amplia, no como el foco principal del artículo, salvo que se confirme el alcance de la integración.

EcoFlow presenta públicamente OASIS como un sistema de gestión de energía del hogar con monitorización en tiempo real, paneles, información energética e integración de dispositivos multiplataforma. 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 multiplataforma. 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 considerarse 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 como 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 descubrimiento 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 poseen 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 de 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 de marca conjunta. La oportunidad mayor es ofrecer compatibilidad con Shelly basada en capacidades: EcoFlow descubre el dispositivo Shelly, entiende 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. Lo 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 protocolos de Shelly.

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

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

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

Dirección pública confirmada

La dirección confirmada es que EcoFlow reconoce el valor de 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 plataforma, supervisión energética 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 exactamente donde Shelly puede contribuir: supervisión y control a nivel de dispositivo, conectados con las decisiones energéticas de EcoFlow.

Problema actual en campo

El problema práctico es sencillo:

> Los instaladores y los clientes no pueden ver ni añadir de forma fiable dispositivos Shelly más nuevos 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.

• Como no se han previsto 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 y de dispositivos compatibles de EcoFlow/Shelly 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:

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

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

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

• Permitir que EcoFlow determine 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 EcoFlow muestra el sistema energético completo.

• La aplicación 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.

No se trata de un modelo de aplicaciones excluyente.

EcoFlow representa la perspectiva del sistema energético. Shelly Smart Control representa 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 de dispositivo/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 ese control sin explicarlo. Si EcoFlow debe imponer un estado por motivos de seguridad, tarifas, respaldo, límites del inversor o energy-management, esto debería hacerse de forma explícita y mediante 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 debe ser fiable;

• las generaciones modernas de Shelly deben ser compatibles;

• las capacidades de los dispositivos deben mapearse en lugar de codificarse mediante listas de modelos antiguos;

• el control manual debe 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 dispositivos 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 basándose en los comentarios reales de los instaladores y en la instalación alemana probada.

Problema 1 - Los nuevos dispositivos Shelly no aparecen

Comportamiento observado:

• Shelly Plug S Gen3 no apareció.

• Shelly Plug S Gen4 no apareció.

• Los dispositivos Shelly 1 Gen4 no aparecieron.

• Aparecieron principalmente dispositivos Shelly antiguos.

Impacto:

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

• Los clientes con nuevos dispositivos Shelly no pueden utilizarlos dentro del flujo de EcoFlow.

• La integración parece obsoleta, aunque las API de Shelly son estándar y modernas y existen 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 dispositivos y capacidades compatibles.

Inquietud 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 en la LAN

• Descubrimiento mediante mDNS

• Importación desde la cuenta/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 se pueden separar 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 del escaneo.

• Permitir reintentar.

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

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

• Usar BLE o el punto de acceso Wi-Fi para dispositivos nuevos sin aprovisionar.

Inquietud 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 se pueden especificar con confianza.

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

• 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.

Inquietud 4 - La coexistencia del control manual debe ser clara

El control debería 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 dispositivos Shelly.

• Las hogares 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.

Inquietud 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 debería residir en un script personalizado oculto.

• Debería estar dentro de EcoFlow, donde el cliente espera que se tomen las decisiones energéticas.

Solución recomendada:

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

• Usar dispositivos Shelly 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 sabe:

• generación solar;

• estado de la batería;

• comportamiento del almacenamiento;

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

• contexto de tarifas o Time-of-Use;

• modo de respaldo;

• límites del sistema;

• objetivos de energía.

Shelly dispositivos saben:

• consumo a nivel de electrodoméstico;

• 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 de uso más sólido para los dispositivos Shelly Pro.

Dispositivos Shelly relevantes:

• Shelly Pro 3EM

• Shelly EM-50

• 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 hogares con Shelly existente

Muchos clientes ya tienen dispositivos Shelly instalados antes de comprar EcoFlow. Es posible que ya utilicen Shelly para iluminación, calefacción, bombas, enchufes, relés, sensores y medición de energía.

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 descubre 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:

• Menor barrera de 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 que buscan una solución lista para usar

Los usuarios que buscan una solución lista para usar necesitan dispositivos sencillos y un lenguaje claro.

Dispositivos Shelly relevantes:

• Shelly Plug S Gen3

• Shelly Plug S Gen4

• otros dispositivos compatibles conectados a enchufes

Cargas habituales:

• calefactor;

• ventilador;

• deshumidificador;

• lavadora;

• calentador de agua pequeño;

• equipos de oficina;

• cargas de electrodomésticos.

Por qué EcoFlow ofrece ventajas:

• Un usuario puede empezar poco a poco.

• El cliente ve inmediatamente el impacto energético.

• 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 que se deben admitir

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

Calentador de agua con excedente solar

Cuando hay excedente de energía solar, 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.

Control del cargador de vehículos eléctricos / cargas grandes

EcoFlow puede coordinar las cargas grandes según la energía solar disponible, el estado de carga de la batería, los límites de importación de la red y las necesidades 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 preservar la autonomía de la batería.

Programación de tarifas / Uso de tiempo

Las cargas pueden trasladarse a periodos de bajo coste o de alta disponibilidad de energía solar.

Conclusión empresarial

La oportunidad de facilitar la elección de EcoFlow.

La amplia compatibilidad con Shelly ofrece a EcoFlow:

• una experiencia más sólida para el instalador;

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

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

• un ecosistema de aplicaciones más sólido;

• un camino 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

País:

• Alemania

Red:

• Red IP local estándar

• Router TP-Link

Sistema EcoFlow:

• batería EcoFlow STREAM Ultra

• paneles solares

dispositivos Shelly disponibles/probados:

• Shelly Plug S Gen3

• Shelly Plug S Gen4

• Shelly Pro 3EM

• Shelly EM-50

• varios dispositivos Shelly 1 Gen4

Versiones de firmware mencionadas:

• 1.5.7

• 2.0.0

Problema observado en la aplicación de EcoFlow:

• No se mostraban los dispositivos Shelly new Gen3 y Gen4.

• Aparecieron algunos dispositivos Shelly más antiguos.

Solución alternativa personalizada funcional:

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

Dirección deseada del producto:

• La lógica de equilibrado y control debería residir en EcoFlow.

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

Cómo debería funcionar el descubrimiento de dispositivos

El método de descubrimiento actual de EcoFlow no se conoce desde fuera. El artículo no debería afirmar un método actual específico salvo que EcoFlow lo confirme.

Lo importante es la arquitectura de descubrimiento deseada.

aplicación de EcoFlow | +-- New dispositivo Shelly | +-- Descubrimiento mediante Bluetooth | +-- Configuración mediante punto de acceso Wi-Fi | +-- Lectura de capacidades | +-- Asignación de funciones de EcoFlow | +-- Instalación de Shelly existente | +-- Descubrimiento mediante mDNS | +-- Escaneo de IP de la LAN | +-- Adición manual de IP | +-- Importación opcional de la cuenta/account 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 dispositivos nuevos cerca del instalador.

Más adecuado para:

• dispositivos 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 junto a cada dispositivo;

• no es eficiente para decenas de dispositivos 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 dispositivo Shelly aún no está conectado a la red del cliente.

Más adecuado para:

• configuración de un new dispositivo;

• usuarios plug-and-play;

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

Limitaciones:

• redundante para dispositivos 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 dispositivos ya instalados en la red local.

Más adecuado para:

• instalaciones de modernización;

• hogares existentes con Shelly;

• 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 cortafuegos;

• puede requerir limitar la velocidad;

• puede requerir seleccionar manualmente la subred.

Ruta de detección 4: mDNS

mDNS resulta útil porque los dispositivos Shelly pueden anunciarse en la red.

Más adecuado para:

• detección en la misma LAN;

• dispositivos existentes;

• experiencia de usuario automática de “se ha encontrado un dispositivo nuevo”;

• 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 dispositivos.

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 dispositivos ya conectados. 2. Escaneo de IP como alternativa. 3. Bluetooth o punto de acceso Wi-Fi para dispositivos nuevos. 4. Introducción manual de IP para instaladores avanzados. 5. Importación opcional desde la cuenta o la nube de Shelly para flotas en proceso de modernización, si cuenta con soporte comercial.

Esto es importante porque EcoFlow atiende a varias personas usuarias:

• new instalaciones;

• hogares en proceso de modernización;

• usuarios finales plug-and-play.

Un único método de detección no puede funcionar bien para los tres casos.

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

Problema 1: los nuevos dispositivos Shelly Gen3/Gen4 no aparecen

Observación:

• Shelly Plug S Gen3 no apareció.

• Shelly Plug S Gen4 no apareció.

• Los dispositivos Shelly 1 Gen4 no aparecieron.

• Aparecieron principalmente dispositivos antiguos.

Impacto:

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

• Los instaladores no pueden especificar soluciones EcoFlow + Shelly.

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

Solución recomendada:

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

• Pasar a un soporte 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 dispositivo 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 resolver los 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 la resolución de problemas.

• Permitir realizar una prueba manual de IP.

• Registrar los intentos de detección de dispositivos.

Problema 3: las instalaciones existentes no se tratan como una opción principal

Observación:

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

• Si EcoFlow espera únicamente un flujo limitado para accessory compatibles, la modernización resulta difícil.

Impacto:

• EcoFlow pierde a los clientes que ya tienen Shelly.

• Los instaladores no pueden vender EcoFlow como una mejora para un hogar inteligente.

Solución recomendada:

• Añadir una ruta para “dispositivos de Shelly existentes”.

• Importar y mostrar los dispositivos ya instalados.

• Conservar los nombres asignados por el usuario.

• Permitir asignar roles a los dispositivos.

Problema 4: los nombres de los dispositivos deben ser fáciles de usar

Observación:

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

Impacto:

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

• Los dispositivos multicanal pueden resultar confusos.

Solución recomendada:

• Leer el nombre asignado por el usuario al dispositivo 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 de Shelly.

Problema 5: el comportamiento del control manual debe ser explícito

Observación:

• Los usuarios deberían poder controlar los dispositivos de 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 respaldo deberían basarse en modos y explicarse.

Arquitectura del sistema

Componentes de hardware

Componentes EcoFlow incluidos en el alcance:

• batería EcoFlow STREAM Ultra

• paneles solares

• EcoFlow PowerStream

• DELTA + Hogar inteligente Panel

• aplicación de EcoFlow

• EcoFlow OASIS / PowerInsight cuando corresponda

Componentes Shelly incluidos en el alcance:

• Shelly Plug S Gen3

• Shelly Plug S Gen4

• Shelly Pro 3EM

• Shelly EM-50

• Shelly 1 Gen4

• dispositivos Shelly Pro

• relés y contactores Shelly

• sensores Shelly cuando sean ú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 descubrimiento de EcoFlow a Shelly;

• si EcoFlow utiliza una 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 ve los dispositivos Shelly.

Modelo de control

Modelo de control previsto:

• EcoFlow establece los objetivos energéticos.

• Los dispositivos Shelly ejecutan el control local.

• Los dispositivos Shelly informan del estado y las mediciones 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 hoy mediante scripting personalizado 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 del STREAM Ultra | +-- escribir parámetros de control del STREAM Ultra | +-- Lógica de decisión +-- intervalo nocturno -> cargar +-- carga diurna por encima del umbral -> descargar +-- carga diurna por debajo o igual al umbral -> inactividad 

La solución alternativa 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 de EcoFlow;

• producción fotovoltaica de EcoFlow;

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

• 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.

El scripting 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 equilibrio.

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

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

• El comportamiento esencial 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 canales de medidor del tipo Shelly EM Gen4, leyendo act_power;

• Switch.GetStatus para canales de enchufe del tipo 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/gestión 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 significativo: la prueba de concepto no requiere un portátil, Home Assistant, ioBroker, Cloudflare Worker ni ningún 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 normales;

• requiere conocimientos técnicos;

• no es un flujo de trabajo oficial para instaladores;

• es difícil de admitir globalmente;

• no resuelve el descubrimiento desde 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 frecuencia y la gestión de errores necesitan compatibilidad a nivel de producto.

Conclusión del producto

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

Shelly debe seguir siendo la capa de dispositivos distribuidos.

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

Red

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 la multidifusión está bloqueada?

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

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

Firmware

Versiones de firmware mencionadas:

• 1.5.7

• 2.0.0

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

• qué firmware corresponde a cada dispositivo Shelly;

• Versiones del firmware y de la 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

No se trata únicamente de un problema de una instalación. Se reciben comentarios similares de instaladores de distintas regiones.

El mensaje repetido:

• los clientes no pueden ver los dispositivos Shelly nuevos;

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

• el soporte no es lo bastante 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 dispositivos Shelly nuevos no aparecen de forma fiable en el flujo de descubrimiento de EcoFlow.

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

• Aparecieron algunos dispositivos Shelly antiguos, lo que sugiere una brecha en la lista de descubrimiento/soporte, 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 dispositivos no está clara.

• El problema afecta tanto a las instalaciones reales como a los proyectos previstos.

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 soporte nativo de EcoFlow para el descubrimiento, la visibilidad y el control de Shelly.

Recursos

Recursos de EcoFlow:

• EcoFlow STREAM Ultra:

• EcoFlow PowerStream:

• EcoFlow Hogar inteligente Panel:

• EcoFlow OASIS:

• Lista de dispositivos EcoFlow PowerInsight:

• EcoFlow Developer:

Recursos de Shelly:

• Documentación de la API de Shelly:

• API de integrador de Shelly:

• Artículo sobre integraciones de terceros de Shelly:

Archivos de apoyo 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 dispositivos Shelly antiguos visibles en EcoFlow. La configuración de test actual no incluye dispositivos Shelly antiguos.

• Captura de pantalla independiente de la lista completa de dispositivos Shelly. Las pruebas disponibles son el resultado del escaneo de EcoFlow de Gen3/Gen4 y las fotos de la instalación real y de los dispositivos.

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 de colaboración;

• adecuado para instalaciones reales;

• útil únicamente como solución personalizada;

• candidatos para una implementación nativa de EcoFlow.

El punto técnico más importante:

> Los dispositivos Shelly no son la parte difícil. Los dispositivos Shelly exponen API estándar. La parte difícil es que EcoFlow convierta en producto la capa de descubrimiento, mapeo y control energético.

Configuración de test

El esquema muestra el patrón de conexión real de la configuración de prueba de EcoFlow + Shelly: red/fuente, medición de Shelly, dispositivos Shelly Plug S Gen3/Gen4, paneles fotovoltaicos y EcoFlow STREAM Ultra conectado como capa de producción y almacenamiento de energía.

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

Versiones de firmware mencionadas:

• 1.5.7

• 2.0.0

El conjunto de pruebas 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

• Red IP local estándar

• Router TP-Link

• Dispositivos Shelly en la LAN/Wi-Fi

• Dispositivo/aplicación de 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 balance.

Acceso a la API y para developers de EcoFlow

EcoFlow cuenta con una plataforma para developers, y el trabajo público de integraciones 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 de developer está disponible.

• Algunas integraciones de terceros utilizan credenciales de la API en la nube.

• La documentación oficial para developers está basada en una aplicación web y puede requerir iniciar sesión o JavaScript.

Para documentar:

• Tipo de account: cuenta de developer de EcoFlow.

• Estado de aprobación del developer: pendiente.

• El script requiere la access key y la secret key del EcoFlow Developer Portal.

• El script requiere el número de serie del STREAM Ultra.

• Región de test real: eu.

• El script admite la selección de 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 api

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

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

Endpoints de 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 velocidad

Los límites de velocidad del servidor de la API oficial de EcoFlow no están documentados 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 los límites del servidor de la API oficial de EcoFlow mediante la documentación de EcoFlow o la aprobación de un developer.

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 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:

• activar las cargas de los 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 tiempo de uso / tarifa

Objetivo:

• desplazar las cargas flexibles a las franjas de bajo coste;

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

• 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 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 solo con una advertencia clara.

Modo isla / apagón

Objetivo:

• proteger la capacidad limitada de respaldo;

• evitar la sobrecarga del inversor;

• dar prioridad a 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 dispositivos Shelly exponen conceptos comunes:

• estado del dispositivo;

• estado del componente;

• estado del interruptor;

• datos del medidor;

• estado de entrada;

• configuración;

• HTTP/RPC local;

• WebSocket/RPC;

• MQTT cuando esté configurado;

• scripting en dispositivos 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 dispositivo Shelly. 2. Leer las capacidades del dispositivo y de sus componentes. 3. Identificar los componentes: - interruptor - medidor - entrada - sensor - canal de relé - regulador de intensidad 4. Asignar los componentes a roles energéticos de EcoFlow: - carga inteligente - medidor de toda la vivienda - medidor de circuito - relé controlable - carga prioritaria de respaldo - dispositivo solo de monitorización 5. Permitir que el usuario o instalador asigne el rol y la prioridad.

Dispositivos multicanal

Los dispositivos multicanal no deberían aplanarse en un único dispositivo genérico.

Comportamiento de ejemplo:

• 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é disponible.

Nombres de los dispositivos

EcoFlow debe utilizar nombres fáciles de entender para el usuario:

• nombre del dispositivo;

• nombre del canal;

• sala/ubicación cuando esté disponible;

• nombre de Shelly asignado por el usuario.

Esto es fundamental para las instalaciones de modernización.

Opciones de detección 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 new

Métodos de detección preferidos:

• Bluetooth;

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

• Respaldo mediante código QR/manual cuando esté disponible.

Flujo:

1. El usuario abre la aplicación EcoFlow. 2. El usuario selecciona «Añadir dispositivo Shelly». 3. EcoFlow detecta un dispositivo Shelly cercano. 4. EcoFlow configura 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

Métodos de detección preferidos:

• mDNS;

• escaneo de IP en la LAN;

• añadir IP manualmente;

• importación opcional de la cuenta/nube.

Flujo:

1. El instalador selecciona «Usar dispositivos Shelly existentes». 2. EcoFlow escanea la red. 3. EcoFlow muestra los dispositivos detectados 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

Métodos de detección preferidos:

• IP manual;

• escaneo de la 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: Detección actual mediante la aplicación EcoFlow

Arquitectura:

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

Estado:

• Funcionamiento parcial.

Resultado observado:

• Aparecieron algunos dispositivos Shelly más antiguos.

• No aparecieron dispositivos Shelly Gen3/Gen4.

Conclusión:

• La ruta actual de detección/asistencia no es suficiente para la planificación profesional.

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

Arquitectura:

Controlador JavaScript de Shelly -> lecturas RPC locales de Shelly desde dispositivos EM / Plug S configurados -> carga medida agregada -> 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 orientada a producción basada en componentes virtuales:

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 dispositivos configurados.

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

• Controla 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 asistencia a instaladores a escala global.

• 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 la lista de compatibilidad.

Conclusión:

• Demuestra que la lógica es posible.

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

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

Arquitectura:

Aplicación de EcoFlow / OASIS / capa de energy-management -> descubrir el dispositivo Shelly -> leer las capacidades -> asignar la función energética -> 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 opción a largo plazo.

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

Arquitectura:

El usuario autoriza la cuenta de Shelly -> EcoFlow importa los dispositivos compartidos -> EcoFlow recibe la lista de dispositivos/el estado/la capacidad de control -> el instalador asigna las funciones energéticas 

Estado:

• Recomendación conceptual.

Por qué es útil:

• Sólido para instalaciones de modernización.

• Conserva los dispositivos existentes.

• Puede importar los nombres de los usuarios.

• Evita la incorporación dispositivo por dispositivo.

Limitación:

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

Conclusión:

• Ruta útil para una integración de nivel de socio.

Enfoque 5: integración de 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 mediante gateway.

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 objetivo del producto.

Solución alternativa en JavaScript para 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 del caso real está disponible en:

load_balancing_static.shelly.js 

La variante orientada a producción de Virtual Components 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 del dispositivo real en DEVICES_CFG:

• tipo: em o enchufe

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

• canal: índice del canal EM o identificador 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: carga, descarga o inactivo;

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

Modos

Consulta local de Shelly

El script lee los dispositivos Shelly configurados mediante HTTP local:

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

Utiliza:

• act_power para canales EM;

• apower para 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 de origen en lugar de duplicar las 503 líneas de este artículo. La lógica básica de los modos es:

if (night) { requestCharge(...); } else if (totalW > CFG.threshold) { requestDischarge(...); } else { requestIdle(...); } 

Interpretación del producto

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

La solución final debe ser:

• visible en la aplicación EcoFlow;

• compatible con EcoFlow;

• comprensible para los instaladores;

• robusto en las familias de dispositivos Shelly compatibles;

• seguro para los usuarios finales.

Siguiente enfoque previsto

Fase 1: Estabilizar la integración actual -> lista de dispositivos 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 de instalación -> importar instalaciones Shelly existentes -> asignación de roles -> asignación de nombres a canales -> confianza durante la puesta en marcha Fase 4: Convertir la lógica energética en un producto -> reglas de excedente solar -> programación según tarifas -> prioridad de cargas de respaldo -> equilibrado nativo de EcoFlow 

Siguiente enfoque técnico/de producto recomendado:

1. Confirmar la lista actual de dispositivos Shelly compatibles con EcoFlow. 2. Probar el descubrimiento de dispositivos Gen3 y Gen4 con EcoFlow. 3. Identificar por qué no aparecen los new dispositivos: - lista de modelos; - método de descubrimiento; - firmware; - cambio de protocolo; - configuración regional de la aplicación. 4. Añadir descubrimiento basado 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 validada.

Fase 1: estabilizar la integración actual

Objetivo:

• Hacer fiables los dispositivos 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 visibles y utilizables los dispositivos Gen3/Gen4.

Tareas:

• probar las generaciones actuales de Shelly;

• asignar capacidades;

• evitar el filtrado exclusivo de 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 Shelly existentes;

• asignación de roles;

• asignación de nombres a las cargas;

• informe de puesta en servicio;

• compatibilidad multicanal;

• matriz de compatibilidad.

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

Objetivo:

• Trasladar la lógica de equilibrado externo 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 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 técnicamente realista una integración amplia.

• Una solución alternativa basada en JavaScript personalizado de Shelly + la API de EcoFlow puede gestionar el equilibrado 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 de EcoFlow probado.

Desconocido:

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

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

• comportamiento actual de anulación manual de EcoFlow;

• si EcoFlow puede importar dispositivos existentes de la cuenta de Shelly;

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

• detalles completos de la API de EcoFlow para STREAM.

Para añadir más adelante:

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

• capturas de pantalla de fallos de detección 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 de la aplicación de EcoFlow registrada;

• 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 de la aplicación regional;

• 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 Hogar inteligente 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 la implementación adjunto:

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

• Script de equilibrado de carga de componentes virtuales de EcoFlow STREAM Ultra:

• README del script de EcoFlow STREAM Ultra:

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