> 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/koppelingen/welke-koppeling-kiezen.md).

# Welke koppeling kiezen?

De DSMR-API software kan metergegevens op verschillende manieren delen. Welke koppeling het beste past, hangt af van het systeem dat de data gaat gebruiken.

## Snel kiezen

| Ik wil koppelen met...                  | Beste keuze    | Waarom                                                                    |
| --------------------------------------- | -------------- | ------------------------------------------------------------------------- |
| Home Assistant, zo eenvoudig mogelijk   | HomeWizard API | Weinig instellingen nodig. Home Assistant herkent de dongle als P1 meter. |
| Home Assistant, met veel eigen controle | MQTT           | Geschikt voor eigen topics, automatische discovery en meerdere sensoren.  |
| DSMR-reader of Domoticz                 | Poort 82       | Geeft het ruwe P1 telegram door zoals een seriele P1 kabel.               |
| Laadpaal, omvormer of energiemanagement | Modbus RTU/TCP | Veel apparaten verwachten een Modbus energiemeter.                        |
| Eigen scripts of dashboards             | HTTP API       | Simpel lokaal JSON ophalen via HTTP.                                      |

## HomeWizard API

Gebruik deze optie als u Home Assistant snel wilt koppelen zonder MQTT broker. Voeg in Home Assistant de HomeWizard integratie toe en vul het IP-adres van de dongle in.

De dongle biedt hiervoor deze endpoints aan:

* `/api`
* `/api/v1/data`
* `/api/v1/telegram`

Zie ook [Home Assistant](/dsmr-api/koppelingen/home-assistant-ha.md) en [API overzicht](/dsmr-api/geavanceerd/api-overzicht.md).

## MQTT

Gebruik MQTT als u de data automatisch naar een broker wilt sturen. Dit is handig voor Home Assistant, Node-RED of andere smart home systemen.

MQTT is vooral geschikt wanneer:

* u al een MQTT broker gebruikt;
* u Home Assistant auto discovery wilt gebruiken;
* u de publicatiefrequentie zelf wilt bepalen;
* u meerdere dongles of eigen automatiseringen gebruikt.

Zie [MQTT](/dsmr-api/koppelingen/mqtt.md).

## Poort 82

Poort 82 stuurt het ruwe P1 telegram door via het netwerk. Dit lijkt voor ontvangende software op een P1 kabel via TCP.

Gebruik deze optie voor:

* DSMR-reader;
* Domoticz;
* Home Assistant DSMR Slimme Meter integratie;
* Virtual P1.

Zet hiervoor in de settings `raw-port` / **Ruwe data op poort 82** aan. Zie [Domoticz & DSMR-reader](/dsmr-api/koppelingen/domoticz-and-dsmr-reader.md) en [Virtual P1](/dsmr-api/gebruik/virtual-p1.md).

## Modbus RTU/TCP

Gebruik Modbus wanneer een laadpaal, omvormer of energiemanagementsysteem een energiemeter verwacht. Alle netwerkdongles ondersteunen Modbus TCP. Hardware met RS485 ondersteunt ook Modbus RTU.

Kies in de settings de juiste `mb_map` voor uw apparaat. Zet tijdelijk `mb_monitor` aan als u wilt zien welke registers de client opvraagt.

Voor een Fronius Symo GEN24 is een aparte, door gebruiker Arnoud aangeleverde praktijkhandleiding beschikbaar: [Fronius GEN24 integration](/dsmr-api/koppelingen/fronius-gen24.md).

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

## HTTP API

Gebruik de HTTP API voor eigen scripts, dashboards of lokale automatisering. Voor actuele meterwaarden is meestal dit endpoint voldoende:

```http
GET /api/v2/sm/actual
```

Zie [API overzicht](/dsmr-api/geavanceerd/api-overzicht.md).


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.smart-stuff.nl/dsmr-api/koppelingen/welke-koppeling-kiezen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.