DataGuard via Analog Inputs

This page describes how to set up a DataGuard analog channel from the physical input signal to the value shown and logged in Emiko.

To complete an analog channel, you must configure both the analog input itself and the DataGuard reporting parameters. DataGuard logging alone is not enough.

Use DataGuard via 1-Wire when the value comes from a mapped 1-Wire sensor channel. Use DataGuard via Driver Communication when the value comes from a configured driver profile rather than a physical analog input.

Complete Setup Workflow

• Configure the physical analog input for the correct electrical signal on the controller or I/O module. For a 4-20 mA transmitter, the channel must be set to current input in hardware. See Analog Transmitter Wiring before configuring DataGuard reporting.
• Use the same channel number (#) for all analog input and DataGuard parameters that belong to the same sensor.
• Set VRTYPE#, TMIN#, and TMAX# in the shared analog input settings. For normal analog values, these settings scale the raw input to the wanted engineering value. For selector-specific paths, follow the selector rule on this page.
• Set VREQT# and VRDATATYPE# so Emiko receives the value under the correct equipment and data type.
• Set VRLOGMODE# and, when needed, VRLOGINT# or VRLOGHYS# to control how the value is sent and logged.
• Verify that the live analog value is correct before relying on history, graphs, sharing, or monitoring.

When DataGuard is Needed

• Use this page when an analog value must be stored as history over time.
• Use this page when an analog value must be exported onward to Emiko for presentation, graphs, or sharing.
• Do not use this page when the analog value only needs local scaling, local alarms, or local product logic.

Activation Rules

• Data is only sent when VREQT# > 0, VRDATATYPE# > 0, and VRLOGMODE# > 0.
• Use the same channel number (#) for all DataGuard parameters that belong to the same analog source.

Typical Uses

• A standalone DataGuard installation with analog sensors for logging, monitoring, graphs, and presentation in Emiko
• OceanWatcher or similar products that use DataGuard as the shared analog data layer
• Other products with free analog inputs where additional sensor values must be sent through DataGuard to Emiko

Product Paths That Use Analog DataGuard

Use the product page first when the analog value belongs to a product-specific flow. Use this page for the shared DataGuard reporting parameters.

Product path	Analog source	DataGuard values	Product setup
Standalone DataGuard	Physical analog input on the controller or I/O module.	VREQT#=35 and a supported child DTY such as 1101.	This page
WeatherStation	4-20 mA or voltage wind direction transmitter. NRG 200M and RNRG/NRG 200P use voltage AI only.	VREQT#=23 and VRDATATYPE# values such as 1106, 9000, 9004, 9006, 9012, or 9013.	WeatherStation DataGuard setup
OceanWatcher	Analog radar distance-to-water value.	VREQT#=20 and VRDATATYPE#=9007.	OceanWatcher DataGuard setup
FlexVander	Optional field value connected to an available analog input.	Use the equipment type and DTY required by the delivered sensor path.	FlexVander LX9 eco IO list

Worked Example

This example shows a standalone DataGuard unit with a temperature transmitter on channel 1.

Field	Example value
Transmitter type	4-20 mA
Measurement range	0 to 100 deg C
Reported in Emiko as	DataGuard equipment, temperature data

Configure the transmitter type and measurement range in the shared analog input settings. Typical DataGuard reporting values for this setup are:

Parameter	Example value	Result
VREQT1	35	Reports the value under the DataGuard equipment itself.
VRDATATYPE1	1101	Sends the value as temperature.
VRLOGMODE1 and VRLOGINT1	Installation-specific	Controls how and when the value is logged or exported.

Analog Source Prerequisites

Configure the analog input source before setting the DataGuard reporting parameters on this page. The full analog source reference is maintained in the shared analog input settings.

• Set VRTYPE# to match the electrical signal from the transmitter.
• For normal analog values, set TMIN# and TMAX# to match the transmitter measurement range. For selector-specific paths, follow the selector rule on this page.
• For analog wind direction values and generic selectors 9000..9006, the direction range is fixed to 0..360 degrees. TMIN# and TMAX# are not used for direction scaling. For RNRG/NRG 200P selector 9013, TMIN# and TMAX# define the post-input signal range in mV before direction conversion. WeatherStation setup explains how VRLIN# can be used as a true-north correction for wind direction. Direction payload values use degrees x 0,01; 36000 means 360,00 degrees / north.
• For water-level selector VRDATATYPE# 9007, set TMIN# and TMAX# in metres as distance from radar to water, for example TMIN1 0 and TMAX1 10. DataGuard converts the scaled metre value to millimetres before the water-level calculation.
• Verify the live scaled analog value before relying on DataGuard history, graphs, sharing, or monitoring.

Analog Wind Direction Calculation Selectors

Use the 9000..9006 selectors only for an analog wind-direction transmitter where the input signal represents a direction over 0..360 degrees. The code scales the electrical signal directly to direction, applies optional VRLIN# true-north offset, and then calculates the selected state, mean, spread, or package output.

Use 9012 only for an NRG 200M wind vane on voltage AI. DataGuard calculates degrees = volts * 147.91 - 1.460 from a 0.007 to 2.5 VDC signal and applies VRLIN# after the NRG voltage conversion.

Use 9013 only for an RNRG/NRG 200P wind vane on voltage AI. DataGuard calculates degrees = 4 + ratio * 352, where ratio = (signal_mV - TMIN#) / (TMAX# - TMIN#), and applies VRLIN# after the 200P conversion. Use TMIN# and TMAX# as the conditioned signal range in mV for this selector.

Generic wind-direction selectors do not identify the exact physical wind-direction sensor model. Confirm the installed model from the delivery or installation record. DataGuard owns the calculation and emitted child-DTY values.

When VRLIN# is changed on an analog wind-direction channel that uses mean, spread, or package output, DataGuard rebuilds the averaging history for that channel from samples with the new correction. The first output after the change can use warmup child values until the 10-minute history is complete.

Selector	Calculation	How DataGuard calculates it	Emitted child-DTY
9000	Wind direction state/QC	Checks analog range, transmitter setup, and calculation state.	1117
9001	10-minute mean direction	Builds rolling vector history and calculates circular mean after coverage.	1118; warmup/QC as 1117
9002	10-minute spread	Finds the largest circular distance from the 10-minute mean. Spread at or above 60.00 degrees sets variable direction state.	1119; warmup/QC as 1117
9003	Reserved	Not accepted by the current setup parser.	None
9004	10-minute package	Sends state/QC during initial warmup, then the 2-minute package during early coverage, then 10-minute mean, spread, and state/QC.	1117, 1120, 1121 during 2-minute coverage; 1117, 1118, 1119 after 10-minute coverage
9012	NRG 200M 10-minute package	Uses NRG 200M voltage conversion, then sends state/QC before 2-minute coverage, the 2-minute package during warmup, and the 10-minute package after 10-minute coverage.	1117 before 2-minute coverage; 1117, 1120, 1121 during 2-minute warmup; 1117, 1118, 1119 after 10-minute coverage
9013	RNRG/NRG 200P 10-minute package	Uses RNRG/NRG 200P mV range conversion from TMIN# and TMAX#, then sends state/QC before 2-minute coverage, the 2-minute package during warmup, and the 10-minute package after 10-minute coverage.	1117 before 2-minute coverage; 1117, 1120, 1121 during 2-minute warmup; 1117, 1118, 1119 after 10-minute coverage
9005	2-minute mean direction	Calculates circular/vector mean over the 2-minute window after coverage.	1120; warmup/QC as 1117
9006	2-minute package	Sends 2-minute mean, 2-minute spread, and state/QC after coverage.	1117, 1120, 1121; warmup/QC as 1117

NRG 200M voltage wind vane

• Use VRDATATYPE#=9012 only as a setup selector for the NRG 200M wind vane. It is not an emitted measurement data type.
• Use voltage AI input types: VRTYPE#=2, 4, or 5.
• Do not use VRTYPE#=0 / 4-20 mA with 9012. That setup is unsupported and reports configuration QC.
• Direction payload values use degrees x 0,01. A value of 36000 means 360,00 degrees / north.

RNRG/NRG 200P voltage wind vane

• Use VRDATATYPE#=9013 only as a setup selector for the RNRG/NRG 200P wind vane. It is not an emitted measurement data type.
• Use voltage AI input types: VRTYPE#=2, 4, or 5.
• Set TMIN#=0 and set TMAX# to the conditioned post-input signal range in mV, normally 2500, 5000, or 10000.
• Do not use 9012 for the 200P wind vane. 9012 is the NRG 200M voltage calculation.
• The controller input must receive a supported conditioned voltage signal. Do not treat the sensor excitation voltage as the analog input signal.
• Direction payload values use degrees x 0,01. A value of 36000 means 360,00 degrees / north.

DataGuard Water Level

Use VRDATATYPE# 9007 when an analog radar such as an LR100 4-20 mA sensor must be handled as a shared water-level source.

• The analog input must be scaled to distance-to-water in metres with TMIN# and TMAX#.
• DataGuard converts the distance to millimetres, applies the configured water-level reference and datum parameters, and sends child DTY values 1220, 1201, 1221, and 1222.
• 9007 is a setup selector. It is not sent as the measurement DTY.

Typical analog radar setup for a 0..10 m distance range:

• TMIN1 0
• TMAX1 10
• VREQT1 20
• VRDATATYPE1 9007

DataGuard Reporting Parameters

Configure these parameters after the analog signal type and measurement range are correct. This is the DataGuard part of the analog setup.

Equipment Type

Select which Emiko equipment type the analog value is reported under. For a standalone DataGuard installation, use the DataGuard EQT value.

Data Type

Select which data type (DTY) the value is sent as in Emiko. For temperature values, use the temperature data type.

Log Mode

Select how the value is triggered and sent, for example periodically, on threshold change, or on event.

Log Interval

Use this parameter when the selected log mode includes periodic logging.

Hysteresis

Use this parameter when the selected log mode includes threshold or hybrid logging.

• Used only with VRLOGMODE values 2 and 4.
• At runtime, the hysteresis value is internally scaled by 100 for comparison with values at 0.01 resolution.

Related References

• Analog Transmitter Wiring
• Shared Runtime Analog Input Settings
• Shared Runtime Data Type Reference
• WeatherStation DataGuard setup
• OceanWatcher DataGuard setup