Skip to main content

Devices

Devices are physical hardware units (sensors, trackers, gateways) that connect to the SensoCAN platform to send telemetry data.

Adding a Device​

  1. Navigate to Management > Devices

  2. Click + Create Device

  3. Fill in the form:

    • Name: A friendly identifier (e.g., "Warehouse Temperature Sensor")
    • Description: (Optional) Additional details about the device
    • Device Group: (Optional) Assign to an existing group for organization
    • Status: Enable or disable the device

  4. Click Save

After creation, the system generates a unique Device UUID and Access Token for authentication.

Viewing Device Credentials​

After creating a device:

  1. Click on the device name to open Device Details
  2. Navigate to the Credentials tab
  3. You'll see:
    • Device UUID: Unique identifier for the device
    • Access Token: Used for MQTT/HTTP authentication

Warning: Keep the Access Token secure. Anyone with this token can send data as this device.

Device Details Page​

The Device Details page shows:

  • Overview: Device name, status, last seen timestamp
  • Latest Values: Most recent reading from each sensor
  • Historical Charts: Time-series graphs for each sensor
  • Sensors: List of configured sensors for this device
  • Credentials: Auth tokens for data ingestion

Adding Sensors to a Device​

Sensors represent individual data points that a device collects (e.g., temperature, humidity, GPS coordinates).

  1. Go to Device Details > Sensors
  2. Click + Add Sensor
  3. Fill in:
    • Sensor Name: Descriptive name (e.g., "Engine Temperature")
    • Sensor Slug: Short identifier used in data payloads (e.g., temp_engine)
    • Sensor Type: Select from predefined types (Temperature, Humidity, GPS, etc.)
    • Unit: Measurement unit (e.g., °C, %, V)

Connecting Your Device​

SensoCAN supports two methods for sending data:

See the MQTT Integration Guide for detailed connection instructions.

Quick Example:

Topic: tenant/123/device/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sensor/temp_01
Payload: {"value": 24.5}

Option 2: HTTP API​

See the HTTP API Guide for REST endpoint documentation.

Device Assignments​

You can restrict which users can see specific devices. This is useful for:

  • Field technicians who only need access to certain equipment
  • Clients who should only see their own devices

Assigning Devices to Users​

  1. Navigate to Management > Device Assignments
  2. Select a user from the list
  3. Check the devices they should have access to
  4. Click Save Assignments

Important: Only users with the "User" role are affected by assignments. Admins and Managers can see all devices.

Device Status​

Devices can have the following statuses:

  • Active: Device is enabled and can send/receive data
  • Inactive: Device is disabled (data ingestion blocked)
  • Last Seen: Timestamp of the most recent data received

To enable/disable a device, use the toggle switch on the Device Details page.