Skip to main content

Devices

A Device in VWire represents a physical or virtual IoT endpoint — an ESP32, Arduino, Raspberry Pi, custom gateway, or any system that communicates via MQTT.


Device lifecycle

Register → Connect → Authenticate → Publish/Subscribe → Disconnect
↑ └── MQTT CONNECT ──────── LWT ──────────────┘
└── Dashboard / API
  1. Register — Create a device in the dashboard (or API). Receive a unique Device Token.
  2. Connect — Device connects to VWire MQTT broker with clientId = deviceToken.
  3. Authenticate — Broker validates token; rejects unknown tokens.
  4. Publish/Subscribe — Device sends sensor data (publish) and receives commands (subscribe).
  5. Disconnect — LWT (Last Will Testament) tells the server the device went offline.

Device properties

PropertyDescription
NameHuman-readable name (e.g. "Greenhouse Sensor")
Device TokenSecret credential used for MQTT authentication
Device IDImmutable UUID assigned at creation
StatusOnline / Offline (derived from MQTT connection)
Last SeenTimestamp of last activity
ProjectThe project this device belongs to
TagsOptional labels for filtering

Device limits (by plan)

PlanDevicesData points/dayNotifications
Free550,000100/day
Pro25500,000Unlimited
EnterpriseUnlimitedUnlimitedUnlimited