Skip to end of metadata
Go to start of metadata

Scenario: 

  1. The "Thermometer" thing has a float property "Temperature"
  2. The "Thermometer" thing also has a "temperatureChanged" event which refers to a float value
  3. In this example, a Dashboard is created to show temperature data based on the "temperatureChanged" event
  4. The data can be displayed in various graphical or tabular formats by using widgets
  5. Three display formats for the "Temperature" Dashboard are created in this example:
    1. a gauge showing the most recent temperature value
    2. a graphical chart showing temperature changes over a selected time period
    3. a log table with temperature changes listed in tabular form (time of reading and value)

Prerequisites:

  1. A "Thermometer" thing with a float property "Temperature" was created in the Create, Read And Write Property example
  2. A "temperatureChanged" event with a float value was added to the "Thermometer" thing in the Create Event And Trigger example

Steps: 

This tutorial only covers three of the many possible dashboard widgets available on GadgetKeeper. A complete description of all widgets, along with their set-up procedures, can be found in Dashboard Widgets.

1. Create "Temperature" dashboard

  1. Open "Dashboards" in main menu to show list of dashboards
  2. In the dashboards list, click "+" to open "Create Dashboard" dialog
  3. Set the name to "Temperature"
  4. Click to save new dashboard

The "Temperature" dashboard is added to the list, and the "Dashboard: Temperature" tab will open

2. Create "Temperature gauge" widget

  1. In the "Dashboard: Temperature" tab, click "Add Widget" to open drop-down menu
  2. Click "Event Data Gauge" in this menu to open the "Settings" dialog
  3. Set "Title" to "Temperature gauge"

  4. Set "Thing" to "Thermometer"

  5. Set "Event" to "temperatureChanged"

  6. Set "Attribute" to "value"
  7. Set "Refresh rate" to "10"
  8. Click to save new widget for displaying temperature from "Thermometer" thing

The "Temperature gauge" widget will show the temperature based on the most recent "temperatureChanged" event:


3. Create "Temperature chart" widget

  1. Click "Add Widget" to open drop-down menu
  2. Click "Event Data Chart" in this menu to open the "Settings" dialog
  3. Set "Title" to "Temperature chart"
  4. Set "Chart Type" to "Spline"

  5. Set "Thing" to "Thermometer"

  6. Set "Event" to "temperatureChanged"

  7. Set "Attribute" to "value"
  8. Set "Refresh rate" to "10"
  9. Click to save new widget for showing temperature over the selected time range from "Thermometer" thing 

The "Temperature chart" widget will show a temperature chart based on "temperatureChanged" events occurring within the time range
In this example, "Time Range" is set to "6 hours", but this can be changed as needed

4. Create "Temperature log" widget

  1. Click "Add Widget" to open drop-down menu
  2. Click "Thing Event Log" in this menu to open the "Settings" dialog
  3. Set "Title" to "Temperature log"

  4. Set "Thing" to "Thermometer"

  5. Uncheck " the "All" checkbox to allow an individual event to be selected

  6. Set "Selected" to "temperatureChanged"
  7. Set "Refresh rate" to "10"
  8. Click to save new widget for showing the log of temperature events from "Thermometer" thing

The "Temperature log" widget will show a temperature log based on the most recent "temperatureChanged" events up to the "Entries" value
In this example, "Entries" is set to "100", but this can be changed as needed

 

  • No labels