# Implements a custom ESS Mode 3 Control Loop.
# This implementation is specific to the ricardocello Victron ESS configuration.
#
# Interesting Features
#
# The Daily Schedule is programmed to handle every day with minimal interaction other than the target minimum SoC
# at which to start the day. The schedule is built around sunrise and sunset times, so it is unaffected by
# seasons changing (including Daylight Saving Time).
#
# The current Daily Schedule has these actions:
#
# (1) Starting four hours before sunrise, the batteries are discharged to the ESS Minimum SoC using Critical Loads.
# Any PV power that becomes available also powers the Critical Loads, which will slightly reduce
# the battery discharge rate. This should be sufficient time to discharge the batteries down to 10% from 50% SoC.
#
# (2) Starting one hour after sunrise, solar power is used to power all loads. Grid usage is minimized to the
# grid setpoint value in Watts. If there is insufficient solar to power all the loads, grid power is used.
# This keeps the battery SoC increasing monotonically throughout the day. If there is excess solar power available,
# it is used to charge the batteries. When the battery SoC reaches 80%, the battery is also used to power the
# loads, helping to prevent the SoC from reaching 100%. As the solar power decreases such that it is again
# insufficient to power all loads, the battery SoC will be held at 80%.
#
# (3) Starting in the afternoon (70% of the solar day completed), the battery is maintained at a 50% SoC.
# If the SoC is above 50%, the battery is used to power the Critical Loads until it reaches 50% SoC.
# If the SoC is below 50% due to a really cloudy day, grid is used to bring the battery SoC back up to 50%.
# This is to guarantee the battery availability during the critical dinner time hours, especially in the summer.
#
# (4) Starting one hour after sunset, the battery is maintained at a 50% SoC as above. However, when the
# SoC reaches 50%, the inverter and charger are disabled to save considerable idle power overnight (passthru mode).
# This also disables solar power, but since it is dark, it does not matter. This continues through to the next day.
#
# The user can switch between Optimized, Keep Batteries Charged, and this External Control Mode 3 implementation
# by using the console GUI. When one of the ESS Mode 2 modes is active, the custom Mode 3 implementation idles.
# If the user changes the Minimum SoC value in the GUI, it will be passed on to the Mode 3 implementation when
# External Control is reselected. This is convenient for making a real-time setting change.
# If a Daily Schedule is running, it will be restarted to ensure consistency.
#
# The AllLoadsPV state handles the atypical use-case of applying maximum PV power to loads during the day.
# This is to help avoid filling a battery bank with insufficient capacity and for efficiency.
#
# There is a 400-500 W/sec built-in limitation in the inverter firmware (800-1000 W/sec for split-phase 240V loads).
# Although the Grid Meter and control loop run at 10 Hz, response time to a setpoint change appears to be 0.5 seconds.
# These limitations will cause exported power to be sent to the grid when large loads switch off.
#
# L1 and L2 have independent exponential filters for the power setpoints, with dynamic switching of time constants
# to help minimize inadvertent exporting of power to the grid. This also prevents undesired feeding back on one leg
# to the utility transformer, which should increase efficiency. The time constants have been carefully tuned to
# minimize grid feedback. This also balances the L1/L2 difference from the grid, eliminating the inefficiency of
# sending power back to the utility transformer on the Neutral line.
#
# See https://www.victronenergy.com/live/ess:ess_mode_2_and_3
).
