lbsadminsettings.h File Reference

No setting

Self locate configuration for Home Network CLbsAdmin::TSelfLocateService

Self locate configuration when roaming CLbsAdmin::TSelfLocateService

Positioning quality profile for the Self Locate requests. Used when the application does not specify its own criteria. Profile definitions TBD. TProfileId

External locate configuration for Home Network.

Defines if external location requests (received from the network or from the Network Privacy API or the Privacy Request API) are processed. This setting is not checked when LBS is configured to use a Privacy Q&N Notifier (if KLbsSettingPrivacyHandler == CLbsAdmin::EPrivacyHandleByAdvancedNotifier) - requests are always sent to the Notifier.

The setting may be retrieved in two ways. The default setting may be read by using the CLbsAdmin::TExternalLocateService type when calling CLbsAdmin::Get(). By using the TLbsAdminExtLocServicesInfo type it is possible to get both, the default setting, and the module specific settings.

Module specific settings supersede the default setting.

CLbsAdmin::TExternalLocateService TLbsAdminExtLocServicesInfo KLbsSettingPrivacyHandler

External locate configuration when roaming. For additional information see KLbsSettingHomeExternalLocate.CLbsAdmin::TExternalLocateService TLbsAdminExtLocServicesInfo KLbsSettingPrivacyHandler

Positioning quality profile for the External Locate requests. Used when the application does not specify its own criteria. Profile definitions TBD. TProfileId

Emergency External locate configuration for Home Network. CLbsAdmin::TExternalLocateService

Emergency External locate configuration when roaming CLbsAdmin::TExternalLocateService

Send to 3rd party for Home Network CLbsAdmin::TTransmitLocateService

Send to 3rd party when roaming CLbsAdmin::TTransmitLocateService

Positioning quality profile for the Transmit to 3rd party requests. Used when the application does not specify its own criteria. Profile definitions TBD. TProfileId

GPS mode when in home network CLbsAdmin::TGpsMode

GPS mode when roaming CLbsAdmin::TGpsMode

Network Protocol module(s) for Home Network.

The setting may be retrieved in two ways. The Id of the default module may be read by using the TProtocolModuleId type when calling CLbsAdmin::Get(). By using the TLbsAdminProtocolModulesInfo type it is possible to retrieve a list of all the Protocol Modules to be loaded.

TProtocolModuleId TLbsAdminProtocolModulesInfo

Network Protocol module(s) when roaming. For details see KLbsSettingHomeProtocolModule.TProtocolModuleId TLbsAdminProtocolModulesInfo

System mode configuration CLbsAdmin::TLbsSystemStartMode

Privacy settings CLbsAdmin::TPrivacyTimeoutAction

Privacy Handler selection CLbsAdmin::TPrivacyHandler

LBS behaviour mode selection CLbsAdmin::TLbsBehaviourMode

Usage Logging This setting is designed to only be read on LBS system startup. Changing it via this API while LBS is running could cause undefined behaviour. CLbsAdmin::TLogger

Enabling LBS special features. Extra caution and full understanding of the effects is required when manipulating special features. A user MUST NOT be allowed to change them (e.g. through a UI Control Panel type application). A licensee must decide which features will be supported and fix them before a phone's release.

These settings are read-only.

KLbsSpecialFeatureMaximumRequestDelay KLbsSpecialFeatureAllowTBFinalNetPos KLbsSpecialFeatureIgnoreAccuracy KLbsSpecialFeatureWithholdDeliveryOfReferencePositions KLbsSettingLogger This feature allows LBS to temporarily buffer the following locations and errors: a single Reference Location from the network, a single Final Network Location from the network or a single Error Code from an AGPS Module.Reason for introducing the feature: When using RPositioner from the Location Acquisition API there are very short periods of time when the LBS subsystem has no outstanding location request. This happens when an application has received an asynchronous notification (CActive::RunL()) signalling completion of a previous request, but has not yet sent a new request by calling RPositioner::NotifyPositionUpdate().

The time is defined in milliseconds and is of TLbsTimeIntervalMilliSeconds type. Acceptable values are between 0 and KLbsMaximumRequestDelayMax (values above this report KErrAgrument) where 0 turns the feature OFF. Note that under normal circumstances using values greater than 100ms should not be required and suggests problems with a user application or platform performance (e.g. a high priority process is using nearly 100% of CPU time).

The feature must NOT be used to accommodate for badly behaving applications that do not reissue RPositioner::NotifyPositionUpdate() immediately.

This setting is read-only, and is disabled if a value of 0 is used.

TLbsTimeIntervalMilliSeconds KLbsSettingMaximumRequestDelay RPositioner::NotifyPositionUpdate() MLbsNetworkProtocolObserver::ProcessLocationUpdate()

This feature enables the delivery of Terminal Based Final Network Locations to a local application.

This feature may cause very serious side effects (including not up to date locations being reported to the client application) and must NOT be normally used.

This setting is read-only.

TSpecialFeature RPositioner::NotifyPositionUpdate() MLbsNetworkProtocolObserver::ProcessLocationUpdate()

This feature enables the delivery of reference positions to a local application that has opened the RPositioner by explicitly specifying the module ID.

This feature may cause very serious side effects (including not up to date locations being reported to the client application) and must NOT be normally used.

This setting is read-only.

TSpecialFeature RPositioner::NotifyPositionUpdate()

Specifies the Protocol Module loading strategy. There are two loading strategies supported. Loading just one Protocol Module saves memory, but requires the LBS system to be restarted in order to load a different module (e.g. after roaming status change). Loading all (both roaming and home) Protocol Modules uses more memory, but does not require restarting LBS when roaming status changes. The latter strategy should be used if emergency call support is required (to avoid memory allocation failures).

TLbsAdminProtocolModuleLoadingInfo

The maximum number of external locate requests that can be active at any time.

The value 0 is reserved for future use. The value 1 is the default, this allows only one active external locate request at a time. Values greater than 1 allow multiple requests to be handled simultaneously. Values up to KMaxTInt can be set, but memory limitations restrict the number of requests that can be supported. A privacy request will leave with error code KErrNoMemory if there is insufficient free memory to support it.

If the maximum number of simultaneous requests is reached, then any further requests are rejected. This setting is read only on LBS system startup. Setting it via the LBS Admin API has no effect while LBS running. Setting will take effect during next LBS system startup. MLbsPrivacyRequestObserver::OnPrivacyResponse() MPosVerificationObserver::HandleVerifyComplete()

The time to wait after the last privacy client disconnects before shutting down LBS. Only used with the Network Privacy API and the Privacy Request API. This setting is read only on LBS system startup. Setting it via the LBS Admin API has no effect while LBS running. Setting will take effect during next LBS system startup.

Time is specified in microseconds.

CPosNetworkPrivacy CLbsPrivacyRequest

The maximum number of concurrent network privacy sessions allowed with the Network Privacy API. This setting is read only on LBS system startup. Setting it via the LBS Admin API has no effect while LBS running. Setting will take effect during next LBS system startup.

The value 0 disallows any network privacy sessions

CPosNetworkPrivacy

The connection timeout for sessions using the Network Privacy API. This setting is read only on LBS system startup. Setting it via the LBS Admin API has no effect while LBS running. Setting will take effect during next LBS system startup.

Time is specified in microseconds.

CPosNetworkPrivacy

This feature enables the withholding of the delivery of reference positions to a local application that has opened the RPositioner by explicitly specifying a GPS module ID

TSpecialFeature RPositioner::NotifyPositionUpdate

Privacy Timeout Time in milliseconds that LBS will wait for a response from the privacy controller application / notifier A value of zero means never timeout/wait forever. KLbsSettingPrivacyAppTimeout TLbsTimeIntervalMilliSeconds

This feature enables the LBS subsystem to check for 'futile' GPS updates between location requests when LBS is working in either Terminal Assisted Mode or Simultaneous Terminal Assisted Mode & Terminal Based Mode (also known as Hybrid Mode).

The LBS subsystem does not normally return a location update to the network if it occurs while there is no outstanding location request from the network. This is normally the correct behaviour.

In Hybrid Mode or Terminal Assisted Mode, a licensee's GPS module may decide that there is no way of getting a GPS fix and return a 'futile' update during the session. If the update happens while there is no outstanding network request then it is ignored and the futile update is not sent to the network.

Turning this setting on enables the LBS subsystem to look for futile updates between location requests and to return the updates to the network.

This feature only applies when the LBS subsystem is working in Hybrid Mode or Terminal Assisted Mode. This feature may cause very serious side effects and must NOT be normally used.

This setting is read-only. TSpecialFeature

Network induced locate configuration for Home Network. CLbsAdmin::TExternalLocateService

Network induced locate configuration when roaming CLbsAdmin::TExternalLocateService

Licensee specific Set Clock Module Id. A null value means that a default, internal implementation should be used. TLbsSetClockModuleId

Automatic clock adjustment interval in microseconds. The value defines the time between consecutive attempts to automatically adjust the clock. Relevant only if automatic clock adjustment is enabled. CLbsAdmin::KLbsSettingClockAdjust CLbsAdmin::KLbsSettingClockAdjustThreshold

Automatic clock adjustment threshold in microseconds. If the difference between the system UTC time and the GPS based UTC time is less than the threshold then the system clock is not being adjusted. Relevant only if automatic clock adjustment is enabled. CLbsAdmin::KLbsSettingClockAdjust TTimeIntervalMilliSeconds

Allow the system clock to be adjusted manually (synchronised with GPS on user demand). CLbsAdmin::TClockAdjust

Synchronise the handset clock with the time obtained from GPS. CLbsAdmin::TClockAdjust