Device Setup Assistant - Overview

Large-scale device onboarding made easy

Configure and deploy your devices faster than ever with the Device Setup Assistant. This tool provides an easy and seamless setup experience, even for IoT beginners. With this tool, you can assign useful Custom Fields and Tags to devices during the installation process. This makes managing your device fleet easier and facilitates integration into third-party applications.

Prerequisites

Before using the Device Setup Assistant, ensure that assets have already been created in your workspace. For setting up multiple devices simultaneously, we recommend using the Bulk Import feature.

The Device Setup Assistant is accessible on both mobile and desktop devices.

Steps to Setup a Device

  1. Scan Device QR Code

    Scan the QR code on the device. The QR code must redirect to the following URL structure:

    https://api.akenza.io/v3/resolve-device?deviceId=0018B20000001122

    Here, 0018B20000001122 represents the Device ID / DevEUI of the asset. As an alternative, you can select your device from the list of added devices.

  2. Device Overview

    Check if the correct device has been selected. If the device has already sent data, you can use the “Last Message Time” to verify if the device is online. Additionally, you can view the signal quality and the current battery level. If the device has been assigned CustomFields or Tags, you can also view them here.

  3. Configure Device

    Add values to your Custom Fields and Tags for your physical asset. This helps in categorizing and managing your devices efficiently.

  4. Complete Setup

    That’s it! Your device is now fully set up and ready to use.

Advanced Setup with CSV Upload

To simplify the setup process even further, you can upload a CSV file with pre-filled Custom Fields, Tags, and Device Names. Follow these guidelines for the CSV file:

  • The field names "tags" and "deviceName" must not be changed.

  • Custom Fields and Tags must be predefined in the Workspace with the exact same names to be utilized by the Device Setup Assistant.

  • Define which Custom Field should be the Primary Field. This field can be selected from a dropdown list in the Device Setup Assistant, and all other fields will be automatically filled based on the uploaded CSV.

Example CSV Structure:

After selecting your device or scanning the QR code, only your primary Field needs to be selected, and all other values will be filled out as defined in the CSV. Save changes to apply them to your device.

Last updated