This package adds additional digital inputs and relay outputs
for Venus OS running on Raspberry PI platforms. 
It is not suitable for other GX devices such as CCGX or Cerbo GX.

The stock RPI Venus distribution there are NO relays or digital inputs defined.

This script adds:
    5 digital inputs
    makes additional digital inputs available
    makes all digital inputs behave the same: pull up so they are active low
    6 relay outputs
    activates GPIO 16 (header pin 36) as a shutdown pin
		This requires ShutdownMonitor v2.0 or later

The Raspberry PI default is for the first 8 GPIO pins to have pull UPs
and the remaining have pull DOWNs. This makes some digital input pins behave differently
This script installs a DT overlay that switches to pull UPs for all digital input pins


Only the relay 1 can be assigned to a function: alarm, generator start/stop or pump.
In addition, relay 2 can be assigned to temperature alarm
The remaining 4 relays are only provided manual on/off control from the menu.

Note that the Raspberry PI has no relays or isolated/filtered digital inputs on board.

Relay outputs are 0 volts when inactive and 3.3 volts when active.
Current sink and source is limited. Check Raspberry PI specifications for details.
You must attach the GPIO pins to external relays.
Relays should active on a high (3.3 volt) input.
Relays that activate on a low signal are NOT COMPATIBLE since
the relays would still close during Raspberry PI boot regardless of the logic provided by Venus OS.

Digital inputs expect 0 volts for an inactive input and 3.3 volts for an active input.
You must provide isolation for the digital inputs to avoid damage to the CPU chip!!!

Venus OS does not provide native support for i2c relay boards and this package does not add any.

This script will accept default options when run from PackagManager. 


This script will select default options when run from PackageManager.
This may not be appropirate. See section below on GPIO conflicts:
The script MUST be run from the command line to set options.
After that, those options will be used when installing via PackageManager,
including automatic reinstall following a firmware update.


GPIO conflicts:

GPIO assignments for relays 5 and 6 may cause conflicts with hat board interrupts. 
This conflict may cause the system to not boot or be extremely sluggish.
This script allows for two assignments for relays 5 and 6.
gpio_list is the legacy one: GPIO 23 and 24, respectively
gpio_listForCanHats provides compatibility with
		Waveshare CANbus dual channel hats (and possibly others)
	GPIOs 2, 12 and 4 are used for relays 1. 5 and 6, respectively
	GPIO 3 is used for digital input 4
	However, i2c is disabled since it uses GPIO 2 and 3 !

An option to select the legacy or compatible set is offered
when running setup from the command line.

Custom GPIO list:

If /data/setupOptions/RpiGpioSetup/gpio_list exists it is used in place
	of the one in the package directory.
	This accommodates Relay HATs, etc. that use different GPIO pins.

Installation:

RpiGpioSetup requires that SetupHelper is installed first.

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

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