IBM Bluemix Setup

This is a small subsection of Smart Trash can guide to configure IBM bluemix account for simulation.  View Source

1. IBM IoT Service Setup

In order to make the communication work between the Trashcan simulator and mobile app, we will need to setup and configure the IBM IoT service as per our application needs. Follow along the steps given below to launch your IBM IoT service instance. If you do not yet have an IBM Id, this is the time to create one and get started.

Step 1: Locate the “IBM Internet of Things Platform” Service

Login to your IBM Bluemix account and locate the “IBM Internet of Things Platform” under catalog.

Shortcut in classic console

Shortcut in new Console

Step 2: Launch the Service

Click on the “IBM Internet of Things Platform” service icon to launch the service. Specify the service parameters for Space, App, Service Name and Selected Plan as shown below (on the right side panel), and click on “CREATE” button.

Note: The Space for the service refers to an IBM Bluemix space that you have to create separately from your Bluemix dashboard.

Once created, a welcome screen will be displayed for your newly launched service.

Step 3: Launch the service dashboard

Scroll down on the welcome page and you will be able to locate a button “Launch Dashboard” under the “Connect your devices” section.

Step 4: Access the device profiles page on the service dashboard

To use this service with IOT devices, we must create the device profiles first. As described in the “Overview” section, we have two devices, the virtual raspberry pi that interfaces with the IOTIFY trashcan simulator and the mobile app. So to facilitate communication between the two devices, we will create a device profile for each.

In the dashboard page, hover your mouse to left side menu to expand and bring it up.

Click on the “DEVICES” sub-menu to bring up the Device list page

And on the same page, click on “Device Types” tab to bring up the device types panel.

Step 5 : Create device profile for the IOTIFY trash can simulator

Click on the “Create Type” button on the top right corner of the page to add a new device profile. Follow the sequence of screenshots below to add a device type for the virtual hardware underneath IOTIFY trash can simulator.

Note: Make sure to select “Create device type” in the above step

Click on the “Next” button on the bottom right corner of the “Create Device Type” dialog to move through the steps. All the subsequent steps are optional and can be skipped. Finally, the device type will be created and listed under the “Device Types” tab panel.

Step 6: Create device profile for the mobile app

Now we can follow the same steps to create another device type in “IBM IoT Platform” for the mobile app.

At last, we will have the two device types listed as per our project requirement.

Step 7: Create device instances

We now have the device types defined in the service. The next thing is to define the actual device itself which acts as a virtual identifier (device id) for every device instance that is going to access the service. In our case, we have the virtual raspberry pi and the mobile app as our two device instances.

So lets go ahead and add them by clicking on the “Add Device” button under the “Browse” tab of “Devices” section in the dashboard.

Lets first add the trash can simulator device. We will select the device type as “iotify_trashcan”.

And, assign a unique name to the device, TRASHCAN_001 in this case.

Note: Just like in the case of adding device types, we can ignore the other steps in creating device and hit Next until we reach the end of “Add Device” dialog.

As part of the final step, we will be presented with the device credentials of this newly added device.

Similarly, let also create another device instance for the mobile app

We now have the devices also listed in the IBM IoT Platform service, and that concludes the device provisioning.

Make a note of the Organization ID displayed in the “Your Device Credentials” section of “Add Device” dialog.This will be required for programming the device SDKs

Step 8: Generate API Key and Auth Token

Now that all the devices are created , we need to generate the API key and auth token to access the IBM IOT service from our end point devices.

For this, go to the “ACCESS” sub-menu

Click on the “API Keys” tab.

Now, click on the “Generate API Key” button.

You will see the API key and Auth token being displayed on a dialog. Make a note of these parameters.

Click “Finish” on the lower right corner of the dalog to return back to the “API Keys” tab and you can now see your newly generated API credentials listed over there.

Make sure that you make a note of the API key & authentication token displayed on the screen for your device instance. This token will be used to program the application software later