Integrating Sensor Data with SCADA

This guide explains how to interpret and transform Raw Value data received from the Agent, so it can be used meaningfully in your SCADA system. Some data is transmitted directly from the sensor without modification, while other data must be converted using a specific formula. The tables below provide all necessary mapping and transformation details.

---

Understanding Mapped Names

The ChannelTypeRaw and ChannelNumber values in your Agent's Raw Value data are mapped to more user-friendly ChannelType names in FAI Lite. These mapped names appear in both CSV exports and DNP3 client outputs.

---

Channels, Mapped Names, and Required Transformations

Use the table below to determine:

• The meaning of each channel

• Whether a transformation is required

• What equation to use (performed in SCADA)

• Description of the parameter being measured

ChannelNumber	Mapped Name	Transformation Equation	Description
0–15	Serial	Depends on protocol (see below)	Based on communication protocol (sample_handler): • Modbus (1) • KEP (2) • Kapta (3) • Others: divide by 1000
0–3	Analog	Step 1: • Current: ÷ 1000 • Voltage: ÷ 1,000,000 Step 2: Convert to engineering units	Current in mA; Voltage in µV
0–5	PulseCounter	—	Event counts per time interval (e.g., per hour)
0–5	Digital	—	Binary status input
0	GPS	—	GPS position of the device
0	Power	÷ 1000 (see note 4)	Battery voltage (per minute)
1	Power	—	Battery voltage during cellular activity
2	Power	—	External power voltage
3	Power	—	Battery µA consumption per sample/transmit
4	Power	—	External µA consumption per sample/transmit
5	Power	—	Remaining battery charge (0–100%), reported post-measurement
0	TemperatureHumidity	—	Internal temperature (°C, whole numbers)
1	TemperatureHumidity	—	Moisture penetration (%). Supported in: Wavelet 4™, V2™, Ex™ Not supported: Wavelet 4R™
0	CellularSignal	dBm = -113 + (CSQ × 2)	CSQ modem signal strength
1	CellularSignal	—	Modem signal percentage
2	CellularSignal	—	RSRP (4G signal power)
3	CellularSignal	—	RSRQ (4G signal quality)

---

Protocol-Specific Transformation Rules

(1) Modbus

In the UI: Path: your_device > stream_with_serial_flow > Advanced Device Configuration > Serial > channel_number

• If read_type is one of: MODBUS_READ_HOLDING_U8/U16/U32/S8/S16/S32 MODBUS_READ_INPUT_U8/U16/U32/S8/S16/S32 ➤ No conversion needed Final Value = Raw Value

• If read_type is one of: MODBUS_READ_HOLDING_FLOAT/DOUBLE MODBUS_READ_INPUT_FLOAT/DOUBLE ➤ Multiply by the third parameter (multiplication factor) of extra_params Final Value = Raw Value / multiplication_factor

---

(2) KEP

In the UI: Path: your_device > stream_with_serial_flow > Advanced Device Configuration > Serial > channel_number

• If reset_delay has a value: Final Value = Raw Value / reset_delay

• Otherwise: Final Value = Raw Value / 1000

---

(3) Kapta

In the UI: Path: your_device > stream_with_serial_flow > Advanced Device Configuration > Serial > channel_number

• If read_type is one of: MODBUS_READ_HOLDING_U8/U16/U32/S8/S16/S32 MODBUS_READ_INPUT_U8/U16/U32/S8/S16/S32 ➤ No conversion needed Final Value = Raw Value

• If read_type is one of: MODBUS_READ_HOLDING_FLOAT/DOUBLE MODBUS_READ_INPUT_FLOAT/DOUBLE ➤ Final Value = Raw Value / 1000

---

(4) Voltage Value Scaling

Each Raw Value sample of voltage is multiplied by 1000 before transmission to avoid floating-point operations on the device.

Examples:

• 0.123V is sent as 123

• 4.789V is sent as 4789

To retrieve the real voltage: Final Value = Raw Value / 1000

---

For More Information

📘 [Overview of Technical Streams]