Configure Home Assistant energy monitoring with dashboards, solar, grid, and device tracking.

1. Incorrect

   state_class

   values (must be

   total

   ,

   total_increasing

   , or

   measurement

   )
2. Missing

   device_class: energy

   on energy sensors
3. Wrong

   state_class

   for utility_meter entities (must be

   total_increasing

   )
4. Using

   unit_of_measurement: kWh

   without

   state_class

   (breaks statistics)
5. Forgetting to enable statistic collection in configuration.yaml
6. Configuring solar sensors without battery tracking for self-consumption
7. Grid monitoring with mismatched sensor pairs (consumption vs return)
8. Utility meter cycle settings that don't align with billing periods

• sensor:
  • name: "Total Energy Consumed" unique_id: total_energy_consumed unit_of_measurement: kWh device_class: energy state_class: total_increasing state: "{{ (states('sensor.energy_meter') | float(0)) }}"
  • name: "Solar Production" unique_id: solar_production unit_of_measurement: kWh device_class: energy state_class: total_increasing state: "{{ (states('sensor.solar_meter') | float(0)) }}"

**Why this matters:** Proper `state_class` enables Home Assistant to automatically create statistics and energy dashboard integration. Without it, your sensors won't appear in the energy dashboard.

Include sensors with state_class for statistics

**Why this matters:** Statistics require the recorder to be properly configured. Without explicit inclusion, energy sensors may not generate statistics for long-term analysis.

• Use

  state_class: total_increasing

  for cumulative meters that only increase
• Add

  device_class: energy

  to all energy sensors
• Set

  unit_of_measurement: kWh

  (or appropriate unit) on energy sensors
• Configure utility_meter for billing cycle tracking
• Include all energy sensors in recorder's

  include

  list
• Reset cumulative sensors on device restart via template sensor
• Use separate sensors for grid consumption and grid return

• Use

  state_class: measurement

  for cumulative meters (breaks statistics)
• Forget the

  offset

  parameter on utility_meter (may cause midnight resets)
• Mix power (W) and energy (kWh) sensors without Riemann sum integration
• Create energy sensors without

  state_class

  (they won't work in energy dashboard)
• Assume solar production should subtract from consumption (energy dashboard handles this)
• Configure bidirectional flow on single sensors (use separate consumption/return sensors)
• Skip utility_meter configuration if you need consumption tracking by period

template:
  - sensor:
      - name: "Main Energy Meter"
        unique_id: main_energy_meter
        unit_of_measurement: kWh
        device_class: energy
        state_class: total_increasing
        availability_template: "{{ states('sensor.meter_input') not in ['unavailable', 'unknown'] }}"
        state: "{{ (states('sensor.meter_input') | float(0)) }}"

      - name: "Instantaneous Power"
        unique_id: instantaneous_power
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        state: "{{ (states('sensor.power_meter') | float(0)) }}"

• device_class: energy

  - Identifies as energy sensor for energy dashboard

• state_class: total_increasing

  - Cumulative meter that only increases

• state_class: measurement

  - Instantaneous values (power, not energy)

• unit_of_measurement: kWh

  - Energy units; use W for power

• availability_template

  - Prevents unavailable states from breaking statistics

utility_meter:
  daily_consumption:
    source: sensor.total_energy_consumed
    cycle: daily
    offset:
      hours: 0
    net_consumption: false        # true for solar with self-consumption

  monthly_consumption:
    source: sensor.total_energy_consumed
    cycle: monthly
    offset:
      days: 1                     # Reset on 1st of month
      hours: 0

  peak_consumption:
    source: sensor.total_energy_consumed
    cycle: weekly
    offset:
      days: 0                     # Reset on Monday
      hours: 0

• cycle

  : hourly, daily, weekly, monthly, bimonthly, quarterly, yearly

• offset

  : Time adjustment for billing alignment

• net_consumption

  : Set to true for solar to track self-consumption

integration:
  - platform: riemann_sum
    name: "Daily Energy from Power"
    unique_id: daily_energy_riemann
    source: sensor.instantaneous_power
    round: 3
    unit_prefix: k                # Converts W to kWh
    unit_time: h
    method: trapezoidal

• source

  : Power sensor (W) to integrate

• unit_prefix: k

  - Converts watts to kilowatts

• method: trapezoidal

  or

  left

  for integration algorithm

• round: 3

  - Decimal precision

references/

• state-class-guide.md

  - Comprehensive state_class reference

• device-class-reference.md

  - All energy-related device classes

• utility-meter-patterns.md

  - Billing cycle configurations

• energy-dashboard-setup.md

  - Step-by-step energy dashboard guide

• solar-integration.md

  - Solar panel and battery tracking

Note: For deep dives on specific topics, see the reference files above.

assets/

• energy-sensors-template.yaml

  - Complete sensor template

• utility-meter-examples.yaml

  - Meter configurations for all scenarios

• energy-dashboard-card.yaml

  - Dashboard card configuration

• Energy Integration Overview
• Electricity Grid Monitoring
• Solar Panels Integration
• Utility Meter Integration
• Template Sensor
• Statistics Integration

• sensor:
  • name: "Battery Charge" unique_id: battery_charge unit_of_measurement: kWh device_class: energy state_class: total_increasing state: "{{ (states('sensor.battery_charge_meter') | float(0)) }}"
  • name: "Battery Discharge" unique_id: battery_discharge unit_of_measurement: kWh device_class: energy state_class: total_increasing state: "{{ (states('sensor.battery_discharge_meter') | float(0)) }}"

• sensor:
  • name: "Energy Meter" unique_id: energy_meter unit_of_measurement: kWh device_class: energy state_class: total_increasing availability_template: "{{ states('sensor.meter_input') not in ['unavailable', 'unknown'] }}" state: "{{ (states('sensor.meter_input') | float(0)) }}"

undefined

• Home Assistant is running 2023.1 or later
• You have access to configuration.yaml (File Editor or VS Code add-on)
• You have at least one energy sensor available (grid meter, smart plug, integration sensor)
• You've decided on meter types (grid consumption/return, solar, battery, individual devices)
• You understand your billing cycle (daily, monthly, etc.)
• Recorder is enabled in configuration.yaml
• You've identified all devices/meters to monitor