This guide provides step-by-step instructions for deploying a Kontakt.io occupancy solution, enabling accurate measurement of people footfall traffic. The solution utilizes Kontakt.io Portal Beams placed at entrances or interior spaces, which count people as they pass through an invisible threshold line.
Deployment involves setting up the Kio Cloud Platform and installing Kontakt.io Portal Lights (BLE to Wi-Fi gateway infrastructure devices) and Portal Beams. If your deployment includes integration with Cisco Spaces and Catalyst Access Points, Kontakt.io Portal Lights are only deployed when supplemental coverage is required.
This guide is intended for those responsible for system setup and device installation.
The following provides an overview of the steps to deploy a Kontakt.io occupancy solution. Before you begin, be sure also to review the Deployment Prerequisites.
If you are deploying a solution that consists of multiple use cases, such as both room and seat occupancy and asset tracking, steps 1 through 2 are the same for all use cases.
-
Step 1: Get Kio Cloud account
The first step of any Kontakt.io deployment is to create or sign in to your Kio Cloud account, Kontakt.io's cloud based platform.
-
Step 2: Add Devices
When you receive a Kontakt.io order, you’ll claim the Order ID to add the devices to your Kio Cloud account.
-
Step 3: Set up Smart Location
Kio Cloud Smart Location is the mapping of the physical environment - from each campus, building, and building floors along with digital floor plans.
Required to upload digital floor plan maps - supported files type include JPG, PNG, BMP, and TIFF.
This step is very important for location, occupancy, and tracking accuracy. Learn more about the Kontakt.io Location Engine Reference Architecture that highlights the importance of rooms and more.
-
Step 4: Install Devices
Each infrastructure device, Portal Lights and Portal Beams, must be set up and installed with the Kio Setup Manager app. This step is completed onsite at the device install locations.
For Footfall Traffic, a Portal Beam must be externally powered; battery power is for backup purposes only. Required AC power adapter: 110-220VAC to 12VDC power supply, DC jack 5.5mm.
-
Step 5: Explore Kio Cloud
Learn about monitoring and managing your deployed Kontakt.io devices and other system settings.
Before you begin, be sure you have what's required for deployment.
Commonly completed by those responsible for system administration.
-
Kontakt.io Order ID. Required to add the order's devices to your Kio Cloud account.
-
Digital floor plan for each building floor. Required for Smart Location setup. Supported files type include JPG, PNG, BMP, and TIFF.
-
Length of the building floors or longest section of the floors. During the floor plan setup in Smart Location, you will need to set reference points to allow the app to scale the floor plan to represent the size and layout of the actual floor space.
The longer the distance between the two reference points will result in a more accurate scale of the floor. It's recommended to set the two reference points using the entire floor length. Optionally, you can choose two reference points that are located on opposite walls and with a minimum distance of 5 feet (1.5 meters). This distance between the two reference points can be provided in feet or meters.
An Infrastructure device is a stationary device that is placed onto a ceiling or wall. These devices include Portal Lights that are BLE to Wi-Fi Gateways and Portal Beams that are room sensors providing occupancy measurements.
-
Site install plan that identifies the device install locations.
-
Portal Light network requirements are met.
-
Portal Light local Wi-Fi network settings (SSID and passphrase). The Wi-Fi network they will connect to at their installation locations.
Not required If Kontakt.io pre-configured the Portal Lights Wi-Fi network settings; requested when an order is placed.
-
Portal Light install locations meet the Portal Light placement guidelines.
-
Portal Beam install locations meet the placement guidelines and best practices.
-
Your Kio Cloud user account sign-in credentials.
-
Smartphone or tablet with internet and Bluetooth enabled/on.
The following provides Portal Beam placement and coverage area guidelines to achieve accurate occupancy. It's important to follow these guidelines when mounting and installing Portal Beams.
In some cases, obstructions or other conditions may require a Portal Beam to be mounted outside these guidelines.
When there is a deviation from these guidelines, consult with your Kontakt.io representative or submit a request to our support team for additional recommendations.
-
Ceiling mount only, facing downwards. Do not mount to a side wall or in the corner of a room or space.
-
Mount in the center of the room or space being monitored.
-
For optimal coverage and accuracy, mount at its maximum height of 10.6 ft (3.25 m) and do not mount below its minimum install height of 8.2 ft (2.5 m). Mounting above or below this range will affect the Portal Beam coverage area and accuracy.
-
Must have an unobstructed view of the area being measured. Do not mount where tall cabinets, hanging light fixtures, or other large stationary objects would obstruct its coverage area.
-
Place at least 4 to 6 ft (1.2 to 1.8 m) away from heat sources, including supply vents, lighting or large stationary fixtures, windows, and other electronic stationary devices.
-
Avoid mounting in the direct path of HVAC airflow ducts/vents or other heat sources.
-
Avoid mounting directly above an area where the sun heats the floor, near glass doors, or in the path of direct sunlight.
In footfall traffic mode a Portal Beam counts people entering and exiting a defined space.
The mounting placement guidelines vary by the two types of footfall traffic:
-
Doorway traffic - counts people as they enter and exit a room
-
Corridor traffic - counts people as they only pass through a space
To maintain an accurate count of people entering and exiting through a doorway:
-
Center the Portal Beam horizontally so that its thermal camera eye faces the doorway to ensure people are detected within its coverage area.
-
Mount on the non-door swing of the doorway to avoid the door obstructing its crossing line pathway and reducing its coverage area.
-
Mount as close to the doorway as possible, so that people are counted as they pass through the crossing line.
-
Do not mount where it would be obstructed by opening or closing the door or could risk being dismounted by opening or closing the door.
-
If a door is higher than a standard 6.8 feet (2 meters) and the interior door and opens to the inside of the room, place it closer to the doorway and verify that people are visible as they open or close the door.
To maintain an accurate count of people passing through a corridor pathway:
-
Center the Portal Beam above the corridor pathway entryway to ensure alignment with its crossing line. People are counted as they cross this invisible barrier.
-
Do not place near doorways or where two corridor entryways intersect.
The following provides the details on how to ceiling mount a Portal Beam by each available method.
A Portal Beam is supplied with 3M double-sided mounting tape, T-Bar ceiling mounting kit, mounting screws and anchors, and pre-installed batteries.
Optional accessories (sold separately): AC power adapter (110-220VAC to 12VDC power supply, DC jack 5.5mm)
Portal Beam is mounted to the ceiling using the supplied screws, anchors, and mounting plate.
-
Drill two mounting holes into the ceiling and insert supplied anchors.
-
Place the mounting plate against the ceiling and fasten it to the ceiling with the supplied screws.
-
Place Portal Beam into the mounting plate and rotate gently to lock it.
Portal Beam is mounted with a t-rail mount to a suspended ceiling.
-
Put all kit elements together.
-
Lock the t-rail to the suspended ceiling bar.
-
Screw standard mount to t-rail mount.
-
Place Portal Beam into the standard mount and rotate gently to lock it.
Warning
Recommended for use if the plate mount or T-bar ceiling mount cannot be performed or for use during a short-term mounting placement.
Portal Beam is mounted directly to the ceiling using the supplied 3M double-sided mounting tape.
-
Peel one side of mounting tape and affix it to the backside of the mounting plate.
-
Peel the other side of the mounting tape and affix it to the ceiling surface.
-
Align the mounting plate tape to the ceiling tape and press to secure.
-
Place Portal Beam into the mounting plate and rotate gently to lock it.
-
From a web browser, go to https://cloud.kontakt.io/register > enter your account profile information > select CREATE ACCOUNT.
A Kio Cloud account activation is sent to your email address. It may take a few minutes for the email to arrive.
-
From the Kio Cloud account activation email, select VERIFY YOUR ACCOUNT.
If you did not receive the email, check your Junk/Spam folder - the email is sent from hello@kontakt.io. If you need additional assistance, submit a request to our support team.
When you receive an order from Kontakt.io, you must add the devices to your Kio Cloud account. This process is commonly referred to as claiming an Order ID. An Order ID can only be claimed once by a single account. Once claimed, the devices are successfully added to your Kio Cloud account.
Important
If you are integrating with Cisco Spaces, Kontakt.io orders are claimed in your Cisco Spaces account. Learn how to claim an Kontakt.io order in Cisco Spaces.
You'll need the Kontakt.io Order ID that is located on the Quick Start Guide included in the order packaging and included in the order confirmation emails. Please do not add devices until the order shipment is received.
-
Sign in to Kio Cloud.
If you don't have an account yet, you'll need to register for one before you can proceed.
-
From the Launchpad, select Device Management 2.0.
-
From the Add Devices menu, select Claim Order > enter your Kontakt.io Order ID exactly as it appears (it's case sensitive) > select ADD DEVICES.
All of the order's devices are added to your account at once.
Receive a wrong Order ID error?
First, verify the Order ID is entered exactly as it appears. It's case sensitive and must contain all characters.
If this does not work, verify the Order ID was not previously used. An Order ID is a one-time use code. From your Kio Cloud account, go to Device Management 2.0 > select Beacons or Gateways. From the list, verify the Order ID does not already exist. If it does not exist, it may have already been claimed from a different Kio Cloud account.
If you continue to receive an error message, submit a request to our support team. They'll help resolve the issue.
Your Kontakt.io devices are ready to be deployed and installed!
Applies to Portal Beams that measure people footfall traffic
During this deployment step, you'll set up your Smart Location to map the facility locations - including each campus and its buildings, and the building floors and rooms.
Complete this step in the following order:
A campus is a collection of buildings. Many organizations are different - you may have just one or many campuses. For example, when you have facility locations in multiple cities, you'll create a campus for each location. Or maybe you have multiple buildings that are unique to their business services, you may then choose to have a campus for each business service location. Regardless of your organization's facility structure, deploying a Kontakt.io solution requires a single campus with a minimum of one building.
Quick demo of adding a campus and building.
If you have more than one campus, complete this step for each campus.
-
From the Launchpad, select Smart Location > select + ADD CAMPUS.
-
Enter the below campus information > when complete, select ADD.
-
Address: where the campus is located
-
Name: unique name of the campus
-
Description: for information purposes only
-
Campus image (optional)
-
A building is located in a campus. You may have one or multiple buildings in a single campus. Complete this step for each building.
-
Select + ADD BUILDING.
-
Enter the following building information > when complete, select Save.
-
Address: where the building is located (by default set to the campus address)
-
Name: unique name of the building
-
Description: for information purposes only
-
Building image (optional)
-
After buildings are added, you are now ready to add the building floors.
During this step, you'll first add a floor to a building that requires you to upload a floor plan.
Important
Be sure that you have a floor plan image file, sometimes called an indoor map, for each building floor.
JPG, PNG, BMP, and TIFF files are supported. The file size cannot be larger than 800 kB.
Quick demo of adding a floor and its floor plan.
-
Go to the Building, select + ADD FLOOR.
-
Enter the following floor information.
-
Level: what building level the floor is located on
-
Name: unique name of the floor
-
Floor Plan: select + to upload the floor plan file
-
You'll now set the floor plan one-time Reference Point and Floor Outline. This ensures the floor plan is scaled correctly.
Important
Once saved, the following settings cannot be changed.
-
From the list of floors, select the floor you created in the previous step.
-
Select CONFIGURE FLOOR.
-
Select SET POINTS.
Set POINT A by clicking on the first reference point on the floor plan (purple X appears) > set POINT B by clicking on the second reference point > enter the distance between the two reference points > select NEXT.
The longer the distance between the two reference points will result in a more accurate scale of the floor. It's recommended to set the two reference points using the entire floor length. Optionally, you can choose two reference points that are located on opposite walls and with a minimum distance of 5 feet (1.5 meters). This distance between the two reference points can be provided in feet or meters.
-
Select DRAW FLOOR OUTLINE.
Select either the rectangle or polygon tool, hold down your mouse pointer over the start point and release > then drag the points to outline the floor plan. A green line appears around the floor outline.
-
From the Floor Plan, verify that the calculated floor width and length measurements are accurate. This is calculated by the reference point measurement provided and the floor outline.
-
When complete, from the upper-right corner select SAVE AND CONTINUE.
You can now draw the floor's rooms.
When in Footfall Traffic mode, a Portal Beam counts people entering and exiting a space. Commonly, a Portal Beam is installed at an entrance or interior corridor and people are counted as they pass through the Portal Beam's invisible crossing line.
Unique to Portal Beam set to footfall traffic mode, setup requires adding both a Footfall location that is a virtual location and room that is the physical location within a floor where the Portal Beam is installed.
You will need to add a Footfall location to identify where people footfall traffic is being measured.
One room footfall traffic: if the Portal Beam is only measuring people entering and exiting one room, you'll create a single room where the Portal Beam is installed in (inbound room).
Two room traffic (adjacent spaces): if the Portal Beam is measuring the people traffic between two rooms, you'll create two rooms. One room where the Portal Beam is installed (inbound room) and the second room (outbound room).
For each Traffic Beam, you will create a room that identifies their planned installation location within a floor.
-
Go to the floor you're setting up > from the upper-right corner, select CONFIGURE FLOOR.
-
From the Room Outlines, select the type of room being added.
Room: an actual room with four interior walls (office, patient room, conference room).
Virtual Room: open space or area with no walls. A workspace with sofas or other collaboration-type space or a workstation area with multiple desks being measured by Portal Beam.
Corridor: location is a corridor, which may also be referred to as a hallway or walkway.
-
Enter a Name: uniquely identifies the room.
-
Room Number: numerical value unique to the room; duplicates are not allowed.
-
Select a drawing tool
or
> from the floor plan, place your mouse at the left upper-side of the room location > left click to begin drawing the room.
Now, you'll assign each Portal Beam to its room install location and Footfall location. During onsite installation with the Kio Setup Manager mobile app, a Portal Beam is re-assigned to its room.
-
Select the Beacons tab > select ADD TRAFFIC SENSOR WITHOUT DEVICE.
-
From Choose Beacon, select the Portal Beam.
-
Assign its Footfall location.
For one room traffic: from Add Inbound Footfall > select the Footfall location > select ADD. The Outbound Space is not assigned.
For two room traffic (adjacent spaces): from Add Inbound Footfall, select the Footfall location, and then from Add Outbound Footfall, select the Footfall location, select ADD. The Portal Beam will measure both the inbound and outbound traffic between the two Spaces' assigned rooms.
Deploying both Portal Lights and Portal Beams? First, configure and install each Portal Light and then the Portal Beams.
Be sure you have what's needed before you begin installing Kontakt.io devices.
-
Your Kio Cloud user account sign-in credentials.
-
Site install plan that identifies the device install locations.
-
Portal Light local Wi-Fi network settings (SSID and passphrase). The Wi-Fi network they will connect to at their installation locations.
Not required If Kontakt.io pre-configured the Portal Lights Wi-Fi network settings; requested when an order is placed.
-
Smartphone or tablet with internet and Bluetooth enabled/on.
-
Computer with internet.
During installation, the app is required and walks you through the setup and installation steps. If you already have the app, be sure you have the latest version.
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 11 or later | Android phone or tablet: version 5.0 or later | Bluetooth enabled (on) | Internet connection
These instructions provide the steps to get a Portal Light ready for use. A Portal Light is configured with the facility's Wi-Fi network settings, and once configured they are ready to be installed with Kio Setup Manager app.
Once you have completed the following steps, the Portal Light will scan for Kontakt.io IoT tags and devices and transmit the collected data to Kio Cloud via its connection to the facility's local Wi-Fi network.
If Kontakt.io pre-configured the Portal Light's WIFi network settings, go to the next step.
Important
For Enterprise Wi-Fi networks (TLS/TTLS/PEAP), submit a request to our support team. They will assist with the Portal Light network configuration.
For WPA (TKIP & AES), WP2, or Open Wi-Fi (WEP; Open & Shared) Wi-Fi networks, complete the following instructions.
Tip
If you have a handful to hundreds of Portal Lights, we recommend completing the Portal Light bulk configure and install instructions to set the WiFi network for multiple devices at the same time.
-
Sign in to Kio Cloud > select Device Management 2.0 > select Gateways.
-
From the list, select the Portal Light ID. It's Unique ID and MAC address is printed on the device.
-
Select the WiFi Connectivity tab > enter its WiFi Settings. This is the local network the Portal Light connects to at its install location.
-
WIFI Network SSID: this is case sensitive.
-
WiFi User Name: only when applicable and required to connect to network.
-
WiFi Password: passphrase (network password); case sensitive
-
Proxy Settings: for use with a Proxy Server on the network the Portal Light connects to. Provide the Proxy URL (https://) and Proxy Port.
-
-
Select Save Changes.
The Portal Light synchronizes with Kio Cloud during the next step to download its Wi-Fi settings.
Note
Fallback WiFi Settings. This is the Kontakt.io factory network and cannot be changed.
When a Portal Light cannot connect to its configured WiFi Network, it attempts to connect to this Fallback WiFi network.
This network can be used during installation or troubleshooting as a means for a temporary network connection through a mobile hotspot or local network.
Important
This step must be completed at the Portal Light install location.
During this step, a Portal Light synchronizes with Kio Cloud to download its Wi-Fi network settings.
-
Power on the Portal Light - plug into a standard grounded outlet.
-
From your mobile device, open the Kio Setup Manager app
> sign in with your Kio Cloud username (email address) and password.
-
Bring your mobile device close to the Portal Light > tap Install Devices > tap Portal Light Setup.
-
Follow the step-by-step instructions.
Tip
Have a problem with the app not finding a device, shows out of range and you are nearby, or it's not allowing you to perform an action?
From your mobile device, turn Bluetooth OFF and then ON again. Wait for the app to establish its connection to the Portal Light.
-
Verify the Portal Light LED is a solid green, which indicates it's connected to the local Wi-Fi network.
If its LED remains RED, it could not connect to the local Wi-Fi network. From Device Management, verify its network settings are correct.
You can also refer to the Portal Light LED indicators.
During this final install step, you'll place a Portal Light at its exact mounting location within its Smart Location room. This step is very important and required for all installed Portal Lights.
-
Sign in to Kio Cloud > from the Launchpad, select Smart Location.
-
Go to the Campus, Building, and Floor where Portal Light is installed.
-
From the upper-right corner, select CONFIGURE FLOOR > select the Gateways tab.
-
Select ASSIGN NEW GATEWAY > from the list, select the Portal Light > select ADD.
The Portal Light is placed at the center of the visible floor plan.
-
Select its edit icon (pencil) > from the floor plan, move the Portal Light icon to its actual location in the room > select SAVE
You'll complete this step at the Portal Beam install location using the Kio Setup Manager app. The app guides you through each step, including configuring and mounting the Portal Beam.
People are counted as they pass through the Portal Beam invisible barrier known as its crossing line that is set during installation with the Kio Setup Manager app.
When completing the onsite installation from with Kio Setup Manager app:
-
Be sure the crossing line is positioned perpendicular to the flow of people traffic.
-
Place the crossing line as close to the center of the image as possible.
-
Ensure the crossing line covers the doorway or corridor pathway.
-
Avoid setting the crossing line directly in the path of stationary objects that emit heat or other types of heat sources.
-
Avoid placing near large stationary objects right before or after the crossing line. For example, HVAC tubing or other large objects mounted to the ceiling.
-
Avoid setting the crossing line near sofas or other furniture where people can sit and continuously cross and pass through the crossing line.
Important
For Footfall Traffic, a Portal Beam must be externally powered; battery power is for backup purposes only. Required AC power adapter: 110-220VAC to 12VDC power supply, DC jack 5.5mm.
-
From the underside of the Portal Beam, switch its battery power to the ON position.
You will apply AC power during mounting.
-
From your mobile device, open the Kio Setup Manager app > sign in with your Kio Cloud username and password.
-
Once signed in, the app guides you through each step.
-
When you receive confirmation that the install is complete, continue to the next step.
During this step, you'll place the Portal Beam at its exact mounting location within its installed room from Kio Cloud Smart Location. When you assigned its location from the Kio Setup Manager app, the Portal Beam is automatically placed in the center of its assigned room location.
If the Portal Beam is installed at the center of the room, you can skip this step.
-
Sign in to Kio Cloud > from the Launchpad, select Smart Location.
-
Go to the Floor where the Portal Beam is installed and assigned to > from the upper-right corner, select CONFIGURE FLOOR > select the Beacons tab.
-
From the list, select the Portal Beam > select the edit (pencil) icon > from the floor plan, move the Portal Beam icon to its mounting location within its assigned room > select SAVE.
If you are responsible for the management and monitoring of the Kontakt.io solution and deployed devices, be sure to learn more about Kio Cloud. For our developer community, learn more about integrating with Kio Cloud APIs and SDKs.
Kio Cloud is Kontakt.io's cloud-based platform. It's where you can manage and monitor your Kontakt.io solutions and IoT devices. This include device management and monitoring, the mapping of the physical indoor environment, and managing user access.
Need to sign in to your Kio Cloud account? From a web browser, go to https://app.cloud.us.kontakt.io/.
-
The app where you'll set up and manage the map of the physical indoor environment that includes campuses, buildings, floors, and rooms. From each floor, you can view the real-time data for your Kontakt.io devices, including their location, occupancy, and telemetry data.
Smart Location setup is required for tracking, location, and occupancy-based services and solutions. It represents the Location Topology that is used by the Kio Cloud Location Engine that computes accurate, room-level data.
-
The app where you'll monitor and manage your Kontakt.io devices - from adding devices with your Kontakt.io Order ID, getting insights into your device inventory and statuses, to keeping devices up to date with the latest firmware and applying configuration changes.
Note
Currently, there are two Device Management apps. Device Management is the legacy app that will be sunsetted soon. Use of Device Management 2.0 is recommended.
Devices can also be managed through our Device Management API and SDKs.
-
The app designed to keep you informed about the state of your deployed Kontakt.io IoT devices. The app has several features including three available alert types, optional mediums for receiving alerts (email or text messages), and elective monitoring of devices (specific devices, device types, or devices in a particular location).
-
The app where you'll manage who has access to your Kio Cloud account.
Users will also find their unique API Key required to integrate with our APIs and SDKs.
-
The app where you can set policies that trigger events when a monitored condition set in a policy is reached and policy actions that serve as a notification method when an event occurs. The available types of policy actions include email and text messages, and stream events to an AWS Kinesis or Azure Event Hub Stream.
From a policy, you can set its monitored condition to trigger events for badge and tag button presses, occupancy thresholds, device battery levels, to device location events.
The Kio Cloud platform is the backbone of Kontakt.io solutions and offerings. It's open and flexible, allowing you to integrate with the platform data to build custom solutions unique to your requirements by using our APIs and SDKs alongside our IoT devices. Learn more about integrating with Kio Cloud.
Visit our Kontakt.io Developer Center explore our open APIs and SDKs.
-
Location & Occupancy API (REST & Streams). Real-time and historical Kio Cloud apps data including location tracking, occupancy, and the full spectrum of sensor data from Kontakt.io devices.
-
Device Management API (REST). Configure, monitor, and manage your Kontakt.io devices in Kio Cloud.
-
Mobile SDKs. Complete development libraries to power your own mobile apps.