# Opwekking (zonne-energy)

<https://envoy/api/v1/production>Vanaf software versie 1.2.0 is het ook mogelijk om de opbrengst van je zonnepanelen op het scherm te tonen.

Hieronder hoe dit in te stellen is en wat de gegevens zeggen.

{% hint style="warning" %}
Bij veranderingen aan de .json bestanden op de dongle altijd de NRG Monitor herstarten.

NRG Monitor leest de bestanden alleen in tijdens het opstarten.
{% endhint %}

## Koppelen

Op de P1 Dongle Pro (of Ultra/variant) wordt een json bestandje gezet met de configuratie van de koppeling. Dit kan nu voor de Enphase IQ Gateway en SolarEdge (v1) systemen. Wellicht ook andere systemen in de toekomst.

<figure><img src="/files/f3o57a8LqUy8TTeX4uLB" alt=""><figcaption><p>P1 Dongle Pro - twee zonnesystemen (SolarEdge + Enphase)</p></figcaption></figure>

### Multi vendor systeem

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.

### Enphase IQ Gateway

Op de P1 Dongle (Pro/H2O/Ultra) dient een bestandje gezet te worden met de volgende gegevens:

bestandsnaam: enphase.json

voorbeeld inhoud:&#x20;

```
{"gateway-url":"https://envoy/api/v1/production",
 "wp":3300,
 "expire":1737323745,
 "refresh-interval": 60,
 "token":"<token>" 
 }
```

De verschillende waardes dienen ingevuld te worden waarbij "token" het belangrijkste is. In vele andere gevallen zijn de andere waarden bruikbaar.

<table><thead><tr><th width="167">naam</th><th>standaard waarde</th><th>omschrijving</th></tr></thead><tbody><tr><td>gateway-url</td><td>https://envoy/api/v1/production</td><td>url van de lokale IQ Gateway. Mocht deze niet op envoy te bereiken zijn dan kan voor envoy ook het ip-adres ingevuld worden</td></tr><tr><td>wp</td><td>3300</td><td>systeemvermogen in Wp. deze wordt gebruikt voor het bepalen van het benuttig van het totaal.</td></tr><tr><td>expire</td><td>0</td><td>waarde 0 is geen check. Indien gevuld zal de Monitor checken of het token verlopen is.</td></tr><tr><td>refresh-interval</td><td>60</td><td>per x seconde zal de data uit de IQ Gateway worden opgehaald. Deze kan ingesteld worden. </td></tr><tr><td>token</td><td>geheim per gebruiker/site</td><td></td></tr></tbody></table>

**STAP 1: Verkrijgen van Token**

Blijkbaar moet dit nogal moeilijk gaan bij Enphase ... het normale token is 12uur geldig en dat werkt niet.&#x20;

Via onderstaande procedure krijgt u een 1 jaar geldig token.

1\) ga naar uw lokale envoy systeem via : <https://envoy/home>

<figure><img src="/files/ZTjiFqIrLxfpncOv4Z0S" alt=""><figcaption></figcaption></figure>

2\) druk op login with Enphase&#x20;

<figure><img src="/files/phHl8KdjqJGvUJeJuobP" alt=""><figcaption></figcaption></figure>

3\) vul username en password in en druk op log in

U krijgt het ingelogd scherm en dient even te wachten voordat u terug gaat naar uw lokale envoy&#x20;

4\) kopieer Serial Number&#x20;

5\) in dezelfde browser (ander tab)  plakt u onderstaande url + na het "=" het serienummer uit stap 4

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

6\) Kopieer het access token. Aan de verlooptijd (einde van het data pakket) kunt u zien dat deze 1 jaar geldig is.

{% hint style="warning" %}
De tokens zijn maximaal 1 jaar geldig. Na een jaar dient u de handeling te herhalen.
{% endhint %}

### SolarEdge

Op de P1 Dongle (Pro/H2O/Ultra) dient een bestandje gezet te worden met de volgende gegevens:

bestandsnaam: solaredge.json

voorbeeld inhoud:&#x20;

```
{
 "gateway-url":"",
 "siteid": 123456
 "wp":3300,
 "expire": 0,
 "refresh-interval": 300,
 "token":"<token>" 
 }
```

De verschillende waardes dienen ingevuld te worden waarbij "token" het belangrijkste is. In vele andere gevallen zijn de andere waarden bruikbaar.

<table><thead><tr><th width="167">naam</th><th>standaard waarde</th><th>omschrijving</th></tr></thead><tbody><tr><td>gateway-url</td><td>niet van toepassing</td><td>niet gebruikt</td></tr><tr><td>wp</td><td>3300</td><td>systeemvermogen in Wp. deze wordt gebruikt voor het bepalen van het benuttig van het totaal.</td></tr><tr><td>expire</td><td>0</td><td>waarde 0 is geen check. Indien gevuld zal de Monitor checken of het token verlopen is.</td></tr><tr><td>refresh-interval</td><td>300</td><td>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.</td></tr><tr><td>token</td><td>geheim per gebruiker/site</td><td>Deze kunt u van uw installateur opvragen of heeft u al een keer ontvangen.  Dit wordt ook wel de X-API-Key genoemd.</td></tr><tr><td>siteid</td><td>geheim per gebruiker/site</td><td>Deze kunt u van uw installateur opvragen of heeft u al een keer ontvangen.</td></tr></tbody></table>

## Uitleg

Naast de basis functionaliteit van de NRG Monitor voegt de opwekking functie enkele elementen toe. Dit werkt voor alle omvormers identiek. Bij gebruikt van meerdere omvormers worden de ingelezen waardes bij elkaar opgeteld.

<figure><img src="/files/L36V4unzUFTg04LdVJ3Z" alt=""><figcaption></figcaption></figure>

In het midden boven de elektra cirkel komen twee "oren" en een zonnetje te staan. HIeronder een verklaring van deze items

<table><thead><tr><th width="136">Item</th><th></th></tr></thead><tbody><tr><td>zonnetje</td><td>wordt geel zodra er opwekking plaatsvind (Aantal Watts > 0); anders is deze grijs</td></tr><tr><td>Linker oor</td><td>Geeft het opgewekte dagvermogen in Wh aan. De groene indicatie laat zien hoeveel van het totale potentieel benut wordt. Het systeemvermogen wordt hiervoor gebruikt en teruggerekend naar dag opwekking op basis van geschat jaaropbrengst</td></tr><tr><td>Rechter oor</td><td>Geeft het de actuele opwekking in Watts aan. De groene indicatie laat zie hoeveel energie er op dat moment opgewekt wordt ten opzichte van het maximale potentieel. Maximale potentieel is systeemvermogen * 85%.</td></tr></tbody></table>

De dagopbrengst en actuele opwekking komen uit de Enphase IQ Gateway.&#x20;

De indicaties worden berekend op basis van het systeemvermogen en zullen afwijken. Ligging, hellingshoek, temperatuur, leeftijd spelen allemaal mee en zijn niet opgenomen in de schatting.  Eventueel kunt u via aanpassing van systeemvermogen in het enphase.json bestand nog wat tweaken met deze indicatoren.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smart-stuff.nl/nrg-monitor/opwekking-zonne-energy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.