Add and manage third-party external devices – Support Center

In this article, you'll learn how to add and manage third-party IoT devices from Kio Cloud Device Management. By adding external devices, you can incorporate third-party IoT devices into Kio Cloud, alongside Kontakt.io devices, for a comprehensive view of your deployed IoT device inventory. Once imported, you can view and manage the external devices from Device Management.

How to add external devices

Complete the following steps to add third-party devices to your Kio Cloud Device Management inventory.

Step 1: Create CSV file with the device data

The following table details the third-party device data specifications for the CSV file that is used to add the devices to Device Management.

Download CSV template. The template includes example data. The CSV header row is required and cannot be modified.

CSV header column	Device Management value	Description	Required	Example
uniqueId	Unique Id	Free text value used to identify the device; maximum of 32 characters allowed If not provided, value is generated automatically.	No	A12dBB
mac	MAC address	MAC address that uniquely identifies the device. Required format: XX:XX:XX:XX:XX:XX Upon import, MAC address is converted to uppercase for consistency.	Yes	08:00:04:02:00:00
alias	Notes	User-defined device details and information.	No	White Bulb
tags	Tags	A method to label devices to group or categorize devices. Tags values cannot include spaces and use a , (comma) to separate tag values.	No	external,bulb,white
deployment.status	Deployment Status	Represents the device's current lifecycle status. Allowed values: TO_BE_DEPLOYED DEPLOYED END_OF_LIFE	Yes	TO_BE_DEPLOYED
product	Product Name	Name of the product in a human-readable way; maximum of 32 characters allowed	Yes	External device
productCode	Product code	Code of the product that identifies its type; maximum of 32 characters allowed	No	external_device
category*	Device category	Category that the device belongs to. Allowed values: TAG INFRASTRUCTURE Tags: are devices that are moving or wearables. Infrastructure: are devices that are stationary, maintaining a fixed position within a given location.	Yes	TAG

* sets where the device is located within the Device Management menus; that being either within the Tags or Infrastructure Inventory menu

Step 2: Import the CSV file

Log in to Kio Cloud > from the Launchpad, select Device Management 2.0.
From the Add Devices menu, select Import External > choose the CSV file with the external device data.
From the success notification, select the option to view the CSV file.
From the file, review the two import columns appended to the file to verify the import.

Step 3: Place infrastructure devices onto floor plan

This step is optional, but provides an organized and visual representation of your deployed infrastructure devices by location.

To place an infrastructure device at its installation location from Smart Location, complete the below steps. You will need to know the device's MAC address or UniqueID.

Sign in to Kio Cloud > from the Launchpad, select Smart Location.
Go to the Campus, Building, and Floor where external device is installed.
From the upper-right corner, select CONFIGURE FLOOR > select the Gateways tab.
Select ASSIGN NEW GATEWAY > from the list, select the device (by its Unique ID/MAC address) > select ADD.

The device is placed at the center of the visible floor plan.
To place it at its exact room install location, select its edit icon (pencil) > from the floor plan, move the device icon to its actual location in the room > select SAVE

External device management

The following provides details on how to manage external devices added to Device Management.

Virtual attribute settings

For external devices, you can manage the following virtual attribute settings.

Tags: a method to categorize or group devices
Deployment Status: to indicate if a device is deployed, not deployed, or has reached its end of life
Notes: general information about a device

Note

Re-importing external devices is not allowed and will result in an error.

Updating external devices is managed from each device profile or through the export and import Device Management features.

If you need to update multiple devices at the same time, be sure to use the Export and Import CSV features available in Device Management 2.0.

Search and locate external devices

From the Tags and Infrastructure menu, use the search and filter options to find and manage your external devices.

The below example illustrates searching for an external Infrastructure device by its MAC address.

The below example illustrates using the filter option to view external Tag devices by setting the Filter condition of Product and selecting the specific model of XYZ Beacon.