This article includes tables that show what Raw Value data is coming from the Agent.
Some data is sent directly from the sensor with no manipulation. Other data that was multiplied by some factor must now be divided by that same factor. The tables show what transformation, if any, needs to be done to the data to make it useful in your SCADA system.
Mapped Names
The following table lists the ChannelTypeRaw and ChannelNumber values that you might see in your Raw Value data from the Agent.
The ChannelTypeRaw name is mapped to a more user-friendly ChannelType name in FAI Lite. The mapped names will be seen in the CSV output or DNP3 client.
Channels, Mapped Names, and Transformations
The following table lists the channel numbers, mapped names, and transformations that might be needed.
The channel number of a mapped name indicates a specific parameter. For example, channel 0 of “Power” is a parameter of battery voltage, but channel 0 of “TemperatureHumidity” is for device temperature.
In your SCADA, Raw Value data might need to be transformed to appropriate engineering units to give Final Value data. For example, the Raw Value data from “Power” on channel 2 must be divided by 1000 to give the Final Value.
For details about specific technical streams, see Overview of Technical Streams.
|
ChannelNumber |
Mapped Name |
Transformation Equation (Must be done in SCADA) |
Description |
|
0 - 15 |
Serial |
The equation depends on the type of communication protocol (sample_handler property) that is used:
|
|
|
0 - 3 |
Analog |
Step 1:
Step 2: Convert the actual sensor measurements (after the revision above) into the appropriate engineering units. |
The device measures current in mA and voltage in µV. |
|
0 - 5 |
PulseCounter |
|
Counts the number of events that occurred in a defined time interval, such as an hour. |
|
0 – 5 |
Digital |
|
|
| 0 | GPS | GPS position of the device. | |
|
0 |
Power |
Divide by 1000. (4) |
Battery voltage every minute. |
|
1 |
Power |
Battery voltage during cellular communication. |
|
|
2 |
Power |
External power voltage. |
|
|
3 |
Power |
|
µA consumption used by the battery for every sampling and transmission. |
|
4 |
Power |
|
µA consumption used by the external power source for every sampling and transmission. |
|
5 |
Power |
|
The remaining amount of charge in the battery, scaled to 0-100%. Sent only after a measurement is perform and the battery is used. |
|
0
|
TemperatureHumidity |
|
The internal temperature in Celsius of the physical device. The temperature is in whole numbers. |
|
1
|
TemperatureHumidity |
|
The amount of moisture, in percentage, that has penetrated the physical device. Supported in: Wavelet 4™, Wavelet V2™, Wavelet Ex™.
Not supported in Wavelet 4R™. |
|
0 |
CellularSignal |
Convert to dBm units: dBm = -113 + (CSQ * 2) |
The modem signal for CSQ. |
|
1 |
CellularSignal |
The modem signal %. |
|
|
2 |
CellularSignal |
|
The RSRP (Reference Signal Received Power) for 4G - the modem signal’s power. |
|
3 |
CellularSignal |
|
The RSRQ (Reference Signal Received Quality) for 4G - the modem signal’s quality. |
(1) In the UI, go to your_device > stream_with_serial_flow > Advanced Device Configuration > Serial > channel_number.
If read_type is any of the following values:
-
-
- MODBUS_READ_HOLDING_U8
- MODBUS_READ_HOLDING_U16
- MODBUS_READ_HOLDING_U32
- MODBUS_READ_HOLDING_S8
- MODBUS_READ_HOLDING_S16
- MODBUS_READ_HOLDING_S32
- MODBUS_READ_INPUT_U8
- MODBUS_READ_INPUT_U16
- MODBUS_READ_INPUT_U32
- MODBUS_READ_INPUT_S8
- MODBUS_READ_INPUT_S16
- MODBUS_READ_INPUT_S32
-
then no conversion is needed. The Final Value = Raw Value.
If read_type is any of the following values:
-
-
-
MODBUS_READ_HOLDING_FLOAT
-
MODBUS_READ_HOLDING_DOUBLE
-
MODBUS_READ_INPUT_FLOAT
-
MODBUS_READ_INPUT_DOUBLE
-
-
then you must use the third parameter (the multiplication factor) of the extra_params parameter and multiply by that parameter value.
Final Value = Raw Value / multiplication_factor
(2) In the UI, go to your_device > stream_with_serial_flow > Advanced Device Configuration > Serial > channel_number.
If the reset_delay parameter has a value, then you must divide by that value. Final Value = Raw Value / reset_delay.
Otherwise, Final Value = Raw Value / 1000.
(3) In the UI, go to your_device > stream_with_serial_flow > Advanced Device Configuration > Serial > channel_number.
If read_type is any of the following values:
- MODBUS_READ_HOLDING_U8
- MODBUS_READ_HOLDING_U16
- MODBUS_READ_HOLDING_U32
- MODBUS_READ_HOLDING_S8
- MODBUS_READ_HOLDING_S16
- MODBUS_READ_HOLDING_S32
- MODBUS_READ_INPUT_U8
- MODBUS_READ_INPUT_U16
- MODBUS_READ_INPUT_U32
- MODBUS_READ_INPUT_S8
- MODBUS_READ_INPUT_S16
- MODBUS_READ_INPUT_S32
then no conversion is needed. The Final Value = Raw Value.
If read_type is any of the following values:
- MODBUS_READ_HOLDING_FLOAT
- MODBUS_READ_HOLDING_DOUBLE
- MODBUS_READ_INPUT_FLOAT
- MODBUS_READ_INPUT_DOUBLE
then Final Value = Raw Value / 1000.
(4) Each Raw Value sample represents a value of voltage with three digits precision. In order to avoid floating point operations on the device, the Raw Value was multiplied by 1000.
For example, a value of 0.123V will be encoded as 123. A value of 4.789V will be encoded as 4789. Therefore, to recover the true voltage value, the value must be divided by 1000.
Final Value = Raw Value / 1000.