Install the library in the Arduino IDE

The InstantIoT library is what makes your board talk to the app — the whole ESP32 family, the ESP8266, the Arduino UNO R4 WiFi, MKR WiFi 1010, Nano 33 IoT and UNO WiFi Rev2, and, behind a Bluetooth module or an Ethernet shield, the Mega, the UNO and the Nano: one header, one object, one begin(). This page installs it from the Arduino IDE’s Library Manager, installs the core of your board next to it, checks that a first sketch compiles, and says what each board can do with it.

Arduino IDE

Three things on the screen, in order:

1. The Library Manager — the books icon in the left bar, or Sketch → Include Library → Manage Libraries.
2. The search field — type InstantIoT; leave Type and Topic on All.
3. The version — the card reads InstantIoT by JeanLoick DT; pick the version in its drop-down and Install. The IDE puts the library where it belongs and finds it on the next compile; once installed, the card shows the version in green.

The version has to match the app’s. The app and the library speak the same protocol only within a major version: a 2.x library goes with a 2.x app, a 1.x library with a 1.x app. The app’s version is on its store page, or in your phone’s settings under the app; the library’s is on that card; the sketch the app writes for you is for its own version. Upgrading one means upgrading the other — and the changes between the two are in What changed in 2.0.

The library is the client; your board’s core is what compiles for it. Once per board family, Tools → Board → Boards Manager:

The Wi-Fi boards need nothing else: their Wi-Fi and TLS come with the core. Two links ask for one more thing, in the sketch as much as in the IDE:

// Bluetooth LE on an ESP32: install "NimBLE-Arduino" (h2zero) from the Library Manager,
// and include it BEFORE InstantIoT.h — without this line, BLELink does not exist
#include <NimBLEDevice.h>
#include <InstantIoT.h>

// An Ethernet shield (W5100 / W5500): the Ethernet library comes with the IDE,
// but the sketch has to ask for it by name, BEFORE the include
#define INSTANTIOT_ETHERNET 1
#include <InstantIoT.h>

Manual

Download a release from github.com/jeanloickdt/InstantIoT — the Source code (zip) — or the repository itself, and either Sketch → Include Library → Add .ZIP Library, or extract it into your Arduino libraries/ folder so that the tree reads:

Documents/Arduino/libraries/InstantIoT/      ← ~/Arduino/libraries/ on Linux
├── library.properties
├── src/
│   ├── InstantIoT.h                         ← the one header a sketch includes
│   ├── Links.hpp · Destinations.hpp
│   └── core/ · transport/ · utils/
└── examples/
    ├── connection/ · controls/ · measurements/ · complete/

Restart the IDE: File → Examples → InstantIoT appears in the menu.

Check that it compiles

Before the app, before the token: one compile. File → Examples → InstantIoT → connection → TheCloud, pick your board in Tools → Board, then Verify (✓). The three lines to fill are at the top of the sketch, and it compiles with the placeholders:

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

What the compiler can tell you at this point, and what to do:

A sketch that will not connect once uploaded: #define INSTANTIOT_DEBUG 1 before the include, and the Serial monitor at 115200 says which step it is stuck on — Wi-Fi, TLS or handshake (Connect your device).

Your first sketch

Once it compiles, this is the whole thing — a button and a measure, both directions, twenty lines:

#include <InstantIoT.h>

const char* TOKEN = "paste-the-token-the-app-gave-you";   // Cloud: from the device sheet, Copy token
InstantTimer timers;

ISimpleButton(I0) {                                        // a button in the app, on I0
    WHEN_PRESSED  { digitalWrite(LED_BUILTIN, HIGH); }
    WHEN_RELEASED { digitalWrite(LED_BUILTIN, LOW);  }
};

void publish() {
    InstantIoT.write(I1, analogRead(A0) * 3.3 / 4095.0);   // a voltage on I1 — a gauge, a chart, your call
}

void setup() {
    pinMode(LED_BUILTIN, OUTPUT);
    InstantIoT.begin(WiFiLink("MyWiFi", "secret"), Cloud(TOKEN));
    timers.every(1000, publish);
}

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

One header. One object. One begin. That sketch reacts to a button and sends a voltage once a second — and it is what the app writes for you on the device’s Code tab, with your own widgets in it.

Devices

A combination your device cannot do fails to compile, and the error message says what to write instead. Board by board, with the app’s list: Supported boards.

Next

Connect the device — every begin() line — and the example sketches, one per link, one per control, one per sensor.