Vertical Level

The Horizontal Level, upright — a tank you look at like a tank. Same value, same settings, a narrow column that fills from the bottom.

What it does

It fills from the bottom in proportion to the value between the signal’s minimum and maximum, and prints it as a percent, as the value, or not at all.

When to use it

• A tank, a silo, a rain gauge — the shape says what it is.
• Several levels side by side — four columns, four tanks.
• A narrow spot — two columns of the grid.

Set it up

1. Declare the signal — Tap the device icon at the top right, then Declare a signal: give it a name, a type and a unit, and fill in the Format — minimum, maximum, decimals — because that is what the widget will use to scale and print the value.
2. Place it — Back on the dashboard, in edit mode, tap + at the bottom and choose Vertical Level under Displays. Two columns wide and eight rows tall makes a column.
3. Wire it to the signal — Tap the widget: its settings open. In the Data tab, tap Pick a signal and choose the signal you declared.
4. Write from the device — In the sketch, write the value to the signal’s address — InstantIoT.write(I1, value) — and it shows up in the widget within a second.

Settings

Tap the widget in edit mode: the sheet opens with a live preview at the top, then two tabs — Data for what it reads or writes, Appearance for how it looks.

Data — what it reads

Signal

Appearance — how it looks

Title

Display

Colors

States

• Waiting for data — nothing has arrived yet on this signal; the widget shows a placeholder.
• Live — every value the device writes replaces the previous one.
• Device offline — the last value stays on screen; the device’s dot is grey in the device list.

Arduino device code

The address is all the device knows — I3 here; use the one the app gave your signal. In the sketch, one line:

InstantIoT.write(I3, tankLevel());

Complete sketch — Cloud

Paste it into the Arduino IDE, put your Wi-Fi and the token the app gave you, upload. It publishes once a second.

#include <InstantIoT.h>

const char* WIFI_SSID    = "MyWiFi";
const char* WIFI_PASS    = "MyPassword";
const char* DEVICE_TOKEN = "PASTE_TOKEN_HERE";

InstantTimer timers;

void publish() {
    InstantIoT.write(I3, tankLevel());
}

void setup() {
    InstantIoT.begin(WiFiLink(WIFI_SSID, WIFI_PASS), Cloud(DEVICE_TOKEN));
    timers.every(1000, publish);
}

void loop() {
    InstantIoT.loop();
    timers.run();
}

Other connections

The widget block never changes. Only the begin() line says how the device reaches the app:

Direct needs no token: the phone is at the other end of the wire. See Connect for TLS, timeouts and what to do when it does not connect.

Any display works at the same address. A metric, a gauge and this widget on the same signal show the same value; the device does not change. Change the widget, not the sketch.

Notes

• Make it tall: the taller the column, the finer the reading.
• A Vertical Slider next to it — the slider sets the target, the level shows the measure.

Next

→ Horizontal Level — the same, across → Gauge — an arc