Device Mapping - Developer Documentation
Skip to content

Device Mapping

The device mapping enables you to map devices, which are connected via MindConnect IoT Extension to your assets. It also enables you to visualize data and monitor the connected devices in Industrial IoT.

In order to correlate the device simulator (pump) and its measurements to assets and aspects, you need to learn defining a device mapping. This can be done manually by "Device Mapping" provided in the Device Management application.


Device mapping can be done automatically using the "Auto On-boarding" feature. The manual device mapping procedure is explained in this section.

Go to the Device Management and navigate to "Device Mapping" from the tool navigation window. The graphic below shows the Device Mapping window:

Device mapping

① Devices: shows a tree component with all available device groups and devices (Simulators).

② Assets: lists all available assets and childassets of the related Insights Hub environment.

③ Mappings: shows all current device mappings.


To create a mapping, proceed as follows:

  1. Select a device on the left side of the navigation panel. In the example scenario, consider the PumpSimulator.
    You can see all the mappings of a selected device below in the Device Mapping table.


If the mapping table doesn't show your device, you can use the search function or assign it to a group, as the view currently is based on group views.

2.Select an asset on the right side of the navigation panel. In this example, consider the PumpIoTAsset.

3.Click "Add Mapping". In order to add a new mapping, you need to choose a device and an asset from the lowest level.
In case of multiple devices and assets, the search text fields for each section can help finding devices or assets in the navigation panel.
You can clear the selection in the navigation panel by clicking "Clear Selection".

Clear selection

4.After clicking "Add Mapping", a dialog appears. This allows you to select the mapping information of the selected device and asset. There are several options to add a mapping:

  • Select from existing mapping template
  • Measurement mapping
  • Event-data mapping
  • Metadata mapping
  • Event mapping
  • Alarm mapping

5.Select the preferred mapping option and fill the "Source" and "Target" information in the "Add Mapping" dialog.

Add mapping


Units are checked in measurement mappings and it can be converted as well.

At this state, the mapping has not committed to any changes yet. You can update a mapping with the following options:

  • Edit: You can edit a selected mapping by clicking on the pencil icon.
  • Delete: You can delete a mapping by clicking on the recycle bin icon.
  • Publish: A mapping needs to be committed for publishing.
    To publish a mapping:
    • Click “Commit Changes”. A new dialog opens.
    • Click "Apply" to apply the changes on the mapping. This action activates all mappings immediately.


You have successfully created a device mapping between the simulated pump and the asset you created in Insights Hub.

You are now able to perform the following tasks:

  • Monitor the pump in Insights Hub Monitor
  • Visualize the pump's data
  • Define rules for alarms.

For further information on MindConnect IoT Extension functionalities, for example Firmware Management, please refer to the document MindConnect IoT Extension User Guide. The Industrial IoT documentation area also provides you with further particulars on all Industrial IoT components and applications.

Last update: June 15, 2023