SmartHomeShop Docs

Firmwarehandleiding

Lokale werking en GitHub-updatecontrole

De lokale Home Assistant-firmware houdt de metingen van P1MeterKit op je eigen netwerk. Sensorwaarden gaan rechtstreeks naar Home Assistant en worden niet naar GitHub of de SmartHomeShop-cloud gestuurd.

De WiFi-firmware voor V2 en V3 bevat een ESPHome-update-entiteit. Deze leest periodiek een klein firmwaremanifest vanaf SmartHomeShop GitHub Pages om de geïnstalleerde versie met de nieuwste release te vergelijken. Alleen firmwaremetadata wordt opgevraagd; het firmwarebestand wordt pas gedownload wanneer je een update installeert.

Cloudfirmware communiceert voor de cloudfuncties bewust met de SmartHomeShop-app. Het uitschakelen van de GitHub-controle verandert cloudfirmware niet in lokale firmware. Thread-firmware voert deze controle niet uit.

P1MeterKit zonder internettoegang gebruiken

Je mag internettoegang voor P1MeterKit blokkeren; de lokale metingen en Home Assistant-verbinding blijven werken. Wil je voorkomen dat een geblokkeerde controle de rode status-led activeert? Neem het apparaat dan over in de ESPHome Device Builder-app/add-on, open de YAML en voeg dit onderaan toe:

update:
  - id: !extend firmware_update
    update_interval: never

Sla de YAML op, kies Validate en installeer de build met Install > Wirelessly. Hiermee schakel je alleen geplande controles uit; het updatecomponent en alle P1MeterKit-sensoren blijven aanwezig.

De geadopteerde YAML bevat nog steeds een packages:-verwijzing naar de SmartHomeShop GitHub-repository. ESPHome gebruikt die verwijzing op de Home Assistant-host tijdens het compileren. Nadat de aangepaste build is geïnstalleerd, vraagt het apparaat zelf niet meer periodiek de firmwareversie op.

Wil je automatische controles herstellen? Verwijder dan het toegevoegde update:-blok en installeer de firmware opnieuw. Kan ESPHome het ID firmware_update niet vinden, werk P1MeterKit dan eerst bij via de SmartHomeShop-webflasher.

P1MeterKit draait op ESPHome, een open-source firmware platform dat werkt met Home Assistant. ESPHome stelt je in staat om elk aspect van je apparaat aan te passen terwijl je volledige lokale controle behoudt: geen cloud vereist.

Open Source & GitHub

Alle P1MeterKit firmware is 100% open source en beschikbaar op GitHub:

🔗 github.com/smarthomeshop/p1meterkit

De repository bevat:

  • Complete ESPHome configuraties voor V1 (ESP8266), V2 (ESP32-C3) en V3 (ESP32-C6)
  • DSMR/P1 poort reader implementatie
  • MBus gas meter integratie
  • Geautomatiseerde builds via GitHub Actions
  • Community bijdragen welkom (PRs & issues)

Je kunt de firmware bekijken, aanpassen en personaliseren naar wens: van het aanpassen van sensor update intervallen tot het toevoegen van compleet nieuwe functies.

Hardware Versies

P1MeterKit is beschikbaar in drie hardwareversies:

V1 - ESP8266

  • Microcontroller: ESP8266
  • Connectiviteit: Alleen WiFi
  • Features: Standaard DSMR/P1 uitlezing, MBus gas meter, temperatuur/luchtvochtigheid sensoren
  • Geschikt voor: Basis slimme meter monitoring

V2 - ESP32-C3

  • Microcontroller: ESP32-C3
  • Connectiviteit: WiFi + Bluetooth (Improv BLE)
  • Features: Alle V1 features + verbeterde prestaties + BLE provisioning
  • Geschikt voor: Bestaande V2 installaties met eenvoudigere setup

V3 - ESP32-C6 (Actueel)

  • Microcontroller: ESP32-C6
  • Connectiviteit: WiFi + Bluetooth (Improv BLE)
  • Features: Alle V2 features + actuele ESP32-C6 hardware + Thread met de Thread-firmware
  • Geschikt voor: Nieuwe installaties en actuele firmware ondersteuning

Hoe controleer je jouw versie: Kijk naar de sensor Hardware Version in Home Assistant. De sensor "ESPHome Version" toont alleen de ESPHome-release.

Firmware Varianten

Variant Verbinding Gebruik met
WiFi (local) 2,4 GHz WiFi Home Assistant, volledig lokaal
WiFi + SmartHomeShop App (cloud) 2,4 GHz WiFi SmartHomeShop-app, Home Assistant blijft mogelijk
Thread (V3) Thread-netwerk Home Assistant, alleen lokaal. Zie Verbinden via Thread

Op V2 en V3 wissel je tussen de lokale en de cloudvariant met de Firmware Variant-keuze in Home Assistant of op de setup-pagina. Het apparaat installeert de gekozen variant dan draadloos. V1 heeft deze keuze niet: gebruik daar de web flasher.

Snelle Update Methodes

Methode 1: Home Assistant (Makkelijkste)

Voor reguliere firmware updates (aanbevolen):

  1. Ga naar Instellingen → Apparaten & Services → Apparaten
  2. Selecteer je P1MeterKit apparaat
  3. Schakel de Update entiteit in als deze uitgeschakeld is
  4. Open de Update entiteit en klik Controleer op updates
  5. Klik Installeren om de update te downloaden en toe te passen
  6. Het apparaat herstart automatisch

V1: heeft geen update-entiteit. Update die met Methode 2 of Methode 3.

Methode 2: ESPHome Device Builder

Voor updates met aangepaste configuraties:

⚠️ Belangrijk: Deze methode vereist de app ESPHome Device Builder (niet alleen de ESPHome integratie). Als je deze nog niet hebt geïnstalleerd, zie de ESPHome Integratie Handleiding sectie hieronder voor stap-voor-stap installatie instructies.

  1. Open het ESPHome Device Builder in Home Assistant (vanuit de zijbalk)
  2. Klik op je P1MeterKit apparaat kaart
  3. Klik Install → kies Wirelessly
  4. Wacht tot de OTA update voltooid is

Methode 3: USB-C Web Flasher

Voor het wisselen van hardware versies of herstel van apparaten:

  1. Verbind P1MeterKit met een USB-C datakabel met een computer met Chrome of Edge
  2. Open de flasher: smarthomeshop.io/firmware?product=p1meterkit
  3. Selecteer je hardware versie (V1, V2 of V3)
  4. Kies hoe je het apparaat gebruikt: Lokaal met Home Assistant of SmartHomeShop-app + lokaal gebruik
  5. Klik op Firmware installeren en kies de USB-poort van je apparaat

Opmerking: Flashen schrijft de fabrieksfirmware en wist alle instellingen, ook je WiFi-gegevens. Stel WiFi daarna opnieuw in.

ESPHome Integratie Handleiding

Wil je je P1MeterKit firmware aanpassen? Volg deze stap-voor-stap handleiding om je apparaat te adopteren in ESPHome en aanpassingen te maken.

🚨 Belangrijk: Het Verschil Begrijpen

Veel gebruikers verwarren twee verschillende zaken:

  • ESPHome Integratie (Instellingen → Apparaten & Services → Integraties) - Dit is hoe je P1MeterKit communiceert met Home Assistant. Deze heb je waarschijnlijk al. ✅
  • App ESPHome Device Builder (Instellingen → Apps, vóór Home Assistant 2026.2 add-ons genoemd) - Dit is de tool die je nodig hebt om firmware te bewerken, builden en flashen. Deze moet je apart installeren! 🔧

Om firmware aan te passen, MOET je de app ESPHome Device Builder hieronder installeren. Alleen de integratie hebben is niet genoeg!

Stap 1: Installeer de App ESPHome Device Builder

Als je de app ESPHome Device Builder nog niet hebt geïnstalleerd:

  1. Open Home Assistant → Instellingen → Apps
  2. Klik op de knop om een app te installeren
  3. Zoek naar ESPHome Device Builder
  4. Klik erop en kies Installeer
  5. Schakel Start bij opstarten en Toon in zijbalk in
  6. Klik Start

Stap 2: Adopteer je P1MeterKit

Adopteren stelt ESPHome in staat om de configuratie van je apparaat te beheren:

  1. Open ESPHome vanuit de Home Assistant zijbalk
  2. Je P1MeterKit verschijnt als een ontdekt apparaat
  3. Klik Adopt op de P1MeterKit kaart
  4. Geef het een naam (bijv. "Woonkamer P1 Meter")
  5. Klik nogmaals Adopt om te bevestigen

ESPHome downloadt nu de huidige configuratie van je apparaat.

Hoe ziet de geadopteerde configuratie eruit?

Na adoptie zie je een YAML configuratie die er zo uitziet:

substitutions:
  name: p1meterkit-a1b2c3
  friendly_name: P1MeterKit A1B2C3

packages:
  smarthomeshop.p1meterkit: github://smarthomeshop/p1meterkit/p1meterkit-v3/p1meterkit.yaml@main

esphome:
  name: ${name}
  name_add_mac_suffix: false
  friendly_name: ${friendly_name}

api:
  encryption:
    key: JOUW_UNIEKE_ENCRYPTIE_KEY_HIER==

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

Deze structuur begrijpen:

  • substitutions: Apparaat-specifieke variabelen (naam, friendly name). Voeg hier meer toe om gedrag aan te passen!
  • packages: Link naar de basis configuratie op GitHub. Dit haalt automatisch updates binnen wanneer beschikbaar.
  • api/wifi: Je apparaat's unieke encryptie key en WiFi inloggegevens.

Deze modulaire aanpak betekent: ✅ Je krijgt automatisch updates van GitHub ✅ Je customizations blijven gescheiden in substitutions ✅ Je hoeft niet de hele configuratie te kopiëren/plakken

Stap 3: Pas de Configuratie Aan

Na adoptie kun je de YAML configuratie aanpassen:

  1. Klik Edit op je geadopteerde P1MeterKit apparaat
  2. De YAML editor opent met je huidige configuratie
  3. Maak je gewenste wijzigingen (zie voorbeelden hieronder)
  4. Klik Save

Stap 4: Upload Aangepaste Firmware

Na het maken van wijzigingen:

  1. Klik Install op je apparaat kaart
  2. Kies Wirelessly (aanbevolen) of Plug into this computer
  3. ESPHome compileert en uploadt je aangepaste firmware
  4. Wacht tot het apparaat herstart en opnieuw verbindt

✅ Klaar! Je P1MeterKit draait nu op aangepaste firmware.

Geavanceerde Aanpassingen

Voorbeeld 1: Pas DSMR Update Interval Aan

Laat de kit de P1 meter minder vaak uitlezen:

dsmr:
  request_interval: 30s  # Standaard is 0ms: elk telegram van je meter wordt gelezen

Voorbeeld 2: Voeg Custom Sensors Toe

Bereken wat de metertotalen kosten tegen een vaste prijs:

sensor:
  - platform: template
    name: "Totale Energiekosten"
    unit_of_measurement: "EUR"
    device_class: monetary
    lambda: |-
      // Uitgaande van 0.30 EUR per kWh
      float cost = id(dsmr_electricity_delivered_1).state * 0.30;
      cost += id(dsmr_electricity_delivered_2).state * 0.30;
      return cost;
    update_interval: 60s

Voorbeeld 3: Gasverbruik Alerts

Gasmeldingen werken het best in Home Assistant, zonder de firmware aan te passen. Maak een Utility Meter-helper met een uurlijkse resetcyclus op Gas Consumed (zie Utility Meters Aanmaken) en laat een automatisering je waarschuwen als de helper boven je grens komt.

Voorbeeld 4: Custom LED Indicatoren

De firmware heeft al een lichtentiteit LED Green. Gebruik die in een Home Assistant-automatisering, zonder YAML aan te passen: zet hem aan als Power Consumed boven je grens komt en weer uit als het verbruik daalt.

Meer info: Bekijk de ESPHome documentatie voor complete configuratie referentie.

Configuratie Structuur

P1MeterKit firmware gebruikt een modulaire architectuur:

p1meterkit-v1/  (ESP8266)
├── p1meterkit.yaml              # WiFi-firmware
├── p1meterkit-cloud.yaml        # WiFi + SmartHomeShop-app
└── [component bestanden]

p1meterkit-v2/  (ESP32-C3)
├── p1meterkit.yaml              # WiFi-firmware
├── p1meterkit-cloud.yaml        # WiFi + SmartHomeShop-app
└── [component bestanden]

p1meterkit-v3/  (ESP32-C6)
├── p1meterkit.yaml              # WiFi-firmware
├── p1meterkit-cloud.yaml        # WiFi + SmartHomeShop-app
├── p1meterkit-thread.yaml       # Thread-firmware
└── [component bestanden]

Dit modulaire ontwerp maakt het makkelijk om:

  • Sensoren toe te voegen/verwijderen
  • Configuraties te delen tussen apparaten
  • Consistentie te behouden over versies
  • Verbeteringen terug te geven aan de community

Probleemoplossing

Snelle oplossing bij N/A stroomwaarden: als P1MeterKit wel opstart maar elektriciteitsdata leeg blijft, voeg dan eerst USB-C voeding toe, adopteer het apparaat daarna in Home Assistant → ESPHome Device Builder-app, en test vervolgens het oudere DSMR-profiel hieronder. Ontbreekt alleen gas, test dan meestal gas_mbus_id waarden 1 t/m 4.

Apparaat Wil Niet OTA Updaten

Symptomen: OTA update mislukt of time-out

Oplossingen:

  1. Zorg dat het apparaat aanstaat en verbonden is met WiFi
  2. Controleer dat het apparaat binnen WiFi bereik is (sterk signaal)
  3. Verifieer dat de P1 meter stroom levert (RJ12 kabel aangesloten)
  4. Probeer het apparaat te herstarten via Home Assistant
  5. Als alles faalt, flash via USB-C kabel

Geen Data van Slimme Meter

Symptomen: Alle sensor waarden tonen "unknown" of "0"

Oplossingen:

  1. Check RJ12 verbinding: Zorg dat kabel goed aangesloten is op zowel P1 meter als apparaat
  2. Voeg USB-C voeding toe: Oudere DSMR meters leveren niet altijd genoeg stroom via P1
  3. Ouder DSMR profiel: Als waarden leeg blijven, adopteer het apparaat in ESPHome en test een ouder UART / DSMR profiel:
uart:
  id: uart_dsmr
  baud_rate: 9600
  data_bits: 7
  parity: EVEN
  stop_bits: 1

dsmr:
  id: dsmr_instance
  uart_id: uart_dsmr
  crc_check: false
  1. DSMR 2.2 alternatief: Als bevestigd is dat je meter DSMR 2.2 is, test dan parity: NONE in plaats van EVEN
  2. Check logs: Bekijk ESPHome logs voor DSMR parsing fouten
  3. Kabel kwaliteit: Gebruik een goede kwaliteit RJ12 kabel (sommige goedkope kabels hebben verkeerde pinout)
  4. Ontbreekt alleen gas? Dan is meestal gas_mbus_id het probleem, niet de P1 kabel zelf

Gasverbruik Update Niet

Symptomen: Gas waarde blijft op 0 of update niet

Oplossingen:

  1. Gasmeter koppeling: Controleer of je gasmeter is gekoppeld aan je slimme meter. De kit leest gas via de P1 poort, er is geen aparte kabel naar de kit
  2. Gas meter compatibiliteit: Niet alle gas meters hebben MBus output
  3. Update frequentie: Gas meters updaten typisch elk uur
  4. Check configuratie: Test gas_mbus_id waarden 1 t/m 4, zie Gas MBus Configuratie

Apparaat Niet Ontdekt Na Flashen

Symptomen: P1MeterKit verschijnt niet in ESPHome na USB flashen

Oplossingen:

  1. Het apparaat heeft mogelijk WiFi inloggegevens verloren tijdens flashen
  2. Verbind via USB-C en bekijk de logs in ESPHome
  3. Alleen V2/V3: Gebruik Improv via BLE om WiFi opnieuw te configureren:
    • Open Home Assistant companion app
    • Ga naar Instellingen → Apparaten → Apparaat toevoegen
    • Selecteer je P1MeterKit uit de BLE apparaten lijst
  4. Alternatief, verbind met de captive portal:
    • Apparaat creëert een WiFi AP genaamd "p1meterkit" met het wachtwoord "p1meterkit"
    • Verbind ermee en configureer WiFi via de webinterface

Onjuiste Tarief Detectie

Symptomen: Energie waarden verschijnen in verkeerd tarief

Oplossingen:

  1. Check of je energieleverancier standaard tarief switching gebruikt
  2. Sommige slimme meters hebben non-standaard DSMR implementaties
  3. Overweeg Home Assistant utility meter voor tarief management
  4. Check DSMR logs voor tarief indicator waarden

Hoge WiFi Herverbinding Rate

Symptomen: Apparaat verbreekt en herverbindt frequent

Oplossingen:

  1. Check signaal sterkte: Zorg voor sterk WiFi signaal (-70 dBm of beter)
  2. Voeding: Verifieer stabiele stroom van P1 poort (sommige meters geven instabiele spanning)
  3. Voeg externe voeding toe: Sluit USB-C voeding aan voor stabielere werking
  4. Router instellingen: Schakel WiFi band steering uit en schakel alleen 2.4GHz in
  5. V1 (ESP8266): Bekend minder stabiel op drukke WiFi netwerken, overweeg upgrade naar V3

Compilatie Fouten in ESPHome

Symptomen: Custom YAML compileert niet

Oplossingen:

  1. Controleer op YAML syntax fouten (inspringingen moeten consistent zijn)
  2. Verifieer dat je een compatibele ESPHome versie gebruikt (check GitHub repo vereisten)
  3. Bekijk de compilatie log voor specifieke foutmeldingen
  4. Vergelijk je wijzigingen met de officiële configuratie
  5. Vraag om hulp op GitHub Issues of onze Discord community

DSMR Specificaties

P1MeterKit ondersteunt de volgende DSMR (Dutch Smart Meter Requirements) versies:

  • DSMR 2.2 (oudere meters, met aangepaste ESPHome UART-instellingen)
  • DSMR 4.0/4.2 (veel voorkomend)
  • DSMR 5.0 (meest moderne meters)

Wat is DSMR? DSMR is het protocol gebruikt door Nederlandse en Belgische slimme elektriciteitsmeters om energiedata te communiceren. De P1 poort biedt real-time toegang tot:

  • Elektriciteitsverbruik per tarief (dag/nacht)
  • Elektriciteitsproductie (zonnepanelen)
  • Real-time stroomverbruik
  • Spanning en stroom per fase
  • Gasverbruik (via MBus)

Firmware Changelog

Nieuwste wijzigingen worden bij releases aangekondigd. Grote updates verschijnen hier.

Waar vind je wijzigingen:

Aanvullende Bronnen

Hulp nodig? Bezoek ons Support Portal of join onze Discord community!

Thread-firmware

De P1MeterKit V3 kan ook een Thread-netwerk joinen voor lokaal gebruik met Home Assistant, met één DSMR-telegram per 5 seconden. Zie P1MeterKit verbinden via Thread.