Configure devices (add, remove, import, and export)
Difficulty: expert
Content
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
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:
Login into Studio for the first tenant, where the device is registered right now.
Disable the device from the device details screen.
Logout from Studio.
Login into Studio for the target tenant, where the device needs to be added.
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