Documentación · 3.8.1

Primeros pasos con TedEnergy

Instalar TedEnergy, obtener la licencia gratuita, declarar el contador y el primer inversor, y comprobar que todo funciona: cuente con unos 30 minutos.

Documentación al día con TedEnergy 3.8.1.

Para qué sirve TedEnergy

TedEnergy es un HEMS multimarca (sistema de gestión de la energía del hogar) para baterías solares. Decide continuamente cuándo se cargan o descargan sus inversores y baterías, a partir de la lectura de su contador eléctrico.

La idea: comprar menos electricidad a la red, almacenar el excedente solar en lugar de exportarlo y evitar idas y venidas inútiles que desgastan las baterías. Funciona con dispositivos de varias marcas a la vez.

  • Modo Autónomo: TedEnergy gestiona por sí mismo todas sus baterías.
  • Modo Asistido: TedEnergy complementa el HEMS de un fabricante (este conserva el control de sus dispositivos, TedEnergy se ocupa de los demás).
  • Funciona en su casa, todo el tiempo, en una máquina local: la regulación no depende de un servicio en línea de TedEnergy. Solo las comprobaciones de licencia y las estadísticas anónimas pasan por Internet (véase Privacidad).

Qué necesita

  • Una máquina que permanezca encendida: un Home Assistant OS (Raspberry Pi, miniPC), un NAS Synology o cualquier ordenador con Docker (miniPC, Raspberry Pi 4 o 5, servidor Linux).
  • La lectura de su contador eléctrico, en vatios: positiva cuando la casa compra a la red, negativa cuando exporta. Un Shelly leído directamente por su dirección IP, un sensor de Home Assistant o el valor de un dispositivo enlazado con TedEnergy (por ejemplo un Zendure Smart Meter).
  • Al menos un inversor o batería controlable. La lista actualizada de marcas y modelos está en la página Compatibilidad.
  • Una licencia gratuita, que solicita el asistente de inicio: bastan un nombre y una dirección de correo.

Home Assistant no es obligatorio: bastan un Zendure y un contador leído directamente (Shelly o dispositivo enlazado). Home Assistant sirve sobre todo para las marcas sin conexión directa.

Elegir la instalación

Tres métodos, del más sencillo al más flexible. Cada guía detalla los pasos con capturas de pantalla:

  • Home Assistant OS: el más sencillo. Añadir el repositorio de la aplicación, instalar, iniciar. Sin token que crear, la conexión con Home Assistant es automática.
  • Synology: Container Manager, sin línea de comandos.
  • Docker: un único comando (o Docker Compose) en cualquier sistema.

Una IA también puede guiarle paso a paso en su hardware exacto: véase instalar con la ayuda de un asistente de IA.

La interfaz de TedEnergy no tiene contraseña: nunca la exponga tal cual en Internet. Para acceder desde fuera, utilice una VPN o el acceso remoto de la aplicación Android (que solo acepta peticiones firmadas).

Primer arranque: el asistente de inicio

Al abrirlo por primera vez, un asistente le guía. Con Home Assistant OS, abra TedEnergy en la barra lateral; con Docker o Synology, abra la dirección de la máquina (por ejemplo http://direccion-de-la-maquina:5002). Cada paso puede omitirse y retomarse más tarde en los Ajustes; el asistente puede reiniciarse desde la página Ayuda.

  1. Licencia gratuita. Nombre, dirección de correo y consentimiento. Puede enviarse un correo de confirmación: haga clic en el enlace y TedEnergy continúa solo.
  2. Conexión con Home Assistant (solo si lo utiliza, y no con la aplicación de Home Assistant OS). La dirección de Home Assistant con su puerto (por ejemplo http://192.168.1.50:8123) y un token de acceso de larga duración: en Home Assistant, haga clic en su nombre abajo a la izquierda, pestaña Seguridad, Tokens de acceso de larga duración, Crear token. El botón «Probar la conexión» lo comprueba todo.
  3. Contador. Elija la lectura de su contador: entidad de Home Assistant, Shelly o valor de un dispositivo enlazado. Un Shelly trifásico propone la fase correcta tras una prueba en directo. Este paso puede omitirse: el contador se declara entonces en Ajustes › Contador eléctrico, donde también se pueden ordenar varios contadores por prioridad (el siguiente toma el relevo si el primero deja de responder).
  4. Contrato. Proveedor, contrato (tarifa única, horas valle, Tempo…), precios y potencia contratada en kVA. Esta potencia limita la potencia de carga; sin ella, una instalación nueva carga como máximo a 3.000 W.
  5. Modos y potencia. Autónomo y/o Asistido, potencia máxima y niveles de batería. Los valores propuestos son adecuados para empezar.
  6. Inversores. El asistente le lleva a la página donde declara sus dispositivos (siguiente apartado).

Declarar su primer inversor

En Ajustes › Dispositivos, añada un dispositivo: elija su marca (una ficha por marca, u «Otra marca») y su modelo. Cada dispositivo puede tener varias conexiones — API local, MQTT local, nube del fabricante, Home Assistant — y TedEnergy utiliza la primera disponible; si falla, toma el relevo la siguiente.

Para un Zendure, lo más sencillo es la nube: en Ajustes › Conectores de dispositivos, pegue el token de la aplicación Zendure y elija después el dispositivo en la ficha. Solo es posible un acceso a la nube por cuenta Zendure: TedEnergy o la integración Zendure de Home Assistant, no ambos.

Pruebe la ficha antes de guardarla: TedEnergy comprueba que llegan las mediciones y que se aceptan las órdenes.

  • Controlado: TedEnergy decide su carga y descarga.
  • Vigilado: TedEnergy solo lo lee (útil para un dispositivo cuyas órdenes conserva otro sistema).

Empiece con un solo inversor controlado, observe el resultado durante unos días y añada después los demás. La página Diagnóstico › Prueba de inversores permite comprobar un dispositivo sin iniciar la regulación.

Comprobar que todo funciona

  • El panel de control muestra la casa animada: solar, casa, red y baterías, con su potencia en directo.
  • En modo Autónomo, el contador se mantiene cerca de cero cuando las baterías pueden absorber o suministrar lo necesario.
  • Un inversor en reposo tarda de unos segundos a unas decenas de segundos en arrancar: es normal, TedEnergy lo tiene en cuenta.
  • Los niveles mínimo y máximo de las baterías las protegen; ajústelos en Ajustes › Baterías y potencias máximas.
  • Una avería o una consigna que un inversor no aplica se indica en su ficha y en las notificaciones.

Durante los primeros días, mire el balance del panel: energía comprada, solar almacenado, parte de la casa cubierta sin la red.

Actualizaciones y copia de seguridad

  • Home Assistant OS: Home Assistant avisa de la actualización de la aplicación; sus ajustes se conservan.
  • Synology y Docker: descargue la nueva imagen y vuelva a crear el contenedor con la misma carpeta de datos (véase la guía de su método).
  • TedEnergy avisa por sí mismo cuando hay una nueva versión disponible (banner e insignia en la barra superior).
  • Ajustes › Copia de seguridad y versiones: exporte su configuración, restáurela y vuelva a una versión anterior si una actualización da problemas.

No borre nunca la carpeta de datos de TedEnergy durante una actualización: contiene sus ajustes, su licencia y su historial.

Obtener ayuda

  • Esta documentación: un capítulo por tema; la versión PDF puede descargarse desde la página de inicio de la documentación.
  • La comunidad: Discord y Facebook.
  • Una IA: en Ajustes › Ajustar con una IA, TedEnergy prepara un texto y un resumen de sus registros para dárselos a ChatGPT, Claude, Gemini o Le Chat. Usted decide qué comparte.

Preguntas frecuentes

¿Es obligatorio Home Assistant?

No. Zendure funciona por su nube, o en local mediante MQTT / API local, sin Home Assistant. Sirve sobre todo para las marcas sin conexión directa. TedEnergy funciona tanto como aplicación de Home Assistant OS como en Docker.

¿TedEnergy es gratuito?

La licencia es gratuita para empezar. Los posibles límites de la licencia (número de inversores controlados, duración) se muestran en Ajustes › Licencia y en la página Apoyar.

¿Puedo probarlo sin riesgo?

Sí. Declare primero sus dispositivos como «vigilados» para ver lo que lee TedEnergy y pase después uno solo a «controlado». Puede desactivar un inversor o toda la regulación en cualquier momento.

Mi inversor no está en la lista.

Elija «Otra marca»: la ficha acepta las entidades de cualquier dispositivo expuesto por Home Assistant o MQTT. Si no basta, pregunte en Discord o Facebook: las marcas más solicitadas se añaden primero.

¿Qué pasa si se cae Internet?

TedEnergy sigue regulando en local. La licencia se vuelve a comprobar en cuanto regresa Internet, sin bloqueo mientras tanto.

¿Una pregunta, un caso particular? La comunidad responde en Discord y Facebook. Una IA también puede analizar su instalación: vea «Ajustar con una IA» en los Ajustes de TedEnergy. Discord · Facebook

¿Listo para que todas sus baterías trabajen juntas?

Descarga gratuita: su licencia gratuita llega en cuanto se confirma su dirección de correo, sin tarjeta bancaria.

Descargar gratis