> 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/gebruik/productie-zonne-energie.md).

# Productie (Zonne-energie)

De dongle kan ook gekoppeld worden aan uw omvormer. Dit om de dag en actuele productie te kunnen zien. Helaas alleen nog voor deze merken:

* SolarEdge
* Enphase
* SMA

### Koppelen <a href="#koppelen" id="koppelen"></a>

Via menu > Settings > Solar Setup kunt u bij de configuratie komen. Via dit scherm wordt de configuratie ingegeven. Dit kan ook voor beide systemen.

{% hint style="warning" %}
Voor SMA dient er een bestand geupload te worden
{% endhint %}

<figure><img src="/files/tk7cbQlDZm3OluPGeoul" alt="" width="375"><figcaption></figcaption></figure>

#### Multi vendor systeem <a href="#multi-vendor-systeem" id="multi-vendor-systeem"></a>

Heeft u zonnepanelen met omvormers van Enphase + SolarEdge dan worden deze beide ondersteund. De opwekking van beide systemen worden los van elkaar gelezen en gecombineerd (opgeteld) weergegeven. Lekker makkelijk toch ... alles in 1 overzicht.

#### SMA <a href="#enphase-iq-gateway" id="enphase-iq-gateway"></a>

De SMA omvormers worden uitgelezen op basis van het uitlezen van WebConnect. De omvormer dient dit te ondersteunen.

Er dient een `sma.json` bestand te worden aangemaakt en op de dongle te worden gezet\
{\
"gateway-url": "\<ip adres van de sma omvormer>",\
"token": "\<SMA\_USER\_WACHTWOORD>",\
"wp": 0,\
"siteid": 0,\
"refresh-interval": 15\
}

Alleen gateway-url en token dienen ingevuld te worden. Wilt u de sma.json wijzigen dan kunt u de gewijzigde file uploaden. Daarna de dongle rebooten.

#### Enphase IQ Gateway <a href="#enphase-iq-gateway" id="enphase-iq-gateway"></a>

Voor Enphase dient minimaal het Token ingevuld te worden.

{% hint style="warning" %}
Door een bug in de nieuwste release van de IQ Gateway-software worden de productiegegevens via het oude eindpunt niet meer doorgegeven. Pas daarom `gateway-url` aan naar `https://<ip-adres of hostname Envoy>/ivp/pdm/energy`.
{% endhint %}

| gateway-url      | <https://envoy/ivp/pdm/energy> | URL van de lokale IQ Gateway. Is deze niet via `envoy` bereikbaar, vul dan het IP-adres of de hostname van de Envoy in. |
| ---------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| wp               | 3300                           | systeemvermogen in Wp. deze wordt gebruikt voor het bepalen van het benuttig van het totaal.                            |
| expire           | 0                              | waarde 0 is geen check. Indien gevuld zal de Monitor checken of het token verlopen is.                                  |
| refresh-interval | 60                             | per x seconde zal de data uit de IQ Gateway worden opgehaald. Deze kan ingesteld worden.                                |
| token            | geheim per gebruiker/site      | ​                                                                                                                       |

\
**STAP 1: Verkrijgen van Token**

Dit gaat nogal omslachtig bij Enphase. U gebruikt eerst een tijdelijk token om de lokale webinterface te openen. Daarna maakt u met het serienummer van de IQ Gateway een owner token aan dat 1 jaar geldig is.

1\) Log in met uw Enphase-account om een tijdelijk access token te verkrijgen. Dit token is 12 uur geldig. Ga naar \[<https://entrez.enphaseenergy.com/>) en kies **Login**.

<figure><img src="https://docs.smart-stuff.nl/~gitbook/image?url=https%3A%2F%2F51680982-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FOLi8uKVPCtT26B5HWACG%252Fuploads%252FcAw1vNNGTQLZ3gokeyR9%252FScreenshot%25202025-01-26%2520at%252010.45.01.png%3Falt%3Dmedia%26token%3D369c2e89-cb80-48bd-a769-1dda488a6d5d&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=ee9422c0&#x26;sv=2" alt=""><figcaption></figcaption></figure>

2\) Kopieer het tijdelijke access token, plak dit op de lokale **Enter Token**-pagina en open daarmee de lokale webinterface van de IQ Gateway.

<figure><img src="/files/eEcJ2Ci2ZhmLP4J7ApG4" alt="Envoy Enter Token-pagina" width="500"><figcaption><p>Plak het tijdelijke access token en kies Authenticate.</p></figcaption></figure>

{% hint style="info" %}
Dit tijdelijke token wordt alleen gebruikt om de lokale webinterface te openen. Gebruik dit 12-uurs token niet in DSMR-API.
{% endhint %}

4\) Ga in de lokale webinterface naar **Settings** en kopieer het **Serial Number** van de IQ Gateway.

5\) Open in dezelfde browser een ander tabblad en plak onderstaande URL. Voeg na het `=`-teken het serienummer uit stap 4 toe.

<https://enlighten.enphaseenergy.com/entrez-auth-token?serial_num=>\<serienummer uit stap 4>

6\) Kopieer uit het getoonde JSON-document uitsluitend de waarde van `token`. Dit is het owner token dat 1 jaar geldig is. Vul dit owner token in bij de Enphase-instellingen van DSMR-API.

{% hint style="warning" %}
Het owner token voor DSMR-API is maximaal 1 jaar geldig. Na een jaar dient u de handeling te herhalen.
{% endhint %}

#### SolarEdge <a href="#solaredge" id="solaredge"></a>

De verschillende waardes dienen ingevuld te worden waarbij "token" en "SiteID" de belangrijkste zijn.

| gateway-url      | niet van toepassing       | niet gebruikt                                                                                                                            |
| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| wp               | 3300                      | systeemvermogen in Wp. deze wordt gebruikt voor het bepalen van het benuttig van het totaal.                                             |
| expire           | 0                         | waarde 0 is geen check. Indien gevuld zal de Monitor checken of het token verlopen is.                                                   |
| refresh-interval | 300                       | per x seconde zal de data worden gelezen. v1 koppeling mag maximaal 300 keer per dag worden gelezen dan is ca elke 5 minuten een update. |
| token            | geheim per gebruiker/site | Deze kunt u van uw installateur opvragen of heeft u al een keer ontvangen. Dit wordt ook wel de X-API-Key genoemd.                       |
| siteid           | geheim per gebruiker/site | Deze kunt u van uw installateur opvragen of heeft u al een keer ontvangen.                                                               |

{% hint style="info" %}
Om het SolarEdge token te kunnen opvragen/maken dient u admin te zijn op uw systeem. Mocht u dat niet zijn dan dient u SolarEdge/Installateur te vragen om dit te doen.
{% endhint %}