Widgets / directory

Gauge

GAUGE

Circular analog-style meter for sensor values and percentages.

At a glance

Default4 x 4
Minimum2 x 2
Resizeboth
Pinrequired
Interactiveno

Behavior

  • Great for speed, current, pressure and humidity.
  • Reads best at medium tile sizes.
  • Often paired with a numeric value tile for exact readout.

Firmware contract

Send a number in the configured range; the app maps it into the gauge arc.

On the app side this widget snaps to the 8-column square grid and uses both resizing. Its raw type is GAUGE and the matching icon token in the app is gauge.medium.

Pin support: A configured pin is required before the widget becomes meaningful.

Transmission: Payload format depends on the widget type and the selected pinType.

Canvas preview

docs.widget.preview
72Gauge0100
Gauge
stable
STATUS

Widget contract

PropertyValue
Raw typeGAUGE
Default size4 x 4
Minimum size2 x 2
Resize modeboth
Pin requirementrequired
Pin supportSee behavior and firmware contract above
Interactiveread-only / service
TransmissionDepends on the widget payload type

Allowed pin families

Bound to the configured pinType and limited by how the current app/connector serialize the widget payload.

Transport path

Payload leaves the canvas through the dashboard transport and lands on the selected virtual, digital or analog endpoint.

Operational limits

Server-side behavior may still depend on board library support and project policy.

Configuration surface

  • Color, label and position are stored in the dashboard profile.
  • Use the app-side widget config sheet to tune behavior per widget type.

Limits and caveats

  • Server-side behavior may still depend on board library support and project policy.

Firmware example

A minimal pattern that matches how this widget usually talks to the board.

gauge.ino
void loop() {  float pressure = readPressure();  Blynk.virtualWrite(V5, pressure);}

Layout notes

Canvas footprint

4 x 4

Default footprint in the Plynx canvas before user resizing.

Resize floor

2 x 2

The minimum size accepted by the app during drag-resize.

Interaction model

Display

Whether the user edits state directly or only reads it.

Related widgets