atrwang / airlocate Goto Github PK

### AirLocate ###

===========================================================================
DESCRIPTION:

AirLocate shows how to use CLLocationManager to monitor and range CLBeaconRegions.
The code also provides an example of how you can calibrate and configure an iOS device as a beacon with CoreBluetooth.

You can configure an iOS device as a beacon as follows:

1) Obtain two iOS devices equipped with Bluetooth LE. One will be a target device, one will be a remote (calibration) device.
2) Load and launch this app on both devices.
3) Turn the target device into a beacon by selecting Configuration and turning on the Enabled switch.
4) Take the calibration device and move one meter away from the target device.
5) On the calibration device start the calibration process by selecting Calibration.
6) Choose the target device from the table view.
7) The calibration process will start. You should wave the calibration device from side-to-side while this process is running.
8) When the calibration process is done, it will show a calibrated RSSI value on the screen.
9) On the target device, go back to the Configuration screen and enter this value under Measured Power.

Note: The calibration process is optional, but recommended as it will fine-tune ranging for your environment.
You can configure an iOS device as a beacon without calibrating it by not specifying a measured power.
If a measured power is not specified, CoreLocation default to a pre-determined value.

Once you've setup your target device as a beacon, you can use this app to demo beacon ranging and monitoring.
To demo ranging, select Ranging from the remote device. ALRangingViewController ranges a set of CLBeaconRegions.
To demo monitoring, select Monitoring from the remote device. ALMonitoringViewController allows you to configure a CLBeaconRegion to monitor.

===========================================================================
RUNTIME REQUIREMENTS:

AirLocate is best viewed on an iPhone

===========================================================================
PACKAGING LIST:

ALCalibrationBeginViewController
ALCalibrationEndViewController

- View controllers for calibrating the measured power of a beacon.
- ALCalibrationBeginViewController allows you to choose a beacon to calibrate.
- ALCalibrationEndViewController shows you the calibrated measured power value for the chosen beacon.

ALCalibrationCalculator

- Calculates the measured power value for a chosen beacon.

ALConfigurationViewController

- View controller to configure this iOS device as a beacon.

ALMonitoringViewController

- View controller to monitor a specific beacon region.

ALRangingViewController

- View controller ranges a set of known beacon regions.


===========================================================================
Copyright (C) 2013 Apple Inc. All rights reserved.