Device Mapper

The main function of the Device Mapper is assigning tracker inputs to variables. These variables are used on screen, event rules, reports, and more.

Using the device mapper

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

Note: to be able to use the device mapper, you need the privilege in your application _EditDeviceMapper.

Read more about how to access the Privileges and Features guide.

2. Select your device model.

  • Note: If you haven’t yet added an asset to the platform for which you're trying to edit the device mapper, the device model might not appear in the list.
  • This does not mean the device is unsupported—It just needs to be enabled on the platform first. The device mapper will then be activated automatically once the corresponding devices are added.
  • If you need to add the device mapper, go to the Asset panel and click on +Asset. From there, select the appropriate tracker model, then click on the "Enable Tracker Model" button, as shown in the screenshot below.Screenshot 2025-10-07 at 16.33.14.png

You'll see Setup and Mappings options on the left-hand side of the window.
From Mappings, you will find Device input, and to the right, Variables.

Screenshot 2024-03-20 at 10.26.04.png

  • Input: the device sends individual signals through each input.
  • Variable: a field where to store the input data to be used in GpsGate. You can select any variable or even create your own variable name.

Another option is available where variables can be assigned the outcome of a user-defined script. This enables the creation of more intricate mappings between variables. Find out more about Device Mapper Scripting

Additional notes

Once the device mapper has been assigned, the mapping is permanent. Reprocessing tracks won't change the values stored in the variables.