Updated on 2022-02-24 GMT+08:00

Device Configuration

Description

On the Device Configuration tab page, you can modify the properties of devices in batches.

For the batch configuration of LWM2M devices, the IoT platform provides the device shadow to store the modified device properties. After a device goes online, the modified device properties are synchronized to it.

NOTE:

Before delivering the configuration, open the Product Models page, click Details of the product model to which the device belongs, and set Device Configuration to Supported on the Maintenance Capability Configuration tab page.

Procedure

  1. Choose Batch Tasks > Device Configuration, and click Create.
  2. Set the parameters in the dialog box displayed.

    Parameter

    Description

    Configuration Rule

    Task Name

    Name of a batch device configuration task.

    Set the parameter based on site requirements. The value can contain a maximum of 50 characters.

    Execution Policy

    Whether an execution policy is configured.

    Set the parameter based on site requirements. By default, this parameter is selected.

    Execution Type

    Time at which the task runs.

    • Now: The task runs immediately after being created.
    • Device online: The task runs when the IoT platform is interconnected with the device.
    • Custom: You can customize the start time and end time. Start date and End date are available only if Execution Type is set to Custom.

    Retry Type

    Whether the IoT platform automatically retries the task upon failure. The default value is No.

    • No: The IoT platform does not retry the failed task.
    • Custom: The IoT platform retries the task a specified number of times.

    Retry Attempts

    This parameter is available only if Retry Type is set to Custom.

    The value ranges from 1 to 10.

    Retry Interval (s)

    This parameter is available only if Retry Type is set to Custom.

    The maximum interval is 1200s.

  3. Click Next to enter the next configuration page. Set the parameters.
  4. Select the device group to which the configuration is to be delivered and click Next to enter the next page. Click to upload the device configuration file in JSON format.

    NOTE:

    Prepare a configuration file as follows:

    • If a configuration file has been delivered, select Devices > Device List, click in the row where the device of the same type resides. In the Device Configuration dialog box, download the configuration file that was delivered last time, modify the file, and import the file again.
    • If no configuration file has been delivered, manually create a configuration file. The configuration items that can be delivered and modified must be consistent with the capabilities supported by the product model, and the configuration file must be in JSON format. For example:
      {    "sensitivity": "0",   
       "dataReportInterval": "20"
      }

  5. Click Submit to complete the task creation.
  6. The task execution status and result are displayed. If the success rate is not 100%, click the task name to open the task details page and view the failure cause.