/
Configure devices (add, remove, import, and export)

Configure devices (add, remove, import, and export)

Difficulty: expert

Learning Objectives

After reading this article, you’ll be able to:

  • Configure devices in Studio

  • Verify devices in Studio


 

  • Go to Workplace back-end Studio

  • Login with your credentials

 

It’s possible the add new devices manually or through batch import of many devices. Both methods are described here.

Add New Device

You can add a new Device by selecting

  • the location in menu item Spaces, where you can manually add a sensor via "Add New Device". The location will be filled in.

  • "Add New Device" button in menu item Devices

Add New Device in Studio

 

‪Select relevant Device Type. This will automatically link the device channel.

Enter Device ID as serial-number with all capitals and including the dashes (format is dependent on device type, see Install and Configure Gateways and Sensors ).

Enter a meaningful Device Name (for example company name_area/site name_floor number_zone).

Select a Location from the location tree if this is already known (field automatically filled in if location was selected before adding new device).

 

In case you want to mirror the data that comes in for 1 sensor to multiple locations, you can use Linked Locations (as 1 device ID can only be linked to 1 main Location in Workplace).

Next to the already selected (main/virtual) Room, you can visualize the same incoming data on workplaces for example.

For comfort data, you can also select a workplace as main Location and mirror the data on other workplaces.

Imagine having 1 comfort sensor in an open office space and you want to visualize this data on all 8 workplaces in that space: Linked Location needs to contain all 8 workplaces. (More information on Linked Locations: Live floorplan settings)

Selecting the correct Device Type, for example "Elsys ERS CO2" should automatically set the Sensor Types and Channels to "Temperature, Humidity and CO2" (see Advanced).

Import/Export

‪Best practice for batch import of devices is to work with an export that you then use as a basis to import

Export devices based on the filters used: the export will list all devices that appear in the overview

  • “Advanced Export” will include information on Type and Channel

  • any export taken in “Devices” menu point without any filters, will also include Disabled devices

Use Export as basis for Import: Configuration

Advanced: possible to remove or add sensor type/channels (for example pointgrab in headcount and/or footfall mode or for External Data Sources )

Check for the correct Device ID.

  • A sensor might list more information than needed. Check the Install and Configure Gateways and Sensors pages to know which format the sensor ID should resemble.

  • A Sensor ID might have a different format than what is required in Studio. Check the Install and Configure Gateways and Sensors pages to know how to modify the sensor ID.

  • Verify for typos, eg Tabs motion sensor ID is in HEX, so only 0-9; A-F characters are used. All letters are in CAPS.

Fill in Device Type, Device ID and location if already known:

Location ID, Workplace ID, Linked Location ID

Location mapping: in the Workplace back-end, each location has a unique location ID.

For example the Location ID for floor “2nd floor” in Spacewell Antwerp offices is “910000000004545”

 

If you want to map a device to a Room or Parking location, just fill in the Location ID field in the Import excel file.

If you want to map a device to a Workplace location, make sure this is embedded under a (virtual) room:

  • fill in Room ID in Location ID field in the Import excel file.

  • fill in Workplace ID in Workplace ID field in the Import excel file.

Use Linked Location ID field if (comfort or traffic) sensor data needs to be copied to those Linked Location(s).

Batch Import through excel file

Upon batch Import: only successful rows are imported. “Rejected due to errors” will not be imported

‪Upon import of Devices through excel, a connection might not be established right away. ‪It’s possible you need to wait some time before all devices connect to the Workplace Platform (“online device”).‪

Delete/Disable Device

‪Deleting devices is not possible through UI in Studio, it is however possible to disable them. Disabling will remove them from the (default) Devices overview, but they are still associated with your environment.

How to disable a device?

  • Disabling is possible manually through the “Disable” button on the Device Label (see Sensor Management).

  • Disabling is possible through the export/import, where you’ll find a column named “deleted at”, which will actually disable the sensor in Studio. Fill in any text in the relevant field before upload/import..

 

Manually disable device: Step 1. Select “Disable” Button

Step 2. Disabled device is

  • no longer listed in (default) Devices Overview

  • only visible in Device Overview when selecting “Health > Disabled”

Step 3. “disabled” Device Overview only shows all disabled devices for the tenant

What behavior can be expected from a disabled device?

A disabled device

  • is no longer tracking data: Disabling a device also disables the channels/types for that sensor

  • is no longer visible in Studio Spaces

  • is no longer listed in the (default) Devices overview

    • is only visible in Device Overview when selecting “Health > Disabled”

  • gets a separate “Disabled” status, meaning it’s no longer counted in the Device Health KPI (see in How to monitor Sensor Health)

    • this also means it’s not listed the Device Health Notifications (only listing devices in “To Check” and “Offline” state)

  • is still listed in the Devices export (column named “deleted at” will show date+time of when the device was disabled)

  • can be “claimed” by another tenant/environment

What happens when you enable a device again?

Disabling a device also disables the channels/types for that sensor.

Enabling a device will also enable all the channels/types for that sensor, as if it was a new set-up.

Move Device

In rare cases, it might be needed to move devices from one environment to another on Studio. To perform this operation, the below process should be followed:

  1. Login into Studio for the first tenant, where the device is registered right now.

  2. Disable the device from the device details screen.

  3. Logout from Studio.

  4. Login into Studio for the target tenant, where the device needs to be added.

  5. Add the device using the standard "Add device" procedure.

FAQ

How do I know which channel or type to configure for my sensor?

This information is provided in the configuration description per sensor, see Install and Configure Gateways and Sensors

 


 

Search

Search