Arduino

Source checked from the public Firmngin Arduino repository on GitHub. The current library metadata shows version 1.0.2 and support for ESP32 and ESP8266.

When to use it

Use this library for:

ESP32 or ESP8266 firmware connected to Firmngin.

Devices that publish structured entity values such as temperature, relay state, energy, or GPS position.

Devices that receive entity commands from the dashboard.

Devices that need secure mTLS connection using downloaded device credentials.

Firmware that participates in paid session, payment, or verification flows.

Devices that need remote OTA firmware update support.

Main capabilities

Capability	What it does
Secure connection	Uses device credentials and mTLS for platform connection.
Entity state	Sends single or batch entity values from firmware to Firmngin.
Entity commands	Receives dashboard commands and routes them to the correct GPIO or component.
Typed callbacks	Provides typed objects for payments, verifications, device state, init, usage, vending dispenses, and active sessions.
Vending mode	Detects service vs vending business mode and handles SKU dispense events.
OTA updates	Checks for remote firmware updates, verifies them, and installs them on device.
Location	Sends GPS coordinates through a builder-style API.
Image upload	Uploads camera/image data and links it to an entity key.

Minimal lifecycle

Most sketches follow this shape:

#include "keys.h"
#include <firmngin.h>

#if defined(ESP8266)
#include <ESP8266WiFi.h>
#elif defined(ESP32)
#include <WiFi.h>
#endif

const char *ssid = "YOUR_SSID";
const char *password = "YOUR_PASSWORD";

Firmngin fngin(DEVICE_ID, DEVICE_KEY);
Entity temperature("temperature");

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

  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  fngin.begin();
}

void loop() {
  fngin.loop();

  static unsigned long lastPush = 0;
  if (millis() - lastPush > 10000) {
    lastPush = millis();
    fngin.pushEntity(temperature, "25.5");
  }
}

Getting started

Core concepts

Monetization

Libraries

When to use it

Main capabilities

Minimal lifecycle

Source repository

See also

​When to use it

​Main capabilities

​Minimal lifecycle

​Source repository

​See also

When to use it

Main capabilities

Minimal lifecycle

Source repository

See also