Configuring sensors

Who can do it: Service provider
Where: Wialon Platform Studio

On the Sensors tab, you can configure how the platform interprets and processes data from your devices.

Sensors represent various telemetry data transmitted in device messages, such as speed, temperature, voltage and others. Configured sensors can transmit parameter values or calculation results using parameters. Depending on the data transmitted, sensors are divided into the following types:

  • Acceleration: Measures the rate of change in velocity (in m/s2 or G).
  • Alarm trigger: Check the alarm status (Triggered or normal)
  • Battery level: Measures the tracker battery charge (in % or kWh)
  • Cargo door open: Monitors the cargo door (Open or Closed)
  • Door open: Monitors the door (Open or Closed)
  • Driver identification: Registers the driver ID using RFID, iButton, or a tachograph card. If the device has a tachograph with two card slots, you can configure a separate value for each slot using the Multiple option in the sensor template.
  • Engine hours counter: Tracks the total duration the engine has been running.
  • Engine temperature: Monitors the engine coolant temperature (in °C or °F).
  • Fuel consumption: Measures the consumed fuel over time (in L or L/100km).
  • Fuel volume: Monitors the fuel amount in the tank (in L). If your vehicle has more than one tank, you can configure a separate value for each tank using the Multiple option in the sensor template.
  • Ignition: Monitors the status of the vehicle’s ignition (On or Off).
  • Load weight: Measures the weight (kg or tonnes)
  • Mileage counter: Tracks the total distance traveled by the vehicle.
  • Private use: Monitors the status of a privacy switch or flag (On or Off).
  • Refrigerator temperature: Monitors the internal temperature of a refrigeration unit (in °C or °F).
  • RPM: Monitors the engine revolutions per minute.
  • Seatbelt: Monitors the seatbelt status (Fastened or Unfastened).
  • Tyre pressure: Measures the tyre pressure (PSI or kPa)
  • Voltage: Measures the electrical system voltage in volts (V).

You can’t create new sensor types.

Each sensor type displays current value and shows a graph illustrating recent readings. This visual representation provides a quick overview of the sensor activity.

To configure a sensor, create a template within a predefined sensor type.

Sensor templates are reusable detailed configuration of telemetry parameters and formatting rules. They let you save and reuse different configurations, for example, for various device models.

To manage the device telemetry data using the Sensors tab:

  1. Select a Sensor type to define which telemetry data you want to track for a specific vehicle.
  2. Create a Sensor template for this sensor type to define how to calculate and format that data, using a specific formula and unit of measurement.

Selecting a sensor type

  1. In Wialon Platform Studio, go to the Customers tab.
  2. Select the customer whose devices you want to configure.
  3. Navigate to the Devices tab.
  4. Select a specific device from the list.
  5. Click on the Sensors tab.
  6. On the Sensors tab, select a sensor from the list of default sensor types, such as Engine temperature, Ignition, Refrigerator temperature. For example, Engine temperature.

The Settings panel on the right will become active, allowing you to create a sensor template for the Engine temperature sensor.

Creating and configuring a sensor template

Sensor templates are reusable configurations that ensure consistency across multiple devices of the same model. You can either use an existing template or create a new one.

Using an existing sensor template

To select a sensor template:

  1. In the Settings section, locate the Sensor template dropdown menu.
  2. Click the dropdown to see a list of existing templates.
  3. Select an existing template if it matches your needs.

If necessary, you can edit the existing template parameters and click Save. The changes to the template will be applied for all the customer devices.

Creating a sensor template from a message parameter

Apart from creating sensors and sensor templates on the Sensors tab, you can do this on the Messages tab of the device details.

.

  1. Navigate to the Messages tab.
  2. Select the message with the required parameter. If you don’t find the necessary message among the displayed ones, increase the selected time period.
  3. On the Message details pane, select the required parameter.
  4. Click the icon .
  5. Select the sensor type.
  6. Edit the sensor name or leave the one suggested by the platform.
  7. Select the measurement unit.
  8. Click Create.

After this, the platform creates the sensor template and a sensor based on this template.

If a sensor of the selected type already exists for the device, the new setup replaces the existing one.

The created sensor is displayed on the Sensors tab. You can reuse the same sensor template for other devices when creating sensors of the same sensor type.

If you find a mistake in the text, please select it and press Ctrl+Enter.