Kontakt.io Plugin + Cisco Spaces
When you need to verify a Portal Beam's people detection or troubleshoot occupancy, you can capture a real-time thermal image using the Kio Setup Manager mobile app. The thermal image can confirm its field of view and people detection accuracy. Additionally, you can configure or update Exclusion Zones from the app.
Each the following troubleshooting actions must be performed locally at a Portal Beam. If these actions do not resolve an issue or you need further assistance, reach out to your Cisco Spaces Account Manager or submit a support request to Kontakt.io and our team will get you in touch with the right person.
Topics include:
Tip
Be sure you have the latest Kio Setup Manager mobile app.
To download the app, go to the App Store or Google Play. Search for Kio Setup Manager .
App requirements: Apple iPhone or iPad: iOS version 15 or later | Android phone or tablet: version 5.0 or later | Bluetooth enabled (on) | Internet connection
Capturing and viewing a Portal Beam's real-time thermal image can assist with troubleshooting occupancy counts.
From the image, you can verify the people detected or other non-human, stationary hot objects within its field of view. A hot object could be a TV, window, or other type of electrical device. It's best practice to configure any non-human, stationary objects as an Exclusion Zone. Re-capturing an image should also be performed if you have re-positioned a Portal Beam to validate its field of view and people detection.
Complete the following steps from the Kio Setup Manager mobile app.
-
From the list of Nearby Devices, locate the Portal Beam by its Unique ID or MAC address .
-
Tap the Portal Beam to access its profile.
(Optional) To verify the Portal Beam selected, tap Flash LED. From its front-side, a BLUE colored LED flashes briefly.
-
From its Troubleshooting section, tap Verify Thermal Camera > tap Capture Image.
-
From the captured image's heatmap, verify the objects detected.
If the thermal image does not accurately identify the people detected within the room, you may need to reposition the Portal Beam and re-take the thermal image.
If there are any non-human, stationary hot objects detected or areas you want to exclude from occupancy detection, you can configure these as Exclusion Zones. When a window allows direct sunlight into a room, it's recommended to configure the window as an Exclusion Zone.
-
From the top section of the image, tap the cloud icon.
The image is uploaded to the Portal Beam's Occupancy settings within the Kontakt.io Device Management Plugin. This image is a helpful troubleshooting resource.
Exclusion Zones are user-defined areas within the Portal Beam's field of view that are ignored by the Kontakt.io Occupancy Engine. These zones can include non-human, stationary objects with high background temperatures, such as TVs, light fixtures, windows, or other electrical equipment. Additionally, a zone can be a specific area within a large room where occupancy detection is not required.
Complete the following steps from the Kio Setup Manager mobile app.
-
From the list of Nearby Devices, locate the Portal Beam by its Unique ID or MAC address .
-
Tap the Portal Beam to access its profile.
(Optional) To verify the Portal Beam selected, tap Flash LED. From its front-side, a BLUE colored LED flashes briefly.
-
From its Troubleshooting section, tap Verify Thermal Camera > tap Capture Image.
-
Toggle on the Exclusion Zones. Configured zones are outlined in red.
-
To update or add a zone, tap Configure Zones.
-
Tap Add Exclusion Zone > draw a box around the object or area that's required to be excluded from occupancy detection.
Be sure the outline of the box only covers the actual object or area. If needed, you can create multiple zones.
-
Once complete, tap Next.
The image is uploaded to the Portal Beam's Occupancy settings within the Kontakt.io Device Management Plugin. This image is a helpful troubleshooting resource.
The following Portal Beam thermal images show how Exclusion Zones can be set to exclude objects or areas from occupancy detection. Each exclusion zone is outlined in red.
Hot objects: wall-mounted TV and window excluded from occupancy detection.
|
Captured thermal image |
TV and window set to exclusion zones |
Large room: two specific areas excluded from occupancy detection.
|
Captured thermal image |
Two areas set to exclusion zones |
The last thermal image shared from the Kio Setup Manager mobile app, can be viewed from the Kontakt.io Device Management Plugin.
-
Sign in to your Cisco Spaces account.
-
From a web browser, go to the below URL specific to your Cisco Spaces account region. If you're not already signed in to Cisco Spaces, you'll be prompted to sign in.
United States region: https://plugin-app.cloud.us.kontakt.io/device-management/
Europe region: https://plugin-app.cloud.uk.kontakt.io/device-management/
-
From the Inventory menu, select Infrastructure > locate and select the Portal Beam.
-
From its profile, select the Occupancy tab. The last image shared from the Kio Setup Manager app is displayed.
There may be situations where a recent Kontakt.io firmware release addresses an issue, provides improvements, or introduces a new feature. You can apply the firmware update immediately locally at the Portal Beam.
In the app, a blue up arrow icon displayed next to a Portal Beam indicates that a firmware update is available.
Complete the following steps from the Kio Setup Manager mobile app.
-
From the list of Nearby Devices, locate the Portal Beam by its Unique ID or MAC address .
(Optional) To verify the Portal Beam selected, tap Flash LED. From its front-side, a BLUE colored LED flashes briefly.
-
It's recommended to apply available firmware updates. Be sure allow a firmware update to complete before proceeding to the next step.
Allow the firmware update to complete.