Instalación

Requisitos

Hardware

Componente	Descripción
Batería	Marstek Venus E v2/v3, Venus A o Venus D
Conversor Modbus	Dispositivo RS485 → Modbus TCP (p. ej. Elfin-EW11) — solo necesario para Venus E v2. Las Venus E v3, Venus A y Venus D se conectan por Ethernet y soportan Modbus TCP de forma nativa.
Sensor de red	Sensor HA que mide el consumo total de la red (p. ej. Shelly EM3, Neurio, contador inteligente)

Software

• Home Assistant 2024.1.0 o superior
• (Opcional) Sensor de previsión solar para la carga predictiva (Solcast, Forecast.Solar, etc.)

Red

La batería debe ser accesible desde Home Assistant por IP en el mismo segmento de red o mediante enrutamiento.

---

Instalación con HACS (recomendado)

1. Haz clic en el botón para añadir el repositorio a HACS:

   

2. Busca "Marstek Venus Energy Manager" e instala.

3. Reinicia Home Assistant.

---

Instalación manual

1. Descarga el zip de la última release desde GitHub Releases.
2. Extrae la carpeta marstek_venus_energy_manager.
3. Cópiala en el directorio custom_components/ de Home Assistant.
4. Reinicia Home Assistant.

---

Instalación de blueprints

Los blueprints son opcionales y se instalan en la carpeta de configuración de Home Assistant, no dentro de custom_components/.

La carpeta de blueprints de tu Home Assistant es:

/config/blueprints/automation/marstek_venus_energy_manager/

Si accedes a Home Assistant mediante Samba, Studio Code Server o File Editor, la misma ruta suele verse como:

config/blueprints/automation/marstek_venus_energy_manager/

Instalación desde la interfaz de Home Assistant

1. Ve a Ajustes → Automatizaciones y escenas → Blueprints.
2. Pulsa Importar blueprint.

3. Pega la URL del blueprint que quieras importar, por ejemplo:

   https://raw.githubusercontent.com/ffunes/Marstek-Venus-Energy-Manager/main/blueprints/different_grid_target_blueprint.yaml
   

4. Pulsa Previsualizar blueprint y después Importar blueprint.

5. Crea una automatización nueva desde el blueprint importado y selecciona tus entidades.

Instalación manual

1. Crea la carpeta /config/blueprints/automation/marstek_venus_energy_manager/ si no existe.
2. Copia dentro los archivos .yaml de la carpeta blueprints/ de este repositorio.
3. En Home Assistant, ve a Ajustes → Automatizaciones y escenas → Blueprints y pulsa Recargar blueprints. Si no aparece la opción, reinicia Home Assistant.
4. Crea una automatización nueva desde el blueprint instalado.

---

Añadir la integración

Después de instalar y reiniciar:

1. Ve a Ajustes → Dispositivos y servicios.
2. Pulsa + AÑADIR INTEGRACIÓN.
3. Busca Marstek Venus Energy Manager.
4. Sigue el asistente de configuración.