Configuring device telemetry

This guide will walk you through the process of configuring device telemetry to translate raw data into meaningful, visually structured information.

Telemetry data is all the information collected from your devices, such as speed, temperature, voltage and others. This information is collected in Sensors. To make setup easier, you can create sensor templates to apply the same data configuration across multiple devices.

Configuring and visualizing sensors includes the following tasks:

1. Setting up a telemetry template
2. Setting up the device list
3. Setting up the device details

A telemetry template saves a predefined configuration of telemetry parameters and formatting rules for a specific device model.

First, define how the platform should interpret data from your devices:

1. In Wialon Platform Studio, navigate to the Customers tab.

2. Select the customer whose device you want to configure.

3. Go to the Devices tab.

4. Select a device.

5. Go to the Sensors tab.

   

6. Select a sensor type on the left, for example, Engine temperature.

7. In the Settings field on the right, select a Sensor template. To create a new one, select Create new in the bottom of the list.

8. Configure the following parameters:

   • Name:
   • Measurement unit: Set the unit (for example, °C).
   • Formula: Define the formula to calculate the value. You can perform mathematical operations within this text field. Use standard mathematical symbols like + (addition), - (subtraction), *(multiplication), / (division), and () (parentheses) to perform calculations. For example, typing (10 * 5) + 2 will be processed as a mathematical expression.
   • Validation: Add validation condition to confirm accuracy. In the Type field, select if the parameter exists or not. In the Name field, indicate the name of the parameter.

9. Click Save to save your template.

See the detailed instructions on the Configuring sensors page.

Advantages of templates:

• Consistency: Apply a single template to all devices of the same model, ensuring uniform data processing and display.
• Simplified configuration: When customizing the device display, you can add preconfigured data types (for example, Ignition) instead of raw parameters.

After configuring sensors in Wialon Platform Studio, you can customize how it is displayed in Wialon Platform FleetSpace.

A device has two configurable views:

• Device list: Overview of all devices.
• Device details: Details of a single device.

You can use chips and widgets to customize both views.

• Chips: Small, color-coded indicators for at-a-glance status.
• Widgets: Larger blocks that display detailed data, often with charts.

The device list is customized with chips for quick, real-time summaries. Telemetry chips provide quick summaries of each device’s key stats, helping you spot issues at a glance.

To add a telemetry chip:

1. Log in as a customer and navigate to the Devices tab.

2. Enable the Editor mode using the toggle switch.

3. In any device row click the Add widget slot.

4. Locate the Telemetry chip and click the icon in its row.

5. In the new window, enter a Parameter system name. This is the data you want to display (for example, position.speed).

   

6. Enter a Unit of measurement for the parameter if applicable (for example, km/h).

7. Add a custom Label for the chip, which is what will be displayed to the user.

8. Under Thresholds, you can define a numerical range.

9. Click the icon to add a new threshold row. You can set a value and then specify the color of the chip when the parameter’s value falls within or exceeds that threshold.

10. Click the icon in the top-right corner of the window to add the telemetry chip to the device’s row.

Now you can monitor the vehicle speed in the devices list. You can add multiple telemetry chips to monitor other parameters.

The device details shows a full dashboard with chips (summary data) and widgets (detailed data such as speed, temperature, ignition, and voltage).

To add a chip:

1. From the device list, open the device details.
2. Enable the Editor mode.
3. In any top row click the Add widget slot.
4. Add the Telemetry chip as described above.

Now you can monitor the vehicle speed in the devices list. You can add multiple telemetry chips to monitor other parameters.

To add a widget:

1. Click the icon in the dashboard body.

2. Select a widget (for example, Telemetry cell).

   

3. In the new window, select a Parameter system name from the dropdown menu. This is the data point you want to display (for example, position.satellites).

4. You can optionally enter a Unit of measurement for the parameter.

5. Provide a Title for the telemetry cell (for example, Satellites).

6. Select a Size for the cell, which determines how much space it occupies.

7. Click the icon .in the top-right corner to add the telemetry cell to the device’s row.

Now you can view satellite data in a cell within the device details main body.

The Track Player tab visualizes historical trips with event icons generated directly from telemetry data. These icons mark critical occurrences such as speeding or harsh driving.

You can customize the data displayed on the Track player page using the Editor mode.