Overview
Device management allows you to add, configure, and monitor individual IoT devices in your fleet. Each device must be associated with a device template that defines its capabilities and data structure.
Steps to Add a Device
Access Device Management
Navigate to the menu and select device management from the sidebar.
Create New Device
Click the add button to register a new device in your system.
Configure Basic Information
Provide a unique device name and select the appropriate device template that matches your hardware.
Set Device Credentials
The system will generate MQTT credentials (username and password) for device authentication. Store these securely for device configuration.
Device Properties
| Property | Description |
|---|---|
| Device Name | Unique identifier for the device in your system |
| Template | Device template defining capabilities and data structure |
| Location | Physical location or deployment site (optional) |
| Description | Additional notes or metadata about the device |
| Status | Active, inactive, or maintenance mode |
Device Authentication
Quarkifi Stream uses MQTT for device connectivity with secure authentication:
MQTT Credentials
Each device receives unique MQTT credentials upon creation. These credentials must be configured in your device firmware to establish secure connection with the platform.
Connection Details
Broker URL: Provided in device settings
Port: 1883 (MQTT) or 8883 (MQTT/TLS)
Protocol: MQTT v3.1.1
Monitoring Device Health
Track device status and performance through the monitoring dashboard:
- Connection Status: Online, offline, or last seen timestamp
- Data Frequency: Rate of incoming telemetry data
- Battery Level: For battery-powered devices (if reported)
- Signal Strength: Network connectivity quality
- Error Logs: Connection failures and data transmission errors
Device Commands
Send commands to actuating devices (switches, relays, etc.):
Select Device
Navigate to the device details page for the target device.
Choose Command
Select from available commands defined in the device template.
Set Parameters
Provide required parameters (e.g., relay state, setpoint values).
Execute Command
Send the command to the device via MQTT. View command status and response in the activity log.
Bulk Operations
Manage Multiple Devices
Use bulk operations to manage groups of devices efficiently:
- Import devices from CSV file
- Export device list with credentials
- Update device properties in batch
- Apply firmware updates to device groups
- Delete or archive multiple devices