---
title: MindSphere Integration Guide
slug: litmusedge-v2/how-to-guides/integration-guides/mindsphere
description: Learn how to set up the MindSphere connector. 
docTags: 
createdAt: 2022-11-24T18:25:41.000Z
---

Review the following guide for setting up an integration between Litmus Edge and MindSphere.

# Step 1: Create a MindSphere Aspect

**To create a MindSphere aspect:**

1. Log in to MindSphere. 
2. From the dashboard, select **Asset Manager**.
   The *Asset Manager* pane appears. 
3. From the left pane, select **Aspects**.
   The *Aspects *pane appears. 
4. Click **Create aspect**. 
   The *Create aspect* dialog box appears. 

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/d-qVuqoy2RubNqKwBjr3o_mindsphere-create-aspect.png" size="80" width="871" height="701" caption="Create aspect dialog box" position="center" showCaption="true"}
5. In the **Name **field, enter **Litmus**. 
6. Scroll to the bottom and click **Add variable**.
   The *Variables *section drops down. 
7. Configure the following parameters. 
   - **Name**: Enter **temperature**. 
   - **Data type**: Select **LONG**. 
   - **Unit**: Enter **C**. 
8. Click **Add variable**. 
   A new row appears in the *Variables *section. 
9. Configure the following parameters. 
   - **Name**: Enter **pressure**. 
   - **Data type**: Select **INT**. 
   - **Unit**: Enter **bar**. 
10. Scroll down and click **Save**.
    The aspect appears in the *Aspects *pane.

    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/dI-N7O4YfsA9GqOh9wO4T_mindsphere-aspect.png" size="80" width="1699" height="678" caption="The Aspects pane" position="center" showCaption="true"}

# Step 2: Create a Type

**To create a type: **

1. From the left pane, click **Types**.
   The *BasicAsset *pane appears. 
2. From the Core types section, select **BasicAgent**.
   The *BasicAgent *pane appears. 
3. From the *Core types* section, select **MindConnectLib**.
   The *MindConnect Lib* pane appears. 
4. Click **Add derived type**.
   The *Create type* dialog box appears. 
5. In the *Name *field, enter **boiler**. 
6. From the *Aspects *section, click **Add aspect**.
   A new row appears in the *Aspects *list. 
7. From the *Aspects *list, select the aspect you created from the **Aspect **drop-down list.
8. Click **Save**. 
   The aspect appears in the *boiler *pane. 

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/jYCyEzzUU_CsEzyQIwt0W_mindsphere-type-boiler.png" size="80" width="1694" height="690" caption="The boiler pane" position="center" showCaption="true"}
9. Click **Back **twice. 
   The *BasicAsset *pane appears. 

# Step 3: Create an Asset

**To create an asset:**

1. From the left pane, click **Assets**.
   The r*oot asset* pane appears. 
2. Click **Create asset**. 
   The *Select type* pane appears. 
3. Select **boiler **from the list, and then click **Create**.
   The* Add asset *dialog box appears. 
4. In the name field, enter **plant12**, and then click **Save**. 
   The plant appears in the root asset list. 

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/M2OPOOpADZlqGsouSqB-h_mindsphere-root-asset.png" size="80" width="1664" height="708" caption="The root asset list" position="center" showCaption="true"}

# Step 4: Configure the MindConnect Lib plugin

**To configure the MindConnect Lib plugin:**

1. From the *Aspects *pane, click the **Mindconnect Lib **section.
   The *Configure MindConnect Lib* dialog box appears. 
2. Select **SHARED\_SECRET**, and then click **Save**.
   The *Edit boarding configuration* dialog box appears. 
3. Click **Generate onboarding key**.
   The key appears in the *Boarding configuration* field. 
4. Click **Copy to clipboard**.
   The key is copied to your clipboard. 

# Step 5: Add the MindSphere Connector

Follow the steps to [Add a Connector](docId\:oGW7FKQbWIdBaBn4WL5rr) and select the **MindSphere PSK **provider. 

Configure the following parameters. 

- **Name**: Enter a name for the connector. 
- **Agent boarding configuration**: Paste the key generated in Step 4. 
- **Aspect name**: Enter the aspect name created in Step 1.  
- **Throttling limit**: The maximum number of messages per second to be processed. The default value is zero, which means that there is no limit. 
- **Persistent storage**: When enabled, this will cause messages to undergo a store-and-forward procedure. Messages will be stored within Litmus Edge when cloud providers are online.  
- **Queue Mode**: Select the queue mode as **lifo **(last in first out) or **fifo **(first in first out). Selecting **lifo **means that the last data entry is processed first, and selecting **fifo **means the first data entry is processed first. 

# Step 6: Enable the Connector

After adding the connector, click the toggle in the connector tile to enable it. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/RsAyFme0gN2v66AjMLiDy_mindsphere.png" size="60" width="369" height="345" position="center" showCaption="false"}

If you see a *Failed *status, you can review the [Connector Logs](docId:3u7JzLDiNeHY8ShVIFD-D) and relevant error messages. 

# Step 7: Add Device

Follow the steps to [Connect a Device](docId:3eyAfPpweuVmBLCEy17sq). The device will be used to store tags that will be eventually used to create outbound topics in the connector. Make sure to select the **Enable Data Store** checkbox. 

# Step 8: Add Tags

After connecting the device in Litmus Edge, you can [Add Tags](docId:8sE7z3PmRfwL1nmzcwaLX) to the device. Create tags that you want to use to create outbound topics for the connector. 

# Step 9: Create Topics for Connector

You will now need to import the tags created in Step 7 as topics for the MindSphere connector. The topics will be created as outbound topics. 

**To create outbound topics:**

1. Click the connector tile.
   The connector *Dashboard *appears. 
2. Click the **Topics **tab. 
3. Click the **Import from DeviceHub** tags icon. 
   The *DeviceHub Import *dialog box appears.

![](https://api.archbee.com/api/optimize/xSuIWwMa6RnsbeD5Kdqd7-zaOGMDYbPZWYALvLBgotp-20250606-203859.png)

After adding all required topics, navigate to the Integration overview page and ensure the connector is not disabled and still shows a CONNECTED status.  

# Step 10: Enable Topics

To enable the topics, return to the Topics tab and click the **Enable all topics** icon. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Iq7BWYqGWueu4US73iBl3_image.png" size="80" width="1220" height="330" caption="Enable all topics icon" position="center" showCaption="true"}

# Step 11: Add Data Source

**To add the data source:**

1. Log in to MindSphere. 
2. Click the **Menu **icon, and select **Asset Manager**. 
   The *Asset Manager* pane appears. 
3. From the left pane, click **plant12**.
   The *Aspects *pane appears. 
4. Click **MindConnect Lib**.
   The MindConnect Lib Plugin for the *plant12 boiler *appears.
5. Click **Add data source**.
   The *Add data source* dialog box appears. 
6. In the *Name *field, enter **boiler**, and then click **Accept**.
   The boiler line item is added. 
7. Click **Add data point **next to the boiler line item.
   The *Add data point* dialog box appears.
8. Configure the following parameters. 
   - **Name**: Enter **temp**. 
   - **Type**: Select **LONG**.
   - **Unit**: Enter **C**. 
9. Click **Accept**. 
   The first data point is added to the boiler line item. 
10. Click **Add data point **next to the boiler line item.
11. Configure the following parameters. 
    - **Name**: Enter pres. 
    - **Type**: Select **INT**.
    - **Unit**: Enter **bar**. 
12. Click **Accept**. 
    The second data point is added to the boiler line item. 
13. Click **Save**, and then click **Save **again. 
14. Click the **Data mappings **tab.
15. Click the **Expand **arrow next to **boiler **to display the data points.
16. Click **Link variable **next to *temp*.
    The *Link variable* dialog box appears. 
17. Select **Link variable **next to temperature, and then click **Accept**.
    The data mapping for temperature appears under *temp*. 
18. Click **Link variable **next to *pres*.
    The *Link variable* dialog box appears.  
19. Select **Link variable **next to pressure, and then click **Accept**.
    The data mapping for pressure appears under *pres*. 
20. Click **Close**.
    The *Asset *pane appears. 

# Step 12: Verify the Connection

**To verify the connection: **

1. Return to the MindSphere *Edit boarding configuration* dialog box browser tab.
2. Note that *Onboarded *shows a green status. 

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/oQfQnb0P1VFkCtlc2Db6N_mindsphere-onboarded-green.png" size="80" width="632" height="62" caption="Onboarded Boarding status" position="center" showCaption="true"}
3. Click **Close**.
   The *plant12 assets* pane appears. 
4. Click the **Menu **icon, and select **Fleet Manager**.
   The* Fleet Manager *pane appears. 
5. From the left pane, click **plant12**.
   the *Aspects *pane appears to the right displaying the MindSphere aspect.
6. From the right pane, click the **Litmus Edge aspect**.
   The aspect chart appears displaying the variables. 
7. Click the **Zoom **icon multiple times until the temperature and pressure lines diverge.