Configuring the “Private use” sensor

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

Devices can communicate their private mode status through a hardware method, where a physical button or switch in the vehicle sends a specific parameter. To enable the system to interpret this parameter as private use, you must create a Private use sensor.

If a device doesn’t support sending private use parameters, you can configure widgets for manual activation of private use mode.

To configure the Private use sensor for a device, follow these steps:

1. Log in to Wialon Platform Studio.

2. Navigate to the Devices section.

   

   You can also access devices of a specific customer by:

   • Going to the Customers section
   • Selecting the required customer
   • Clicking the Devices tab in the customer details

3. Select the device for which you want to configure the sensor.

4. Go to the Sensors tab within the device properties.

5. From the list on the left, select Private use as the sensor type.

   

6. In the Settings section on the right, select Create new from the Sensor template dropdown list.

7. In the Name field, enter a descriptive name for the sensor template, for example, Private mode switch.

8. In the Formula field, enter the parameter your device uses to indicate private mode state. This formula must return a boolean (true/false) value. For example, If your device sends a trip.state.enum parameter, where 3 indicates private status, the formula could be $trip.state.enum == 3. Ensure you consult your specific device configuration and its manual to confirm the precise parameter and value.

9. (Optional) In the Validation section, click Add validation to define additional rules for the parameter. For example, select Parameter exists and enter the parameter name used in your formula.

10. Click Save.

This configuration ensures that the system correctly interprets the private use status reported by the device.