MindSphere Integration Guide
Review the following guide for setting up an integration between Litmus Edge and MindSphere.
To create a MindSphere aspect:
- Log in to MindSphere.
- From the dashboard, select Asset Manager. The Asset Manager pane appears.
- From the left pane, select Aspects. The Aspects pane appears.
Click Create aspect. The Create aspect dialog box appears.
Create aspect dialog box- In the Name field, enter Litmus.
- Scroll to the bottom and click Add variable. The Variables section drops down.
- Configure the following parameters.
- Name: Enter temperature.
- Data type: Select LONG.
- Unit: Enter C.
- Click Add variable. A new row appears in the Variables section.
- Configure the following parameters.
- Name: Enter pressure.
- Data type: Select INT.
- Unit: Enter bar.
Scroll down and click Save. The aspect appears in the Aspects pane.
The Aspects pane
To create a type:
- From the left pane, click Types. The BasicAsset pane appears.
- From the Core types section, select BasicAgent. The BasicAgent pane appears.
- From the Core types section, select MindConnectLib. The MindConnect Lib pane appears.
- Click Add derived type. The Create type dialog box appears.
- In the Name field, enter boiler.
- From the Aspects section, click Add aspect. A new row appears in the Aspects list.
- From the Aspects list, select the aspect you created from the Aspect drop-down list.
Click Save. The aspect appears in the boiler pane.
The boiler pane- Click Back twice. The BasicAsset pane appears.
To create an asset:
- From the left pane, click Assets. The root asset pane appears.
- Click Create asset. The Select type pane appears.
- Select boiler from the list, and then click Create. The Add asset dialog box appears.
In the name field, enter plant12, and then click Save. The plant appears in the root asset list.
The root asset list
To configure the MindConnect Lib plugin:
- From the Aspects pane, click the Mindconnect Lib section. The Configure MindConnect Lib dialog box appears.
- Select SHARED_SECRET, and then click Save. The Edit boarding configuration dialog box appears.
- Click Generate onboarding key. The key appears in the Boarding configuration field.
- Click Copy to clipboard. The key is copied to your clipboard.
Follow the steps to Add a Connector 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.
After adding the connector, click the toggle in the connector tile to enable it.
If you see a Failed status, you can review the Connector Logs and relevant error messages.
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.
After adding all required topics, navigate to the Integration overview page and ensure the connector is not disabled and still shows a CONNECTED status.
To enable the topics, return to the Topics tab and click the Enable all topics icon.
To add the data source:
- Log in to MindSphere.
- Click the Menu icon, and select Asset Manager. The Asset Manager pane appears.
- From the left pane, click plant12. The Aspects pane appears.
- Click MindConnect Lib. The MindConnect Lib Plugin for the plant12 boiler appears.
- Click Add data source. The Add data source dialog box appears.
- In the Name field, enter boiler, and then click Accept. The boiler line item is added.
- Click Add data point next to the boiler line item. The Add data point dialog box appears.
- Configure the following parameters.
- Name: Enter temp.
- Type: Select LONG.
- Unit: Enter C.
- Click Accept. The first data point is added to the boiler line item.
- Click Add data point next to the boiler line item.
- Configure the following parameters.
- Name: Enter pres.
- Type: Select INT.
- Unit: Enter bar.
- Click Accept. The second data point is added to the boiler line item.
- Click Save, and then click Save again.
- Click the Data mappings tab.
- Click the Expand arrow next to boiler to display the data points.
- Click Link variable next to temp. The Link variable dialog box appears.
- Select Link variable next to temperature, and then click Accept. The data mapping for temperature appears under temp.
- Click Link variable next to pres. The Link variable dialog box appears.
- Select Link variable next to pressure, and then click Accept. The data mapping for pressure appears under pres.
- Click Close. The Asset pane appears.
To verify the connection:
- Return to the MindSphere Edit boarding configuration dialog box browser tab.
Note that Onboarded shows a green status.
Onboarded Boarding status- Click Close. The plant12 assets pane appears.
- Click the Menu icon, and select Fleet Manager. The Fleet Manager pane appears.
- From the left pane, click plant12. the Aspects pane appears to the right displaying the MindSphere aspect.
- From the right pane, click the Litmus Edge aspect. The aspect chart appears displaying the variables.
- Click the Zoom icon multiple times until the temperature and pressure lines diverge.