From 4d3faf4a943f680ebbdb7369fdcc6e192ac04269 Mon Sep 17 00:00:00 2001
From: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
Date: Mon, 16 Jun 2025 14:53:30 +0200
Subject: [PATCH 1/6] Update badges to indicate support for super secret
feature
---
docs/discovery.mdx | 8 ++++----
docs/introduction.mdx | 17 ++++++++---------
docs/v1/api.mdx | 2 +-
docs/v1/error-handling.mdx | 2 +-
docs/v1/identify.mdx | 2 +-
docs/v1/measurement.mdx | 2 +-
docs/v1/system.mdx | 2 +-
docs/v2/authorization.mdx | 10 +++++-----
docs/v2/batteries.mdx | 4 ++--
docs/v2/device_information.mdx | 10 +++++-----
docs/v2/error-handling.mdx | 10 +++++-----
docs/v2/measurement.mdx | 10 +++++-----
docs/v2/system.mdx | 10 +++++-----
docs/v2/telegram.mdx | 2 +-
docs/v2/websocket.mdx | 10 +++++-----
15 files changed, 50 insertions(+), 51 deletions(-)
diff --git a/docs/discovery.mdx b/docs/discovery.mdx
index 01442c6..e643826 100644
--- a/docs/discovery.mdx
+++ b/docs/discovery.mdx
@@ -46,10 +46,10 @@ A discovery response contains additional data to enhance the setup in your appli
{/* prettier-ignore */}
P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery
---
diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index a270bc0..e0aa3c8 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -38,15 +38,14 @@ To understand the basics of the API, you can read the [getting-started](/docs/ge
The following table shows which devices are supported by the API and which API version they support.
-| Device | Device type | API v1 | API v2 |
-| --------------------------------------- | ---------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| P1 Meter | `HWE-P1` | Supported | Requires Firmware 6.00In beta |
-| Energy Socket | `HWE-SKT` | Supported | In development |
-| Watermeter (Only when powered over USB) | `HWE-WTR` | Supported | In development |
-| kWh Meter (1 phase) | `HWE-KWH1` and `SDM230-wifi` | Supported | In development |
-| kWh Meter (3 phase) | `HWE-KWH3` and `SDM630-wifi` | Supported | In development |
-| Energy Display | `HWE-DSP` | Not planned | In development |
-| Plug-In Battery | `HWE-BAT` | Not planned | Supported |
+| Device | Device type | API v1 | API v2 |
+| --------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| P1 Meter | `HWE-P1` | Supported | Requires Firmware 6.00In beta |
+| Energy Socket | `HWE-SKT` | Supported | In development |
+| Watermeter (Only when powered over USB) | `HWE-WTR` | Supported | In development |
+| kWh Meter (1 phase and 3-phase) | `HWE-KWH1`, `HWE-KWH3`, `SDM230-wifi` and `SDM630-wifi` | Supported | In beta |
+| Energy Display | `HWE-DSP` | Not planned | In development |
+| Plug-In Battery | `HWE-BAT` | Not planned | Supported |
:::tip P1 Meter
The v2 API is available for P1 Meter devices with firmware version 6.00 and higher. This version is currently only available for owners of the Plug-In Battery.
diff --git a/docs/v1/api.mdx b/docs/v1/api.mdx
index 12f789a..18bc3a7 100644
--- a/docs/v1/api.mdx
+++ b/docs/v1/api.mdx
@@ -14,7 +14,7 @@ import Badge from '@site/src/components/Badge.js'
Energy DisplaykWh MeterWatermeter
-Plug-In Battery
+Plug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v1/error-handling.mdx b/docs/v1/error-handling.mdx
index 6d37898..00c835c 100644
--- a/docs/v1/error-handling.mdx
+++ b/docs/v1/error-handling.mdx
@@ -13,7 +13,7 @@ import Badge from '@site/src/components/Badge.js'
Energy DisplaykWh MeterWatermeter
-Plug-In Battery
+Plug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v1/identify.mdx b/docs/v1/identify.mdx
index 88e60fb..1475166 100644
--- a/docs/v1/identify.mdx
+++ b/docs/v1/identify.mdx
@@ -14,7 +14,7 @@ import Badge from '@site/src/components/Badge.js'
Energy DisplaykWh MeterWatermeter
-Plug-In Battery
+Plug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v1/measurement.mdx b/docs/v1/measurement.mdx
index 45f42a6..65fb8b7 100644
--- a/docs/v1/measurement.mdx
+++ b/docs/v1/measurement.mdx
@@ -16,7 +16,7 @@ import Badge from '@site/src/components/Badge.js'
Energy DisplaykWh MeterWatermeter
-Plug-In Battery
+Plug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v1/system.mdx b/docs/v1/system.mdx
index 583771d..a0608b8 100644
--- a/docs/v1/system.mdx
+++ b/docs/v1/system.mdx
@@ -14,7 +14,7 @@ import Badge from '@site/src/components/Badge.js'
Energy DisplaykWh MeterWatermeter
-Plug-In Battery
+Plug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v2/authorization.mdx b/docs/v2/authorization.mdx
index 5f78465..65d586f 100644
--- a/docs/v2/authorization.mdx
+++ b/docs/v2/authorization.mdx
@@ -9,11 +9,11 @@ import Badge from '@site/src/components/Badge.js'
# Authorization `/api/user`
{/* prettier-ignore */}
-P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+P1 Meter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v2/batteries.mdx b/docs/v2/batteries.mdx
index b34e575..5ad6bec 100644
--- a/docs/v2/batteries.mdx
+++ b/docs/v2/batteries.mdx
@@ -9,10 +9,10 @@ import Badge from '@site/src/components/Badge.js'
# Batteries `/api/batteries`
{/* prettier-ignore */}
-P1 Meter
+P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWater MeterPlug-In Battery
diff --git a/docs/v2/device_information.mdx b/docs/v2/device_information.mdx
index 2712251..4dc2ce3 100644
--- a/docs/v2/device_information.mdx
+++ b/docs/v2/device_information.mdx
@@ -9,11 +9,11 @@ import Badge from '@site/src/components/Badge.js'
# Device Information `/api`
{/* prettier-ignore */}
-P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+P1 Meter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v2/error-handling.mdx b/docs/v2/error-handling.mdx
index ededd1e..ff04c2c 100644
--- a/docs/v2/error-handling.mdx
+++ b/docs/v2/error-handling.mdx
@@ -8,11 +8,11 @@ import Badge from '@site/src/components/Badge.js'
# Error Handling
{/* prettier-ignore */}
-P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+P1 Meter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v2/measurement.mdx b/docs/v2/measurement.mdx
index b1b376b..40aec4d 100644
--- a/docs/v2/measurement.mdx
+++ b/docs/v2/measurement.mdx
@@ -10,11 +10,11 @@ import Badge from '@site/src/components/Badge.js'
# Recent Measurement `/api/measurement`
{/* prettier-ignore */}
-P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+P1 Meter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v2/system.mdx b/docs/v2/system.mdx
index e401a86..b0215ea 100644
--- a/docs/v2/system.mdx
+++ b/docs/v2/system.mdx
@@ -9,11 +9,11 @@ import Badge from '@site/src/components/Badge.js'
# System `/api/system`
{/* prettier-ignore */}
-P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+P1 Meter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
diff --git a/docs/v2/telegram.mdx b/docs/v2/telegram.mdx
index 04a1f1c..11d2d9f 100644
--- a/docs/v2/telegram.mdx
+++ b/docs/v2/telegram.mdx
@@ -10,7 +10,7 @@ import Badge from '@site/src/components/Badge.js'
# Telegram `/api/telegram`
{/* prettier-ignore */}
-P1 Meter
+P1 MeterEnergy SocketEnergy DisplaykWh Meter
diff --git a/docs/v2/websocket.mdx b/docs/v2/websocket.mdx
index faa7280..f590fab 100644
--- a/docs/v2/websocket.mdx
+++ b/docs/v2/websocket.mdx
@@ -10,11 +10,11 @@ import Badge from '@site/src/components/Badge.js'
# WebSocket `/api/ws`
{/* prettier-ignore */}
-P1 Meter
-Energy Socket
-Energy Display
-kWh Meter
-Watermeter
+P1 Meter
+Energy Socket
+Energy Display
+kWh Meter
+WatermeterPlug-In Battery _See [Supported Devices](/docs/introduction#devices) for more information._
From 5c13ed156da35817d50fec045dd9668e93145540 Mon Sep 17 00:00:00 2001
From: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
Date: Mon, 16 Jun 2025 15:15:25 +0200
Subject: [PATCH 2/6] Add documentation about measurement API for super secret
feature
---
docs/v2/measurement.mdx | 136 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 136 insertions(+)
diff --git a/docs/v2/measurement.mdx b/docs/v2/measurement.mdx
index 40aec4d..e9696cd 100644
--- a/docs/v2/measurement.mdx
+++ b/docs/v2/measurement.mdx
@@ -93,6 +93,64 @@ Timestamps are formatted via a ISO 8601 string (`YYYY-MM-DDTHH:mm:ss`). The time
Belgian users may be charged for the peak usage per month (see capaciteitstarief). The data points `average_power_15m_w`, `monthly_power_peak_w` and `monthly_power_peak_timestamp` can be used to track the maximum demand.
+## kWh Meter 1-Phase (HWE-KWH1 and SDM230-wifi)
+
+### Parameters
+
+| Data | Type | Description |
+| ------------------ | ------ | -------------------------------------------------- |
+| energy_import_kwh | Number | The energy usage meter reading in kWh. |
+| energy_export_kwh | Number | The energy feed-in meter reading in kWh. |
+| power_w | Number | The total active usage in watt. |
+| voltage_v | Number | The active voltage in volt. |
+| current_a | Number | The active current in ampere. |
+| apparent_current_a | Number | The active apparent current in ampere. |
+| reactive_current_a | Number | The active reactive current in ampere. |
+| apparent_power_va | Number | The active apparent power in volt-ampere. |
+| reactive_power_var | Number | The active reactive power in volt-ampere reactive. |
+| power_factor | Number | The active power factor. |
+| frequency_hz | Number | Line frequency in hertz. |
+
+## kWh Meter 3-Phase (HWE-KWH3 and SDM630-wifi)
+
+### Parameters
+
+| Data | Type | Description |
+| --------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
+| energy_import_kwh | Number | The energy usage meter reading in kWh. |
+| energy_export_kwh | Number | The energy feed-in meter reading in kWh. |
+| power_w | Number | The total active usage in watt, this value is the sum of all phases, so if l1=200, l2=300, l3=-100 then this value is 400. |
+| power_l1_w | Number | The active usage for phase 1 in watt, will be negative when exporting. |
+| power_l2_w | Number | The active usage for phase 2 in watt, will be negative when exporting. |
+| power_l3_w | Number | The active usage for phase 3 in watt, will be negative when exporting. |
+| voltage_l1_v | Number | The active voltage for phase 1 in volt. |
+| voltage_l2_v | Number | The active voltage for phase 2 in volt. |
+| voltage_l3_v | Number | The active voltage for phase 3 in volt. |
+| current_a | Number | The active current in ampere, this value is the sum of absolute values, so if l1=2, l2=3, l3=-1 then this value is 6. |
+| current_l1_a | Number | The active current for phase 1 in ampere, will be negative when exporting. |
+| current_l2_a | Number | The active current for phase 2 in ampere, will be negative when exporting. |
+| current_l3_a | Number | The active current for phase 3 in ampere, will be negative when exporting. |
+| apparent_current_a | Number | The active apparent current in ampere. |
+| apparent_current_l1_a | Number | The active apparent current for phase 1 in ampere. |
+| apparent_current_l2_a | Number | The active apparent current for phase 2 in ampere. |
+| apparent_current_l3_a | Number | The active apparent current for phase 3 in ampere. |
+| reactive_current_a | Number | The active reactive current in ampere. |
+| reactive_current_l1_a | Number | The active reactive current for phase 1 in ampere. |
+| reactive_current_l2_a | Number | The active reactive current for phase 2 in ampere. |
+| reactive_current_l3_a | Number | The active reactive current for phase 3 in ampere. |
+| apparent_power_va | Number | The active apparent power in volt-ampere. |
+| apparent_power_l1_va | Number | The active apparent power for phase 1 in volt-ampere. |
+| apparent_power_l2_va | Number | The active apparent power for phase 2 in volt-ampere. |
+| apparent_power_l3_va | Number | The active apparent power for phase 3 in volt-ampere. |
+| reactive_power_var | Number | The active reactive power in volt-ampere reactive. |
+| reactive_power_l1_var | Number | The active reactive power for phase 1 in volt-ampere reactive. |
+| reactive_power_l2_var | Number | The active reactive power for phase 2 in volt-ampere reactive. |
+| reactive_power_l3_var | Number | The active reactive power for phase 3 in volt-ampere reactive. |
+| power_factor_l1 | Number | The active power factor for phase 1. |
+| power_factor_l2 | Number | The active power factor for phase 2. |
+| power_factor_l3 | Number | The active power factor for phase 3. |
+| frequency_hz | Number | Line frequency in hertz. |
+
## Plug-In Battery (HWE-BAT)
### Parameters
@@ -198,6 +256,84 @@ Content-Type: application/json
}
```
+### HWE-KWH1
+
+```http title="Request"
+curl https:///api/measurement --insecure \
+ -H "Authorization Bearer " \
+ -H "X-Api-Version: 2"
+```
+
+```http title="Response"
+https/1.1 200 OK
+
+Content-Type: application/json
+
+{
+ "energy_import_kwh": 123.456,
+ "energy_export_kwh": 78.910,
+ "power_w": 123,
+ "voltage_v": 230,
+ "current_a": 1.5,
+ "apparent_current_a": 1.6,
+ "reactive_current_a": 0.5,
+ "apparent_power_va": 345,
+ "reactive_power_var": 67,
+ "power_factor": 0.95,
+ "frequency_hz": 50
+}
+```
+
+### HWE-KWH3
+
+```http title="Request"
+curl https:///api/measurement --insecure \
+ -H "Authorization Bearer " \
+ -H "X-Api-Version: 2"
+```
+
+```http title="Response"
+https/1.1 200 OK
+
+Content-Type: application/json
+
+{
+ "energy_import_kwh": 123.456,
+ "energy_export_kwh": 78.910,
+ "power_w": 123,
+ "power_l1_w": 50,
+ "power_l2_w": 40,
+ "power_l3_w": -30,
+ "voltage_l1_v": 230,
+ "voltage_l2_v": 230,
+ "voltage_l3_v": 230,
+ "current_a": 1.5,
+ "current_l1_a": -0.5,
+ "current_l2_a": 0.8,
+ "current_l3_a": 1.2,
+ "apparent_current_a": 1.6,
+ "apparent_current_l1_a": 0.6,
+ "apparent_current_l2_a": 0.9,
+ "apparent_current_l3_a": 1.3,
+ "reactive_current_a": 0.5,
+ "reactive_current_l1_a": -0.2,
+ "reactive_current_l2_a": 0.3,
+ "reactive_current_l3_a": 0.4,
+ "apparent_power_va": 345,
+ "apparent_power_l1_va": 115,
+ "apparent_power_l2_va": 120,
+ "apparent_power_l3_va": 110,
+ "reactive_power_var": 67,
+ "reactive_power_l1_var": -20,
+ "reactive_power_l2_var": 30,
+ "reactive_power_l3_var": 57,
+ "power_factor_l1": 0.95,
+ "power_factor_l2": 0.90,
+ "power_factor_l3": 0.85,
+ "frequency_hz": 50
+}
+```
+
### HWE-BAT
```http title="Request"
From ffee99627ac763c9f9cfa12ae2612da588d49fbc Mon Sep 17 00:00:00 2001
From: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
Date: Mon, 16 Jun 2025 15:36:24 +0200
Subject: [PATCH 3/6] Update system documentation
---
docs/v2/system.mdx | 24 ++++++++++++------------
1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/docs/v2/system.mdx b/docs/v2/system.mdx
index b0215ea..6ab48a5 100644
--- a/docs/v2/system.mdx
+++ b/docs/v2/system.mdx
@@ -24,21 +24,21 @@ The `/api/system` endpoint can be used to get and set some system information, l
## Parameters
-| Data | Type | Access | Description | Availability |
-| --------------------------------------------------- | ---------------- | ---------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| wifi_ssid | String | Read-only | The SSID of the Wi-Fi network. | P1 MeterPlug-In Battery |
-| wifi_rssi_db | Number | Read-only | The signal strength of the Wi-Fi network. | P1 MeterPlug-In Battery |
-| uptime_s | Number | Read-only | The uptime of the device in seconds. | P1 MeterPlug-In Battery |
-| [cloud_enabled](#cloud-communication) | Boolean | Read/Write | The state of the cloud communication. | P1 MeterPlug-In Battery |
-| [status_led_brightness_pct](#status-led-brightness) | Number | Read/Write | The brightness of the status LED in percent. | P1 MeterPlug-In Battery |
-| [api_v1_enabled](#enable-or-disable-the-v1-api) | Optional Boolean | Read/Write | The state of the v1 API, will be removed when API v1 is removed, so this parameter is optional. | P1 MeterPlug-In Battery |
+| Data | Type | Access | Description | Availability |
+| --------------------------------------------------- | ---------------- | ---------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| wifi_ssid | String | Read-only | The SSID of the Wi-Fi network. | P1 MeterkWh MeterPlug-In Battery |
+| wifi_rssi_db | Number | Read-only | The signal strength of the Wi-Fi network. | P1 MeterkWh MeterPlug-In Battery |
+| uptime_s | Number | Read-only | The uptime of the device in seconds. | P1 MeterkWh MeterPlug-In Battery |
+| [cloud_enabled](#cloud-communication) | Boolean | Read/Write | The state of the cloud communication. | P1 MeterkWh MeterPlug-In Battery |
+| [status_led_brightness_pct](#status-led-brightness) | Number | Read/Write | The brightness of the status LED in percent. | P1 MeterkWh MeterPlug-In Battery |
+| [api_v1_enabled](#enable-or-disable-the-v1-api) | Optional Boolean | Read/Write | The state of the v1 API, will be removed when API v1 is removed, so this parameter is optional. | P1 MeterkWh MeterPlug-In Battery |
## Actions
-| Action | Description | Availability |
-| --------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| [Reboot](#reboot) | Reboot the device | P1 MeterPlug-In Battery |
-| [Identify](#identify) | Let the device identify itself by blinking the status LED | P1 MeterPlug-In Battery |
+| Action | Description | Availability |
+| --------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [Reboot](#reboot) | Reboot the device | P1 MeterkWh MeterPlug-In Battery |
+| [Identify](#identify) | Let the device identify itself by blinking the status LED | P1 MeterkWh MeterPlug-In Battery |
## Plug-In Battery exceptions
From 2ec8f431bcaf7199edeab9058b6abe2019f842f5 Mon Sep 17 00:00:00 2001
From: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
Date: Tue, 17 Jun 2025 10:20:26 +0200
Subject: [PATCH 4/6] Update docs/v2/websocket.mdx
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
---
docs/v2/websocket.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/v2/websocket.mdx b/docs/v2/websocket.mdx
index f590fab..7da83c5 100644
--- a/docs/v2/websocket.mdx
+++ b/docs/v2/websocket.mdx
@@ -13,7 +13,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
From 2ef15c94a3e1157327d6ad66d820b8ffc2f21ab1 Mon Sep 17 00:00:00 2001
From: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
Date: Tue, 17 Jun 2025 11:05:06 +0200
Subject: [PATCH 5/6] Apply suggestions from code review
Signed-off-by: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
---
docs/discovery.mdx | 2 +-
docs/v2/authorization.mdx | 2 +-
docs/v2/batteries.mdx | 2 +-
docs/v2/device_information.mdx | 2 +-
docs/v2/error-handling.mdx | 2 +-
docs/v2/measurement.mdx | 2 +-
docs/v2/system.mdx | 2 +-
7 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/docs/discovery.mdx b/docs/discovery.mdx
index e643826..9b4f25a 100644
--- a/docs/discovery.mdx
+++ b/docs/discovery.mdx
@@ -48,7 +48,7 @@ A discovery response contains additional data to enhance the setup in your appli
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
diff --git a/docs/v2/authorization.mdx b/docs/v2/authorization.mdx
index 65d586f..8d5d762 100644
--- a/docs/v2/authorization.mdx
+++ b/docs/v2/authorization.mdx
@@ -12,7 +12,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
diff --git a/docs/v2/batteries.mdx b/docs/v2/batteries.mdx
index 5ad6bec..e50e1c0 100644
--- a/docs/v2/batteries.mdx
+++ b/docs/v2/batteries.mdx
@@ -12,7 +12,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWater MeterPlug-In Battery
diff --git a/docs/v2/device_information.mdx b/docs/v2/device_information.mdx
index 4dc2ce3..c950607 100644
--- a/docs/v2/device_information.mdx
+++ b/docs/v2/device_information.mdx
@@ -12,7 +12,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
diff --git a/docs/v2/error-handling.mdx b/docs/v2/error-handling.mdx
index ff04c2c..8c1e3da 100644
--- a/docs/v2/error-handling.mdx
+++ b/docs/v2/error-handling.mdx
@@ -11,7 +11,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
diff --git a/docs/v2/measurement.mdx b/docs/v2/measurement.mdx
index e9696cd..fe0434e 100644
--- a/docs/v2/measurement.mdx
+++ b/docs/v2/measurement.mdx
@@ -13,7 +13,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
diff --git a/docs/v2/system.mdx b/docs/v2/system.mdx
index 6ab48a5..74b08b3 100644
--- a/docs/v2/system.mdx
+++ b/docs/v2/system.mdx
@@ -12,7 +12,7 @@ import Badge from '@site/src/components/Badge.js'
P1 MeterEnergy SocketEnergy Display
-kWh Meter
+kWh MeterWatermeterPlug-In Battery
From 9c09f482b8aa2293637a3ea69499f53b874291f5 Mon Sep 17 00:00:00 2001
From: Duco Sebel <74970928+DCSBL@users.noreply.github.com>
Date: Tue, 17 Jun 2025 12:58:40 +0200
Subject: [PATCH 6/6] Add comment about kwh meter 1-3 button restriction
---
docs/v2/authorization.mdx | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/v2/authorization.mdx b/docs/v2/authorization.mdx
index 8d5d762..b54a571 100644
--- a/docs/v2/authorization.mdx
+++ b/docs/v2/authorization.mdx
@@ -79,6 +79,10 @@ The response to a successful request will include the following fields:
Keep the token a secret, as it grants full access to the device's data.
:::
+:::important
+Due to hardware limitations, you need to press the wifi-pair button of the **kWh Meter** between **1 to 3 seconds** to authorize the request.
+:::
+
### Examples
#### Step 1: Request a Token