Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Troubleshoot the Juniper Mist SDK

This topic provides information about how to troubleshoot common issues when you develop and test your Juniper Mist™ Software Development Kit (SDK).

Note:

If you need general information about the SDK, see Juniper Mist SDK.

To build a customer-facing application using the Juniper Mist SDK, your system must meet the following requirements:

Prior to troubleshooting, ensure that you are using the correct API callbacks:

To troubleshoot the SDK, identify the potential issue and then apply the recommended remedy:

Table 1: SDK Issues and Remedies
Potential Issue Remedy

For iOS devices only: You receive SDK errors, or you cannot develop and test the project on the simulator. (Testing requires a Juniper Mist SDK-enabled device on which to run the SDK.)

Note:

This issue applies only to iOS devices.

Use the following sample app and sample code to run the project on the simulator:

Sample App (iOS only)

Sample Code (iOS only)

The floorplan doesn’t load, the blue dot is inaccurate, or the app doesn't work when you run it on a simulator.

  1. Confirm that the X,Y placement of the access points (APs) on the floorplan matches the physical placement of the APs in your deployment. See Manually Place an Access Point on a Floorplan.

  2. Scale the floorplan accurately. See Scale a Floorplan.

  3. Ensure that you are running the SDK on a device.

  4. Ensure that you enabled Bluetooth permission on the device.

  5. Ensure that the Mobile SDK secret is correct.

The blue dot is not accurate.

  1. Confirm that you are using the latest version of the SDK.

    To get the latest version, click the relevant link:

  2. Ensure that you placed your APs according to the deployment guidelines. See Access Point Placement for Location Services.

  3. Collect RF Environment recordings—specifically, the Received Signal Strength Indicator (RSSI) values—to see if the SDK receives a strong enough signal. See Troubleshoot Location Services Using the RF Environment.

Juniper Mist cannot receive virtual beacon notifications.

  1. Confirm that you placed the virtual beacons on the floorplan accurately.

  2. Ensure that the Name, Message, and Url fields are complete.

Juniper Mist cannot receive zone notifications.

  1. Confirm that you placed the zones on the floorplan accurately.

  2. Ensure that the zone has a name. See these topics:
The SDK returns invalid latitude and longitude values. To resolve this issue, follow the steps in Troubleshoot Incorrect Latitude and Longitude (SDK).