Documentation

[ Building Beacon Maps (Mapper files) | API Documentation | Software Unlocking ]

Building Beacon Maps

If you have a Bluetooth GPS you can build your own beacon maps, or mapper files, using the POLS Stumbler and Log Cooker applications.

Before you run the Stumbler, you'll need to pair the phone with the Bluetooth GPS unit by following these steps. Note that they may differ slightly depending on the phone.

Pairing to the GPS

Windows Mobile 5.0

  1. Choose Start > Settings > Connections > Bluetooth.
  2. Enable Bluetooth, and choose Menu > Devices.
  3. Choose Menu > New, and choose your GPS device from the list.
  4. The GPS device should now be paired and a prompt for a name should appear. Press Next.
  5. Click the checkbox to enable the Serial Port service and press Done twice.
  6. Choose Menu > COM Ports and then Menu > New Outgoing Port.
  7. Select the GPS device and choose COM7.
  8. Choose Done and it'll be ready for stumbling.

Windows Mobile 2003 SE

  1. Choose Start > Configuration > BT SerialPortSetup.
  2. Check Outbound COM Port, and make sure the COM port shown is COM7.
  3. Choose Done and then OK. You'll now be taken to the Bluetooh Settings panel.
  4. Enable Bluetooth, and choose Menu > Devices.
  5. Choose Menu > New, and choose your GPS device from the list.
  6. Choose Done and it'll be paired.

Stumbling

You can start the Stumbler at Start > POLS > Stumbler and just choose Start once in the Stumbler. Once connected to the GPS, it will start displaying the current latitude and longitude on-screen. The generated logs are automatically named with a timestamp, and stored at either \Storage\POLSData\Logs or \Storage Card\POLSData\Logs, depending on whether or not you have a storage card installed.

Cooking the Logs

Log files from the stumbler need to be cooked into a mapper file to be used for localization. Cooking is the process of reading in a set of stumbler logs and estimating the true position of the observed cells/beacons. The cooked estimations get stored in a mapper file.

Cooking on the PC (using PCCookerSample)

First, verify that following directory structure exists on your PC: \Documents and Settings\your username\Application Data\POLSData\Logs If it doesn't exist, create it. To generate the mapper file over a set of stumbling logs place them in the above directory and run PCCookerSample.exe. The resulting mapper file will be stored in the POLSData directory.

Cooking on the Phone

In order to cook the mapper file make sure that the stumbling logs are located at \Storage\Application Data\POLSData\Logs or \Storage Card\POLSData\Logs (If the storage card is present).

To cook a mapper file start the PhoneLogCooker at Start > POLS > LogCooker and select Cook Logs from the menu. The application will go through the set of stumbling logs in the above directory and generate the corresponding mapper file that will be stored in the POLSData directory.



API Documentation

The POLS API documentation is available in HTML as well as self-contained Windows Help File format.

POLS also has a few components that are specific to the PC-platform. Documentation for these portions can be found in the following documentation sets:



Software Unlocking

Your phone needs to be software unlocked, which is not the same as SIM unlocked, in order to run POLS software. This is because the method used by the phone to access the cell info requires switching into kernel-mode, something not usually allowed by WindowsCE. Note that this also referred to as application unlocking.

You can refer to this guide for assistance in application unlocking your device.