Device Mapper Types

In GpsGate Server you have the possibility to create multiple instances of your Device Mappers for the same device model and brand.


Having different instances of a Device Mapper could be useful in the following cases:

  • When you have the same device brand and model in different vehicles and you need to capture different signals from each vehicle.
  • When you want to use different Device Odometer types in different vehicles.
  • When you want to use different Trip Definitions in different vehicles.
  • When you want to use device mapper scripting and you don’t want this script to interfere with the default Device Mapper of a certain device.

Site Admin configuration

New Device Type creation

  1. To create a new instance of a Device Mapper you need to login in Site Admin and go to Devices > Types 
  2. Select a Device Type and then an Instance of this device. Click in “New”. 
    You’ll immediately be able to see the newly created copy of the instance if you drop down the list (if you only had one instance, the new one is the second on the drop-down list. To avoid confusion about which is the original we recommend to do not select any of the items. In the drop-down menu, the newly copied instance is already selected after clicking in New). Follow instead to the next step. 
  3. Now choose a new name for the new copy of the instance. Type a name and click in save before performing any further action: 

Instance Options

    For all the options and buttons you have an explanation just under them. Nonetheless we consider to mention more in detail the following:
  • Track Filter Settings: default/City Drive. The filter establishes how the tracking points are going to be processed to be displayed on screen. To learn more about Track Filters here.
  • Upgradable: you normally want to turn this option. When there is a device plugin update in the server, this instance will be updated too if there is a new feature.
  • Supported Commands: it will display the commands available for this device type and if you want to include them in this instance to be triggered within the Vehicle Tracker application. To know more about template commands here.
  • Device Mapper Template: lets you set the signal mapping defaults for this device type.

How to copy/retrieve a Device Mapper template to/from an application

If you select the option Device Mapper Template you will access to the following screen:



In that screen, at the bottom, you have two options to select:

  • Copy To Application: this will allow to copy the current mapping that is being displayed in this screen, to a selected application of your choice. This will overwrite the device mapping in the application. 

    Notice that you will be eligible to select only the applications that are currently using this instance of the device mapper. After clicking in Copy you will receive the confirmation that the device mapper has been overwritten in the application.
  • Copy From Application: this will take a current device mapper configuration from a selected application to get copied to this template. You will be eligible to select the application source where you want to copy the device mapper from to use it to replace the current saved template in this screen.
    After clicking in Copy you should see the confirmation message:

In the Vehicle Tracker application

If you go to Devices > Device Mapper you should be able to see the new instance of the device mapper.