Accessing the IBM IoT Connection Service Dashboard
â€˘ Using a web browser such as Chrome or Firefox, navigate to the URL for your IoTCS instance provided to you.
â€˘ Click the â€śLog in as <instance name>â€ť and proceed to login using your IBM credentials.
Once you have logged in, you should see a dashboard similar to the following.
The following services and their corresponding usage data might be displayed:
- IBM Watsonâ„˘ IoT Platform
- IBM IoT Registration Service
- Cloudant NoSQL DB
- IBM Db2Â® Warehouse on Cloud
- IBM Cloud Object Storage
- IBM Cloud App ID
- IBM Message Hub for IBM Cloud
- IBM Secure Gateway for IBM Cloud
- IBM IoT Blockchain Service
Note:Â Depending on your plan, not all services might be available.
In this recipe we will primarly learn how to register and connect a device and then create a device twin.
In part 2 of this recipe we will learn about other services as well.
Clicking on any of the service names allows you to view subscribed capacity and consumption
Security and Authentication
IBM IoT Connection Service provides secure end-to-end solution for your data and access.Â Each service component manages the security of its part of the solution.
- Â Device connection and security is managed by Watson IoT Platform
- Â Data security and integrity is managed by each of the storage solutions.
- Â User authentication is managed by each component, usually by using the IBMid as the common mechanism.
- Â Inter-service data flow takes place over secure communication with encrypted data per IBM’s Standard Security policies.
View details of a service
â€˘ Click the â€śView Detailsâ€ť of a service to see more information such as API keys and URL endpoints to access the service API.
â€˘ Some of the services also have a â€śLaunchâ€ť button to allow you to navigate to the web UI for that service.
IoT Platform Service
Navigating to IoTP
â€˘ Make note of the â€śOrg Idâ€ť found in the â€śView Detailsâ€ť dialog for the IoT Platform service.
â€˘ Click the â€śLaunchâ€ť button to open the IoTP in a separate tab.
â€˘ Click the â€śSign Inâ€ť button to log into the service.
â€˘ Lastly, choose the Org ID found in the details of service.
Register and Connect Device
On the left hand, in the menu icon Click on Devices icon.
Go to the Device Types tab and click on Add Device Type Button on top right.
On the click on “Add Device Type Button”. Enter the name of Device Type.
Provide the name of the Device Type. And Click on Next.
Then Add the Device Information. It is Optional. Click on Next.
Once all this is done you have registered the Device Type successfully.
Now add the Device, by clicking on the “Register Devices” button. Enter any Device ID.
Click on Next.
Add the Metadata. It is Optional. Click on Next.Â
Now enter your own Authentication Token. In case left blank then platform generates a Authentication Token on its own.
Click on Next.
Click on Done.
You will find all the details Device Type, Device ID and the Securit Token. Please note down all this information for the future reference and making connection to the device.
Conculsion of this step – Device Type and Device Id created successfully.
Next Step – Enable Simulation
This Simulation feature let you send the device event to the created device.
To enable simulation, on the left menu click on Settings. Scroll down to the page to Device Simulator. Activate the Device Simulator.
At the bottom left you will find a tab “0 simulations running”. Click on the New Simulation.
Click on new Event Type. Set the JSON message. You can use the sample message also or create your own JSON message as well. Click on Save.
Create Device Twin
A device twin includes a physical interface and one or more logical interfaces, each corresponding to an event type sent by a device.
- IoT Connection Service requires one logical interface per event type for each device type.
- The physical and a logical interfaces of the device twin are required to sendÂ your IoT data to the Db2 Warehouse on Cloud component according toÂ the IoTdate lifeÂ cycle flow.
Click on Device Types. Click on the particular deviceType on which you need to create Interface.
Click on Interface.Click on Create Interface.
Provide a name Â to the interface and click on next.
Adding Properties to Interface-
Click on Create EventType. As you have already enabled the simulation you can Click on “Use Last Event Cache” and select the Device Id from the drop down.
Now select the properties you need to map to the Logical Interface. Click on Add and then Click on Done.
Creating Physical and Logical Interface-
Once you will click on Done you will find the Physical and Logical Interface are created. Then Click on Activate button.
Then click on Done and then Deploy.
Once Deployed the Device Twin is created.
View Device Details in IoTP
While the simulation is running, you can navigate back to the IoTP tab and view live MQTT messages coming from the simulated device.
- Click on the â€śDeviceâ€ť tab to view the device.
- Click on the created device and then the â€śRecent Eventsâ€ť tab to view live sensor data.
Once you are in the IoTP service, you can begin to create device types and devices in order to start connecting physical devices and collecting sensor data.
In this recipe we learned about the Watson IoT platform register and connect device, enable simulation and how to create device twin.
In the part 2 of this recipe we will learn about other services on the IBM IoT Connection Services Instance.
The second part of this recipe is available at :Â https://developer.ibm.com/recipes/tutorials/ibm-iot-connection-service-watson-iot-platform-part-2/
Co-Author of this recipe
Surbhi Agarwal (email@example.com) is IoT Solution Architect and co-author of this recipe.