Advanced Button

The same button as the Simple Button, with a label, an icon, and — the part that matters — a value of your choice for each gesture. When 1 and 0 are not what the device wants to hear, this is the button to place.

What it does

It writes to its signal on three gestures — press, release, long press — and you decide what each one sends. A fan button can send 255 on press and 0 on release; a preset button can send 3. In Momentary mode (the default) press and release are two events; in Toggle mode each tap alternates between the press value and the release value.

When to use it

• A preset — one tap sends a fixed value: a scene, a speed, a mode number.
• Full speed while held — press sends 255, release sends 0.
• Two actions on one button — a short press and a long press that do different things, each with its own value.

Set it up

1. Place it — In edit mode, tap + at the bottom of the dashboard and choose Advanced Button under Controllers.
2. Wire it to a signal — Tap the button, open the Data tab, tap + Add a target and pick an Integer signal on your device.
3. Set the values — In the same tab, under What each gesture sends, type the number you want for a press, a release and a long press — 255, 0 and 128 for a fan, say.
4. Dress it and try it — In the Appearance tab, give each gesture a label and an icon. Close the settings, tap ▶, and press the button.

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 writes

Targets

Mode

What each gesture sends

Appearance — how it looks

Title

Press

Release

Long press

States

• Edit mode — a tap opens the settings.
• Run mode — the button changes label, icon and colours as you press, hold and release, so you see which gesture registered.
• Device offline — a gesture is never replayed.

Arduino device code

The address is all the device knows — I0 here; use the one the app gave your signal. In the sketch, the block that runs on every gesture — or ISignal(I0, int v) if you only care about the number:

IAdvancedButton(I0) {
    WHEN_PRESSED      { … }
    WHEN_RELEASED     { … }
    WHEN_LONG_PRESSED { … }
};

Complete sketch — Cloud

Paste it into the Arduino IDE, put your Wi-Fi and the token the app gave you, upload.

#include <InstantIoT.h>

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

const int FAN = 5;

IAdvancedButton(I0) {
    WHEN_PRESSED      { analogWrite(FAN, 255); }   // full speed while held
    WHEN_RELEASED     { analogWrite(FAN, 0);   }
    WHEN_LONG_PRESSED { analogWrite(FAN, 128); }   // half speed, and it stays
};

void setup() {
    Serial.begin(115200);
    pinMode(FAN, OUTPUT);
    InstantIoT.begin(WiFiLink(WIFI_SSID, WIFI_PASS), Cloud(DEVICE_TOKEN));
}

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

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.

ISignal does the same job — and survives a restart. ISignal(I0, int v) runs with exactly the same value as IAdvancedButton(I0): the widget block is the readable form, ISignal the generic one, and you can use either. The difference shows when the device reconnects: with Restore after a restart on the signal, the Cloud sends the last value again and only the ISignal block runs — a gesture is not replayed. If the value is what matters after a restart (a preset), read it with ISignal(I0, int v) and turn Restore on: the device gets the last preset back by itself. See One block for everything.

Notes

• If you only need the number, ISignal(I0, int v) is shorter than three WHEN_ clauses: v is whatever the gesture sent.
• The icon list is long; type the first letters in the picker to find one.

Next

→ Simple Button — when 1 and 0 are enough → Segmented Switch — several fixed values, side by side