Device Mapper

This guide explains what is the Device Mapper and how to use it.


The main function of the Device Mapper is assigning the signals sent by the device to variables on GpsGate Server that will be use on event rules, reports and more. It is found on the Vehicle Tracker application under the Admin menu.


How it works

1. Access the Device Mapper by logging into your Vehicle Tracker application and selecting Admin > Device Mappers.

2. Once opened, select your device model. If you don't see your device model listed, check that you've installed your device plugin. More info about this here.

3. On one side we have a device that might be sending some signals like ignition, fuel level percentage… and on the other side we have GpsGate Server receiving all those signals. On the device mapper you select what variable relates to each signal that your device is sending.

The Device Input column displays signals that your device might be sending and the Variable column shows a drop down list for each signal with all the variables available. As it can be seen on the screen shot above, the name of the signal and the name of the variable might be different but the ones that you will use on Event Rules and Reports on GpsGate Server are the variable names.


Not every signal displayed on the device mapper has to be mapped to a variable, only those ones that you are using on GpsGate Server. You can check what variables are being sent by your device and are already mapped on the Status window of the Vehicle Tracker application.

You also can display those values by adding them on the top right corner menu of the Track points panel window.

Different Device Mappers

You could use different device mapper configurations using device types


If you have two devices of the same brand and model, but you want to capture signals for a Truck (to capture CAN BUS signals for example like CAN_FuelLevel) and another mapping for a car (using another set of signals like Ignition or SOS).

If you want to know what device mapper you are using for an specific device then right click on it on the Vehicles list and select Overview. If you want to change it you can do it right clicking the device on the Vehicles list and selecting Edit 

Advanced usage

If you don´t find the variables you need on GpsGate Server you can add your custom variables.

The Multiplicator and Constant columns allow you to modify the value of the variable by multiplying and/or adding and specific quantity to the original value from signal. If you leave the default values on those colums the original signal will not be changed when assigned to the variable.

Using Device Mapper Scripting you can use to create more complex mappings and modify the output of a variable. 

Remember that you can always check the terminal data either on the Vehicle Tracker application right clicking on a device and selecting Terminal or login to SiteAdmin and navigating to System Tools tab.