Templated version of the config

[excalbian]

Since I have two Vue's (42 position panel) and it's how I prefer to setup my esphome projects, I converted the example to a file that can be used as a package (see below). This allows me to reference the package from the individual device files, overriding values as needed.

Note that I have wifi as a separate package (because I use it in multiple nodes) but you could move the wifi definitions back into the 'main' package if you wanted. I also use a few other 'standard' packages on my nodes (text sensors with device status, project info, and a restart button) which I've left out for brevity.

Simplest node definition

substitutions:
  devicename: vue-beta
  devicename_upper: Emporia Vue Beta
  
packages:
  wifi: !include shared/packages/wifi-no-captive.yaml
  vue: !include
    file: shared/packages/vue.yaml

More involved node definition

substitutions:
  devicename: vue-alpha
  devicename_upper: Emporia Vue Alpha

packages:
  wifi: !include shared/packages/wifi-no-captive.yaml
  vue: !include
    file: shared/packages/vue.yaml
    vars:
      cir1_name: Stove (phase A)
      cir1_phase:  phase_a
      cir2_name: A/C (phase A)
      cir2_phase: phase_a
      cir3_name: Garage Plugs
      cir3_phase: phase_a
      cir4_name: Garage Door
      cir4_phase: phase_b
      cir5_name: Breaker 13
      cir5_phase: phase_a
      cir6_name: Fridge
      cir6_phase: phase_b
      cir7_name: West Bedroom
      cir7_phase: phase_a
      cir8_name: Office
      cir8_phase: phase_b
      cir9_name: Breaker 21
      cir9_phase: phase_a
      cir10_name: Office_2
      cir10_phase: phase_b
      cir11_name: EV Charger
      cir11_phase: phase_a
      cir11_factor: "2"
      cir12_name: Shed (GCFI)
      cir12_phase: phase_a
      cir13_name: Outside A/C 1 (phase B)
      cir13_phase: phase_b
      cir14_name: Stove (phase B)
      cir14_phase: phase_b
      cir15_name: A/C (phase B)
      cir15_phase: phase_b
      cir16_name: Outside A/C 1 (phase A)
      cir16_phase: phase_a
  

Package definition (shared/packages/vue.yaml)

######
# Package for Emporia Vue 2 Smart Home Energy Monitor
# Based off: https://github.com/emporia-vue-local/esphome
#
# NOTE: 
# - Do not use the web_server since it is not compatible with the esp-idf framework, and you will get odd error messages.
# - Do not include shared/common.yaml - this package already defines those pieces
# - Do not include shared/wifi.yaml - without captive portal support for esp-idf, it will fail
#
# Substitutions:
#   devicename_upper - Device name used for the sensor labels (eg: Livingroom)
#
# Secrets:
#   wifi_ssid: the SSID of the WiFi to connect to
#   wifi_password: password for the WiFi network
#   fallback_hotspot_password: the password to assign to the hotspot AP   
######



# Follow https://github.com/esphome/esphome/pull/3500 and https://github.com/emporia-vue-local/esphome/discussions/52 to enable captive portal and web server some day

substitutions:
  cir1_name: Circuit 1
  cir2_name: Circuit 2
  cir3_name: Circuit 3
  cir4_name: Circuit 4
  cir5_name: Circuit 5
  cir6_name: Circuit 6
  cir7_name: Circuit 7
  cir8_name: Circuit 8
  cir9_name: Circuit 9
  cir10_name: Circuit 10
  cir11_name: Circuit 11
  cir12_name: Circuit 12
  cir13_name: Circuit 13
  cir14_name: Circuit 14
  cir15_name: Circuit 15
  cir16_name: Circuit 16
  cir1_factor: "1"
  cir2_factor: "1"
  cir3_factor: "1"
  cir4_factor: "1"
  cir5_factor: "1"
  cir6_factor: "1"
  cir7_factor: "1"
  cir8_factor: "1"
  cir9_factor: "1"
  cir10_factor: "1"
  cir11_factor: "1"
  cir12_factor: "1"
  cir13_factor: "1"
  cir14_factor: "1"
  cir15_factor: "1"
  cir16_factor: "1"
  cir1_phase: phase_a
  cir2_phase: phase_b
  cir3_phase: phase_a
  cir4_phase: phase_b
  cir5_phase: phase_a
  cir6_phase: phase_b
  cir7_phase: phase_a
  cir8_phase: phase_b
  cir9_phase: phase_a
  cir10_phase: phase_b
  cir11_phase: phase_a
  cir12_phase: phase_b
  cir13_phase: phase_a
  cir14_phase: phase_b
  cir15_phase: phase_a
  cir16_phase: phase_b
  # To calculate new calibration value use the formula <in-use calibration value> * <accurate voltage> / <reporting voltage>
  phase_a_calibration: 0.022 # 0.022 is used as the default as starting point but may need adjusted to ensure accuracy
  phase_b_calibration: 0.022  # 0.022 is used as the default as starting point but may need adjusted to ensure accuracy
  vue_version: "vue-0.0.4"

## Changelog
# v0.0.4 - Added substitutions for voltage calibration
# v0.0.3 - Added buzzer fix as suggested at https://github.com/emporia-vue-local/esphome/discussions/150
# v0.0.2 - Added substitutions for circuits
# v0.0.1 - Initial version as a package

# <<: !include shared/common.yaml
esphome:
  name: ${devicename}
  friendly_name: ${devicename_upper}

esp32:
  board: esp32dev
  framework:
    type: esp-idf
    version: recommended
  
# Enable logging
logger:

api:
  encryption:
    key: !secret esphome_encryption
  services:
    - service: play_rtttl
      variables:
        song_str: string
      then:
        - rtttl.play:
            rtttl: !lambda 'return song_str;'

ota:
  password: !secret ota_password
  
external_components:
  - source: github://emporia-vue-local/esphome@dev
    components:
      - emporia_vue

preferences:
  # the default of 1min is far too short--flash chip is rated
  # for approx 100k writes.
  flash_write_interval: "48h"

output:
  - platform: ledc
    pin: GPIO12
    id: buzzer
  - platform: gpio
    pin: GPIO27
    id: buzzer_gnd

rtttl:
  output: buzzer
  on_finished_playback:
    - logger.log: 'Song ended!'

button:
  - platform: template
    name: "Two Beeps"
    on_press:
      - rtttl.play: "two short:d=4,o=5,b=100:16e6,16e6"

light:
  - platform: status_led
    name: "D3_LED"
    pin: 23
    restore_mode: ALWAYS_ON

i2c:
  sda: 21
  scl: 22
  scan: false
  frequency: 200kHz  # recommended range is 50-200kHz
  id: i2c_a

time:
  - platform: homeassistant
    id: homeassistant_time
    on_time_sync:
      then:
        - logger.log: "Synchronized system clock from Home Assitant"
    
# these are called references in YAML. They allow you to reuse
# this configuration in each sensor, while only defining it once
.defaultfilters:
  - &moving_avg
    # we capture a new sample every 0.24 seconds, so the time can
    # be calculated from the number of samples as n * 0.24.
    sliding_window_moving_average:
      # we average over the past 2.88 seconds
      window_size: 12
      # we push a new value every 1.44 seconds
      send_every: 6
  - &invert
    # invert and filter out any values below 0.
    lambda: 'return max(-x, 0.0f);'
  - &pos
    # filter out any values below 0.
    lambda: 'return max(x, 0.0f);'
  - &abs
    # take the absolute value of the value
    lambda: 'return abs(x);'

sensor:
  - platform: emporia_vue
    i2c_id: i2c_a
    phases:
      - id: phase_a  # Verify that this specific phase/leg is connected to correct input wire color on device listed below
        input: BLACK  # Vue device wire color
        calibration: $phase_a_calibration
        voltage:
          name: "${devicename_upper} Phase A Voltage"
          filters: [*moving_avg, *pos]
        frequency:
          name: "${devicename_upper} Phase A Frequency"
          filters: [*moving_avg, *pos]
      - id: phase_b  # Verify that this specific phase/leg is connected to correct input wire color on device listed below
        input: RED  # Vue device wire color
        calibration: $phase_b_calibration
        voltage:
          name: "${devicename_upper} Phase B Voltage"
          filters: [*moving_avg, *pos]
        phase_angle:
          name: "${devicename_upper} Phase B Phase Angle"
          filters: [*moving_avg, *pos]
    ct_clamps:
      - phase_id: phase_a
        input: "A"  # Verify the CT going to this device input also matches the phase/leg
        power:
          name: "${devicename_upper} Phase A Power"
          id: phase_a_power
          device_class: power
          filters: [*moving_avg, *pos]
      - phase_id: phase_b
        input: "B"  # Verify the CT going to this device input also matches the phase/leg
        power:
          name: "${devicename_upper} Phase B Power"
          id: phase_b_power
          device_class: power
          filters: [*moving_avg, *pos]
      # Pay close attention to set the phase_id for each breaker by matching it to the phase/leg it connects to in the panel
      - { phase_id: $cir1_phase, input:  "1", power: { name:  "${cir1_name} Power", id:  cir1, filters: [ *moving_avg, *pos, multiply: $cir1_factor ] } }
      - { phase_id: $cir2_phase, input:  "2", power: { name:  "${cir2_name} Power", id:  cir2, filters: [ *moving_avg, *pos, multiply: $cir2_factor ] } }
      - { phase_id: $cir3_phase, input:  "3", power: { name:  "${cir3_name} Power", id:  cir3, filters: [ *moving_avg, *pos, multiply: $cir3_factor ] } }
      - { phase_id: $cir4_phase, input:  "4", power: { name:  "${cir4_name} Power", id:  cir4, filters: [ *moving_avg, *pos, multiply: $cir4_factor ] } }
      - { phase_id: $cir5_phase, input:  "5", power: { name:  "${cir5_name} Power", id:  cir5, filters: [ *moving_avg, *pos, multiply: $cir5_factor ] } }
      - { phase_id: $cir6_phase, input:  "6", power: { name:  "${cir6_name} Power", id:  cir6, filters: [ *moving_avg, *pos, multiply: $cir6_factor ] } }
      - { phase_id: $cir7_phase, input:  "7", power: { name:  "${cir7_name} Power", id:  cir7, filters: [ *moving_avg, *pos, multiply: $cir7_factor ] } }
      - { phase_id: $cir8_phase, input:  "8", power: { name:  "${cir8_name} Power", id:  cir8, filters: [ *moving_avg, *pos, multiply: $cir8_factor ] } }
      - { phase_id: $cir9_phase, input:  "9", power: { name:  "${cir9_name} Power", id:  cir9, filters: [ *moving_avg, *pos, multiply: $cir9_factor ] } }
      - { phase_id: $cir10_phase, input: "10", power: { name: "${cir10_name} Power", id: cir10, filters: [ *moving_avg, *pos, multiply: $cir10_factor ] } }
      - { phase_id: $cir11_phase, input: "11", power: { name: "${cir11_name} Power", id: cir11, filters: [ *moving_avg, *pos, multiply: $cir11_factor ] } }
      - { phase_id: $cir12_phase, input: "12", power: { name: "${cir12_name} Power", id: cir12, filters: [ *moving_avg, *pos, multiply: $cir12_factor ] } }
      - { phase_id: $cir13_phase, input: "13", power: { name: "${cir13_name} Power", id: cir13, filters: [ *moving_avg, *pos, multiply: $cir13_factor ] } }
      - { phase_id: $cir14_phase, input: "14", power: { name: "${cir14_name} Power", id: cir14, filters: [ *moving_avg, *pos, multiply: $cir14_factor ] } }
      - { phase_id: $cir15_phase, input: "15", power: { name: "${cir15_name} Power", id: cir15, filters: [ *moving_avg, *pos, multiply: $cir15_factor ] } }
      - { phase_id: $cir16_phase, input: "16", power: { name: "${cir16_name} Power", id: cir16, filters: [ *moving_avg, *pos, multiply: $cir16_factor ] } }
  - platform: template
    name: "Total Power"
    lambda: return id(phase_a_power).state + id(phase_b_power).state;
    update_interval: 2.88s
    id: total_power
    unit_of_measurement: "W"
  - platform: total_daily_energy
    name: "Total Daily Energy"
    power_id: total_power
    accuracy_decimals: 0
  - platform: template
    name: "Balance Power"
    lambda: !lambda |-
      return max(0.0f, id(total_power).state -
        id( cir1).state -
        id( cir2).state -
        id( cir3).state -
        id( cir4).state -
        id( cir5).state -
        id( cir6).state -
        id( cir7).state -
        id( cir8).state -
        id( cir9).state -
        id(cir10).state -
        id(cir11).state -
        id(cir12).state -
        id(cir13).state -
        id(cir14).state -
        id(cir15).state -
        id(cir16).state);
    update_interval: 2.88s
    id: balance_power
    unit_of_measurement: "W"
  - platform: total_daily_energy
    name: "Balance Daily Energy"
    power_id: balance_power
    accuracy_decimals: 0
  - { power_id:  cir1, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir1_name} Daily Energy" }
  - { power_id:  cir2, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir2_name} Daily Energy" }
  - { power_id:  cir3, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir3_name} Daily Energy" }
  - { power_id:  cir4, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir4_name} Daily Energy" }
  - { power_id:  cir5, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir5_name} Daily Energy" }
  - { power_id:  cir6, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir6_name} Daily Energy" }
  - { power_id:  cir7, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir7_name} Daily Energy" }
  - { power_id:  cir8, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir8_name} Daily Energy" }
  - { power_id:  cir9, platform: total_daily_energy, accuracy_decimals: 0, name:  "${cir9_name} Daily Energy" }
  - { power_id: cir10, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir10_name} Daily Energy" }
  - { power_id: cir11, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir11_name} Daily Energy" }
  - { power_id: cir12, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir12_name} Daily Energy" }
  - { power_id: cir13, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir13_name} Daily Energy" }
  - { power_id: cir14, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir14_name} Daily Energy" }
  - { power_id: cir15, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir15_name} Daily Energy" }
  - { power_id: cir16, platform: total_daily_energy, accuracy_decimals: 0, name: "${cir16_name} Daily Energy" }

Package definition (shared/packages/wifi-no-captive.yaml)

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot in case wifi connection fails
  ap:
    ssid: ${devicename} Hotspot
    password: !secret fallback_hotspot_password

sensor:
  - platform: wifi_signal
    name: "${devicename_upper} WiFi Signal strength"
    id: wifi_signal_strength
    update_interval: 60s
  - platform: template
    name: "${devicename_upper} RSSI"
    # Calculation taken from Tasmota so the values are comparable
    lambda: |-
      if (id(wifi_signal_strength).state <= -100) {
        return 0;
      } else if (id(wifi_signal_strength).state >= -50) {
        return 100;
      } else {
        return 2 * (id(wifi_signal_strength).state + 100);
      }
    update_interval: 60s
    unit_of_measurement: '%'
    accuracy_decimals: 0
    icon: "mdi:access-point"
    entity_category: diagnostic
    filters:
    - filter_out: nan
    - sliding_window_moving_average:
        window_size: 10 # creates a moving average of the last 10 values
        send_every: 1 # sends the moving average at every measurement (but only if it passes the delta filter below)) 
        send_first_at: 1 # after startup immediately start sending the result rather than wait for the first 10 measurements
    - delta : 0.5 # only send the result if the difference with the last sent result is higher than this


text_sensor:
    - platform: wifi_info
      ip_address:
        name: ${devicename_upper} IP Address
      ssid:
        name: ${devicename_upper} Connected SSID
      bssid:
        name: ${devicename_upper} Connected BSSID

# Add services for managing wifi bssid (from https://github.com/esphome/feature-requests/issues/731#issuecomment-1069360463)
api:
  services:
    - service: scan_wifi
      then:
        - lambda: |-
            wifi::global_wifi_component->start_scanning();
    - service: scan_reset
      then:
        - lambda: |-
            // Reset old priorities for known networks
            for (auto &scan : wifi::global_wifi_component->get_scan_result()) {
              if (wifi::global_wifi_component->has_sta_priority(scan.get_bssid())) {
                wifi::global_wifi_component->set_sta_priority(scan.get_bssid(), 0);
              }
            }