Skip to content

Power Management Basics

Jump to bottom
partach edited this page Feb 14, 2026 · 3 revisions

Power Management Basics

Overview

The HA_Felicity integration includes power management to prevent electrical overload by monitoring and controlling the current on all three phases of the electrical system.

Operating Principle

Real-Time Monitoring

The system continuously monitors electrical current across all three phases via TREX inverter registers.

Automatic Power Limiting

When any phase exceeds the configured maximum amperage:

  1. System detects the overload condition
  2. Power is automatically reduced in 1 kW steps per cycle
  3. Reduction continues until all phases are within safe limits
  4. Power is gradually restored when demand decreases

Power Management Algorithm

Safe State

  • Condition: All three phases are below the maximum amperage threshold
  • Behavior: System operates at user-configured default power level
  • Status: Normal operation

Overload Detection

  • Trigger: Any single phase exceeds the Max Amperage setting
  • Response: Immediate power reduction initiated

Power Reduction

  • Action: Power level decreased by 1 kW per cycle
  • Frequency: Continues each cycle until safe levels are restored
  • Protection: Prevents circuit breaker trips and electrical system damage

Power Restoration

  • Condition: Current demand decreases after scale-back
  • Action: Power level increased by 1 kW per cycle
  • Limit: Restoration continues until user-configured desired power level is reached
  • Purpose: Maximizes system utilization while maintaining safety

Configuration Settings

The integration uses two primary settings for power management:

1. Power Level

Description: Maximum charge/discharge power setting for the system

Function:

  • Sets the target power level for normal operation
  • Acts as the upper limit for power restoration
  • Controls how fast energy flows to/from the battery

Usage:

  • Used during both charging and discharging operations
  • Reference point for power scaling algorithms
  • Default operating point when no overload is detected

2. Max Amperage

Description: Maximum allowable current for any single phase

Function:

  • Threshold for triggering power reduction
  • Protection limit for electrical installation
  • Prevents overloading individual phases

Behavior:

  • Continuously compared against real-time phase currents
  • When exceeded, initiates power reduction cycle
  • Reduction continues until all phases are within tolerance

Safety:

  • Prevents electrical system damage
  • Protects against circuit breaker trips
  • Ensures balanced load across phases

Power Scaling Logic

State: Safe
├─ All phases < Max Amperage
├─ Power = User configured level
└─ Monitor continuously

State: Overload Detected
├─ Any phase >= Max Amperage
├─ Trigger: Power reduction
└─ Transition to: Reducing Power

State: Reducing Power
├─ Power level -= 1 kW per cycle
├─ Check: All phases < Max Amperage?
│   ├─ Yes → Transition to: Safe (Monitoring for restoration)
│   └─ No → Continue reducing
└─ Minimum limit check

State: Restoring Power
├─ Demand decreased
├─ Power level += 1 kW per cycle
├─ Check: Power < User configured level?
│   ├─ Yes → Continue restoring
│   └─ No → Transition to: Safe (at target level)
└─ Monitor for new overload

Benefits

Safety

  • Prevents electrical system overload
  • Automatic protection without manual intervention
  • Works independently for each phase

Optimization

  • Maximizes available power usage
  • Automatically adapts to changing demand
  • Gradual restoration prevents oscillation

Flexibility

  • User-configurable thresholds
  • Works with different electrical installations
  • Compatible with varying load patterns

Implementation Details

Implementation varies by inverter model:

Related Pages

Clone this wiki locally