Beam Mini deployment and installation

Beam Mini + Cisco Spaces + Kio Cloud

To get room-level certainty outcomes with a Kontakt.io Beam Mini infrastructure and Cisco Spaces, you'll need to complete additional integration steps. These steps include the setup of Kontakt.io's Kio Cloud platform and installing Beam Minis with the Kio Setup Manager mobile app.

If you have any questions or need assistance, contact our support team.

Deployment overview

Prerequisites

Before you begin your deployment, the following prerequisites must be met.

• A Kontakt.io Kio Cloud account. If your organization doesn't have one, submit a Kontakt.io support request > Request a new account.

• A Cisco Spaces account with an Advantage or Premier license. Learn more from the Cisco Spaces Setup Guide.

• Cisco Spaces: IoT Services (Wireless) prerequisites are met.

  This includes controllers added and active, Access Points connected and added to Maps, IoT Manage Streams enabled, and Access Points synchronized.

  Refer to the Cisco Spaces: IoT Services Configuration Guide (Wireless) for complete details and instructions.

• Cisco Spaces Maps with floor images setup is complete.

Step 1: Claim Kontakt.io order in Cisco Spaces

Claiming a Kontakt.io Order ID in Cisco Spaces adds the order's devices to your Cisco Spaces device inventory. You'll need the Kontakt.io Order ID printed on the Quick Start Guide included in the order packaging. The Order ID is also in your order confirmation emails.

1. Log in to your Cisco Spaces account.

2. Go to IoT Services > Inventory.

3. Select Claimed Devices > Claim devices.

   

4. From Claim Devices, select BLE Tags & Sensors > Next.

   

5. Enter the Kontakt.io Order ID (it is case sensitive) > select Claim.

   

6. Verify the Kontakt.io devices were claimed: from Inventory > Claimed Devices, verify the devices are listed.

Step 2: Activate the Kio Cloud app in Cisco Spaces

This step activates the integration between your Cisco Spaces and Kio Cloud account.

1. From your Cisco Spaces account, go to the Home menu > Partner Apps.

2. Select Show all Partner Apps > search for Kontakt.io > select the Kontakt.io Kio Cloud app for your geographical location. For US and North America locations, select Kio Cloud and for UK and Europe locations, select Kio Cloud UK.

   

3. Select Activate.

Step 3: Get Cisco Spaces Device Management API Key

This API Key is unique to the Cisco Spaces account. You'll need it to synchronize your Kontakt.io devices with Kio Cloud in the next step.

1. From your Cisco Spaces account, go to IoT Services > Manage.

2. Select BLE Devices > select the MAC Address of a device.

   

3. From the Beacon Configuration section, select Advance Configuration > select Confirm.

   

4. From the Server API Key section, select the copy icon. You'll need this Server API Key in the next step.

   

Step 4: Synchronize Kontakt.io Devices with Kio Cloud

In this step, using your Cisco Spaces Device Management API Key, you'll complete a one-time setup to synchronize the Kontakt.io devices claimed in Cisco Spaces with your Kio Cloud account. Once complete, Kio Cloud automatically synchronizes daily with Cisco Spaces Device Management, allowing you to view and manage your devices from either platform.

1. Sign in to your Kio Cloud account.

2. From your Kontakt.io Launchpad, select Device Management.

3. From Add Devices > select Device Federation.

4. Enter in your Cisco Spaces Device Management API Key > select Create.

   

Step 5: Submit Cisco Spaces map import request to Kontakt.io

This step results in the Kontakt.io team importing your Cisco Spaces Maps into your Kio Cloud Smart Location. Once complete, you can access your maps from Smart Location.

To request a map import, submit a Kontakt.io Support Request.

Please include the following information: 

• Description: Cisco Spaces map import and activate Kio Workspace Insights app.

• Your contact details: name, phone number

• Cisco Spaces account detail (admin account)

• Your Kio Cloud account email address

• The Kontakt.io Order ID claimed within Cisco Spaces

Step 6: Download Kio Setup Manager and sign in

Once you receive confirmation from Kontakt.io that your integration is complete, it's time to install. A Beam Mini is a stationary, infrastructure device that requires installation with Kontakt.io's Kio Setup Manager.

Download Kio Setup Manager

Kontakt.io Infrastructure devices, those that remain in a fixed, stationary position, are required to be installed using Kio Setup Manager. 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.

• Device compatibility: iPhone or iPad: iOS version 17 or later | Android phone or tablet: version 8 or later

• Connectivity: Bluetooth enabled | Wi-Fi connection with Internet

Things to know

• User access requirements. You must be assigned to a Device Management role. A role determines your permission level and which devices you can access. For example, a user assigned the Device Management Administrator role has full permissions to all devices. For more information, see About user access to Device Management.

• Account type. You'll need to know if your organization's account is a Tenant or Non-Tenant type. You can identify the account type from the URL used to sign in from a web browser.

  Tenant account type: You sign in to Kio Cloud from an unique URL that includes the Tenant ID. Example: https://[Tenant ID].app.cloud.[us or uk].kontakt.io.

  Non-Tenant account type: You sign in to Kio Cloud from https://app.cloud.us.kontakt.io or https://app.cloud.uk.kontakt.io.

• Account Region. During sign in, you'll need to select the region of your organization's account.

  The Region is also located in the account URL (https://[Tenant ID].app.cloud.[us or uk].kontakt.io).

Kio Setup Manager sign in steps

1. From your mobile device, open Kio Setup Manager.

   The first time you sign in, or after you reinstall the app, you complete all of the following steps. After you sign in, the app remembers your Region and Tenant ID.

2. Select a Sign in Method > tap Kio Cloud Account.

   Cisco Spaces Account: for use when installing Kontakt.io Portal Beams integrated with Cisco Spaces.

   Sign in with Kontakt.io QR code: for use only when instructed by the Kontakt.io team.

   

3. Select Region > tap the geographic location of your organization's Kio Cloud account.

   United States: North America and Asia/Pacific locations.

   United Kingdom: UK and European locations.

   Custom Region: only select when instructed by the Kontakt.io team.

   

4. Enter your organization's Tenant ID, based on how your organization signs in to Kio Cloud (see Account type in Things to know):

   • Tenant account (most organizations): enter your organization's Tenant ID > tap Continue. The Tenant ID is the first part of your Kio Cloud sign-in URL, for example https://[Tenant ID].app.cloud.[us or uk].kontakt.io.

     

   • Non-Tenant account: if you sign in to Kio Cloud from https://app.cloud.us.kontakt.io or https://app.cloud.uk.kontakt.io, tap I don’t have Tenant ID.

5. The Kio Cloud sign-in page opens. Sign in with your Kio Cloud user credentials (email and password, or SSO).

Step 7: Install Beam Mini with Kio Setup Manager

Before you begin, be sure you're familiar with the Beam Mini placement and coverage and mounting instructions.

1. Unbox and power on the Beam Mini; from its underside, move its battery switch to the ON position.

   Recommended: write down its MAC address and Unique ID located on its underside. Once the Beam Mini is mounted, this information will not be visible.

2. From Kio Setup Manager, tap Install > Beam > Beam Mini.

   To start from a nearby device instead, tap Devices > tap the Beam Mini being installed > Install Your Device (iPhone or iPad) or Install Device (Android). The app skips the next step.

3. Identify the Beam Mini: scan its QR code or tap Enter MAC / Unique ID and enter its MAC address or Unique ID (both printed on the device). You can also tap Scan Nearby Devices and tap the Beam Mini in the list.

   The app verifies that the device exists in Kio Cloud.

4. Tap Choose location > select the campus, building, floor, and room > tap Next.

5. On the floor plan, drag the Beam Mini icon to its location in the room where you'll mount the device > tap Next.

6. The app applies the Beam Mini configuration over Bluetooth. Keep your mobile device near the Beam Mini until it completes.

7. (Optional) Add a device note > tap Next. The app saves the Beam Mini's location to Kio Cloud.

8. The app displays Installation Success!

   To install another one, tap Install next Beam Mini.

9. Mount the Beam Mini. Follow the mounting instructions.

10. (Optional) Test the Beam Mini IR coverage. You'll need one of these Kontakt.io tags in the same room: Smart Badge, Smart Badge 3 Mini, Asset Tag 2, or Asset Tag 2 Mini.

    1. From Installation Success!, tap Test Your Device > IR Test.

       If you already left that screen, tap Devices > tap the Beam Mini > Test IR.

    2. Tap Add Tag > scan the tag's QR code, or tap Enter MAC / Unique ID and enter its MAC address or Unique ID. If prompted, tap Next.

    3. The app displays IR Test finished successfully when the tag detects the Beam Mini's IR signal in the same room.

       If the app displays IR Test failed, make sure the tag is in the same room and near the Beam Mini, then tap Retry.

    From Test Your Device, you can also perform the Cloud Connection Test to verify that the Beam Mini's data reaches Kio Cloud through a gateway (requires a Portal Light).

Get room-level certainty outcomes

By activating Kontakt.io's suite of Kio RTLS apps, you can get outcomes with room-level certainty almost instantly.

• Asset Tracker: track and locate assets in real-time with your Beam Mini infrastructure and Kontakt.io Asset Tags.

• Staff Safe: enhance staff safety with real-time duress alerts with your Beam Mini infrastructure and Kontakt.io Smart Badges.