> 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/start-1/schermuitleg.md).

# Schermuitleg

![startscherm](/files/tkbBEJLpUN4m2BX995se)

De navigatie van de dongle bestaat uit meerdere delen:

* menubalk bovenaan
* tijdsaanduiding (komt uit de slimme meter) rechtsboven
* het dashboard met meerdere gegevens. Elk onderdeel wordt hier onder uitgelegd.
* wachtindicatie (spinner) als in het midden van het scherm. Nieuwe gegevens worden gehaald van de dongle.
* rechtsonder de firmware versie van de dongle

### Menubalk

In de menu zijn de volgende opties opgenomen

{% tabs %}
{% tab title="Home" %}
klik op het home icoon om bij het dashboard uit te komen
{% endtab %}

{% tab title="Dash" %}
Geeft de actuele en historische gegevens van de afgelopen 3 dagen weer in diverse "tegels"
{% endtab %}

{% tab title="Actueel" %}
Actuele informatie uit slimme meter en eventueel gas en water.
{% endtab %}

{% tab title="Uur/Dag/Maand" %}
De verbruikscijfers weergegeven per dag/maand/jaar
{% endtab %}

{% tab title="(i)" %}
Via het <img src="/files/4qPrrwaGdahuEXHb43c4" alt="" data-size="line"> icoon kunt u diverse soorten informatie inzien. Namelijk:

1. Systeem info : informatie over de adapter zoals versie, capaciteit
2. Webpagina:
3. Telegram : ruwe data uit de slimme meter
4. All Fields : alle slimme meter data
5. APIDocs : informatie over de mogelijkheid om de gegevens op afstand te kunnen uitlezen
   {% endtab %}

{% tab title="folder" %}
Via het <img src="/files/ttzop5wZ03oi1MvK2g3D" alt="" data-size="line">icoon komt u bij het bestandsbeheer. Hier zijn de configuratie, log en data bestanden te vinden. Tevens kunnen bestanden gedownload worden en nieuwe geupload.
{% endtab %}

{% tab title="settings" %}
Via het <img src="/files/Uf13OdsrdympvDtZo6G8" alt="" data-size="line"> icoon kunt u diverse soorten informatie inzien en/of bewerken, namelijk:

* systeeminstellingen
* maandstanden handmatig invoeren
* reset & update menu
  {% endtab %}

{% tab title="datum/tijd" %}
datum en tijd uit de slimme meter. Kan tot 10 seconden afwijking in zitten in verband met snelheid van verversen
{% endtab %}
{% endtabs %}

### Dashboard

Het dashboard toont een combinatie van actuele en historische gegevens van maximaal 3 dagen. Het aantal onderdelen is afhankelijk van uw situatie. Als u bijvoorbeeld geen gasaansluiting heeft, ziet u hier ook geen gegevens over.

{% hint style="info" %}
Klik op het potlood rechtsboven in het dashboard om beschikbare tegels te tonen of te verbergen. In dezelfde bewerkmodus kan de weergave van actueel vermogen tussen Watt en kW worden gewisseld. Zie [Dashboard aanpassen](/dsmr-api/instellingen/frontend-instellingen.md).
{% endhint %}

<details>

<summary>Actueel (altijd zichtbaar)</summary>

* Levert uw systeem terug dan is de kop groen, neemt u af dan wordt hij rood.
* Wekt u zelf geen energie op dan zal de kop altijd blauw blijven
* Bij slimme meter versie 4 en 5: Wanneer u meer dan 1 stroomfase heeft worden alle weergegeven
* Per boog is het actuele stroomverbruik zichtbaar en onder in het totale
* De verdeling van het stroom over de fases is via de bogen te zien (load balacing)
* Onder Actueel \[kW] is de actuele totale belasting/teruglevering te zien
* Min/max zijn de minimale en maximale waardes gemeten voor de duur dat de webpagina getoond wordt.

</details>

<details>

<summary>Afname (altijd zichtbaar)</summary>

* De boog toont de gegevens van vandaag, gisteren en eergisteren
* Daaronder de afname van vandaag
* Afname = wat afgenomen wordt van het net

</details>

<details>

<summary>Teruglevering (alleen bij systemen die terugleveren)</summary>

* Boog zijn de gegevens van vandaag, gisteren en eergisteren
* Daaronder de teruglevering van vandaag
* Teruglevering = wat het netwerk heeft ontvangen van uw zelf opgewekte energie

</details>

<details>

<summary>Afname - Terug (alleen bij systemen die terugleveren)</summary>

* Boog zijn de gegevens van vandaag, gisteren en eergisteren
* Daaronder de afname - teruglevering van vandaag
* Deze indicator geeft aan wat er afgenomen of teruggeleverd wordt per dag

</details>

<details>

<summary>Electra (alleen bij systemen die niet terugleveren)</summary>

* Boog zijn de gegevens van vandaag, gisteren en eergisteren
* Daaronder de afname van vandaag

</details>

<details>

<summary>Gas (afhankelijk van uw aansluiting)</summary>

* Boog zijn de gegevens van vandaag, gisteren en eergisteren
* Daaronder het gasverbruik van vandaag

</details>

<details>

<summary>Water (afhankelijk van de dongle)</summary>

* Boog zijn de gegevens van vandaag, gisteren en eergisteren
* Daaronder het waterverbruik van vandaag

</details>

<details>

<summary>Spanning (soms zichtbaar)</summary>

* De boog toont de actuele gegevens van de spanning per fase.
* Daaronder het aantal fases in uw systeem
* Min en max waardes zijn de minimale en maximale spanning over alle fases heen zolang de browser actief is

</details>

### Actueel

In het actueel scherm zijn alle huidige waardes te zien. Hieronder een voorbeeld.

<div align="left"><img src="/files/3RrP0CUKneOHMlboH7bm" alt="actueel scherm"></div>

In uw situatie kunnen er meer of minder gegevens staan afhankelijk van de hoeveelheid fases en andere voorzieningen.

Gegevens spreken redelijk voor zich.

### Uur / Dag / Maand schermen

Voorbeeld hieronder is dagtabel te zien en maand grafiek.

{% hint style="danger" %}
Bedragen in de dongle zijn bij benadering en kunnen afwijken van de kosten die door de energieleverancier in rekening worden gebracht.
{% endhint %}

![dagtabel](/files/EiQ88tMSxG2LgEqhFgCM)

In de tabel is het verbruik per dag te zien met daarachter de kosten. Bij de maandtabel dienen de kosten zichtbaar gemaakt te worden middels een vinkje.

![maandgrafieken](/files/X5vncFYOD5NZVIXAwhGQ)

In de grafieken is het verloop per maand te zien door het jaar heen. De maanden worden vergeleken met de maand van het vorige jaar wanneer de dongle langer dan 13 maanden in bedrijf is.

In het voorbeeld ontbreekt 1 maand. Dat is de maand waarin de slimme meter gewisseld is en weer op 0 is begonnen. Wisselen van de slimme meter is nog geen voorziening voor.

### Informatie

Informatie menu bestaat uit meerdere submenus. Hieronder per submenu de uitleg.

<details>

<summary>Systeeminformatie</summary>

in dit scherm zijn alle systeem gegevens te zien. Zijn er best wat;-)

</details>

<details>

<summary>Telegram</summary>

De slimme meter stuurt eens per x seconden een datapakket op. Dit heet een Telegram. De ruwe data zijn uit te lezen via dit scherm

</details>

<details>

<summary>Alle velden</summary>

Alle Telegram velden zijn in dit scherm te zien. Wanneer er geen informatie is voor een veld staat er een "-".

</details>

<details>

<summary>API Documentatie</summary>

Naast het inzicht van de webpagina's is de dongle data ook gemakkelijk te delen met andere systemen. Dit kan via MQTT (zie geavanceerd) of via een API. Zie [API overzicht](/dsmr-api/geavanceerd/api-overzicht.md) voor de beschikbare endpoints.

</details>

### Folder (Bestandsbeheer)

De dongle slaat zijn configuratiegegevens en meterdata op in bestanden. Deze bestanden worden weergegeven. Elk bestand kunt u afzonderlijk downloaden of uploaden. Met **Download all** worden alle zichtbare bestanden achter elkaar gedownload.

Welke bestanden kunt u hier vinden.

* DSMRindexEDGE.html -> dit is de index file voor het aanroepen van de broswer webpagina. Deze kan verwijderd worden. De dongle download dan direct een nieuwe versie
* DSMRsettings.json -> alle settings van de dongle
* P1.log -> logging van de dongle wordt hierin opgeslagen. Zodra deze te lang wordt zal er een nieuwe P1.log aangemaakt worden en de oude wordt genoemd naar P1\_old.log
* P1\_old.log -> zie P1.log
* RNGdays.json -> hierin worden de dagstanden opgeslagen
* RNGhours.json -> hierin worden de uurstanden opgeslagen
* RNGmonths.json -> hierin worden de maandstanden opgeslagen

{% hint style="info" %}
`Frontend.json` wordt vanaf firmware 5.7 niet meer gebruikt. Dashboardvoorkeuren worden in de browser opgeslagen en de algemene instellingen staan in `DSMRsettings.json`.
{% endhint %}

### Settings

Het settingsmenu bestaat uit verschillende opties. namelijk:

<details>

<summary>Settings</summary>

Op dit scherm zijn de settings te vinden van de dongle. Deze zijn niet alleen leesbaar maar ook aan te passen. Wat is de betekenis van deze settings?

De instellingen zijn gegroepeerd per onderwerp, zoals algemeen, tarieven, MQTT, Modbus, water en energiemanagement. Zie [Settings](/dsmr-api/instellingen/settings.md) voor een actueel overzicht van de velden en betekenis.

Bij een dongle met watermeter sensor:

* water\_m3: watermeterstand in m3 (zwarte letters)
* water\_l: watermeterstand in liters (rode letters)
* water\_fact: factor van de pulsteller of watermeter

Bij gebruik van DSMR-reader of een vergelijkbare koppeling kan **Ruwe data op poort 82** worden aangezet.

</details>

<details>

<summary>Meterstanden</summary>

Via dit scherm kunnen de meterstanden per maand aangepast of ingevuld worden. Bovenaan wordt er gekozen tussen:

* energie geleverd
* engergie teruggeleverd
* gas geleverd

Invoer is in jaar | maand | teller1 | teller 2

</details>

<details>

<summary>Reset &#x26; Update</summary>

Via dit menu komt u bij het reset en update scherm uit. Hierin kan gekozen worden voor:

* U wilt de Wifi koppeling opnieuw uitvoeren.
* opnieuw instellen van de wifi koppeling. [Wifi setup](/dsmr-api/start-1/wifi-koppeling.md) dan opnieuw doorlopen dienen te worden. Gegevensfiles blijven staan
* update van de firmware. Zie [Software update](/dsmr-api/instellingen/software-update.md)

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/dsmr-api/start-1/schermuitleg.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.
