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
      • 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
      • GPS 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

      DM Logo
      Expand