> 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 %}