Battery management¶
IN PROGRESS COMMUNITY
The box reads your home battery and takes it into account when sharing the surplus. During off-peak hours, it can stop the battery from emptying into the car. It never controls the battery's charging: that stays with the inverter.
What the box reads¶
- The state of charge, as a percentage, and the power: charging or discharging.
- The app shows them in the energy flow ("Battery", the percentage and the power) and keeps the state-of-charge history (the "Battery %" curve in the Energy screen and the day card).
Any battery its plugin presents as energy storage is read; with several batteries, the box uses their average state of charge.
The battery and the surplus¶
The reserve. In EMS settings, the Charging priority card sets a charge level (in an administrator session).
- Below the reserve, the battery comes first: the surplus goes to no controlled load (neither charging station nor water heater), and the box leaves some for the battery to recharge. The reason says so.
- Above the reserve, what the battery absorbs counts as surplus: controlled loads come before filling a battery that is already above its reserve.
- Its discharge is never surplus: the box does not empty the battery to run a controlled load, whatever its level.
A reserve set above the current state of charge blocks all surplus control until the battery rises above it: the app points this out.
During off-peak hours: the battery does not empty into the car¶
With a peak / off-peak tariff (Tariffs), during off-peak hours and as long as a car is actually charging, the box blocks the battery's discharge. Otherwise the battery would supply the car with energy that costs less from the grid at that time.
- The block starts when the station draws current, and ends when the car has finished or at the end of off-peak hours: the battery then returns to normal operation.
- During that time, the battery does not discharge at all, the house included.
- The box never touches the battery's charging, nor its recharging from the grid.
If the battery allows it. The box only blocks the discharge of a battery that offers a controllable discharge limit and a revert timer: if the box stops, the battery returns to normal operation by itself after that delay. Without either, the box does not control it: the battery discharges into the car, and the app says so ("battery not protected").
During the block, the battery line of the Right now card shows that discharge is blocked while the car charges in off-peak hours, and until when.
Which batteries¶
| Battery | Read | Discharge blocked in off-peak hours |
|---|---|---|
| Battery seen by the SunSpec plugin as SunSpec Storage (for example a Fronius battery reached over Modbus SunSpec) | yes | yes, if its Setpoint revert time setting (revertTime) is at least 120 s; it is 0 by default |
| Batteries of the other inverter plugins | yes, if the plugin publishes the state of charge | no: their plugin offers no discharge limit |
For devices and their channel, see Compatibility.
What the box does not do¶
- It controls neither the battery's charging nor its recharging from the grid.
- It does not discharge the battery for a controlled load.
- It does not choose charging or discharging times according to price.
Going further: the API
- Reserve:
NymeaEnergy.GetBatteryLevelConsideration/SetBatteryLevelConsideration(0 to 1; writing requires the administrator right). Reason:BATTERY_RESERVE. - Off-peak hours:
storageblock ofNymeaEnergy.GetLoadTelemetry, reasonsSTORAGE_DISCHARGE_BLOCKED,STORAGE_AUTOMATICandSTORAGE_NOT_PROTECTED(cause:noDischargeControl,noRevertTimer). The box only writes thedischargingRateandenableDischargingstates of theenergystorageinterface. - See the API reference.