kwindrem / ExtTransferSwitch

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

This software interfaces an external transfer switch ahead of a MultiPlus AC input
	changing the AC input current limit and and AC source type based on on grid/on generator

NOTE: ExtTransferSwitch is incompatible with Venus OS v3.20~45 and newer
	The functionality has been moved to GuiMods
	there were many overlaps in the generator modifications required in the two packages
	ExtTransferSwitch support ends effective immediately

ExtTransferSwitch includes support for "renewable energy" prioritizaiton added in Venus OS 3.10.
	This also requires Multi firmware 506.
	Renewable energy priority shuts down the Multi/Quattro charger allowing solar, wind and other charging sources
		to charge the battery. Grid power is reneabled at a low SOC (battery voltage) set in the Multi configuration.
	In addition, switching the AC source to generator reenables Multi AC input charging.

ExtTransferSwitch includes support for generator warm-up and cool-down added in Venus OS v3.00~37
The same functionality is included in GuiMods, however there are additional enhancements
to the generator interface in GuiMods. Installing GuiMods is recommended.
		
Note: changes added in Venus OS v3.00 and changes added to Multi/Quattro in fimware 502,
	support a generator on AC 2 in.
	These are required for this package to work on a Quattro's AC 2 input

A GX device digital input is connected to the external transfer switch to indicate
	if the grid or generator is routed to the Multi's AC input
	This service then makes changed to the AC input current limit and AC source(type)
	grid/shore or generator

Configuration:

Install the ExtTransferSwitch pacakge (see below under Installation)

Program a digital input for External transfer switch

For Quattros, select if the transfer switch is connected to AC 1 in or AC 2 in.
	(for Multis, this selection does not exist since there is only one AC input.)

Connect an output from the transfer switch to the GX device digital input to indicate
	if the grid or generator source is being routed to the AC 1 input of the Multi.

	The best signal to use is a grid power detection circuit.
		A simle relay across the grid is probably fine for this.
		This same signal would typically switch the transfer switch to the grid position.

	The transfer switch may change state based on generator power being present.
		If this is the case, the generator might not ever start when using this to feed the digital input.
		Install a separate grid power detection circuit to insure proper behavior.

	Verify that the On Grid / On Generator state shown in the Device List tracks the actual state
		of the transfer switch. If it is backwards, change Inverted swich in the device's setup menu.

While On grid, set the grid input current limit and grid type (grid or shore).

Cause the transfer switch to change state and while On Generator, set the input current limit again,
	this time for the generator values.

Now the input current limit will switch between the grid and generator settings.

If you make changes to the input current limit, those changes will be remembered and restored when the transfer switch
returns to that position again.

If you wish to prevent the generator from running when On Grid, make sure the system is not On Generator and
	turn on the Do not run generator when AC1 is in use in:
		Device List / Settings / Generator start/stop settings /Settings / Conditions
	The transfer switch logic will turn this off when switching to On Generator and restore it when switching to On Grid.


Installation:

ExtTransferSwitch requires that SetupHelper is installed first.

The easiest way to install ExtTransferSwitch is to do a "blind install" of SetupHelper
	and then add the ExtTransferSwitch package via the PackageManager menus.

Refer to the SetupHelper ReadMe for instructions and for other install options:
	https://github.com/kwindrem/SetupHelper


Background / internals :

Two input types are reserved for a grid connection: grid or shore.
	This selection is stored so that that specific selection is restored when
	switching back from generator

In addition, the AC input current limit is saved when on both generator and grid
	so that value can also be restored.
	This is stored in dbus
		/Settings/TransferSwitch/GridType

In addition, the Do not run generator ... is saved when on grid
	so that value can also be restored.
	This is stored in dbus
		/Settings/TransferSwitch/StopWhenAc1Available
		/Settings/TransferSwitch/StopWhenAc2Available

Separate grid and generator input current limits are needed for a tidy transition
	between grid and generator.
	These are stored in dbus
		/Settings/TransferSwitch/GridCurrentLimit
		/Settings/TransferSwitch/GeneratorCurrentLimit

The user has no access to /Settings/TransferSwitch/... parameters directly.
Rather, these are updated when the transfer switch digital input changes state
	That is the current settings are stored in /Settings/TransferSwitch/...
		so they can be restored when the transfer switch changes state again

A new digital input type "External transfer switch" allows the external transfer switch to
	communicate with the this software.
	This input should be connected to an isolated contact on the transfer switch that closes
	when the transfer switch is in the generator position.
	The logic can be inverted if the contact closes when on grid.
	The invert control is located in the device list under the transfer switch device


About


Languages

Language:Python 90.9%Language:Shell 7.6%Language:QML 1.5%