> 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/instellingen/settings.md).

# Settings

Op de settingspagina kunt u de belangrijkste instellingen van de dongle bekijken en aanpassen. Dit overzicht beschrijft de instellingen van de actuele v5-firmware. Oudere firmwareversies kunnen afwijken.

![](/files/lA404tbJbG0HzgGV1V3k)

{% hint style="info" %}
Niet elke instelling is op elk type dongle zichtbaar. De beschikbare opties hangen af van hardware, ingeschakelde functies en compile-opties.
{% endhint %}

De instellingen zijn ook via de API te lezen:

```http
GET /api/v2/dev/settings
```

Een instelling wijzigen kan via:

```http
POST /api/v2/dev/settings
```

met bijvoorbeeld:

```json
{
  "name": "mqtt_interval",
  "value": 10
}
```

## Algemeen

| Instelling              | Betekenis                                             | Opmerking                                                                             |
| ----------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `hostname`              | Naam van de dongle in het netwerk.                    | Deze naam wordt ook gebruikt voor de `.local` URL.                                    |
| `IndexPage`             | Startpagina die lokaal vanaf de dongle wordt geladen. | Standaard de DSMR webinterface.                                                       |
| `hist`                  | Metergegevens lokaal opslaan.                         | Nodig voor uur-, dag- en maandhistorie.                                               |
| `led`                   | LED aan of uit.                                       | Bepaalt of de status-LED actief is.                                                   |
| `auto_update`           | Automatisch updaten.                                  | De dongle kan zelf controleren op nieuwe firmware.                                    |
| `ota_url`               | Update URL zonder `http://`.                          | Alleen aanpassen bij gebruik van een eigen OTA-locatie.                               |
| `b_auth_user`           | Gebruiker voor Basic Auth.                            | Beveiligt webinterface en API.                                                        |
| `b_auth_pw`             | Wachtwoord voor Basic Auth.                           | Laat leeg als u geen Basic Auth gebruikt.                                             |
| `overvoltage_threshold` | Overspanningsgrens in volt.                           | Geldige waarde: 200 t/m 300 V.                                                        |
| `fuse`                  | Hoofdzekering in ampere.                              | Keuze uit `16`, `25` of `35`. Wordt gebruikt voor dashboard- en belastingsindicaties. |
| `phases`                | Aantal fases.                                         | `0` is automatisch, daarnaast `1`, `2` of `3`.                                        |
| `meent_interval`        | Verzendinterval naar MEENT/NRG Monitor in seconden.   | Alleen zichtbaar in firmware waarin deze koppeling is ingeschakeld.                   |
| `conf`                  | Configuratieprofiel.                                  | Informatief veld, niet bedoeld om handmatig te wijzigen.                              |

## Tarieven en vaste kosten

Deze waarden worden gebruikt voor de kostenindicatie in de webinterface. De bedragen kunnen afwijken van uw energienota.

| Instelling          | Betekenis                               | Opmerking                                           |
| ------------------- | --------------------------------------- | --------------------------------------------------- |
| `ed_tariff1`        | Elektra afgenomen tarief 1 per kWh.     |                                                     |
| `ed_tariff2`        | Elektra afgenomen tarief 2 per kWh.     |                                                     |
| `er_tariff1`        | Elektra teruggeleverd tarief 1 per kWh. |                                                     |
| `er_tariff2`        | Elektra teruggeleverd tarief 2 per kWh. |                                                     |
| `gd_tariff`         | Gastarief per m3.                       |                                                     |
| `w_tariff`          | Watertarief per m3.                     | Alleen zichtbaar wanneer waterkosten relevant zijn. |
| `electr_netw_costs` | Netwerkkosten elektra per maand.        |                                                     |
| `gas_netw_costs`    | Netwerkkosten gas per maand.            |                                                     |
| `water_netw_costs`  | Netwerkkosten water per maand.          |                                                     |

## MQTT

Zie ook [MQTT](/dsmr-api/koppelingen/mqtt.md) voor uitleg over de koppeling en de beschikbare topics.

| Instelling         | Betekenis                                  | Opmerking                                                                             |
| ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------- |
| `mqtt_enabled`     | MQTT aan of uit.                           | Bij uitgeschakelde MQTT wordt niet gepubliceerd.                                      |
| `mqtt_tls`         | MQTT over TLS.                             | Gebruik dit alleen als uw broker TLS ondersteunt.                                     |
| `mqtt_broker`      | IP-adres of hostname van de MQTT broker.   | Bijvoorbeeld het IP-adres van Home Assistant of Mosquitto.                            |
| `mqtt_broker_port` | Poort van de MQTT broker.                  | Meestal `1883`, bij TLS vaak `8883`.                                                  |
| `mqtt_user`        | MQTT gebruikersnaam.                       | Optioneel.                                                                            |
| `mqtt_passwd`      | MQTT wachtwoord.                           | Optioneel.                                                                            |
| `mqtt_toptopic`    | Hoofdtopic waaronder de dongle publiceert. | Belangrijk bij Home Assistant vervanging.                                             |
| `mqtt_interval`    | Publicatie-interval in seconden.           | `0` betekent niet periodiek publiceren.                                               |
| `act-json-mqtt`    | Actuele data als JSON payload publiceren.  | Publiceert actuele waarden in een gecombineerd bericht.                               |
| `macid-topic`      | MAC-ID toevoegen aan het MQTT topic.       | Handig bij meerdere dongles.                                                          |
| `ha_disc_enabl`    | Home Assistant auto discovery.             | Stuurt MQTT discovery informatie naar Home Assistant.                                 |
| `ha_unique_ids`    | Unieke MQTT discovery ID's gebruiken.      | Handig wanneer Home Assistant sensoren opnieuw aangemaakt of vervangen moeten worden. |

## Slimme meter en ruwe data

| Instelling      | Betekenis                                    | Opmerking                                                                                                  |
| --------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `pre40`         | Ondersteuning voor oudere DSMR/SMR meters.   | Gebruik dit bij oudere slimme meters die minder fase- of tijdinformatie leveren.                           |
| `raw-port`      | Ruwe telegramdata op poort 82.               | Nodig voor sommige DSMR-reader of Home Assistant integraties.                                              |
| `try_calc_i`    | Stroom berekenen.                            | Kan stroomwaarden berekenen wanneer de meter deze niet direct levert.                                      |
| `virtual_p1_ip` | IP-adres van de bron-dongle voor Virtual P1. | Vanaf DSMR-API 5.7.2 via de webinterface in te stellen. Zie [Virtual P1](/dsmr-api/gebruik/virtual-p1.md). |

## Water

| Instelling    | Betekenis                   | Opmerking                                              |
| ------------- | --------------------------- | ------------------------------------------------------ |
| `water_enabl` | Watersensor aanwezig.       | Zet dit aan als de dongle een watersensor gebruikt.    |
| `water_m3`    | Watermeterstand in hele m3. | Zwarte cijfers op de watermeter.                       |
| `water_l`     | Watermeterstand in liters.  | Rode cijfers, invoer als liters.                       |
| `water_fact`  | Watermeterfactor.           | Meestal `1`, afhankelijk van de pulsteller/watermeter. |

## Modbus

Zie ook [Modbus RTU/TCP](/dsmr-api/koppelingen/modbus-rtu-tcp.md).

| Instelling   | Betekenis                  | Opmerking                                                                                                                |
| ------------ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `mb_map`     | Gekozen Modbus mapping.    | Geldt voor TCP en RTU.                                                                                                   |
| `mb_id`      | Modbus device ID.          | Voor RTU en sommige TCP-clients relevant.                                                                                |
| `mb_port`    | Modbus TCP poort.          | Standaard wordt een Modbus TCP poort gebruikt.                                                                           |
| `mb_baud`    | Baudrate voor Modbus RTU.  | Alleen zichtbaar op hardware met RTU/RS485.                                                                              |
| `mb_parity`  | Parity voor Modbus RTU.    | Alleen zichtbaar op hardware met RTU/RS485.                                                                              |
| `mb_monitor` | Modbus monitor aan of uit. | Toont de laatste Modbus requests voor diagnose.                                                                          |
| `mimic`      | Emulatieprofiel.           | `0` is uit, `1` is HomeWizard P1, `2` is Shelly Pro 3EM. Alleen zichtbaar op dongles waar mimic/emulatie beschikbaar is. |

## EnergyID en energiemanagement

| Instelling      | Betekenis                           | Opmerking                                                              |
| --------------- | ----------------------------------- | ---------------------------------------------------------------------- |
| `eid-enabled`   | EnergyID koppeling activeren.       | Na activeren is er een beperkte setupperiode.                          |
| `eid-planner`   | EnergyID stroomplanner beschikbaar. | Informatief veld wanneer plannerdata aanwezig is.                      |
| `nrgm-enabled`  | Data naar NRG Monitor.              | Alleen zichtbaar op hardware/profielen die dit ondersteunen.           |
| `netsw-enabled` | NetSwitch aan of uit.               | Alleen zichtbaar als NetSwitch beschikbaar is.                         |
| `udp`           | UDP broadcast aan of uit.           | Alleen zichtbaar wanneer UDP broadcast in de firmware is ingeschakeld. |

## Verborgen of geavanceerde settingsfile opties

Sommige opties staan niet altijd in de webinterface, maar kunnen wel in `DSMRsettings.json` voorkomen.

| Instelling     | Betekenis                                                                                                             |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| `mqtt-hide`    | Verbergt MQTT instellingen in de webinterface.                                                                        |
| `remove-index` | Verwijdert de indexpagina na update zodat deze opnieuw wordt opgehaald.                                               |
| `skip-network` | Start zonder netwerkkoppeling. Zie [Netwerkkoppeling overslaan](/dsmr-api/geavanceerd/netwerkkoppeling-overslaan.md). |
| `led-prt`      | Bridge/status-leds aan of uit, afhankelijk van hardware.                                                              |

{% hint style="warning" %}
Pas verborgen opties alleen aan wanneer u weet waarvoor ze bedoeld zijn. Maak vooraf een backup van `DSMRsettings.json`.
{% endhint %}


---

# 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/instellingen/settings.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.