Skip to content

Releases: decoded-cipher/nodrix-sdk

Release list

v0.1.0

Choose a tag to compare

@decoded-cipher decoded-cipher released this 05 Jul 05:31

First release of the Nodrix Arduino library — connect ESP32 and ESP8266 hardware to Nodrix in a few lines. It hides WiFi, TLS, the WebSocket/HTTP transport, JSON, and the control/telemetry protocol behind a tiny API, so a sketch is mostly your own device logic.

Features

  • Control handlersNODRIX_WRITE("var") { ... } runs when the cloud writes a variable, with automatic acks and typed value coercion (asBool(), asInt(), asLong(), asFloat(), asDouble(), asString(), isNull()).
  • TelemetryNodrix.send() with batching; overloads for bool, int, long, float, double, const char*, and String.
  • Two transports — always-on WebSocket (begin() / run()) and HTTP polling for deep-sleep devices (beginHTTP() / poll()).
  • Resilience — multiple WiFi networks with failover (addAP()), automatic reconnect, heartbeat, and control-variable seeding.
  • Optional TLS pinningsetCACert() (ESP32) and setFingerprint() (ESP8266 HTTP); unvalidated setInsecure() by default.
  • Events — trigger server-side automations with event().

Boards

ESP32 (including S2, S3, C3, C6, H2) and ESP8266.

Install

  • Arduino IDE — install ArduinoJson (v7) and WebSockets (by Markus Sattler) from the Library Manager, then add Nodrix.
  • PlatformIO — add bblanchon/ArduinoJson@^7, links2004/WebSockets@^2.6, and this repo to lib_deps.

Then #include <Nodrix.h>. See the README and the examples/ folder (LedControl, HomeLights, MultiWiFi, SensorTelemetry, DeepSleepSensor). The two DHT11 examples — SensorTelemetry and DeepSleepSensor — also need the DHT sensor library by Adafruit.