EM410-RDL – Configurable Properties

You can update a device's settings by modifying the configurable properties of its TSL model via API. This topic provides the configurable parameters for EM410-RDL TSL model, their descriptions, and how to use them.

Usage

  1. Have an overview of the configurable properties and their default values of EM410-RDL .
  2. Copy the example code and remove the comments and parameters that do not require modification.
  3. Edit the desired properties according to the detailed properties description .
    Note: Make sure that the edited example code complies with the JSON format requirements.
  4. Use the edited example code as the body parameters of Update Device Properties Incrementally.

Configurable Properties

The following code represents all configurable properties in the EM410-RDL TSL model, along with their default values.

Note:
  • Click a property to view its detailed description and valid values.
  • Configure the example code as needed, then use it as the body parameters of Update Device Properties Incrementally to save time and effort.
{
    "version": "v1.0",
    "type": "TSL",
    "properties": {
        "reporting_interval": { // Reporting Interval Settings Type: struct
            "time": 1440 // Reporting Interval Type: int Unit: min
        },
        "outlier_resampling_settings": { // Outlier Resampling Parameter Settings Type: struct
            "times": 1, // Re-collected Times Type: int
            "interval": 5 // Re-collected Interval Type: int Unit: s
        },
        "tilt_linkage_distance_enable": true, // Tilt&Distance Switch Type: bool
        "device_mode": "0", // Scenario Mode Type: enum
        "general_mode_range": { // Measurement Range of General Mode Type: struct
            "max": 12000 // Measurement Range Type: int Unit: mm
        },
        "rainwater_well_mode_range": { // Measurement Range of Rainwater Well Mode Type: struct
            "max": 6000 // Measurement Range Type: int Unit: mm
        },
        "wastewater_well_mode_range": { // Measurement Range of Wastewater Well Mode Type: struct
            "max": 6000 // Measurement Range Type: int Unit: mm
        },
        "time_zone": "0", // Time Zone Type: enum Unit: min
        "collection_interval": 10, // Collecting Interval Type: int Unit: min
        "alarm_reporting_times": 1, // Alarm Reporting Times Type: int
        "distance_alarm_rule": { // Distance Threshold Alarm Type: struct
            "condition": "0", // Threshold Condition Type: enum
            "alarm_deactivation_enable": "0", // Alarm Dismiss Report Type: enum
            "threshold_min": 300, // Value A Type: int Unit: mm
            "threshold_max": 300 // Value B Type: int Unit: mm
        },
        "distance_mutation_alarm_rule": { // Distance Mutation Threshold Alarm Type: struct
            "condition": "0", // Threshold Condition Type: enum
            "threshold_max": 1 // Value B Type: int Unit: mm
        },
        "distance_calibration_parameter": { // Distance Calibration Settings Type: struct
            "enable": false, // Calibration Enable Type: bool
            "value": 0 // Calibration Value Type: int Unit: mm
        },
        "data_storage_enable": false, // Data Storage Enable Type: bool
        "retransmission_enable": false, // Data Retransmission Enable Type: bool
        "retransmission_interval": { // Retransmission Interval Settings Type: struct
            "interval": 600 // Retransmission Interval Type: int Unit: s
        },
        "retrival_interval": { // Retrival Interval Settings Type: struct
            "interval": 60 // Retrival Interval Type: int Unit: s
        }
    }
}

Description

The following table provides the description and valid values for the configurable properties of EM410-RDL.

Parameter Type Description
reporting_interval Struct

Reporting Interval Settings.

time Integer

Specify the interval for data reporting (Unit: Minute).

  • Default value: 1440
  • Valid value: 1 - 1440
outlier_resampling_settings Struct

Recollection settings of Measure Outlier Calibration.

times Integer

Specify the times to re-collect distance when the device distance value exceeds the outlier range compared to the previous value.

  • Default value: 1
  • Valid value: 1 - 3
interval Integer

Specify the interval to re-collect distance when the device distance value exceeds the outlier range compared to the previous value. ( Unit : s)

  • Default value: 5
  • Valid value: 1 - 10
tilt_linkage_distance_enable Boolean

Decide whether to turn off the distance measuring function when the offset angle is greater than 15 degrees.

Valid value:
  • false: disable.
  • true: enable (Default value).
device_mode Enum

Specify the Scenario Mode of measurement.

Valid value:
  • 0: General Mode (Default value).
  • 1: Rainwater Well Mode.
  • 2: Wastewater Well Mode.
general_mode_range Struct

Measurement Range settings of General Mode.

max Integer

Specify the maximum measurement range of General Mode ( Unit : mm).

  • Default value: 12000
  • Valid value: 1000 - 12000
rainwater_well_mode_range Struct

Measurement Range settings of Rainwater Well Mode.

max Integer

Specify the maximum measurement range of Rainwater Well Mode ( Unit : mm).

  • Default value: 6000
  • Valid value: 1000 - 12000
wastewater_well_mode_range Struct

Measurement Range settings of Wastewater Well Mode.

max Integer Specify the maximum measurement range of Wastewater Well Mode ( Unit : mm).
  • Default value: 6000
  • Valid value: 1000 - 12000
time_zone Enum

Specify the time zone for this device.

  • Default value: 0 (UTC / Western European Time)
  • Valid value: Refer to time_zone Value for valid values and description.
collection_interval Integer

Specify the interval for collecting data (Unit: Minute).

  • Default value: 10
  • Valid value: 1 - 1440
alarm_reporting_times Integer Specify the number of reporting alarms.
  • Default value: 1
  • Valid value: 1 - 1000
distance_alarm_rule Struct

Distance Threshold Alarm settings.

condition Enum

Specify the conditions for triggering the distance threshold alarm.

Valid value:

  • 0: Do NOT send distance alarm (Default value).
  • 1: The detected distance < Minimum threshold.
  • 2: The detected distance > Maximum threshold.
  • 3: Minimum threshold < The detected distance < Maximum threshold.
  • 4: The detected distance < Minimum threshold or the detected distance > Maximum threshold.
alarm_deactivation_enable Enum Decide whether to enable alarm dismiss report.
Valid value:
  • 0: disable (Default value).
  • 1: enable.
threshold_min Integer

Specify the minimum threshold for distance alarm ( Unit : mm).

  • Default value: 300
  • Valid value: 300 - 12000
threshold_max Integer

Specify the maximum threshold for distance alarm ( Unit : mm).

  • Default value: 300
  • Valid value: 300 - 12000
distance_mutation_alarm_rule Struct

Distance Shifts Threshold Alarm settings.

condition Enum Decide whether to enable distance shifts threshold alarm.
Valid value:
  • 0: disable (Default value).
  • 5: enable.
threshold_max Integer

Specify the shifts value for distance alarm ( Unit : mm).

  • Default value: 1
  • Valid value: 1 - 11700
distance_calibration_parameter Struct

Distance Calibration Settings.

enable Boolean

Decide whether to enable distance calibration.

Valid value:
  • false: disable (Default value).
  • true: enable.
value Integer

Specify the calibration value ( Unit : mm).

  • Default value: 0
  • Valid value: -12000 - 12000
data_storage_enable Boolean

Decide whether to allow the device to store data.

Valid value:
  • false: disable (Default value).
  • true: enable.
retransmission_enable Boolean
Decide whether to enable data retransmission, which allows the device to log time point of network disconnection periodically resend the accumulated data during the disconnection period upon reconnection.
Note: This setting ONLY takes effect when data_storage_enable is set to true.
Valid value:
  • false: disable (Default value).
  • true: enable.
retransmission_interval Struct
Note: This setting ONLY takes effect when retransmission_enable is set to true.
The interval for data retransmission.
interval Integer
Specify the interval for data retransmission (Unit: Second).
  • Default value: 600
  • Valid value: 30 - 1200
retrival_interval Struct

Data retrival Interval Settings.

interval Integer
Specify the time interval for data retrieval (Unit: Second).
  • Default value: 60
  • Valid value: 30 - 1200