Jump to content

OBD Manual OEM Request Validation Instruction: Difference between revisions

From Teltonika Telematics Wiki
No edit summary
No edit summary
Line 3: Line 3:
== Manual OEM Request Validation Guide ==
== Manual OEM Request Validation Guide ==


This guide outlines the procedure for manual OEM request validation using the <code>obdoemdatasource:</code> command. This process is used to manage and verify data sources when the device retrieves multiple or incorrect diagnostic values.
This guide outlines the procedure for manual OEM request validation using the <code>obdoemdatasource:</code> command. This process is used to manage and verify data sources when the device retrieves multiple or incorrect diagnostic values from the vehicles.


== When to Use ==
== When to Use ==
* '''Incorrect Values:''' When an OEM parameter value is wrong due to incorrect validation.
* '''Incorrect Values:''' When the received values do not match the actual values displayed on the vehicle's dashboard
* '''No Value:''' When no OEM parameter value is received by the device.
* '''No Value:''' When no OEM parameter value is received by the device.
* '''Erratic Data:''' When a source (e.g., OEM Ignition) provides sporadic data that does not correspond to the actual vehicle state.


----
----
Line 15: Line 14:
The command can be executed through various communication channels:
The command can be executed through various communication channels:


=== Parameter Reference ===
==== Available Operations (<operation>) ====
{| class="wikitable"
{| class="wikitable"
! Method
! Method
Line 45: Line 47:
| Sets the selected source and deletes all other sources for that identifier.
| Sets the selected source and deletes all other sources for that identifier.
|-
|-
| <code>delete</code>
 
| Deletes a specific source for a particular identifier.
|}
|}


Line 82: Line 83:
----
----


== Step-by-Step Validation Examples ==
== Step-by-Step Validation Example ==


=== Example 1: Locking Total Mileage to a Correct Source ===
=== Example 1: Locking Total Mileage to a Correct Source ===
'''Scenario:''' The received values do not match the actual values shown on the vehicle's dashboard.
'''Example:''' The device is currently reporting an OEM mileage of 86,666 km, while the actual dashboard reads 56,566 km.
# '''Identify Available Sources:''' Use the <code>get</code> command for Mileage.
# '''Identify Available Sources:''' Use the <code>get</code> command for Mileage.
#* '''Command:''' <code>obdoemdatasource:get:1</code>
#* '''Command:''' <code>obdoemdatasource:get:1</code>
Line 91: Line 95:
# '''Set the Source:''' <code>@smsrun:obdoemdatasource:set:1:3</code>
# '''Set the Source:''' <code>@smsrun:obdoemdatasource:set:1:3</code>
# '''Confirm:''' "Manual OEM source setting performed successfully" will be displayed.
# '''Confirm:''' "Manual OEM source setting performed successfully" will be displayed.
=== Example 2: Deleting a Faulty Source (e.g., Ignition) ===
# '''Retrieve Sources:''' Use the <code>get</code> command for Ignition.
#* '''Command:''' <code>@smsrun:obdoemdatasource:get:18</code>
#* '''Response:''' <code>Sources: 1. val:1</code>
# '''Delete the Source:''' <code>@smsrun:obdoemdatasource:delete:18:1</code>
# '''Confirm:''' "OEM source deletion performed successfully" will be displayed.

Revision as of 14:14, 4 June 2026

Manual OEM Request Validation Guide

This guide outlines the procedure for manual OEM request validation using the obdoemdatasource: command. This process is used to manage and verify data sources when the device retrieves multiple or incorrect diagnostic values from the vehicles.

When to Use

  • Incorrect Values: When the received values do not match the actual values displayed on the vehicle's dashboard
  • No Value: When no OEM parameter value is received by the device.

Command Syntax

The command can be executed through various communication channels:

Parameter Reference

Available Operations (<operation>)


Parameter Reference

Available Operations (<operation>)

Method Syntax
SMS (With Login) <login><space><password><space>obdoemdatasource:<operation>:<arg1>:[<arg2>]
SMS (No Login) <space><space>obdoemdatasource:<operation>:<arg1>:[<arg2>]
GPRS obdoemdatasource:<operation>:<arg1>:[<arg2>]
Operation Description
get Retrieves OEM sources for a specific data identifier.
set Sets the selected source and deletes all other sources for that identifier.

Data Identifier Mapping (<arg1>)

<arg1> OEM Data Identifier (DID) <arg1> OEM Data Identifier (DID)
1 OEM Total Mileage 10 OEM HVBattery Max Energy
2 OEM Fuel level1 (l) 11 OEM HVBattery Available Energy
3 OEM Distance Till Next Service 12 OEM HVBattery Lifetime Charge
4 OEM Remaining Distance 13 OEM HVBattery Lifetime Energy
5 OEM Fuel level2 (l) 14 OEM Ambient Temperature
6 OEM HVBattery Charge Level 15 OEM Remaining Oil Life
7 OEM HVBattery Charge State 16 OEM HVBattery Voltage
8 OEM HVBattery Health 17 OEM HVBattery Current
9 OEM HVBattery Temperature 18 OEM Ignition
Note: <arg2> is the numerical value representing the source for a particular identifier. You must use the get command first to find the available sources.

Step-by-Step Validation Example

Example 1: Locking Total Mileage to a Correct Source

Scenario: The received values do not match the actual values shown on the vehicle's dashboard.

Example: The device is currently reporting an OEM mileage of 86,666 km, while the actual dashboard reads 56,566 km.

  1. Identify Available Sources: Use the get command for Mileage.
    • Command: obdoemdatasource:get:1
    • Response: Sources: 1. val:0 2. val:0 3. val:65799 4. val:1684300
  2. Compare with Vehicle Dashboard: If the dashboard shows 65,799, the 3rd source is correct.
  3. Set the Source: @smsrun:obdoemdatasource:set:1:3
  4. Confirm: "Manual OEM source setting performed successfully" will be displayed.