SmartHomeShop Docs

Sensor Definitions

This page provides detailed explanations of all sensors, controls, and entities available on the P1MeterKit. Use this as a reference to understand what each value means and how to use it.

Source Code: View the complete ESPHome configuration on GitHub

Quick Navigation

Energy Consumption

These sensors track your total electricity consumption.

📖 ESPHome Documentation: DSMR Component

Entity Description Unit
Energy Consumed Tariff 1 Total energy consumed during low tariff (usually night/weekend). Use for Energy Dashboard. kWh
Energy Consumed Tariff 2 Total energy consumed during high tariff (usually daytime). Use for Energy Dashboard. kWh

Tariff Explanation

Most energy contracts have two tariffs:

  • Tariff 1 (low): Cheaper rate, typically nights and weekends
  • Tariff 2 (high): Standard rate, typically weekdays during the day

The Electricity Tariff entity shows which tariff is currently active.

Energy Production (Solar)

If you have solar panels, these sensors track energy returned to the grid.

Entity Description Unit
Energy Produced Tariff 1 Total energy returned to grid during low tariff. Use for Energy Dashboard. kWh
Energy Produced Tariff 2 Total energy returned to grid during high tariff. Use for Energy Dashboard. kWh

Power Monitoring

Real-time power consumption and production.

Entity Description Unit
Power Consumed Current total power being consumed. Real-time power usage. W
Power Produced Current power being returned to grid. Real-time solar/battery export. W

Per-Phase Power (3-phase only)

Entity Description Unit
Power Consumed Phase 1/2/3 Power consumption per individual phase. W
Power Produced Phase 1/2/3 Power production per individual phase. W

Voltage & Current

Monitor your electrical supply quality.

Voltage

Entity Description Unit
Voltage Phase 1 Current voltage on phase L1. Normal range: 220-240V. V
Voltage Phase 2 Current voltage on phase L2 (3-phase only). V
Voltage Phase 3 Current voltage on phase L3 (3-phase only). V

Current

Entity Description Unit
Current Phase 1 Current amperage on phase L1. A
Current Phase 2 Current amperage on phase L2 (3-phase only). A
Current Phase 3 Current amperage on phase L3 (3-phase only). A

Gas Monitoring

Gas consumption is read via the P1 port from the gas meter connected to your smart meter.

Entity Description Unit
Gas Consumed Total gas consumption. Use for Energy Dashboard. Updated approximately every hour by most meters. m³

Gas Not Showing?

The gas meter communicates via MBus protocol. If gas data doesn't appear:

  • The default MBus ID is 1
  • Try changing to 2, 3, or 4 in ESPHome configuration

🔧 See Usage Guide: Gas MBus Configuration for instructions.

Electricity Quality

These sensors help monitor the quality and reliability of your electricity supply.

Entity Description
Electricity Failures Total number of power failures recorded by the meter.
Electricity Long Failures Total number of long (>3 min) power failures.
Voltage Sags Phase 1/2/3 Number of voltage dips (brownouts) per phase.
Voltage Swells Phase 1/2/3 Number of voltage surges per phase.

Tariff Information

Entity Description
Electricity Tariff Current active tariff as the meter sends it: 0001 = low tariff, 0002 = normal tariff. On Belgian meters the two are swapped. Useful for automations to run appliances during cheap hours.

Belgium and Luxembourg

These entities are disabled by default. Enable them on the device page if your meter needs them.

Entity Description
Gas Consumed Belgium Gas consumption on Belgian meters.
DSMR Water Consumed Digital water meter reported through the P1 telegram (also DSMR Water Equipment ID, DSMR Water Device Type, DSMR Water Valve Position).
Current Average Demand Average import demand.
Maximum Demand Current Month Peak demand this month, for the capacity tariff.
Maximum Demand Last 13 Months Peak demand over the last 13 months.
Energy Consumed Luxembourg / Energy Produced Luxembourg Energy totals on Luxembourg meters.

Environment Sensors

The P1MeterKit includes a temperature and humidity sensor. It measures at the device, so readings can differ from the room.

Entity Description Unit
Temperature Temperature at the device location. Pre-calibrated with -5.5°C offset. °C
Humidity Relative humidity at the device location. Pre-calibrated with +12% offset. %

Device Controls

Switches

Entity Description
Restart Restarts the P1MeterKit. Useful after configuration changes.

Buttons

Entity Description
Factory Reset Resets the device to factory defaults. Warning: Removes all configuration including WiFi credentials. Disabled by default.

Light

Entity Description
LED Green Turns the green LED on or off. The local firmware does not use it, so it is free for your own automations. Cloud firmware flashes it briefly on every successful sync.

Selector (V2/V3)

Entity Description Options
Firmware Variant Selects the firmware the device installs and updates from. WiFi (local), WiFi + SmartHomeShop App (cloud)

Diagnostic Entities

Version Information

Entity Description
ESPHome Version The ESPHome version running on the device.
Software Version The P1MeterKit firmware version.
Hardware Version The hardware version (V1, V2 or V3).

P1 Meter Information

Entity Description
Identification Your smart meter's identification string.
Version The DSMR/ESMR protocol version of your meter.
Gas Equipment ID The serial number of your gas meter (if connected). Disabled by default.

Firmware Update

Entity Description
P1MeterKit Firmware Shows available firmware updates (V2/V3). Install directly from Home Assistant.

Connection and System

Entity Description
WiFi Signal WiFi signal strength.
IP Address Current IP address of the device.
Connected SSID / Connected BSSID WiFi network and access point the device is connected to.
MAC Address MAC address of the device.
CPU Temperature Temperature of the chip, for diagnostics (V2/V3).

SmartHomeShop Cloud (cloud firmware only)

Entity Description
Cloud Status Current cloud status, for example Connected.
Cloud Connected On when the device is registered and the last sync succeeded.
Cloud Device ID The ID you use to add the device in the app when discovery does not find it.
Cloud Sync Failures Number of failed syncs.
Reset Cloud Button that clears the cloud registration on the device.

LED Indicators

The P1MeterKit has three LED indicators:

LED Color Meaning
LED 1 White Powered via USB-C
LED 2 Red (flashing) Not connected to WiFi or Home Assistant
LED 3 Yellow Powered via RJ12 (from smart meter)

On V2 and V3 cloud firmware the red LED flashes while the device is offline or not set up, and stays off once it is online.

Entity Naming Convention

All entities follow this naming pattern. The kit adds its MAC suffix (here a1b2c3) to the name, so you can use several kits side by side:

sensor.p1meterkit_a1b2c3_[sensor_name]
switch.p1meterkit_a1b2c3_[switch_name]
button.p1meterkit_a1b2c3_[button_name]

ESPHome Configuration

For advanced users who want to customize the P1MeterKit firmware:

🔧 Advanced Configuration: See Usage Guide: ESPHome Configuration for substitutions and customization options.

P1MeterKit vs WaterP1MeterKit

Looking for more features? The WaterP1MeterKit adds:

Feature P1MeterKit WaterP1MeterKit
P1 energy meter ✅ ✅
Gas monitoring ✅ ✅
Water monitoring ❌ ✅
Temperature and humidity sensor ✅ ✅
Ethernet/PoE ❌ ✅ (V2+)
Water leak sensor ❌ ✅ (V3/V4, optional)

Need Help?