The Bluetooth GPS PSY Settings Storage API defines Central Repository keys for storing and retrieving the settings of the Bluetooth GPS PSY. The API is for developers who write applications to get and set Bluetooth GPS PSY settings.
The Bluetooth GPS PSY Settings Storage API is used for storing and retrieving the settings of the Bluetooth GPS PSY. The settings are stored in the Central Repository.
This API consists of a set of Central Repository keys defined in the header file BtGpsPsyPrivateCRKeys.h. Applications must link with the Central Repository library centralrepository.lib to use this API.
This API is a Central Repository type of API used for storing and retrieving the Bluetooth GPS PSY settings.
This API does not define any classes. It defines the Bluetooth GPS PSY Setting Storage Central Repository UID KCRUidBtGpsPsy and keys. The keys are defined in BtGpsPsyPrivateCRKeys.h.
The Bluetooth Settings Storage API supports the following operations:
Storing and retrieving the following GPS device settings:
Reading Bluetooth GPS PSY settings.
Some PSY settings are read only. Read only values can be modified by device creators as described in Modifying the Bluetooth GPS PSY Central Repository Initialisation File.
Changing Bluetooth GPS device settings
Some settings that describe the state of the connected Bluetooth GPS device have read and write permissions (see the table below).
Storing or retrieving Bluetooth GPS PSY Central Repository values
To change one of the read-write settings requires a client to have WriteDeviceData capability. A client does not need to have any capability to read key values. See Central Repository How To Guide for details of how to read and write the settings.
The following table describes the Central Repository keys.
| Keys | Description | Permission |
|---|---|---|
Whether the Bluetooth GPS Night Mode setting is off or on (value is 0 or 1). |
Read & Write |
|
Stores address of paired Bluetooth GPS device for future reference. |
Read & Write |
|
Stores information about whether connected Bluetooth device is a GPS device or not. Values are: |
Read & Write |
|
The minimum delay between messages that are sent to the Bluetooth device. Value is in microseconds. |
Read |
|
Defines the user equivalent range error used in GPS data error calculations. User equivalent range error is used for examining GPS positioning accuracy. Value is in metres. |
Read |
|
The number of test NMEA sentences expected. |
Read |
|
The delay between the initialisation messages sent to the GPS device. Value is in microseconds. |
Read |
|
The number of "set full power" messages to send when initialising the GPS device. |
Read |
|
The delay in waiting for a PNOK compatible BT GPS device to respond to a PNOK polling message. Bluetooth GPS PSY sends a PNOK polling message to Bluetooth GPS device to determine whether connected Bluetooth GPS device is PNOK compatible. Value is in microseconds. |
Read |
|
The time to wait between re-connection attempts. Value is specified in microseconds. |
Read |
|
If the PSY has received no tracking session or location request by the expiry of this timeout, the PSY goes into the standby state. In the standby state, the connection to Bluetooth GPS device is disconnected. Value is in microseconds. |
Read |
|
Specifies whether Bluetooth GPS device is in power saving mode or not. A value of 0 means power saving is disabled. Any other value means power saving is enabled. The power saving mode is where the device is powered on a certain amount of time at certain intervals and otherwise is turned off. |
Read |
|
Integer value that specifies the satellite information expiration time. Cached satellite information older than this value is not used. Value is in microseconds. |
Read |
|
The size of NMEA data buffer. |
Read |
The Bluetooth GPS PSY Settings Storage API does not define or use any error codes. Refer to the CRepository class description in Symbian platform reference for further details on error handling in the Central Repository API.
The Bluetooth GPS PSY Settings Storage API does not require any memory. The Central Repository API requires some memory to use the Bluetooth GPS PSY Settings Storage API.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.