Managing device properties

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

After a device is created, you can manage its settings and data streams through its properties. To access them, go to the Devices page and click on the required device from the list.

The device properties are organized into several tabs described below.

The General tab provides the primary configuration for a device, including basic identification and operational settings. Enter the general vehicle properties when you create a device. After you save the device, you can add more properties in the general section and add detailed identifiers and physical characteristics under the following separate sections:

• Vehicle identification and control
• Energy and emissions
• Vehicle physical characteristics

The following fields are available for an existing device under the general section:

• Document number: The vehicle registration certificate (technical passport) number.
• Vehicle plate: The primary license plate of the vehicle.
• VIN: Vehicle Identification Number (17 characters, uppercase letters (excluding I, O, Q) at the start, followed by digits).
• Plate number: Secondary license plate field.

To show extended vehicle fields, enable the Vehicle identification and control toggle and provide the following information:

• Make: The vehicle manufacturer. For example, Mercedez-Benz.
• Model: The vehicle model. For example, Citaro G (O530).
• Manufacture year: The year the vehicle was produced. For example, 2022.
• Operational control status: Ownership or lease arrangement used for emissions reporting. Click to select from the list: Owned, Finance lease or Operating lease (Controlled).

This section is available only if the Emissions module is enabled for the customer.

To show the fields in this section, enable the Energy and emissions toggle and provide the following information:

• Fuel type (required): The fuel or energy source for the vehicle. Available options are: Gasoline, Diesel, Biodiesel, Hybrid, Electric, Petrol, LNG, or LPG. This field is required to calculate emissions.
• Normative fuel consumption (required): The fuel or energy consumption rate for the device. Enter the numeric value; the unit of measurement is selected in the Consumption unit field below. Use the value from your operational experience or the vehicle manufacturer’s technical specifications. This value is used to estimate emissions when the fuel volume sensor isn’t configured or doesn’t provide sufficient data.
• Consumption unit (required): The unit used to track the consumption rate across distance or operating hours. Available options are: l/100km (liters per 100 kilometers) or l/1eh (liters per 1 engine hour).
• Emission standard (optional): The regulatory emission class for environmental compliance. The following emission standard options are available:
  • Europe (EU): Euro 1, Euro 2, Euro 3, Euro 4, Euro 5a, Euro 5b, Euro 6b, Euro 6c, Euro 6d-Temp, Euro 6d, Euro 6e, Euro 7.
  • USA Federal (EPA Tier): Tier 0, Tier 1, Tier 2, Tier 3, Tier 4.
  • USA California (CARB LEV/ZEV): LEV I, LEV II, LEV III, LEV IV, ZEV.

The platform uses two data sources to calculate emissions: actual fuel consumption from the fuel volume sensor and estimated consumption based on mileage or engine hours. If the fuel volume sensor data is available, the platform uses it. Otherwise, it falls back to the normative fuel consumption specified here. For details on how emissions are calculated, see Emissions.

To show the vehicle dimensions and weight, enable the Vehicle physical characteristics toggle and provide the following information:

• Gross weight: Total weight of the vehicle in kilograms (kg).
• Length: Vehicle length in millimeters (mm).
• Width: Vehicle width in millimeters (mm).
• Height: Vehicle height in millimeters (mm).

The Sensors tab allows you to configure how the platform interprets raw data from the device. This is where you map raw data channels to meaningful parameters. See how to configure sensors on the Configuring sensors page.

Here you can assign labels to categorize the device (for example, Truck, Van, or Car).

Link the device to specific driver behavior criteria presets to monitor driving quality.

The Packets tab is a service tab for technical diagnostics. This tab can be used by developers and support staff to troubleshoot connectivity issues and verify the raw data stream. It displays the raw data packets as they are received by the platform from the device.

The data is shown with timestamps (for example, 2025-10-28 18:41:51.106 +02) and indicates whether the packet was set or received, along with the size and the raw hexadecimal content of the packet.

The Messages tab is used for technical diagnostics, allowing you to view the parsed messages received from the device. The messages are listed in a table format with fields like Time, Server time, Speed, Address, Satellites, and Other data. To use the tab:

1. Click the message row.
2. See the parsed parameters on the Message details pane on the right.
3. Verify the device data.

On this tab, you can view and manage the commands available for the device. The list of available commands varies depending on the protocol the device is using. To learn more about the device commands, see the Commands section for your protocol in flespi documentation.

Here you can track all changes made to the device’s properties. The tab provides a complete history of who did what and when.