Skip to main content

Configuration Parameters for Devices

Configuration Parameters are key-value pairs that enable you to customize the behavior of your Devices in different scenarios. For example, you can use them to specify how to decode data or send downlink messages, filter your devices on Widgets, or interact with API & Analysis scripts.

Configuration Parameters are stored on the configuration page of your device. You can access them by clicking on the Devices module in the left menu and selecting a device. You will see a tab called "Configuration Parameters", where you can add, edit, or delete parameters. You can set parameters and retrieve them later by making a request from the device.

How it works​

Each Configuration Parameter has three configurable fields:

  1. Key: Name of the parameter that you can use to reference it in your code or widgets.

  2. Value: The value you want to assign to your device for that parameter.

  3. Read & Unread: A boolean value (true or false) that indicates whether the parameter has been sent to the device.

note

Maximum limit: The maximum number of parameters per Device is 60. If you attempt to add additional items beyond this limit, a notification will appear indicating that the maximum capacity has been reached.

Managing Configuration Parameters​

You can manage your device’s configuration parameters through several methods:

  • Manually – Add, edit, or delete parameters directly from the device page on TagoIO using its user interface.
  • Analysis SDK – Use JavaScript code in an analysis script to create, update, or remove parameters with functions such as paramList, paramSet, and paramRemove.
  • API endpoint – Send HTTP requests (GET, POST, PUT, DELETE) with JSON payloads to TagoIO’s API for programmatic parameter management.
  • Widgets – Some widgets allow you to edit device configuration parameters natively, such as the Device List Widget.

Common Use Cases​

  • Payload Parser – Dynamically change parsing logic based on a parameter value (e.g., mode set to normal or debug).
  • Widget Display – Show additional device details like firmware version or battery level, and filter or sort devices by parameters.
  • API & Analysis – Send commands or queries to devices using their Device‑Token; for example, a downlink parameter can carry payloads that are sent as instructions.