Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Digital Matter Site
  • Contact Us

Set Odometer and Run Hour counts - 0x0012 and 0x0013

Set an initial Odometer or Run Hour reading on the device, via API call

Written by Iman Kareem

Updated at April 17th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Contact Support
  • Home
  • Device Manager (OEM Server)
  • Device Manager API
  • Device Control - Asynchronous Messages

Table of Contents

Before you start Description 0x0012 - Set Odometer Request Example 0x0013 - Set Run Hours

Before you start

Ensure you have reviewed:

  • Welcome to the Device Manager API
  • Device Manager ASYNC Messaging Architecture

A full list of API calls can be found at: https://api.oemserver.com/swagger/index.html.

 

Description

The following messages can be sent in order to set an initial Run Hours or Odometer reading on a device. For use with On Device Run Hours. 

0x0012 - Set Odometer Request Example

Payload:

Offset

Length

Data Type

Description

0

4

UINT32

The odometer value in metres/10

Example: 

{ 
"MessageType":18, // 0x0012 – Set Odometer,
"CANAddress":4294967295,   //0xFFFFFFFF,//HOST_ADDRESS
"Data":[232,03,00,00],   //See below
"ExpiryDateUTC":"2018-07-20T18:25:43.511Z"
}

The above example sets the odometer reading to 10km = 10 000m. The unit/LSB is 10m therefore,

10 000m/10m = 1000 = 0x3E8

Converting this to Little Endian = E8 03 00 00

Then we send the byte array in JSON format

E8 = 232
03 = 03
00 = 00
00 = 00 

Giving:
[232, 03, 00, 00]

0x0013 - Set Run Hours

Payload:

Offset

Length

Data Type

Description

0

4

UINT32

The run hours value in seconds

hour tracking odometer setting

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • On Device Odometer and Run Hours
  • Geofence Downloads to Device
  • Movement Trips - Assumed Start Point Range
  • Set device GPS Position - 0x0107

Subscribe to Partner News

Subscribe to our mailing list to receive Digital Matter news, product and tehnical updates, and more.

Subscribe

Copyright © Digital Matter . All Rights Reserved.

Privacy Contact Support

Knowledge Base Software powered by Helpjuice

Expand