Skip to content

Global configuration

Powercalc offers configuration options that can be set globally. These global settings will apply to all sensors created with Powercalc. However, if you configure settings for an individual sensor, those specific settings will take precedence over the global configuration for that sensor.

Note

Sensors created with the GUI do have a configuration set for create_energy_sensors, create_utility_meters, ignore_unavailable_state and energy_integration_method, changing global configuration will not affect the existing GUI configuration entries, to make it easy to change all of them Powercalc provides an action powercalc.change_gui_config. Refer to Change GUI configuration action.

Global configuration can be defined both in configuration.yaml and in the GUI.

GUI configuration

Click the button to go to the Powercalc configuration flow:

config_flow_start

Select Global configuration and follow the instructions.

When you'd like the change the configuration later, go to the Powercalc integration page, find the Global configuration entry and click on Configure.

Configure

YAML configuration

You can add the options to configuration.yaml under the powercalc: property, like so:

powercalc:
  force_update_frequency: 00:01:00 #Each minute
  power_sensor_naming: "{} Powersensor"
  create_energy_sensors: false

Configuration options

All the possible options are listed below.

Name Type Requirement Default Description
create_domain_groups list Optional Create grouped power sensor aggregating all powercalc sensors of given domains, see domain group
create_energy_sensors boolean Optional true Let the component automatically create energy sensors (kWh) for every power sensor
create_utility_meters boolean Optional false Set to true to automatically create utility meters of your energy sensors. See utility meter
disable_extended_attributes boolean Optional false Set to true to disable all extra attributes powercalc adds to the power, energy and group entity states. This will help keep the database size small especially when you have a lot of powercalc sensors and frequent update ratio
disable_library_download boolean Optional false Set to true to disable the Powercalc library download feature, see library
enable_autodiscovery boolean Optional true Whether you want powercalc to automatically setup power sensors for supported models in your HA instance.
energy_sensor_naming string Optional {} energy Change the name of the sensors. Use the {} placeholder for the entity name of your appliance. This will also change the entity_id of your sensor
energy_sensor_friendly_naming string Optional Change the friendly name of the sensors, Use {} placehorder for the original entity name.
energy_sensor_category string Optional Category for the created energy sensors. See HA docs.
energy_integration_method string Optional trapezoid Integration method for the energy sensor. See HA docs
energy_sensor_precision numeric Optional 4 Number of decimals you want for the energy sensors. See HA docs
energy_sensor_unit_prefix string Optional Unit prefix for the energy sensor. See HA docs. Set to none for to create a Wh sensor
force_update_frequency string Optional 00:10:00 Interval at which the sensor state is updated, even when the power value stays the same. Format HH:MM:SS
ignore_unavailable_state boolean Optional false Set to true when you want the power sensor to display a value (0 or standby_power) regardless of whether the source entity is available.
power_sensor_naming string Optional {} power Change the name of the sensors. Use the {} placeholder for the entity name of your appliance. This will also change the entity_id of your sensor
power_sensor_friendly_naming string Optional Change the friendly name of the sensors, Use {} placehorder for the original entity name.
power_sensor_category string Optional Category for the created power sensors. See HA docs.
utility_meter_net_consumption boolean Optional false Enable this if you would like to treat the source as a net meter. This will allow your counter to go both positive and negative. See utility_net_consumption
utility_meter_offset string Optional 00:00:00 Offset for the utility meters. Format HH:MM:SS. See utility_offset
utility_meter_types list Optional daily, weekly, monthly Define which cycles you want to create utility meters for. See utility_cycle
utility_meter_tariffs list Optional Define different tariffs. See utility_tariffs.
include_non_powercalc_sensors boolean Optional true Control whether you want to include non powercalc sensors in groups. See include entities

Change GUI configuration action

To change the configuration options for all Powercalc GUI config entries at once you can utilize the action powercalc.change_gui_config. You can use it to change the configuration for the following options

  • create_energy_sensor
  • create_utility_meters
  • ignore_unavailable_state
  • energy_integration_method

You can call this action from the GUI (Developer tools -> Actions). For example to set create_utility_meters to yes for all powercalc GUI configurations:

action: powercalc.change_gui_config
data:
  field: create_utility_meters
  value: 1