Battery parameters
battery.type
Type
Required : battery
- Type: string
battery.active
Active
Optional
- Type: number
- Default:
0
Possible values
0- No1- Yes
Deactivated loads are ignored during the calculation
battery.name
Name
Required
- Type: string
Unique load name
battery.priority
Priority
Optional
- Type: number
- Default:
0
Possible values
-2- lowest-1- lower0- normal1- higher2- highest
To prioritise the loading of the battery during daylight times over the use for other loads, set the priority higher than 'normal'.
SOC
battery.capacity
Capacity (brutto)
Required
- Type: integer
- Unit: Wh
- Min:
0
battery.soc
Initial/actual SOC
Required
- Type: integer
- Unit: %
- Min:
0 - Max:
100
More or less the only real variable parameter over time for multiple calculations.
battery.soc_min
Minimal SOC
Required
- Type: integer
- Unit: %
- Min:
0 - Max:
100
battery.soc_max
Maximal SOC
Optional
- Type: integer
- Unit: %
- Min:
0 - Max:
100 - Default:
100
battery.soc_ddp
SOC deep discharge protection
Optional
- Type: integer
- Unit: %
- Min:
0 - Max:
100 - Default:
5
Always charge the battery from the grid to prevent deep discharge, e.g. after a longer period of non-charging.
Charge
battery.charge_min
Minimum charging power
Required
- Type: integer
- Unit: W
- Min:
0
Do not set the min. value too small because of the conversion losses.
battery.charge_max
Maximum charging power
Required
- Type: integer
- Unit: W
- Min:
0
battery.block_charge
Block charge
Optional
- Type: string
Format: HH:MM-HH:MM[,HH:MM-HH:MM]...
Block battery charge for specific time window(s), periods defined over midnight possible.
battery.tariff_pv
PV surplus load tariff
Optional
- Type: number
- Unit: €/kWh
- Min:
0 - Step:
0.001
Charge from PV surplus only if the purchase price is lower or equal. This can be used to postpone the battery charge to midday / times with a very low exchange price.
The next 3 parameters only make sense in conjunction with a variable tariff. (If 'tariff_grid' is not given, possibly given 'power_grid' and 'soc_grid' are ignored)
battery.tariff_grid
Marginal tariff
Optional
- Type: number
- Unit: €/kWh
- Step:
0.001
Discharge only if the tariff is higher, otherwise use energy from grid and/or load up to 'soc_grid'.
battery.power_grid
Grid charging power
Optional
- Type: integer
- Unit: W
- Min:
0
Is only used in connection with 'tariff_grid'.
battery.soc_grid
Load from grid up to SOC
Optional
- Type: integer
- Unit: %
- Min:
0 - Max:
100
Is only used in connection with 'tariff_grid'.
Discharge
battery.discharge_min
Minimum discharging power
Required
- Type: integer
- Unit: W
- Min:
0
Do not set the min. value too small because of the conversion losses.
battery.discharge_max
Maximum discharging power
Required
- Type: integer
- Unit: W
- Min:
0
battery.block_discharge
Block discharge
Optional
- Type: string
Format: HH:MM-HH:MM[,HH:MM-HH:MM]...
Block battery discharge for specific time window(s). Also forces charge from PV surplus. Periods defined over midnight possible.
Other
battery.efficiency
Efficiency
Optional
- Type: integer
- Unit: %
- Min:
0 - Max:
100 - Default:
95
For charge/discharge per direction (inverter + battery combined, 95% each will result in abt. 90% overall).
battery.standby_loss
Standby power loss
Optional
- Type: integer
- Unit: W
- Min:
0 - Default:
10
Continuous consumption.
battery.costs
Costs from battery
Optional
- Type: number
- Unit: €/kWh
- Min:
0 - Step:
0.001
Discharge only if the costs from the battery are lower than the purchase price, otherwise use energy from grid and/or load up to 'soc_grid'.