SAMDUO Nex E6000 lokaal aansturen met Home Assistant: elf laadstrategieën in één integratie

De SAMDUO Nex E6000 is een stekkerbatterij van 6 kWh in een behuizing van nog geen 12 centimeter dik. Wil je hem slim laten laden en ontladen op het overschot van je eigen zonnepanelen of op dynamische energieprijzen, dan wil je hem aansturen vanuit Home Assistant. En dat kan! Er is een lokale API beschikbaar, zodat je je batterij onafhankelijk van de cloud kan aansturen. Een kant-en-klare integratie daarvoor was er nog niet, dus heb ik er zelf een gebouwd: SAMDUO Nex Local voor Home Assistant.

De integratie werkt volledig lokaal en heeft elf laadstrategieën ingebouwd, van gewoon nul op de meter tot handelen op dynamische prijzen. Je hebt er geen YAML-packages, hulpautomatiseringen of Node-RED voor nodig. In dit artikel lees je wat hij doet, wat je nodig hebt en hoe je hem installeert.

Volledig lokaal, zonder cloud

SAMDUO heeft een Open API gepubliceerd waarmee je de batterij via je eigen netwerk kunt uitlezen en aansturen. De integratie praat via die API rechtstreeks met de batterij, over TCP-poort 3335. Er komt geen cloud aan te pas en je hebt geen account nodig. Staan Home Assistant en de batterij in hetzelfde netwerk, dan vindt Home Assistant de batterij vanzelf. Lukt dat niet, dan kun je hem ook met zijn IP-adres toevoegen.

Een belangrijke instelling vooraf: zet HEMS Managed uit in de SAMDUO-app. Staat die aan, dan regelt de batterij zichzelf op zijn eigen P1-meter en negeert hij stilletjes elke opdracht van buitenaf. De integratie merkt dat op en geeft dan een melding in Home Assistant onder Reparaties.

Let ook op: de batterij accepteert maar één verbinding tegelijk. Houden de sensoren op met bijwerken terwijl de SAMDUO-app openstaat, sluit de app dan. De integratie maakt daarna zelf weer verbinding.

Laadstrategieën

De laadstrategieën zijn gebaseerd op het bekende Zendure-package van Gielz1986. Dat package draait op een flinke set YAML-automatiseringen en hulpentiteiten. In deze integratie zit alle logica in de integratie zelf. Je kiest één modus en de integratie doet de rest.

Een aparte sensor laat zien wat de integratie op dat moment doet, bijvoorbeeld ontladen naar nul op de meter of laden in een goedkope periode. Zo zie je altijd waarom de batterij doet wat hij doet.

Wat heb je nodig?

• Home Assistant 2025.3 of nieuwer.
• Een SAMDUO Nex-batterij in hetzelfde netwerk. De integratie is getest op de Nex E6000 en de Nex E6000H. Andere Nex-modellen spreken volgens SAMDUO hetzelfde protocol, maar heb ik niet getest.
• Een P1-sensor voor nul op de meter. Bijvoorbeeld een HomeWizard P1-meter of een andere snelle sensor die het vermogen op je meter in watt geeft.
• Een prijssensor voor de dynamische modi. Bijvoorbeeld Nordpool, ENTSO-e of EnergyZero, met de prijzen van vandaag en morgen.

Alles in te stellen vanuit Home Assistant

Alle instellingen staan als entiteiten in Home Assistant. Met de knop Adviesinstellingen overnemen zet je ze in één keer op verstandige standaardwaarden. Daarna kun je ze bijstellen:

• Goedkope en dure periodes. Standaard kiest de integratie per dag de 3 goedkoopste en de 3 duurste uren. Werk je met kwartierprijzen, dan zet je de kwartierperiodes aan.
• Spread en spread NOM. De dynamische modi laden alleen bij als het prijsverschil tussen goedkoop en duur groot genoeg is. Spread NOM telt alleen de dure periodes na de eerste goedkope periode mee: stroom die je ’s nachts koopt, levert alleen iets op tegen de prijzen die je later die dag uitspaart.
• Handmatige periodes. Wil je zelf bepalen wanneer de batterij laadt en ontlaadt, dan overschrijf je de automatische keuze voor een dag.
• Laadtoestand. Een minimale en maximale laadtoestand, plus een beveiliging die de batterij bijlaadt als hij onder het minimum zakt.
• Marges en startdrempels voor nul op de meter. Zo begint de batterij niet bij elke kleine schommeling op je meter te laden of te ontladen.

Het maximale laad- en ontlaadvermogen staat standaard op 800 watt, de grens voor een batterij in een gewoon stopcontact. Heb je de batterij op een eigen groep, dan kun je dat verhogen tot maximaal 2.600 watt. Houd die waarde wel gelijk aan of lager dan de grens in de SAMDUO-app.

Let bij het combineren met andere integraties op het teken: bij deze integratie is positief ontladen en negatief laden. Dat is de conventie van de batterij zelf.

Entiteiten

Naast de instellingen maakt de integratie een flinke set sensoren aan. Ze worden standaard elke 5 seconden bijgewerkt. De belangrijkste:

• Laadpercentage: hoe vol de batterij is.
• Batterijvermogen: hoeveel watt de batterij nu laadt of ontlaadt.
• Energie geladen en Energie ontladen: de totaaltellers in kWh, die je direct in het energiedashboard van Home Assistant kunt gebruiken.
• Strategie: wat de integratie op dit moment doet, bijvoorbeeld laden in een goedkope periode.
• Huisverbruik: het verbruik van je huis, berekend uit je P1-meter en het batterijvermogen.
• Beschikbare energie en Energie tot vol: hoeveel kWh er nog in de batterij zit boven het minimum, en hoeveel er nog bij past.
• Resterende ontlaadtijd en oplaadtijd: hoe lang het bij het huidige vermogen nog duurt tot de batterij leeg of vol is.
• Huidige prijs, Spread en Spread NOM: de stroomprijs van dit moment en het prijsverschil tussen de goedkope en dure periodes, voor vandaag en morgen.
• Goedkope periode en Dure periode: staan aan tijdens een goedkope of dure periode, handig voor je eigen automatiseringen.

Daarnaast zijn er diagnostische sensoren voor de gezondheid van de batterij, zoals de batterijgezondheid (SOH), de netspanning en -frequentie, de temperaturen van de omvormer en de foutcode. Die zie je terug in de health-weergave van het dashboard.

Veilig als Home Assistant uitvalt

Elke opdracht die de integratie naar de batterij stuurt, valt onder de watchdog van de batterij zelf. Crasht Home Assistant of valt het netwerk weg, dan maakt de batterij zichzelf binnen 90 seconden weer vrij. Hij blijft dus niet hangen op een laad- of ontlaadopdracht. Valt je P1-sensor weg, dan zet de integratie de batterij in de nul-op-de-metermodi op 0 watt tot de sensor terug is.

Een kant-en-klaar dashboard

Bij de integratie hoort een dashboard dat je zo kunt plakken. Je ziet de prijzen per uur als balken: groen voor goedkoop, rood voor duur en grijs voor de rest, met de uren die al voorbij zijn vervaagd. Daarnaast zijn er grafieken van het vermogen en de laadtoestand, en staan alle instellingen bij elkaar. Een tweede tabblad laat de gezondheid van de batterij zien: temperaturen, netspanning en -frequentie, en de geschiedenis van modus en strategie. Voor het dashboard heb je de apexcharts-card uit HACS nodig.

Zo installeer je de integratie

De integratie is te installeren via HACS. Klik op de knop hieronder om de repository in je eigen Home Assistant te openen, of voeg in HACS handmatig https://github.com/DannyOosterveer/ha-samduo-local toe als custom repository met als categorie Integratie.

1. Installeer SAMDUO Nex in HACS en herstart Home Assistant. Zonder HACS kun je ook de map custom_components/samduo naar je eigen custom_components-map kopiëren.
2. Zet in de SAMDUO-app HEMS Managed uit.
3. Ga naar Instellingen en dan Apparaten en diensten. De batterij staat daar als gevonden apparaat. Bevestig hem en geef hem een naam. Je kunt de integratie ook zelf toevoegen met de knop hieronder.
4. Open Configureren bij de integratie en kies je P1-sensor en je prijssensor.
5. Druk één keer op Adviesinstellingen overnemen en kies een modus.

Het dashboard vind je in de map dashboard van de repository. Maak in Home Assistant een nieuw, leeg dashboard aan, open de raw configuratie-editor en plak het bestand erin. Heb je je batterij een andere naam gegeven dan Samduo, vervang dan samduo_ door die naam.