Skill Level: Beginner

Fetching data from a device or a set of devices and visualizing them using Bar chart, Donut chart, Line graph has been shown. The Device List Card enhances the experience to re-use the graph or chart for multiple listed devices without any further edits.


  1. Introduction

    The BOARDS and CARDS, as available on the Watson IoT Platform Dashboard, enhances the User’s Visualization experience, in terms of visualizing the Device status & data, Usage & Consumption patterns, Analytics based on Rules & Device specific metrics, etc.

    This recipe is in continuation to the Watson IoT Platform recipe Configuring Boards & Cards in the new Watson IoT Dashboard, which detailed out on step by step instructions to create, configure and use the Boards & Cards in Watson IoT Platform Dashboard.

    Continuing on the same line, this current recipe dwells into the usage of the CARD Device List, that further helps to monitor the data from multiple devices, each device at a time, in a chosen set of visualization option, say for example, the BAR chart, the Donut chart, or a Line graph or a Gauge map, etc.

    Use Case:

    Assume that you are monitoring Temperature, Humidity & Object Temperature data from three different devices. Now, to monitor the Temperature data on a Gauge Map, on a generic note, you would need to create three different Cards, one each for each Device. Similarly, additional Cards needs to be created, one each for Humidity and Object Temperature, for each individual Devices being monitored.

    With Device List Card, you shall be creating the Gauge Map only once, i.e just one Card to monitor the Temperature readings. Now, as you click on the Device entry in the Device List Card, the readings on the Gauge Map reflect the corresponding readings for the chosen Device.

    Makes it easy for monitoring? Sounds interesting? Continue to read on, to get a feel of the Device List Card features.


  2. Connect your devices to Watson IoT Platform

    In this section, you shall be made aware of the pre-requisites, the flow as to how the recipe shall be carried out and what to expect out of this recipe.

    As you work through this recipe, it is necessary that, you need to have atleast two or more Devices registered on the Watson IoT Platform (Refer this recipe to register Devices to Watson IoT Platform)

    In the scope of this recipe, let us consider that the following three Devices, Device01, Device02 & Device03 have been registered on the Watson IoT Platform. 


    You can plan to use the IoT Simulator Sensor to simulate and fetch sensor data for the following set of readings:

    • Temperature
    • Humidity &
    • Object Temperature

    Refer to this IoT Recipe to further understand on how to configure the IoT Simulator and fetch the sensor data for the sensors mentioned above.

    Going ahead, Of the several options available, let us demonstrate the usage of Device List Card by creating:

    • Line Graph using Temperature sensor data
    • BAR Graph using Humidity sensor data
    • Gauge Map to depict Object Temperature readings

    In this section, you were briefed on the requisites that are needed to be in place, before you begin to work on creating Device List Card and have now defined the scope of this recipe.


  3. Create a Device List Card

    In this section, you shall be introduced to the Device List CARD and the scenarios that shall be constructed around it.

    All Boards is the default landing page, as you log into the Watson IoT Platform Dashboard. Of the three default BOARDS that are made available, i.e DEVICE-CENTRIC ANALYTICS, USAGE OVERVIEW and RULE-CENTRIC ANALYTICS, the Board DEVICE-CENTRIC ANALYTICS holds the Device List Card, bearing the name similar to Devices I Care About.

    If you have created a custom Board and now want to have the Device List Card as part of the new board, then, you can do so, by following the steps mentioned below:

    1. Choose the BOARD of choice, where you would like to create the Device List CARD
    2. Click on +Add New Card option available on the top-right corner
    3. Under the Devices section, click on Show More to stretch the section and view additional listed options


    4. Now, you get to see the Device List CARD being listed under the Devices section. Click on the Device List Card, to select it


    5. You are now presented with the Card Preview option, where in, you can choose the size of the Card. By default, it is set to Small. Choose appropriate size of choice and click on Next.


    6. In the Card Information option, fill in the Title (Card header) and Description, as needed and choose a color theme that outlines the Card. Click on Submit to finish creating a Device List Card.


    7. You now have the Device List card as part of your custom BOARD, listing the Devices that are registered to the Watson IoT Platform, as shown below:


    In this section, you were introduced to the set of steps to use the existing Device List Card and create a new Device List Card, in your custom BOARD, of choice.


  4. Configure the defined visualization options with Device List Card

    In this section, you shall be experiencing the steps to configure various visualization options that leverage the Device List Card.

    Let us first work through setting up a Line Graph, that depicts the Temperature data in real time, as emitted by the devices, Device01, Device02 and Device03, where, all three of them are now part of the Device List Card.

    1. Within the same BOARD where you have the Device List Card, click on the +Add New Card, to add a new Card
    2. Under the Devices section, click on Show More and within the additional options made available, click on the Device List, to create a new Device List Card
    3. You are now prompted to add a data source. Click on Add Data Source to add one


    4. Choose the Device List Card you had created in the previous section, as your data source, by clicking on the radio button listed against the entry, Devices I Care About Device List Card. Click on Next to continue.


    5. In the Card Preview option, you are now presented with visualization options, to choose from. If no visualization option is chosen, then plain Device List Card shall be created for you. As we are working through Line Graph to depict the Temperature readings, click on the first icon, the Line Graph ( Similarly, to generate a BAR Graph, choose the second icon and to create a Gauge Map, click on the fifth icon), as shown in the following Image.

      Optionally, choose the appropriate size for the Graph / Chart, that appeals to the visualization. Additionally, configure the Settings to setup the Window size, Data Retention period and couple more options.

    6. When you choose a Graph / Chart of choice, an entry for the chosen data source gets listed under the Card Source Data on the left hand menu. Click on the data source entry, to fill up the values against the parameters Event, Property & Name. Optionally, you can edit the Type & Unit.


      Click on Next to Continue

    7. In the Card Information option, fill in the Title (Card header) and Description, as needed and choose a color theme that outlines the Card. Click on Submit to finish creating a Device List Card.
    8. You should now have the Line Graph, that lists the Temperature readings for all three devices, randomly.


    9. Now, to filter out the readings and to single out the data for a particular device of choice, click on the device entry, as listed under the Devlice List Card Devices I Care About. For example, if you click on Device01 entry, then, only the Temperature readings for Device01 is listed. The behaviour is similar for other two devices as well.


    10. Repeat the steps from Step 5 through to Step 9, to create and visualize
       РBAR Graph using Humidity sensor data
       РGauge Map to depict Object Temperature readings

      Once completed, you should get to see the Graph / Chart, similar to the one, shown below


    11. The above mentioned visualization options were captured, as you clicked through Device01 on the Device List Card. Similarly, as you click through Device02 and Device03, you would ideally get to see the visualization options, respectively, as shown below:



  5. Conclusion

    Creating visualization charts, graphs and maps helps monitoring the device status and device data, in a user friendly manner. But, if the said set of visualization options are limited to only a particular device or particular parameter of the device, then, redundancy comes into the picture, as we need to repeat or re-do the efforts for all other devices and their parameters.

    BOARDS and CARDS contribute significantly in terms of providing visualization options. Device List Card enhances the experience, as it helps in building the graph / chart template once, for all the devices listed as registered device and then visualize all of them randomly or monitor each of them individually. This helps to track the device data in real time as well, act as comparison metric, as we work through various registered devices, using the same template, as set against the defined graph / chart / map.

    The Watson IoT Recipe Configuring Boards & Cards in the new Watson IoT Dashboard helps you to acclimatize and familiarize yourself with creating and configuring BOARDS & CARDS, while this recipe Device List Card SIMPLIFIES Real Rime Device Monitoring, helps you leverage the feature(s) of Device List CARD.

Join The Discussion