Gauge
The Gauge widget provides a dynamic way to display numerical data such as temperature, humidity, or battery levels. Configure the widget to match your needs with adjustable ranges, colors, and styles.
There are two gauge variants:
- Simple Gauge: Fully configurable from the widget settings.
- Advanced Gauge: Configured via DataVista action cards for complete control over data and visualization.
Add the widget to your dashboard
- Open the Homey app and go to Dashboards.
- Enter Edit Mode and select Add Widget.
- Choose Apps and select DataVista.
- Pick the Gauge widget.
- Click the preview to add it to your dashboard.
Configure the Simple Gauge
The Simple Gauge is configured entirely through widget settings:
| Setting | Description |
|---|---|
| Datasource | Select a device capability to provide values. The widget uses its current, minimum, and maximum values when available. |
| Number of segments | Sets the number of gauge segments; each segment border shows a value. |
| Refresh interval (seconds) | Seconds between polling updates. |
| Minimum value | Override the capability minimum. |
| Manual minimum value is negative | Treat the manual minimum as a negative number. |
| Maximum value | Override the capability maximum. |
| Manual maximum value is negative | Treat the manual maximum as a negative number. |
| Style | Choose Style 1, Style 2, or Circular. Style 1 uses a needle, Style 2 a colored bar, and Circular renders a 360° dial. |
| Transparent background | Toggle between a solid tile or transparent background. |
| Color 1 | Color at the minimum value. |
| Color 2 | Color at the midpoint. |
| Color 3 | Color at the maximum value. |
| Gradual color transitions | Enabled by default: the colors blend into each other. Disable it for equally sized solid bands, one for each selected color (for example three bands with three colors). |
Configure the Advanced Gauge
The Advanced Gauge relies on DataVista action cards and offers more flexibility:
| Setting | Description |
|---|---|
| Datasource* | A DataVista datasource (percentage or range) that feeds the gauge. |
| Configuration source* | A DataVista configuration that defines gauge colors and offsets. |
| Number of segments | Sets the number of gauge segments; each segment border shows a value. |
| Style | Choose Style 1 (needle), Style 2 (colored arc), or Circular (360° dial). |
| Gradual color transitions | Enabled by default: the colors blend into each other. Disable it for solid color bands. Each color then starts at its configured value and runs up to the value of the next color. Without values, the axis is divided into equally sized bands. |
| Transparent background | Toggle between a solid tile or transparent background. |
The datasource must be created by running a DataVista action card that sets a percentage or range at least once before it appears in the widget settings.
The configuration source requires a DataVista action card to define gauge colors. Run it once before selecting it in the widget settings.
Tutorials
FAQ
Why does the gauge animate through 0, 25, 50, 75, and 100?
The datasource could not be found or is no longer available. Reconfigure the datasource setting and select a valid value.
How do I render a circular gauge?
Select Circular in the Style setting to render a round 360° gauge.
How do I get solid color bands instead of a gradient?
Disable Gradual color transitions in the widget settings. On the Simple Gauge, the axis is then divided into equally sized bands, one for each selected color. On the Advanced Gauge, each color starts at the value set in the gauge configuration card and runs up to the value of the next color. For example, green at 0, orange at 60 and red at 80 shows green up to 60, orange from 60 to 80, and red from 80. Because these values can come from flow tokens, you can change the bands from a flow.
With Style 2, the inner bar takes the color of the band that the current value falls in.