Configure a widget on the dashboard
To configure the widgets on your dashboard, hover over the widget header, and click the settings icon that appears in the upper-right corner of your device's input output (I/O) channel icon. On the widget settings page, you can edit and customize the display of each widget. The following table briefly describes each widget setting and how it affects the widget.
Widget Setting | Description |
---|---|
Input Stream |
Specifies the data stream that the widget subscribes to for data updates. Can be Digital (DIO#) or Analog (AD#). (The tilt indicator widget has X-Axis Stream and Y-Axis Stream settings; these are two copies of the Input Stream setting, renamed to clarify the use of the stream.) |
Output Stream |
Specifies the digital I/O pin (DIO#) on the XBee module to which the widget sends its output values. |
Units | String label used in the widget to display the units for the values (for example, millivolts, decibels). |
Timespan | The total timespan, in seconds, to display in the graph. For example, if the timespan is set to 90, the graph will show 90 seconds of data at a time. |
X-axis tick size | The spacing, in seconds, between tick marks/lines drawn along the X-axis of the graph |
Y-axis autoscale | When you select this check box, the Y-axis of the graph automatically scales to fit the data displayed. If you clear the check box, the minimum and maximum values default to the Y-axis min/max values. |
Y-axis minimum/maximum | The minimum and maximum range on the graph's Y axis. You can use this setting if the Y-axis auto scale check box is cleared. |
Low value/High value | This setting is available on the progress bar and gauge widgets. It specifies the low and high values for data within the progress bar or gauge. For example, you can set these values to display a data stream’s values ranging from 100 to 1000. |
Input Transform |
Allows incoming data to be processed with an expression for display. The transform field is implemented using the AngularJS $eval function, and will only evaluate basic Angular expressions. For example, the stock potentiometer gauge widget uses value/1023 * 100. The following variables can access the input value:
See Angular Expressions vs. JS Expressions for more information on Angular JS. |
Invert Values |
When you select this check box, setting the switch to the On position sends the value 0. Setting the switch to the Off position sends the value 1. If you clear this check box, setting the switch to the On position sends 1 and setting the switch to the Off position sends 0. |
Read Only Switch | When you select this check box, the switch represents the data stream value last received from the server. |
Add Carriage Returns | This setting is available on the serial data widget. Specifies whether to wrap serial data sent to the XBee module in carriage return characters first. This use of a carriage returns helps make the text more readable when printed out, displayed in the widget, or XCTU. |
Check Radio Configuration button |
Verifies that the XBee module’s I/O configuration is appropriate for the selected input or output stream. (For example, if the Input Stream is set to DIO0, the Check Radio Configuration dialog verifies that D0 on the XBee module is set to act as a digital input.) Click this button to ensure that your XBee module is configured to work with your XBee Zigbee Cloud Kit. |
Discover control (near XBee Module) |
Provides available options for refreshing the list of XBee modules. The options include:
|