Skip to main content

Vehicle Metrics

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

Overview​

NOTE

The Vehicle Metrics plugin is a paid feature of the OsmAnd app.

The Vehicle Metrics plugin allows users to read, record, and display real-time vehicle data on their screen using the OBD-II protocol. It offers insights into key engine metrics, fuel efficiency, speed, and other essential performance indicators, enabling users to monitor their vehicle’s health directly from their device.

Required Setup Parameters​

⚠️ Android only
This feature is currently not available for the iOS version of the OsmAnd app.

To begin using data from your OBD-II scanner, follow these steps:

  1. Enable the Vehicle Metrics plugin in the Plugins section of the main menu.
  2. Connect the OBD-II scanner to your vehicle's OBD-II port.
  3. (Optional) Add Vehicle Metrics widgets to your screen for quick access to data.
  4. To record Vehicle Metrics data as part of a track, use the Trip recording plugin.

Pair ODB-II scanner​

Ensure the OBD-II scanner is connected to your vehicle.

Navigate to the Vehicle Metrics menu or Vehicle Plugin settings to add the OBD-II device:

  • Menu → Plugins → Vehicle Metrics → Settings → Connect or +
  • Menu → Vehicle Metrics → Settings → Connect or + (if you've added this section to the General menu)

Select the OBD-II device from the list and connect to it.

OBD connectionOBD connection

Settings​

Menu → Plugins → Vehicle Metrics → OBD → Three dots

  • Connect/Disconnect – Connects or disconnects the OBD-II sensor.
  • Settings – Opens the OBD-II settings screen, where you can connect or disconnect from the OBD-II sensor and view all available vehicle parameters.
  • Rename – Allows you to rename the sensor.
  • Forget – Removes the previously added OBD-II sensor from the list.
OBD settingsOBD settings

Metrics list​

List of vehicle metrics:

  • Temperature:

    • Intake Temperature - Displays the temperature of the air entering the engine intake manifold.
    • Ambient Temperature - Displays the temperature outside the vehicle.
    • Coolant Temperature - Displays the temperature of the engine’s coolant.
    • Engine Oil Temperature - Displays the temperature of the engine oil.

  • Engine:

    • Engine Speed - Displays the vehicle's tachometer RPM via the OBD sensor.
    • Engine Runtime - Shows how long the engine has been running since it was started.
    • Calculated Engine Load - Displays the percentage of the engine’s available power being used at a given moment.

  • Fuel:

    • Fuel Pressure - Shows the pressure within the fuel system.
    • Fuel Consumption - Displays the vehicle's fuel consumption rate based on calculations.
    • Remaining Fuel - Shows the vehicle's fuel level via the OBD sensor.

  • Other:

    • Battery Level - Shows the voltage level of the vehicle's battery.
    • Vehicle Speed - Displays speed from the Vehicle Speed Sensor (VSS).
    • Throttle Position - Displays the angle of the throttle plate in the throttle body.
    • VIN - A 17-character identifier (digits and capital letters) unique to the vehicle.

Trip Recording​

Menu → Plugins → Trip recording → Settings → Data → Record vehicle metrics

Next, you need to select parameters to be recorded in the GPX file. Data from a connected OBD-II sensor can be added to the GPX file using the Trip recording plugin.

note

OsmAnd uses custom tag names for vehicle metrics in track recording, such as vm_eotemp (Engine Oil Temperature), vm_fpress (Fuel Pressure), and vm_espeed (Engine Speed).

OBD recording OBD recording

Widgets​

Menu → Configure screen → Widgets → Left/Right/Top/Bottom panels → Vehicle Metrics

List of availabe widgets is here (except "VIN").

Vehicle Metrics widgets is automatically added to the widget list when you enable the Vehicle Metrics plugin. Before starting your trip, ensure these widgets are visible on your screen. If they are not, add them through the Configure Screen menu. Vehicle Metrics widgets provide real-time tracking of data from your connected OBD-II sensor, allowing you to monitor essential metrics seamlessly during your journey.

OBD settings OBD settings

Widgets Settings​

Menu → Configure screen → Widgets → Left/Right/Top/Bottom panels → Vehicle Metrics → ⚙️ or Settings

Some Vehicle Metrics widgets offer a display mode option: "Instant" or "Average":

  • Instant - Displays current, real-time parameters.
  • Average - Displays averaged data over a selected interval (from 15 seconds to 60 minutes).

This article was last updated in October 2024