ems

Namespace

ems

Description:

  • Energy Management System (EMS) namespace.

    This namespace provides functions for energy management.

Source:

Methods

(static) calculateOptimalChargeLimit(currentSoC, surplusForecast, targetSoC, targetTime, batteryCapacityKWhopt, includeConsumptionopt) → {Quantity|null}

Description:

  • Calculates the minimum charging power limit (in kW) needed to ensure the battery reaches target SoC exactly by the target time.

Source:
Parameters:
Name Type Attributes Default Description
currentSoC number

Current State of Charge in percentage (0 - 100)
surplusForecast Array:.<items.PersistedItem:>

Array of forecasted surplus power (Solar - Consumption) in kW
targetSoC number 100

Target State of Charge in percentage (0 - 100)
targetTime time.ZonedDateTime

Target time to reach the target SoC
batteryCapacityKWh number <optional>
 10.2

Total capacity of the battery in kWh
includeConsumption boolean <optional>
 false

If true, negative surplus (house consumption) reduces the available energy for charging.
Returns:

The calculated charging power limit

Type
Quantity | null