Analog Gauge Widget
An analog-style needle dial with configurable tick marks and labeled color zones. Great for visualizing temperature, speed, pressure, or any value where ranges carry meaning (safe / warning / danger).
Default size: 2 × 2 grid cells
Configuration
| Property | Type | Default | Description |
|---|---|---|---|
min | number | 0 | Minimum scale value |
max | number | 100 | Maximum scale value |
unit | string | `` | Unit label below needle |
| Device | device | — | The device to read from |
| Pin | V0–V255 | — | The virtual pin to display |
| Label | string | — | Widget label |
Firmware example
void loop() {
Vwire.run();
float rpm = readRPM(); // e.g. 3500
Vwire.virtualSend(V0, rpm);
delay(500); // fast update for gauges
}
Color Zones
Color zones let you highlight safe, caution, and danger ranges:
| Zone | Range | Color |
|---|---|---|
| Normal | 0 – 70% | #10B981 green |
| Caution | 70 – 90% | #F59E0B amber |
| Danger | 90 – 100% | #EF4444 red |
Configure zones in the Widget Settings panel after creation using the Color Zones editor.
Tips
Fast refresh
For real-time gauges (e.g. RPM), push data every 200–500 ms. The server respects burst limits, but values are buffered and the needle updates smoothly.
Out-of-range values
Values below min or above max clamp — the needle stops at either end without error.