Powerfox Local

The Powerfox Local integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to gather data from your Poweropti device directly over your local network, without relying on the Powerfox cloud API.

Powerfox is a German company that provides smart meters (Poweropti) for reading electricity, water, gas, and heat. This integration communicates directly with the device on your local network, offering faster updates and no dependency on internet connectivity or the Powerfox cloud service.

Prerequisites

• A powerfox PRO Service subscription is required to use the local interface. The PRO Service can be purchased in the powerfox Shop.
• Your Poweropti device must be running firmware version v2.02.07 or higher.

Supported devices

The local interface is available for the following Poweropti models:

• PA 201901
• PA 201902
• PB 202001 (poweropti+)

Configuration

To add the Powerfox Local device to your Home Assistant instance, use this My button:

Powerfox Local can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Configuration parameters

Automatic discovery

If your Poweropti device is on the same network as Home Assistant, it will be discovered automatically via mDNS/Zeroconf. You only need to confirm the setup. No manual entry of the host or API key is required.

Data updates

The integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] the Poweropti device every 5 seconds and provides real-time measurements.

Actions

This integration does not provide additional actions.

Examples

Get alerted when power usage spikes

Use this automation to keep an eye on sudden peaks in your electricity usage. When the Poweropti sensor reports more than 4 kW for two minutes, Home Assistant sends a notification so you can react quickly (for example by switching off large loads).

alias: "Powerfox high usage alert"
description: "Notify me when the Poweropti meter reports sustained high power draw."
triggers:
  - trigger: numeric_state
    entity_id: sensor.poweropti_power
    above: 4000
    for:
      minutes: 2
actions:
  - action: notify.mobile_app_phone
    data:
      title: "High consumption detected"
      message: "Poweropti currently reports {{ states('sensor.poweropti_power') }} W."

Replace the threshold value and the notify target with the entities that exist in your installation.

Supported functionality

The Powerfox Local platform provides sensors that you can use in your energy dashboard.

Power meter

It will create the following sensors:

• Power (W): Active power that is currently measured.
• Energy usage (Wh): Total energy used since installation.
• Energy usage - high tariff (Wh): Energy usage on the high tariff.
• Energy usage - low tariff (Wh): Energy usage on the low tariff.
• Energy return (Wh): Energy returned to the grid.

Troubleshooting

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.