Potentiometer Add-On

Configuration Parameters

In addition to the GW4 configuration parameters the add-on has the following specific parameters:

Analog Channel Parameters

Description	Key	Type	Possible Values	Default
Enabled Channel 1	ch1Enable	Boolean	true or false	true
Enabled Channel 2	ch2Enable	Boolean	true or false	true
Enabled Channel 3	ch3Enable	Boolean	true or false	true
Cron in case of alarm	alarmCron	String	Any cron	``
Number of ms to wait before reading	ch1PreReadTO	Integer	0..60000	10
Number of ms to wait before reading	ch2PreReadTO	Integer	0..60000	10
Number of ms to wait before reading	ch3PreReadTO	Integer	0..60000	10
Number of samples to take in one measurement	ch1Samples	Integer	1..200	200
Number of samples to take in one measurement	ch2Samples	Integer	1..200	200
Number of samples to take in one measurement	ch3Samples	Integer	1..200	200
Calibration Factor	ch1Factor	String		[not set]
Calibration Factor	ch2Factor	String		[not set]
Calibration Factor	ch3Factor	String		[not set]
Calibration Offset	ch1Offset	String		[not set]
Calibration Offset	ch2Offset	String		[not set]
Calibration Offset	ch3Offset	String		[not set]
Alarm threshold high	ch1AlarmHigh	String		[not set]
Alarm threshold high	ch2AlarmHigh	String		[not set]
Alarm threshold high	ch3AlarmHigh	String		[not set]
Alarm threshold low	ch1AlarmLow	String		[not set]
Alarm threshold low	ch2AlarmLow	String		[not set]
Alarm threshold low	ch3AlarmLow	String		[not set]

Detailed Description

chXFactor and chXOffset Parameters

The measured raw value is multiplied by chXFactor and then chXOffset is added. All further calculations and alarm checks are done with this derived value.

chXAlarmLow and chXAlarmHigh Parameters

If the calculated measurement value is above chXAlarmHigh or below chXAlarmLow, a alarm is triggered. The number of triggered alarms and the time in the alarm state is measured and transmitted.

alarmCron Parameter

In case of an active alarm, this cron is used instead of the regular cron. If empty, the regular sensor cron will be used.

LoRaWAN Communication

Potentiometer and Analog Values (Port 8)

The gateway will transmit the raw and converted values together with alarm data for all enabled channels.

Byte | 0 .. 5     | 6           | 7 ...       |
     +------------+-------------+-------------+
Data | Timestamp  | Temperature | Channeldata | 

For every enabled channel a block with its data is transmitted:

Byte | 0 .. 4    | 5 .. 8  |      9       | 10 .. 11  |      12     |  13..14  |
     +-----------+---------+--------------+-----------+-------------+----------+
Data | Raw value | Voltage | High Counter | High Time | Low Counter | Low Time |