> 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/home-assistant-ha/p1-dongle-vervangen-zonder-verlies-van-data.md). # P1 Dongle vervangen zonder verlies van data Deze handleiding beschrijft hoe je een bestaande Smartstuff P1 Dongle vervangt door een nieuw model (bijvoorbeeld een P1 Dongle Pro+), zonder dat je: * Entities verliest * Dashboards moet aanpassen * Historische data kwijtraakt * De Energy Dashboard configuratie moet wijzigen Dit werkt omdat Smartstuff dongles vaste naamconventies gebruiken op basis van: * Hostname * MQTT Topic Als deze exact overeenkomen met de oude dongle, blijft Home Assistant dezelfde entities gebruiken. ## Scenario In dit voorbeeld vervangen we een bestaande P1 dongle Pro dongle door een nieuwe P1 Dongle Pro+ (multifunctioneel). Stap 1 t/m 3 zijn voorzorgsmaatregelen. ## Stap 1 — Entities veiligstellen (voorzorg) 1. Ga in **Home Assistant** naar:\ **Instellingen → Apparaten & Diensten → Entiteiten** 2. Filter op je huidige **P1 apparaat** 3. Kopieer alle bijbehorende entities naar een veilige plek (bijvoorbeeld Notepad++). > Let op: Sommige entities zijn Utility Meter of Template entities. Deze blijven sowieso bestaan en worden niet beïnvloed door het vervangen van de dongle. *** ## Stap 2 — Huidige instellingen noteren Open de webinterface van de oude dongle en noteer: * Hostname * MQTT server IP / poort * MQTT gebruikersnaam * MQTT wachtwoord * MQTT topic * Tariefinstellingen * Eventuele andere specifieke configuratie ⚠ **Hostname en MQTT Topic zijn cruciaal.** Eventueel kun je configuratiebestanden downloaden, maar Home Assistant gebruikt deze niet direct. *** ## Stap 3 — Nieuwe dongle opstarten 1. Sluit de nieuwe dongle aan 2. Verbind met het tijdelijke WiFi netwerk (bijvoorbeeld `NRG-Dongle-Pro`) 3. Open in de browser: ``` http://192.168.4.1 ``` > Let op: Soms opent je browser automatisch een andere pagina. Controleer of je echt verbonden bent met het WiFi netwerk van de dongle. *** ### WiFi configureren 1. Klik op **Configure WiFi** 2. Verbind met je eigen WiFi netwerk 3. Zoek in je router (DHCP lijst) het nieuwe IP-adres 4. Open de webinterface via dat IP-adres De MAC-adresinformatie vind je onder: **Info → Station MAC** Handig voor: * DHCP reservering * MAC filtering Je kunt eventueel hetzelfde IP-adres gebruiken als de oude dongle. *** ## Stap 4 — Oude dongle loskoppelen Koppel de oude dongle los. Eventueel kun je in de oude dongle MQTT uitschakelen zodat deze online blijft maar geen data meer publiceert tijdens de wissel. Controleer in Home Assistant dat er geen nieuwe data meer binnenkomt van het oude apparaat. *** ## Stap 5 — Nieuwe dongle identiek configureren Open de instellingen van de nieuwe dongle en stel exact hetzelfde in als bij de oude: * Zelfde **Hostname** * Zelfde **MQTT Topic** * Zelfde MQTT server instellingen * Zelfde gebruikersnaam en wachtwoord * Zelfde tariefinstellingen ⚠ **Wijzig de Update URL niet.**\ Deze is device-specifiek. *** ### Waarom Hostname en MQTT Topic identiek moeten zijn * Het **MQTT Topic** bepaalt alle entities * De **Hostname** identificeert het apparaat binnen MQTT Als deze exact overeenkomen met de oude dongle: * Home Assistant herkent het apparaat als hetzelfde * Entity ID’s blijven gelijk * Dashboards blijven werken * Historische data blijft behouden * De Energy Dashboard configuratie blijft intact *** ## Stap 6 — Aansluiten op de P1 meter 1. Sluit de nieuwe dongle aan op de P1 meter 2. Bevestig eventueel de watermeter sensor Water sensor oriëntatie: * Zwarte zijde boven * Gele zijde onder De dongle zal pas MQTT data publiceren zodra er data van de P1 meter wordt ontvangen. *** ## Waarom dit werkt Dit werkt omdat: * Beide dongles van dezelfde leverancier zijn * De firmware dezelfde naamconventies gebruikt * Entities gebaseerd zijn op Hostname + MQTT Topic *** ## Wisselen naar een andere leverancier? Wanneer je overstapt naar een andere leverancier: * Entities krijgen waarschijnlijk andere namen * Oude entities moeten worden uitgeschakeld * Nieuwe entities moeten handmatig hernoemd worden * Dashboards moeten mogelijk aangepast worden Deze handleiding is alleen van toepassing op vervanging binnen Smartstuff producten. *** ## Resultaat Indien correct uitgevoerd: * Geen entity hernoeming nodig * Geen dashboard aanpassingen nodig * Geen dataverlies * Geen SQL ingrepen nodig De vervanging verloopt volledig transparant voor Home Assistant. ## Extra tip Mochten er meerdere sensoren blijven bestaand in MQTT Explorer. Verwijderde de sensoren in de broker via MQTTExplorer bv en reboot de dongle. --- # 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/koppelingen/home-assistant-ha/p1-dongle-vervangen-zonder-verlies-van-data.md?ask= ``` 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.