CT3xx – 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 CT3xx TSL model, their descriptions, and how to use them.

Usage

  1. Have an overview of the configurable properties and their default values of CT3xx.
  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 CT3xx 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": {    // The interval for data reporting (minute).
            "time": 10
        },
        "alarm_interval": 5,  // The interval for alarm (minute). 
        "alarm_count": 3,           // The count of alarm. 
        "set_threshold_parameter_ch1_current":{     // Disable current alarm of Phase A settings.
            "threshold_condition": 0,                
            "threshold_max": 1,
            "threshold_min": 1
        },
        "set_threshold_parameter_ch2_current":{     // Disable current alarm of Phase B settings.
            "threshold_condition": 0,                
            "threshold_max": 1,
            "threshold_min": 1
        },
        "set_threshold_parameter_ch3_current":{     // Disable current alarm of Phase C settings.
            "threshold_condition": 0,                
            "threshold_max": 1,
            "threshold_min": 1
        },
        "set_threshold_parameter_temp":{    // Disable temperature alarm.
            "threshold_condition": 0,                
            "threshold_max": 0,
            "threshold_min": 0
        },
    }
}

Description

The following table provides the description and valid values for the configurable properties of CT3xx.

Parameter Type Description
reporting_interval Struct

The interval for data reporting.
time Integer

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

  • Default value: 10
  • Valid value: 1 - 1440
alarm_interval Integer

Specify the alarm interval for current and temperature. (Unit: Minute).

  • Default value: 5
  • Valid value: 1 - 1440
    Note: The alarm interval must be shorter than the reporting interval.
alarm_count Integer

Specify the number of current or temperature alarms.

  • Default value: 3
  • Valid value: 1 - 1000
set_threshold_parameter_ch1_current Struct Current threshold alarm of Phase A settings.
threshold_condition Enum

Specify the conditions for triggering the current alarm.

Valid value:
  • 0: Do NOT send current alarm (Default value).
  • 1: The detected current < Minimum threshold.
  • 2: The detected current > Maximum threshold.
  • 3: Minimum threshold < The detected current < Maximum threshold.
  • 4: The detected current < Minimum threshold or the detected current > Maximum threshold.
threshold_max Integer

Specify the excessive current threshold value (Unit: Amp).

  • Default value: 1
  • Valid value: 1 - 300 (CT303), 1 - 500 (CT305), 1 - 1000 (CT310)
threshold_min Integer

Specify the insufficient current threshold value (Unit: Amp).

  • Default value: 1
  • Valid value: 1 - 300 (CT303), 1 - 500 (CT305), 1 - 1000 (CT310)
set_threshold_parameter_ch2_current Struct Current threshold alarm of Phase B settings.
threshold_condition Enum

Specify the conditions for triggering the current alarm.

Valid value:
  • 0: Do NOT send current alarm (Default value).
  • 1: The detected current < Minimum threshold.
  • 2: The detected current > Maximum threshold.
  • 3: Minimum threshold < The detected current < Maximum threshold.
  • 4: The detected current < Minimum threshold or the detected current > Maximum threshold.
threshold_max Integer

Specify the excessive current threshold value (Unit: Amp).

  • Default value: 1
  • Valid value: 1 - 300 (CT303), 1 - 500 (CT305), 1 - 1000 (CT310)
threshold_min Integer

Specify the insufficient current threshold value (Unit: Amp).

  • Default value: 1
  • Valid value: 1 - 300 (CT303), 1 - 500 (CT305), 1 - 1000 (CT310)
set_threshold_parameter_ch3_current Struct Current threshold alarm of Phase C settings.
threshold_condition Enum

Specify the conditions for triggering the current alarm.

Valid value:
  • 0: Do NOT send current alarm (Default value).
  • 1: The detected current < Minimum threshold.
  • 2: The detected current > Maximum threshold.
  • 3: Minimum threshold < The detected current < Maximum threshold.
  • 4: The detected current < Minimum threshold or the detected current > Maximum threshold.
threshold_max Integer

Specify the excessive current threshold value (Unit: Amp).

  • Default value: 1
  • Valid value: 1 - 300 (CT303), 1 - 500 (CT305), 1 - 1000 (CT310)
threshold_min Integer

Specify the insufficient current threshold value (Unit: Amp).

  • Default value: 1
  • Valid value: 1 - 300 (CT303), 1 - 500 (CT305), 1 - 1000 (CT310)
set_threshold_parameter_temp Struct Temperature threshold alarm settings.
threshold_condition Enum

Specify the conditions for triggering the temperature alarm.

Valid value:
  • 0: Do NOT send temperature alarm (Default value).
  • 1: The detected temperature < Minimum threshold.
  • 2: The detected temperature > Maximum threshold.
  • 3: Minimum threshold < The detected temperature < Maximum threshold.
  • 4: The detected temperature < Minimum threshold or the detected temperature > Maximum threshold.
threshold_max Float

Specify the maximum threshold for temperature alarm (Unit: °C).

  • Default value: 0
  • Valid value: -20 - 100
    Note: This value supports setting one decimal place.
threshold_min Float

Specify the minimum threshold for temperature alarm (Unit: °C).

  • Default value: 0
  • Valid value: -20 - 100
    Note: This value supports setting one decimal place.