Skip to main content

Mist Configuration Manual - Knowledgebase / Blyott Manuals - Blyott Support & Assistance

Mist Configuration Manual

Authors list


INTRODUCTION


Welcome to the MIST configuration guide. Within this guide, we aim to provide you with useful information and guidance to make the connection to Blyott using MIST AP devices. Take kindly note, the purpose of this guide is to show you the basic connection with Blyott and external devices from MIST using our endpoint. Any additional information on setting the MIST device should be found in official MIST documentation.

Before we show you how to configure the Bloytt part, MIST has a deployment guide, being best practice for deploying Location services. Please see this link which can already give you some insight on the setup of the network. For the generic purpose, you can always point to this link for additional information on Mist and BLE. This guide can be downloaded as a PDF on this LINK.


I. CONFIGURE YOUR SITE ORGANIZATION


After you created the account on the „manage.mist.com“ and made sure your MIST AP device is powered and ready, sign in to create „Organization“:

 


1.Click „Create Organization“.

2. Enter your name and click „Save“.


You will now land on the MIST managing dashboard where you can see the following options on the left sidebar.

3. Go to „Organization“ then select „Site Configuration“.
 
 


4. Click „Create Site“ or select the existing Site of interest.


Here you can configure the site information based on your needs („Site Name“ and „Location“ are mandatory), but the most important options for connecting with Blyott are the following.


Access Points Note: APs with BLE technology needs to be added or claimed in “Access Points” for the created sites as they will listen to the Blyott tags and forward the required information.


II. ENABLE WEBHOOKS AND ADD OUR ENDPOINT


1. Click „Enable“ on the Webhooks section which will open the following:


2. Fill in your desired „Name“ of the Webhook.

3. Fill the following Blyott endpoint „URL“: https://proxylocator.blyott.com/webhook/mist 

4. Make sure to select „Raw data“ in the „Streaming API“ section.

The „Streaming API“ section is optional, based upon your needs. But for the basic configuration, you need to enable „Raw data which will be available on your screen. 


The next step is enabling vBLE in the „Bluetooth based Location Services“ section.


III: ENABLE vBLE ENGAGEMENT


In the „Bluetooth based Location Services“ section you will need to enable two options in order to set the connection.


  1. Enable „vBLE Engagement
     „App Wakeup“ is optional if you are going to use the MIST app (more info in the MIST manual above). This will enable vBLE array on ALL Mist Apps for the selected site.
  2. Enable „Asset Visibility
  3. After you filled all requirements for the Blyott connection, click „Save“ on the top right to save your Site.


IV. ADD A FLOOR PLAN


An additional configuration that is required is to add the floorplan and add the Mist APs on this map. This allows Mist to complete the webhook information that Mist will be sending out.

  1. Click on “Location”, then “Live view”.
  2. Click on the upper right “Add Floorplan”, enter desired name, and upload the Floorplan image.



V. MIST API DOCUMENTATION


While logged in the dashboard, you have the possibility to search MIST API documentation, where you can find everything related to Webhooks and API.


Example Delivery of “asset-raw” via http-post:

POST /uri/... HTTP/1.1

Host: hooks.abc.com:443
 User-Agent: Mist-webhook

Content-Type: application/json

Content-Length: 615

X-Mist-Signature: ce3af7760f1289d02bf6a7ad19f3214c4e5c7c2e

{

    "topic": "asset-raw",

    "events": [

        {
             "site_id": "4ac1dcf4-9d8b-7211-65c4-057819f0862b",

            "map_id": "845a23bf-bed9-e43c-4c86-6fa474be7ae5",

            "timestamp": 1461220784,


"device_id": "00000000-0000-0000-1000-5c5b35000001",

"beam": 5,

            "rssi": -71,


            "mac": "7fc2936fd243",

            "asset_id": "a8ec4d8a-4da6-4ead-a486-d0f72e40dd08",

            "ibeacon_uuid": "f3f17139-704a-f03a-2786-0400279e37c3",

            "ibeacon_major": 13,

            "ibeacon_minor": 138,


            "mfg_company_id": 935,

            "mfg_data": "648520a1020000"

        }

    ]

}


In this example, we see how Locator is identified and the format in which we need to add it on the Blyott Portal. For example "00000000-0000-0000-1000-5c5b35000001".


VI. ADD AP LOCATOR ON THE BLYOTT PORTAL


Before we start, I would recommend seeing our Onboarding Handbook for more details on Blyott Portal. 

We have also created a support portal containing information about the Blyott platform which you can access here. The support portal contains a knowledge base where you can find all relevant information about the platform including Blyott latest API documentation. Please don’t hesitate to contact our Blyott Support for any additional questions.


While on Blyott Dashboard, clicking on the “Locators” tab on the “List Views” panel, depending on your “Access Level”, you can see locators list with information like Locator Name, Location, Location Code, MAC, Type, Last Seen, Serial Number, IMSI, IMEI.


Add new Locator

To add Locators, click on the “+” (Add locator) button and fill in the following data:


  • Locator
     
    Enter desired locator name.
  • MAC*
     
    Enter the MAC ID of the device in the following format:
     
     "00000000-0000-0000-1000-MAC_ADDRESS-BEAM_NUMBER"
     
     Example: "00000000-0000-0000-1000-5C5B35000001-1".
  • Type
     
    Select Wi-Fi.
  • Location
     
    If “Type” is selected “WIFI”, you will need to create fixed locations in the “Location” tab before you can select the location. If you already have Locations, just select desired Location.
  • Hardware model
     
    Select “Mist | BLE-enabled”.
  • Serial Number
     
    Enter the serial number of the device.
  • IMSI
     
    Enter IMSI.
  • IMEI
     
    Enter the IMEI number of the device.

*Make sure to enter the correct MAC ID. This can be confirmed locally with your IT team and/or occasionally marked on the device. Enter the MAC address in capital letters and without the semicolons (:).


VII. IMPORTANT NOTES


8 locators on Blyott Portal

Make sure to add 8 Locators with the same MAC address on the Blyott Portal for your MIST AP device. In our example, you will need to add the following Locators:

00000000-0000-0000-1000-5C5B35000001-1
 00000000-0000-0000-1000-5C5B35000001-2
 00000000-0000-0000-1000-5C5B35000001-3
 00000000-0000-0000-1000-5C5B35000001-4
 00000000-0000-0000-1000-5C5B35000001-5
 00000000-0000-0000-1000-5C5B35000001-6
 00000000-0000-0000-1000-5C5B35000001-7
 00000000-0000-0000-1000-5C5B35000001-8

MIST device has 8 beams - let's imagine one MIST device with 8 beams is representing 8 Locators on the Blyott Portal. One MIST Locator replaces 8 Locators within its beams - using the same MAC address + beam number (from 1 to 8) in the Blyott Portal.

Once the locator(s) have been set up and are active, they can be searched for within the platform by selecting the ‘filter’ icon from the top right corner of the screen.


Activate the Blyott tag as an asset if needed

If needed, activate the Blyott tag as an asset in the Mist platform as this is the trigger to forward data. Under “Clients” > ”BLE clients” at the MIST dashboard you can activate the tag as an asset, optionally you can also use the API to activate the tag to become an asset.


VIII. ADDITIONAL INFORMATIONS 


Mist vBLE Array explained:

  • The Mist AP has a vBLE array, which consists of a 16 Directional Antennae Bluetooth Array. Eight unique antennas are reflectors to help with directing the BLE energy outward away from the AP, and the other eight unique antennas are directional antennas that point in eight different directions, transmitting BLE energy in a flashlight-like fashion. 
  • To better visualize this, imagine a flashlight shining narrow beams in eight different directions.

Mist AP Beams explained:

  • Each AP is transmitting on eight unique directional beams.
  • The Mist SDK on the device hears these beacons from the beams and sends the RSSI and device sensor information back to the Mist cloud. Through either wifi or cellular.
  • The more beams your device hears the more accurate your location will be, as there is more data for the location engine to make a better location estimate.

For asset tracking, like the Blyott tags, we listen to the output of the tag and forward that information via the webhooks to the Blyott server. 16 antenna = 8 for listening to tags/assets and 8 to send out data.


IX. BLYOTT SUPPORT & ASSISTANCE


Within this Help Center, we aim to provide you with useful information, documentation, and guidance that will enable you to make the most out of your access to the Blyott Platform. In the Knowledgebase section you can find a video walkthrough guide for the support page, Release Notes, Documentation, Manuals, and “How To” guides. Keep up to date with the information & articles you are interested in, by selecting the 'Subscribe' option and you will receive email updates every time we add new information.

For everything else do not hesitate to contact us at support@blyott.com.


Thank you for your attention.
 The Blyott Support Team

Helpful Unhelpful

Share