Docs
Widgets / directory

Level Display

LEVEL_DISPLAY

Bar-like fill meter for quantities that need directional visual context.

At a glance

Default2 x 4
Minimum1 x 2
Resizevertical
Pinrequired
Interactiveno

Behavior

  • Very good for tanks, battery, volume and queue progress.
  • Pairs well with Value Display for exact numbers.
  • Vertical orientation helps build hardware-like panels.

Firmware contract

Send a range-bound value and let the widget map it to the fill height or width.

On the app side this widget snaps to the 8-column square grid and uses vertical resizing. Its raw type is LEVEL_DISPLAY and the matching icon token in the app is chart.bar.fill.

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
100650
Level Display
stable
STATUS

Widget contract

PropertyValue
Raw typeLEVEL_DISPLAY
Default size2 x 4
Minimum size1 x 2
Resize modevertical
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.

Layout notes

Canvas footprint

2 x 4

Default footprint in the Plynx canvas before user resizing.

Resize floor

1 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

Value Display

Fast numeric readout for single values like temperature, current or uptime.

Labeled Value

String template display with inline placeholder replacement for the current pin value.

Gauge

Circular analog-style meter for sensor values and percentages.

LCD

Character display widget inspired by classic 16x2 LCD modules.