Quickstart

Panduan ini akan menuntun Anda langkah demi langkah dari membuat proyek di web hingga mengunggah sketsa kode ke mikrokontroler ESP32/ESP8266 Anda menggunakan ElectinsIoT v3.1.0.

Persyaratan Perangkat Keras & Lunak

• Modul Mikrokontroler (ESP32 atau ESP8266).

• Kabel data USB yang mendukung transmisi data.

• Perangkat lunak Arduino IDE (versi 2.0.0 atau yang lebih baru).

• Koneksi internet WiFi 2.4 GHz.

Langkah 1: Membuat Proyek di Web Dashboard

1. Masuk ke akun Anda di electins.id/login.

2. Buka menu IoT Projects pada sidebar navigasi utama, lalu klik tombol + Buat Proyek Baru.

3. Isikan Nama Proyek (misal: Stasiun Cuaca Pintar) dan pilih Tipe Board ESP32.

4. Tambahkan Widget ke Dashboard misal: Gauge dengan Datastream parameter temp dan Button dengan Datastream Parameter relay lalu lik Simpan Proyek.

Langkah 2: Mengambil API Key Proyek

Setelah proyek terbentuk, buka tab Connection. Salin Project API Key berformat unik (misal: ek_98f4a1b2c3d4e5f6...).

Langkah 3: Memasang Library ElectinsIoT di Arduino IDE

1. Buka Arduino IDE, navigasikan ke menu Sketch > Include Library > Manage Libraries....

2. Ketik ElectinsIoT pada kolom pencarian.

3. Klik tombol Install (versi 3.0.3+).

Langkah 4: Mengunggah Sketsa Program Lengkap

Buka berkas baru di Arduino IDE, lalu tempelkan kode program di bawah ini. Pastikan untuk mengganti NAMA_WIFI, PASSWORD_WIFI, dan API_KEY_ANDA sesuai dengan data Anda:

#include <ElectinsIoT.h>

const char* WIFI_SSID    = "NAMA_WIFI_ANDA";
const char* WIFI_PASS    = "PASSWORD_WIFI_ANDA";
const char* API_KEY      = "API_KEY_ANDA";
const char* FIRMWARE_VER = "1.0.0";

const char* PARAM_SUHU   = "temp";
const char* PARAM_RELAY  = "relay1";

WiFiClient client;
ElectinsIoT iot(client);

void setup() {
    Serial.begin(115200);
    pinMode(LED_BUILTIN, OUTPUT);

    iot.setDebug(true);
    iot.beginWiFi(API_KEY, WIFI_SSID, WIFI_PASS, FIRMWARE_VER);
}

void loop() {
    // Membaca status sakelar langsung dari Local Cache (Thread-Safe)
    bool relayState = iot.getBool(PARAM_RELAY, false);
    digitalWrite(LED_BUILTIN, relayState ? HIGH : LOW);

    // Mengirimkan data telemetri suhu setiap 3 detik
    static unsigned long lastSend = 0;
    if (millis() - lastSend >= 3000) {
        lastSend = millis();
        if (iot.connected()) {
            float temperature = 25.0f + random(0, 50) / 10.0f;
            iot.sendTelemetry(PARAM_SUHU, temperature);
        }
    }
}

Langkah 5: Verifikasi Data Realtime di Web & Mobile

Setelah pengunggahan selesai, buka Serial Monitor pada baud rate 115200. Buka Web Dashboard atau Aplikasi Mobile Electins IoT Kit, lihat pada Widget Gauge ata akan mulai mengalir secara realtime LED builtin pada ESP menyala jika Button ditekan.