Basic: EnergieID - plan-d-io/P1-dongle GitHub Wiki

Previous: Home Assistant

https://www.energyid.eu/nl

The P1-dongle has native support for EnergieID, an open and cooperative platform allowing you to gather energy data from different devices and platforms (digital meter, solar inverter, home battery, ...) in one place and link it to the services of your choosing. Depending on your subscription, data can be stored from a daily interval up to 5 minutes resolution.

EnergieID is a cooperative organisation with a social purpose, developing accessible and inclusive tools to help accelerate the energy transition. Please be sure to take a minute to read about their goals and, if possible, support them.

Enabling the EnergieID integration

  1. Open the EnergieID tab, check the `Use EnergieID' box
  2. Copy or write down the alphanumeric Claim code

  1. Make sure you have completed the other required configuration steps (at least WiFi credentials) and reboot the dongle by clicking the Reboot button

The dongle will now reboot, connect to your WiFi and register itself with EnergieID

  1. Create your free EnergieID account. After logging in, create a new 'record' by following the provided steps on their site.
  2. On your record, in the lower left corner, click on Apps. Look for the Plan-D app.
  3. Activate the app and add it to your record. Under Code, fill in the claim code of your dongle.

You have 24 hours to fulfill this step. Otherwise, the claim code will become invalid and you have to factory reset your dongle.

  1. After 1 to 20 minutes, the P1-dongle will start uploading data to your EnergieID record. The relevant sensors and data points get generated automatically.

Renew/unregister EnergieID

The P1-dongle uses a randomly generated, unique claim code to authenticate with the EnergieID servers. Tick this box if your claim code has expired, if you want to reregister the dongle with EnergieID or if you want to unregister your dongle (e.g. you want to return the dongle or transfer it to someone else).

Note that after the reboot, the dongle will be disconnected from the EnergieID servers, and not be able to upload data until you delete and re-add the Plan-D app in your EnergieID record.

If you factory reset the dongle (holding the reset button longer than 5 seconds), it will also unregister with EnergieID.

Removing the EnergieID integration

If you want to remove the EnergieID integration, e.g. because you do not want to use it anymore or if you are transferring the dongle to someone else, follow these steps:

  1. From your EnergieID record, go to Apps, find the Plan-D app and deactivate it. The dongle is now no longer linked to your account.
  2. Factory reset the dongle by pressing the reset button for more than 5 seconds. The dongle will now generate a new claim code which can be used to link to a new EnergieID account.

For developers

Interfacing with the EnergieID servers requires a provisioning key and a provisioning secret. These are included in the pre-compiled binaries, but not in the open-source code. If you want to roll your own firmware, please contact EnergieID to register as a developer.

Next: Advanced settings