> For the complete documentation index, see [llms.txt](https://docs.smart-stuff.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smart-stuff.nl/dsmr-api/integratierecepten/zendure-home-assistant.md).

# Zendure-batterij lokaal aansturen met Home Assistant

DSMR-API-gebruiker **Jos** gebruikt een SmartStuff Ultra P1-dongle om een Zendure SolarFlow 2400 AC+ via Home Assistant aan te sturen. Hiervoor gebruikt hij het communityproject [Zendure-HA-zenSDK](https://github.com/Gielz1986/Zendure-HA-zenSDK).

De SmartStuff Ultra levert de actuele netafname en teruglevering via de HomeWizard-compatibele API. Het Home Assistant-pakket gebruikt die gegevens om de batterij lokaal via de zenSDK-interface te laden en te ontladen.

```
slimme meter → SmartStuff Ultra → HomeWizard API v1 → Home Assistant → zenSDK → Zendure-batterij
```

{% hint style="warning" %}
Dit is een door een gebruiker geteste combinatie en geen officiële SmartStuff- of Zendure-integratie. Het Home Assistant-pakket is software van derden en kan wijzigen. Volg bij installatie en gebruik van de batterij altijd de veiligheidsvoorschriften van de fabrikant.
{% endhint %}

## Benodigdheden

* Een SmartStuff Ultra P1-dongle met DSMR-API.
* Home Assistant.
* Een door Zendure-HA-zenSDK ondersteunde Zendure SolarFlow-batterij. Deze opstelling is getest met de **SolarFlow 2400 AC+**.
* De actuele bestanden en installatie-instructies van [Zendure-HA-zenSDK](https://github.com/Gielz1986/Zendure-HA-zenSDK).
* Een vast of gereserveerd IP-adres voor de P1-dongle en de batterij wordt aanbevolen.

## Koppeling controleren

Open in een browser, met het IP-adres van uw eigen dongle:

```http
http://<IP-ADRES-DONGLE>/api/v1/data
```

Controleer of het antwoord onder andere `active_power_w` bevat en of deze waarde verandert wanneer het actuele vermogen verandert. Het endpoint is onderdeel van de [HomeWizard-compatibele API](/dsmr-api/geavanceerd/api-overzicht.md#homewizard-compatible-api) van DSMR-API.

## Home Assistant en zenSDK instellen

1. Volg de actuele Nederlandstalige installatie-instructies in het bestand [`README.nl.md`](https://github.com/Gielz1986/Zendure-HA-zenSDK/blob/main/README.nl.md) van het project. Maak eerst een back-up van uw Home Assistant-configuratie.
2. Installeer het meegeleverde Home Assistant-pakket en de automatisering zoals daar beschreven.
3. Gebruik bij de HomeWizard P1-instelling van het pakket het IP-adres van de **SmartStuff Ultra**. De dongle biedt de verwachte HomeWizard API v1 lokaal aan.
4. Vul het lokale IP-adres van de Zendure-batterij in en schakel HEMS in de Zendure-app uit, zoals de projecthandleiding voorschrijft.
5. Herstart Home Assistant, controleer de aangemaakte entiteiten en activeer daarna de gewenste bedrijfsmodus.

De [P1/CT-meterpagina in de projectwiki](https://github.com/Gielz1986/Zendure-HA-zenSDK/wiki/Global-and-NL-%E2%80%90-P1-CT-meters-%28API%27s%29) bevat ook een voorbeeld voor HomeWizard API v1. Dat kan helpen wanneer u de P1-waarde eerst als aparte REST-sensor in Home Assistant wilt aanmaken.

## Resultaat

In de opstelling van Jos regelt Home Assistant het laden en ontladen op basis van de lokale P1-metingen. De dagelijkse aansturing van de batterij loopt lokaal via zenSDK en is daardoor niet afhankelijk van de Zendure-cloud.

{% hint style="info" %}
De Zendure-app kan nog nodig zijn voor ingebruikname of apparaatinstellingen. Met “lokaal” wordt hier bedoeld dat de normale regeling door Home Assistant via de lokale zenSDK-interface verloopt.
{% endhint %}

## Problemen oplossen

* Controleer of `/api/v1/data` vanaf het Home Assistant-systeem bereikbaar is.
* Reserveer beide IP-adressen in de DHCP-instellingen van uw router.
* Controleer of HEMS in de Zendure-app is uitgeschakeld.
* Gebruik steeds de nieuwste instructies en bestanden uit het Zendure-HA-zenSDK-project; namen van instellingen en ondersteunde modellen kunnen veranderen.
* Test eerst met beperkte laad- en ontlaadvermogens en controleer of afname en teruglevering de verwachte richting hebben.

Met dank aan **Jos** voor het delen en testen van deze integratie.