MindSphere Integration Guide

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 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 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 step 2 create a type 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 click back twice the basicasset pane appears step 3 create an asset to create an asset from the left pane, click assets the r oot 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 step 4 configure the mindconnect lib plugin 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 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 if you see a failed status, you can review the manage connectors 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 click the connector tile the connector dashboard appears click the topics tab click the import from devicehub tags icon the devicehub import dialog box appears 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 step 11 add data source 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 step 12 verify the connection to verify the connection return to the mindsphere edit boarding configuration dialog box browser tab note that onboarded shows a green 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