Skip to content
Docs

Device Management

Device Lifecycle

Section titled “Device Lifecycle”
graph LR
  A[Unregistered] --> B[Registered]
  B --> C[Online]
  C --> D[Managed]
  B --> E[Claimed]
  D --> F[Retired]

Adding Devices

Section titled “Adding Devices”

Method 1: Manual Registration

Section titled “Method 1: Manual Registration”
  1. Navigate to Devices → Add Device
  2. Fill in the device details:
FieldRequiredDescription
Device IDYesSerial number or IMEI
NameYesFriendly display name
ModelYesDevice model (e.g., RC500)
Device TypeYesopenwrt_rc500, queclink_gps, etc.
TagsNoKey-value pairs for grouping
  1. Click Create Device
  2. The platform generates MQTT credentials
  3. Configure the device with these credentials (manually or via provisioning)

Method 2: Auto-Registration

Section titled “Method 2: Auto-Registration”

Devices with factory-provisioned credentials automatically register on first connection:

  1. Power on the device with network connectivity
  2. Device connects to MQTT broker with provisioned credentials
  3. Platform creates a device record with status “pending”
  4. Device appears in the Unclaimed Devices view
  5. Admin claims the device to their organization

Method 3: Claim Code

Section titled “Method 3: Claim Code”

For handing devices to end customers:

  1. Admin generates a claim code for a registered device
  2. Share the code (6-digit or QR) with the customer
  3. Customer logs into their portal and enters the claim code
  4. Device is moved to the customer’s tenant

Device Detail View

Section titled “Device Detail View”

Click any device in the list to view its detail page:

Status Tab

Section titled “Status Tab”
  • Online/offline status with last-seen timestamp
  • Connection type (cellular/Ethernet)
  • Signal strength (if cellular)
  • Current firmware version
  • MDM agent version

Telemetry Tab

Section titled “Telemetry Tab”
  • System metrics history (CPU, memory, uptime)
  • Network statistics (throughput, latency)
  • Signal strength trend
  • GPS position (if equipped)

Configuration Tab

Section titled “Configuration Tab”
  • Current device configuration
  • Pending configuration changes
  • Configuration sync history
  • Apply new configuration

Events Tab

Section titled “Events Tab”
  • Connection events (online/offline transitions)
  • Configuration change events
  • Firmware update events
  • Alert events

Commands Tab

Section titled “Commands Tab”
  • Reboot — Remote device restart
  • Factory Reset — Reset to defaults (requires confirmation)
  • Config Sync — Force configuration synchronization
  • Firmware Update — Deploy specific firmware version

Device List

Section titled “Device List”

The Devices page shows all devices in a sortable, filterable table:

ColumnDescription
NameDevice display name
StatusOnline / Offline / Error
ModelDevice hardware model
FirmwareCurrent firmware version
SignalCellular signal strength
Last SeenTime since last communication
TagsAssigned tags

Filtering

Section titled “Filtering”
FilterOptions
StatusOnline, Offline, Error, All
Device TypeRC500, GV57, TS80, All
TagsFilter by tag key/value
SearchFree-text search (name, ID)

Bulk Actions

Section titled “Bulk Actions”

Select multiple devices for bulk operations:

  • Push Configuration — Apply a profile to selected devices
  • Deploy Firmware — Update firmware on selected devices
  • Tag — Add/remove tags from selected devices
  • Delete — Remove selected devices (admin only)

Device Tags

Section titled “Device Tags”

Tags are key-value pairs for organizing devices:

region: us-west
customer: acme-corp
site: warehouse-3
fleet: delivery

Tags enable:

  • Filtering the device list
  • Targeting configuration profiles
  • Scoping firmware deployments
  • Grouping in reports and dashboards

Device Deletion

Section titled “Device Deletion”

To remove a device:

  1. Navigate to the device detail page
  2. Click Delete Device (requires Admin role)
  3. Confirm the deletion