Prerequisites
- A supported device board (see Libraries)
- Your firmware toolchain installed
- A firmngin.dev account (sign up here)
Step 1: Create a workspace
Sign up and create workspace
Sign up and create workspace
- Go to firmngin.dev/register and create your account.
- Once logged in, create a workspace from the dashboard.
- Give your workspace a name — this is your project’s home for devices, automations, and billing.
Step 2: Register a device
Add a device to your workspace
Add a device to your workspace
- In the dashboard, navigate to Devices and click Add Device.
- Select your board type.
- Provide a device name and optional description.
- Once created, you will receive:
- Secret ID — your device identifier
- Secret Key — authentication key
- Download the
keys.hfile from your device page — this contains your mTLS credentials.
Step 3: Install the SDK
Arduino IDE
Arduino IDE
- Download the library from firmngin/Firmngin-Arduino.
- In Arduino IDE, go to Sketch → Include Library → Add .ZIP Library…
- Select the downloaded ZIP file.
- The library will be added to your Arduino libraries automatically.
PlatformIO
PlatformIO
Add the library to
platformio.ini:Step 4: Connect your device
keys.h next to your sketch. It provides DEVICE_ID and DEVICE_KEY, so you never paste credentials into the code. See the Arduino library for the full lifecycle.
Upload and verify
Upload and verify
- Select your board and port in Arduino IDE.
- Click Upload.
- Open the Serial Monitor at
115200baud. - You should see WiFi connection messages and device status.
- Go to your Dashboard — the device should appear as Online with live data.
Step 5: See it live
Real-time dashboard
Real-time dashboard
Once your device is connected:
- Status — Online/offline indicator updates in real time
- Entities — GPIO states, sensor readings, and custom entities are synced via
pushEntity()
Entity objects to define typed keys for your data, and pushEntity() to send state updates to the dashboard.Next steps
Devices
Learn how device identity, availability, entities, and public visibility work.
Device Billing
Create service catalogs, integrated payments, sessions, and public pages for guests.
Firmware & OTA
Track firmware artifacts and plan controlled OTA rollouts for your fleet.
Device Billing is currently only available for the Indonesia region.