Location-based Services · Topic 2 of 2

vBLE Engagement

Learn Juniper Mist vBLE engagement: the 8 element antenna array, the Mist SDK, cloud location, virtual beacons, wayfinding and the SUB-ENG subscription.

  • 6 min
In a nutshell
  • vBLE Engagement: APs transmit eight directional beams from the vBLE array; an SDK app listens.
  • Enable it in Organization > Site Configuration > Bluetooth based Location Services, or in a device profile.
  • App Wakeup adds a ninth omni beam, the super beacon.

What it is

vBLE engagement turns Juniper Mist APs into Bluetooth transmitters for indoor location. A mobile app built with the Juniper Mist SDK hears the BLE signals from the APs, the Mist cloud works out where the phone is, and the app uses that position for turn by turn wayfinding and proximity notifications.

The "virtual" in vBLE means there are no physical beacons to buy, place or power. Virtual beacons are simply drawn on the floor plan in the portal.

AP vBLE arraytransmitsBLE beamsPhone appwith Mist SDKsignal and sensor dataMist cloudcalculates locationx and yAppwayfinding and alerts

How it works

The vBLE antenna array

Each vBLE capable Juniper AP has a directional vBLE antenna array that sends out eight directional beams, driven by a single transmitter. Each beam points in a different direction, so a phone hears a different pattern of signal strengths depending on where it stands. (Juniper pages describe the array both as eight directional antennas and as a 16 element array; the eight beams are the constant.)

Enabling vBLE Engagement turns on the vBLE array for all APs at the site, and the APs start transmitting BLE signals for location and wayfinding.

Turning it on

  1. Select Organization > Site Configuration and choose the site.
  2. Scroll to Bluetooth based Location Services.
  3. Enable vBLE Engagement.
  4. Optionally enable App Wakeup.

App Wakeup makes the AP transmit a ninth, omnidirectional beam called a super beacon, which can trigger notifications in a Mist SDK enabled mobile app. The same settings can be applied in device profiles.

Location service enabledData sent to the Mist cloud
Only vBLE EngagementEvery second
vBLE Engagement and Asset VisibilityEvery 2 seconds

How the location is calculated

The phone does not calculate its own position. The SDK collects BLE signal strengths, combines them with the phone's own sensor data, and sends them to the Mist cloud about every second while the device moves. The cloud returns the x and y coordinates.

StepWhat happens
Probability surfacesThe floor plan is split into 1 meter squares. Each of the eight beams produces a probability surface, and the surfaces are combined to find the most likely point
Path loss modelThe path loss exponent (PLE) estimates expected signal strength across the map from antenna gain, orientation and ceiling height; the intercept is the expected power at one meter
Machine learningThe system starts with default path loss values for each device type and learns individual values as it collects estimates, adapting to RF changes without manual calibration

Because the model learns by itself, no manual calibration or site survey is needed. In the portal, an AP that has not yet been learned for a device is shown gray, and once all are learned they show green.

BLE readingsfrom SDKsent to cloudProbability surfaces1 meter gridcombined with ML path lossMost likely pointreturned to app

Virtual beacons

A virtual beacon is an object placed on the floor plan to trigger proximity based events in SDK enabled apps. It does not transmit or receive anything; it only defines a coverage area that the cloud compares with the phone's calculated location.

To add one: Location > Live View, choose the site and floor plan, open Settings and turn on Show Virtual Beacons and Show Virtual Beacons Coverage, then click Beacons and Zones and Add VBeacon. Drag it to the target area and Save.

In Quick Edit you set the Name and the Transmit Power. Transmit Power here only changes the size of the coverage circle shown on the map. The message or web page to launch when a visitor enters the area is configured as a push notification for user engagement.

Zones

Location zones are named rectangles on the floor plan, added from Beacons and Zones > Add Location Zone. Zones give entry and exit events for SDK clients, Wi Fi clients and assets, and feed occupancy and dwell time analytics.

Virtual beaconLocation zone
ShapeA point with a coverage circleAn area drawn on the map
Main useProximity notifications in the appEntry and exit events, occupancy and dwell analytics
Webhook topicvbeaconzone

Wayfinding

Turn by turn wayfinding needs three things: vBLE APs, the User Engagement subscription and an app built with the SDK. The administrator adds wayfinding paths to the floor plan, and push notifications can be set along the route. Juniper recommends drawing one long path for a single hallway, which reduces errors and gaps.

Exam tip

The SDK is the piece that makes engagement work. Without an SDK app on the phone, vBLE engagement gives no wayfinding and no notifications.

SDK client data can also be streamed with the WebSocket channel SDK Client RF Glass Info, or pushed with the site level webhook topics location-sdk, vbeacon and zone.

Subscription

vBLE engagement needs the User Engagement (SUB-ENG) subscription. SUB-ENG is a site level subscription, the count must match the number of APs in the site, and it is supported only on APs with vBLE support.

vBLE EngagementAsset Visibility
Who transmitsThe APThe BLE tag
Who listensThe phone app with the Mist SDKThe AP
SubscriptionSUB-ENGSUB-AST
Typical useWayfinding, proximity notificationsFinding equipment
Watch out

A virtual beacon is not a radio. If an option says a virtual beacon "broadcasts" a message, it is wrong; the cloud decides when the phone's location falls inside the beacon's coverage area.

Common mistakes

Installing battery beacons for Mist wayfinding. vBLE uses the AP's antenna array and virtual beacons on the map. No physical beacons are needed.

Thinking the phone computes its location. The SDK sends readings to the cloud, and the cloud returns the coordinates.

Expecting engagement on any AP. SUB-ENG is supported only on APs with vBLE support.

What to remember for the exam

  • vBLE Engagement: APs transmit eight directional beams from the vBLE array; an SDK app listens.
  • Enable it in Organization > Site Configuration > Bluetooth based Location Services, or in a device profile.
  • App Wakeup adds a ninth omni beam, the super beacon.
  • Location is computed in the cloud: 1 meter probability surfaces plus machine learned path loss; no site survey.
  • Virtual beacons are added in Location > Live View > Beacons and Zones and do not transmit.
  • Wayfinding needs vBLE APs, SUB-ENG and the SDK.
  • SUB-ENG is site level and only for APs with vBLE support.

Check yourself

  • A museum wants turn by turn directions in its visitor app. What does it need?

    vBLE APs with vBLE Engagement enabled, the User Engagement (SUB-ENG) subscription and an app built with the Juniper Mist SDK.

  • Does a virtual beacon transmit BLE signals?

    No. A virtual beacon only defines a coverage area on the floor plan; it neither transmits nor receives signals.

  • Where is a phone's location calculated with vBLE engagement?

    In the Mist cloud, which receives the SDK's readings about every second and returns the x and y coordinates to the app.

Topic 2 of 2 in Location-based Services

Test yourself on Location-based Services

The full Juniper JNCIA-MistAI JN0-253 question bank has 668 questions, with timed practice exams and an explanation for every answer.

This study guide is independent and is not affiliated with, endorsed by, or sponsored by Juniper. Vendor names, certification names and exam codes are trademarks of their respective owners and are used for identification only.