JJOXU

GoodWe ESA & ETA · JOXU Edge

Je GoodWe-batterij slim regelen.

JOXU maakt een plan voor het laden en ontladen van je batterij. Een klein wifi-kastje bij jou thuis, een ESP32, geeft de opdrachten door aan je omvormer. De omvormer maakt de stroom van je batterij bruikbaar voor je huis. Hieronder leggen we uit hoe je de verbinding maakt.

De ESP32 maakt zelf de verbinding met JOXU. Voor deze koppeling is geen inkomende poort of VPN naar je thuisnetwerk nodig.

Zo loopt een opdracht

1 · JOXU maakt de opdracht klaar

JOXU stelt een opdracht beschikbaar voor de gekoppelde installatie. Bijvoorbeeld een ondersteunde instelling voor het laden of ontladen van de batterij.

2 · De ESP32 haalt de opdracht op

De ESP32 start zelf een uitgaande HTTPS-verbinding met JOXU en vraagt of er een opdracht klaarstaat.

3 · Modbus voert het lokaal uit

De ESP32 communiceert binnen je thuisnetwerk met de omvormer via Modbus TCP. Hij leest de instelling terug en meldt het resultaat aan JOXU.

Wat is een ESP32?

Een ESP32 is een kleine programmeerbare chip met wifi. Je koopt hem meestal als een compact printplaatje met een USB-aansluiting. Met de JOXU-software erop wordt het de lokale schakel tussen JOXU en je GoodWe-omvormer.

Je sluit het printplaatje aan op USB-voeding en verbindt het met je wifi-netwerk. De ESP32 haalt opdrachten op bij JOXU en communiceert via je lokale netwerk met de omvormer. Na het installeren en instellen hoeft je computer niet aangesloten te blijven.

Een ESP32 voor de eerste klanten in Nederland

De eerste klanten in Nederland krijgen van JOXU een ESP32. In ruil daarvoor gebruiken we de gegevens die de koppeling oplevert om JOXU verder te ontwikkelen en de aansturing te verbeteren.

Het gaat om gegevens over je energie-installatie, zoals batterijstatus, vermogen en de resultaten van opdrachten. Voor deelname stemmen we af welke gegevens worden gebruikt en hoe je installatie wordt gekoppeld.

Zelf kopen: welk model is geschikt?

Je kunt het printplaatje zelf kopen. Zoek naar ESP32-C3 SuperMini met native USB-C en minimaal 4 MB flashgeheugen. De JOXU-firmware is voor deze uitvoering gemaakt, met de led op GPIO8 en de BOOT-knop op GPIO9.

Hardware voor de huidige JOXU-firmware
  • ESP32-C3 SuperMini: de ondersteunde uitvoering. De TENSTAR ESP32-C3 SuperMini is het in de JOXU-documentatie genoemde bord.
  • Andere C3-borden: geschiktheid is niet bevestigd; alleen dezelfde chipnaam is onvoldoende.
  • ESP32, ESP32-S2, ESP32-S3, ESP32-C6 en ESP8266: niet ondersteund door deze firmware.

Mogelijke verkooppunten:

Controleer bij de verkoper of de gekozen uitvoering een ESP32-C3 SuperMini met native USB-C en minimaal 4 MB flashgeheugen is. Productvarianten en beschikbaarheid kunnen veranderen.

Gebruik een USB-kabel die ook gegevens kan overbrengen, een geschikte USB-voeding en een 2,4 GHz-wifi-netwerk. Controleer de specificaties van de verkoper voordat je bestelt.

Zelf de JOXU-software installeren

De JOXU-software op de ESP32 heet firmware. Je kunt deze via USB vanuit de JOXU-omgeving installeren, wanneer de Edge-installatiefunctie voor jouw omgeving beschikbaar is.

  1. Sluit de ESP32-C3 SuperMini met een USB-datakabel aan op je computer.
  2. Open JOXU op je computer in Chrome of Microsoft Edge.
  3. Ga naar Apparaten, voeg een JOXU Edge toe of open het apparaatbeheer en kies de installatie via USB.
  4. Selecteer de USB-poort van je ESP32 en volg de installatiestappen.
  5. Stel daarna wifi in en meld de ESP32 aan met je JOXU-inschrijfcode.

Voor de eerste USB-installatie gebruik je een computer. Deze installatie werkt niet via Safari of een iPhone. Bij een gekoppeld apparaat met geschikte firmware kunnen latere updates via de bestaande uitgaande verbinding worden opgehaald.

Koppelen via het inschrijfformulier

Een ESP32 met JOXU-software is nog niet aan jouw installatie gekoppeld. Dat doe je zelf met een eenmalige inschrijfcode en een bevestiging in JOXU.

  1. Maak een inschrijfcode aan. Als eigenaar maak je in JOXU bij Apparaten een code voor jouw installatie aan. Je bevestigt dit met je JOXU-wachtwoord. De code is eenmalig bruikbaar en 24 uur geldig.
  2. Verbind met de ESP32. Een nog niet ingestelde ESP32 maakt een tijdelijk wifi-netwerk aan met de naam JoxuEnergyXXXX. De laatste vier tekens verschillen per apparaat.
  3. Vul het inschrijfformulier in. Open op dat tijdelijke netwerk http://10.0.0.1. Kies je eigen wifi-netwerk en vul je wifi-wachtwoord en JOXU-inschrijfcode in. Voer hier niet je JOXU-accountwachtwoord in.
  4. Bevestig de koppeling in JOXU. De ESP32 meldt zich aan en wacht op jouw bevestiging. Koppel hem bij Apparaten aan de juiste omvormer en stel het lokale Modbus-adres in. De gebruikelijke poort is 502; adres en unit-ID moeten bij jouw omvormer passen.
  5. Controleer de verbinding. Pas na het koppelen kunnen opdrachten worden aangeboden. Controleer in JOXU of de ESP32 online is en de omvormer bereikbaar is.

Het inschrijfformulier op de ESP32 stelt wifi en de aanmelding in. De definitieve koppeling aan jouw omvormer bevestig je als eigenaar in JOXU.

Wat is Modbus?

Modbus is een afgesproken manier waarop apparaten met elkaar praten. Zo geven ze gegevens en instellingen door. Bij deze koppeling gebruikt de ESP32 Modbus TCP om lokaal met de GoodWe-omvormer te communiceren. De omvormer moet daarvoor een geschikte en ingeschakelde Modbus-interface hebben.

De opdrachten en registers hangen af van het exacte omvormermodel en de firmware. Daarom controleren we de uitvoering voordat we de koppeling in gebruik nemen.

Wat betekent dit voor je thuisnetwerk?

De JOXU-cloud maakt geen rechtstreekse verbinding met je omvormer. De cloud opent geen Modbus-poort in je thuisnetwerk en gebruikt voor deze koppeling geen VPN of algemene netwerktunnel.

De ESP32 is de lokale schakel. Hij haalt de voor jouw installatie bedoelde opdrachten op, communiceert met de gekoppelde omvormer en stuurt het resultaat terug. Deze opzet geeft JOXU geen algemene toegang tot andere apparaten op je netwerk.

De lokale Modbus-verbinding blijft onderdeel van je thuisnetwerk. Een uitgaande cloudverbinding betekent niet automatisch dat ieder lokaal apparaat of iedere lokale verbinding beveiligd is.

GoodWe ESA en ETA

De ESA-serie combineert omvormer en batterij in een geïntegreerd opslagsysteem. GoodWe vermeldt Modbus RTU en Modbus TCP voor de ESA 3–10 kW-serie. Binnen de JOXU-documentatie is de lokale ESP32-koppeling beschreven voor de GW15K-ETA-G20.

Geschiktheid controleren we per model, firmware en communicatie-interface. De vermelding van een serie is geen bevestiging dat iedere uitvoering al met JOXU is getest.

Een opdracht versturen is nog geen bewijs van laden

Na een opdracht controleert de ESP32 de instelling op de omvormer en geeft hij het resultaat terug. Om vast te stellen dat de batterij daadwerkelijk laadt of ontlaadt, zijn ook actuele vermogens- en batterijgegevens nodig.

Aan de slag met jouw GoodWe

Open JOXU om je installatie aan te melden. Gebruik de handleidingen voor het installeren en koppelen van je ESP32.