LED

On or off, at a glance. A door, a pump, a connection, an alarm — the LED is a state you can read without reading.
What it does
It lights when the signal is anything but 0, and goes dark when it is 0. The device writes 1 or 0 (or HIGH / LOW, or a bool) and the LED follows.
When to use it
- A door or a contact — open / closed.
- Something running — a pump, a heater, a motor.
- A warning — red when a threshold is crossed, from the device’s own logic.
Set it up
- 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.
- Place it — Back on the dashboard, in edit mode, tap + at the bottom and choose LED under Displays. Two columns square is enough.
- 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.
- 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
| Setting | Type | Default | What it controls |
|---|---|---|---|
| Signal | one signal | empty — Pick a signal | The signal the widget reads. Accepts an Integer or Decimal signal — 0 is off, anything else is on. The picker lists nothing else. |

Appearance — how it looks
Title
| Setting | Type | Default | What it controls |
|---|---|---|---|
| Title text | text | empty | A title above the widget. Empty means no title. |
| Alignment | Left / Center / Right | Center | Where the title sits. |
Display
| Setting | Type | Default | What it controls |
|---|---|---|---|
| Halo | toggle | on | A glow around the LED while it is on. |
Colors
| Setting | Type | Default | What it controls |
|---|---|---|---|
| On | colour | theme accent | The LED while on. |
| Off | colour | grey | The LED while off. |

States
- Off — grey. On — the On colour, with its halo.
- Device offline — the last state stays; check the device’s dot to know if it is current.
Arduino device code
The address is all the device knows — I5 here; use the one the app gave your signal. In the sketch, a 0 or anything else:
InstantIoT.write(I5, digitalRead(DOOR));
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(I5, digitalRead(DOOR)); // 1 open, 0 closed
}
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:
| Connection | begin() |
Devices |
|---|---|---|
| Cloud over Wi-Fi (above) | InstantIoT.begin(WiFiLink("MyWiFi", "secret"), Cloud(DEVICE_TOKEN)); |
ESP32 family, ESP8266, UNO R4 WiFi, MKR WiFi 1010, Nano 33 IoT, UNO WiFi Rev2 |
| Cloud over Ethernet | InstantIoT.begin(EthernetLink(), Cloud(DEVICE_TOKEN)); |
any board + an Ethernet shield |
| Direct — the device’s own Wi-Fi | InstantIoT.begin(AccessPoint("MyESP32", "12345678")); |
every board with Wi-Fi |
| Direct — Bluetooth LE | InstantIoT.begin(BLELink("MyESP32")); — #include <NimBLEDevice.h> first |
ESP32 family (not the S2) |
| Direct — Bluetooth Classic | InstantIoT.begin(BluetoothLink("MyESP32")); |
the original ESP32, Android only |
| Direct — a Bluetooth module (HC-05, HM-10) | InstantIoT.begin(SerialLink(Serial1)); — or SerialLink(13, 15) on ESP8266, SerialLink(10, 11) on UNO / Nano |
every board, radio or not |
| Your own InstantIoT Server (open source, at home) | InstantIoT.begin(WiFiLink("MyWiFi", "secret"), MyServer("192.168.1.42", DEVICE_TOKEN)); |
same as Cloud |
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
- An LED and a Switch on the same signal make a pair: the switch commands, the LED confirms what the device actually did if the device writes back.
- For a state the device decides on its own (an alarm), write it only when it changes.
- Want to be told, not just shown? A rule on the same signal sends a notification.
Next
→ Switch — to command the same state → Text — a state with words