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
- Energy Production (Solar)
- Power Monitoring
- Voltage & Current
- Gas Monitoring
- Electricity Quality
- Device Controls
- Diagnostic Entities
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, or4in 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 (1 = low/night, 2 = high/day). Useful for automations to run appliances during cheap hours. |
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. |
Diagnostic Entities
Version Information
| Entity | Description |
|---|---|
| ESPHome Version | The ESPHome version running on the device. |
| Software Version | The P1MeterKit firmware version. |
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). |
Firmware Update
| Entity | Description |
|---|---|
| Firmware Update | Shows available firmware updates. Install directly from Home Assistant. |
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) |
Entity Naming Convention
All entities follow this naming pattern:
sensor.p1meterkit_[sensor_name]
switch.p1meterkit_[switch_name]
button.p1meterkit_[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 sensor | ❌ | ✅ |
| Ethernet/PoE | ❌ | ✅ (V2/V3) |
| Water leak sensor | ❌ | ✅ (V3) |
Need Help?
- Usage Guide — Energy Dashboard & automations
- Troubleshooting — Common issues
- FAQ — Frequently asked questions
- Discord — Community support