Collapse all Symbian^3 Product Developer Library

LBS in Standalone Privacy Mode

This document describes the steps necessary to configure the LBS subsystem with the Privacy Protocol Module.

Introduction

When the Privacy Protocol Module (PPM) is loaded by LBS, the subsystem can handle privacy requests from the network, but not location requests. Location requests must be processed in the device domestic OS.

LBS is said to be in Standalone Privacy Mode when it is configured in this way.

In this configuration LBS can handle:

Location requests from installed applications
Privacy requests from processes running in the device domestic OS

Logically this subsystem can be considered to contain two separate parts (shown in Figure 1):

The Location Server Framework and supporting PSYs
Standalone Privacy Mode components

These are the components of the Symbian platform that are necessary for processing privacy requests from the device domstic OS and include the Network Gateway, Network Request Handler and the Privacy Protocol Module.

Subsystem components

Figure 1 shows the components and files (in green) that you may create or edit in order to create a working LBS subsystem.

All of the LBS processes are transient in this configuration. Processes for handling privacy requests are started when the first privacy request is received. The processes are shutdown after the last privacy request is processed. See Network Privacy API Reference for more details about startup and shutdown sequences.

The Privacy Protocol Module allows LBS to receive privacy requests from the device domestic OS. With the Privacy Protocol Module installed, the Symbian platform LBS components cannot process location requests from the network. Only the privacy part of a request can be handled.

If you build the LBS subsystem in this configuration it is your responsibility to develop a solution to handle location requests from the network.

Note: this subsystem configuration cannot be used to support emergency services location request from the network.

Figure 1. Figure 1. LBS Subsystem with the Privacy Protocol Module. Location Server Framework is on the left, with Standalone Privacy Mode components on the right.

Integration and configuration tasks

This section lists the tasks that may be required to build and configure a working LBS subsystem. Tasks are categorised as required or optional.

[Required] Create a Standalone Privacy Mode client process.
[Required] Create a Privacy Handler (either a Privacy Controller or Privacy Notifiers).

A privacy handler is required to inform the user when privacy requests are received from the network.
[Required] Modify the LBS Default Administration Settings File 1028224B.cre.

It is necessary to configure LBS settings to load the Privacy Protocol Module on startup.
[Required] Modify the LBS Root Process File 10282266.cre to start only those LBS processes necessary for this configuration and to add the Privacy Controller application (if one is used). In this subsystem configuration Privacy Controller startup is managed by the LBS Root process.
[Optional] Create a Positioning Plug-in (PSY) to interface with integrated positioning hardware.

You can use the Positioning Plug-in (PSY) API to develop plug-ins that integrate directly with positioning hardware, possibly using proprietary interfaces and protocols.

Note: When the Privacy Protocol Module (PPM) is installed it is not possible to use A-GPS or cell-based positioning via Symbian platform components because the PPM is not a fully functional Network Protocol Module.

If you want to use both the Privacy Protocol Module and A-GPS or cell-based positioning you must implement your own PSY(s) to obtain A-GPS assistance data and cell position data from the device domestic OS.
[Optional] Create an LBS Settings Application.

Creating a settings application is only necessary if you want to give end users the ability to modify LBS settings at runtime. LBS provides the LBS Administration API and the Location Settings API to modify LBS settings at runtime.
[Optional] Create applications to use the Location Acquisition API.

The Location Acquisition API can be used to create applications that use location data, such as navigation and location stamping applications. This API can be used by device creators and by third party application developers.
Build a ROM

The following documents give additional information about LBS configuration:

Configuration Files for Standalone Privacy Mode gives a list of the LBS configuration files that you can modify.

Parent topic: LBS Integration and Configuration Guide

Related concepts

Integration and Configuration Guide Overview

LBS Architecture Overview

Network Privacy API

Privacy Request API