Description

Mk2_3phase_RFdatalog_temp.ino - Arduino program that maximizes the use of home photovoltaic production by monitoring energy consumption and diverting power to one or more resistive charge(s) when needed. In the absence of such a system, surplus energy flows away to the grid and is of no benefit to the PV-owner.

History

Issue 1 was released in January 2015.

This sketch provides continuous monitoring of real power on three phases. Surplus power is diverted to multiple loads in sequential order. A suitable output-stage is required for each load; this can be either triac-based, or a Solid State Relay.

Datalogging of real power and Vrms is provided for each phase. The presence or absence of the RFM12B needs to be set at compile time

January 2016, renamed as Mk2_3phase_RFdatalog_2 with these changes:

Improved control of multiple loads has been imported from the equivalent 1-phase sketch, Mk2_multiLoad_wired_6.ino
the ISR has been upgraded to fix a possible timing anomaly
variables to store ADC samples are now declared as "volatile"
for RF69 RF module is now supported
a performance check has been added with the result being sent to the Serial port
control signals for loads are now active-high to suit the latest 3-phase PCB

February 2016, renamed as Mk2_3phase_RFdatalog_3 with these changes:

improvements to the start-up logic. The start of normal operation is now synchronized with the start of a new mains cycle.
reduce the amount of feedback in the Low Pass Filter for removing the DC content from the SampleV stream. This resolves an anomaly which has been present since the start of this project. Although the amount of feedback has previously been excessive, this anomaly has had minimal effect on the system's overall behaviour.
The reported power at each of the phases has been inverted. These values are now in line with the Open Energy Monitor convention, whereby import is positive and export is negative.

February 2020: updated to Mk2_3phase_RFdatalog_3a with these changes:

removal of some redundant code in the logic for determining the next load state.

Robin Emley www.Mk2PVrouter.co.uk

October 2019, renamed as Mk2_3phase_RFdatalog_temp with these changes:

This sketch has been restructured in order to make better use of the ISR.
All of the time-critical code is now contained within the ISR and its helper functions.
Values for datalogging are transferred to the main code using a flag-based handshake mechanism.
The diversion of surplus power can no longer be affected by slower activities which may be running in the main code such as Serial statements and RF.
Temperature sensing is supported. A pullup resistor (4K7 or similar) is required for the Dallas sensor.
The output mode, i.e. NORMAL or ANTI_FLICKER, is now set at compile time.
Also:
- The ADC is now in free-running mode, at ~104 µs per conversion.
- a persistence check has been added for zero-crossing detection (polarityConfirmed)
- a lowestNoOfSampleSetsPerMainsCycle check has been added, to detect any disturbances
- Vrms has been added to the datalog payload (as Vrms x 100)
- temperature has been added to the datalog payload (as degrees C x 100)
- the phaseCal/f_voltageCal mechanism has been modified to be the same for all phases
- RF capability made switchable so that the code will continue to run when an RF module is not fitted. Dataloging can then take place via the Serial port.
- temperature capability made switchable so that the code will continue to run w/o sensor.
- priority pin changed to handle peak/off-peak tariff
- add rotating load priorities: this sketch is intended to control a 3-phase water heater which is composed of 3 independent heating elements wired in WYE with a neutral wire. The router will control each element in a specific order. To ensure that in average (over many days/months), each load runs the same time, each day, the router will rotate the priorities.
- most functions have been splitted in one or more sub-functions. This way, each function has a specific task and is much smaller than before.
- renaming of most of the variables with a single-letter prefix to identify its type.
- direct port manipulation to save code size and speed-up performance

January 2020, changes:

This sketch has been again re-engineered. All 'defines' have been removed except the ones for compile-time optional functionalities.
All constants have been replaced with constexpr initialized at compile-time
all number-types have been replaced with fixed width number types
old fashion enums replaced by scoped enums with fixed types
off-peak tariff made switchable at compile-time
rotation of load priorities made switchable at compile-time
enhanced configuration for override specific loads during off-peak period

April 2020, changes:

Fix a bug in the load level calculation

May 2020, changes:

Fix a bug in the initialization of off-peak offsets
added detailed configuration on start-up with build timestamp

June 2020, changes:

Add force pin for full power through overwrite switch
Add priority rotation for single tariff

October 2020, changes:

Moving some part around (calibration values toward beginning of the sketch)
renaming some preprocessor defines
system/user specific data moved toward beginning of the sketch

January 2021, changes:

Further optimization
now it's possible to specify the override period in minutes and hours
initialization of runtime parameters for override period at compile-time

February 2021, changes:

Added temperature threshold for off-peak period

April 2021, renamed as Mk2_3phase_RFdatalog_temp with these changes:

since this sketch is under source control, no need to write the version in the name
rename function 'checkLoadPrioritySelection' to function's job
made forcePin presence configurable
added WatchDog LED (blink 1s ON/ 1s OFF)
code enhanced to support 6 loads

November 2021, changes:

heavy refactoring/restructuring of the sketch
calibration values moved to the dedicated file 'calibration.h'
user-specific values (pins, ...) are now in 'config.h' all other files should/must remain unchanged
added support of temperature sensors (virtually no limit of sensors count)
added support for emonESP (see https://github.com/openenergymonitor/EmonESP)

January 2023: changes:

the datalogging accumulator for Vsquared has been rescaled to 1/16 of its previous value to avoid the risk of overflowing during a 20-second datalogging period.

February 2023: changes:

heavy refactoring
compile-time validation for pin assignment and a couple of values
project can now be used with both Arduino IDE and PlatformIO (Visual Studio Code).
a couple of pre-defined PlatformIO configs added

June 2023: changes:

heavy refactoring (again)
stl add-ons
add relay-output feature

February 2024: changes:

refactoring of 'temperature feature'
refactoring of 'relay feature'
new sliding average (EWMA)
more documentation

March 2024: changes:

multi-relay feature
add DEMA and TEMA sliding average
some tiny fixes
even more documentation

Author: Fred Metrich