Connect an ESP32 to Clavda with the ClavdaOTA library

Add the device and download its file

In Clavda, open Devices → Add Device, choose the installation platform ESP32, and save. Reopen the device and press Get Device File to download clavda_device.h: the relay address and this board's credentials, compiled into the firmware.

Install the library

[env:esp32]
platform = https://github.com/pioarduino/platform-espressif32/releases/download/53.03.11/platform-espressif32.zip
board = esp32dev
framework = arduino
monitor_speed = 115200
board_build.partitions = min_spiffs.csv
lib_deps =
  https://github.com/victusx/ClavdaOTA-Release.git

Add the Clavda code to your sketch

Put clavda_device.h next to the sketch (Arduino IDE) or in include/ (PlatformIO). This is a complete sketch. The five numbered comments are what every Clavda sketch does, and it is the same for every board: what makes it this board is the clavda_device.h beside it.

#include <Arduino.h>
#include <WiFi.h>

// 1. Your firmware version. Change it for every build you upload: the
//    console counts an update done once the board reports it.
#define CLAVDA_FIRMWARE_VERSION "1.0.0"

// 2. The library, then this board's credentials from the console.
#include <ClavdaOTA.h>
#include "clavda_device.h"

const char *ssid = "your-wifi";
const char *password = "your-wifi-password";

void setup() {
  Serial.begin(115200);

  // 3. Join Wi-Fi. No need to wait: the library connects once it is up.
  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);

  // 4. Connect to Clavda. False means clavda_device.h is missing.
  if (!ClavdaOTA.begin(CLAVDA_DEVICE)) {
    Serial.println("No credentials: add clavda_device.h from the console.");
  }
}

void loop() {
  // 5. Keep the connection alive; updates install from here too.
  //    Call it on every loop, and avoid long delay() calls.
  ClavdaOTA.loop();

  // Your application code.
}

Replace the Wi-Fi name and password, and add your own code after ClavdaOTA.loop().

Choose a partition scheme with room for updates

An over-the-air update needs two app slots, and the default layout leaves too little room. In the Arduino IDE, set Tools → Partition Scheme → Minimal SPIFFS (1.9MB APP with OTA). With PlatformIO, the board_build.partitions = min_spiffs.csv line above does the same.

Flash it once over USB

Upload the sketch as usual. As soon as the board is on Wi-Fi, it turns green under Devices in Clavda. From here on you can update it without the cable.