<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-3319E01A-F500-5F5C-9798-351C6F3EC583" xml:lang="en"><title>Updating

the GPS/A-GPS Central Repository Initialisation File </title><shortdesc>This shows how to modify the settings of the GPS/A-GPS PSY and

the A-GPS Integration Module so that they do not conflict with each other. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context><p>As described in <xref href="GUID-D0C20045-FCC5-53CB-BBDB-7AA058C9139E.dita">GPS/A-GPS

PSY Overview</xref>, the GPS/A-GPS PSY does not integrate directly with positioning

hardware. It uses the A-GPS Location Manager with an A-GPS Integration Module

to connect the Location Server (<codeph>eposserver.exe</codeph>) to positioning

hardware. </p> <p>The same A-GPS Integration Module can be used by both the

GPS PSY and the A-GPS PSY, potentially at the same time. There are two places

that information about the properties of the GPS/A-GPS PSY and A-GPS Integration

Module are stored: </p> <ul>

<li id="GUID-E71A7995-B0EA-523A-BEF3-D677086C18B8"><p>The GPS/A-GPS PSY registers

itself as a PSY with the LBS subsystem using a Central Repository initialisation

file with keys defined by the <xref href="GUID-DA2DC704-CE65-54FB-9049-4E1C73092EDF-GENID-1-12-1-19-1-1-10-1-5-1-5-1-8-1.dita">Positioning

Plug-in Information API</xref>. The GPS PSY and the A-GPS PSY have separate

initialisation files. </p> </li>

<li id="GUID-ADDBC706-ACE3-544F-9CD4-EC5F4DD95445"><p>The A-GPS Location Manager

uses a <codeph>.ini</codeph> file that specifies the properties

of the A-GPS Integration Module. </p> </li>

</ul> <p>The description of the properties of the PSY and the Integration

Module must be the same in both files. </p><p>The following procedure assumes

you have created an A-GPS Integration Module for your device's positioning

hardware and have created a module .ini file that correctly describes the

properties of the positioning hardware. The format of the .ini file is described

in <xref href="GUID-5DD17088-1F9C-5810-8143-5067A2B18330.dita">A-GPS Location Data

Source API</xref>. An example file containing some typical values is shown

below. Your A-GPS Integration Module may have different parameters: </p><codeblock xml:space="preserve"># example_datasource.ini

[1]

Version= 0.2.1		#

ModuleId= 271064388	# dec

ModuleName= "Example_AGPS_Module”

TechnologyType= 0101	# binary

DeviceLocation= 1	# binary

Capabilities= 11111	# binary

ClassesSupported= 111111	# binary

TimeToFirstFix= 90000	# ms

TimeToNextFix= 1000	# ms

HorizontalAccuracy= 5.4 # real

VerticalAccuracy= 5.4 # real

CostIndicator= 2	# dec

PowerConsumption= 2	# dec

DataSourceId= 271065673	# dec

ExecutableName= "lbsgpslocmanager.exe"

DeviceGpsModeCaps=1011	# binary - Exclusive TA OR TB (+ Autonomous)</codeblock> </context>

<steps id="GUID-20C3ADEC-CF35-5A8E-903E-E32D7CDD004B">

<step id="GUID-E4B40CA8-FFC8-570D-87BA-530E796695E5"><cmd>If you want to use

the A-GPS PSY with your Integration Module, modify the Central Repository

initialisation file(s) for the PSY so that the values are the same as those

in your Integration Module .ini file. </cmd>

<info>The Central Repository initialisation file for the A-GPS PSY implementation

supplied with the Symbian platform is in <filepath>datasourcemodules\lbsposfwadaptation\lbsgpsagpspsy\lbsagpspsy\cenrep\10285abc.txt</filepath>.

The version supplied with the Symbian platform contains the following: </info>

<stepxmp><codeblock id="GUID-3EB956AB-8D32-548E-A9FF-E6712631B43A" xml:space="preserve">

cenrep

version 1

[owner]

0x101f97b2

[defaultmeta]

 0

[platsec]

 cap_rd=ReadDeviceData cap_wr=WriteDeviceData

[Main]

0x1 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0x2 int 0 0 cap_rd=alwayspass cap_wr=alwaysfail

0x3 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0x4 int 90000000 0 cap_rd=alwayspass cap_wr=alwaysfail

0x5 int 1000000 0 cap_rd=alwayspass cap_wr=alwaysfail

0x6 real 5.4 0 cap_rd=alwayspass cap_wr=alwaysfail

0x7 real 5.4 0 cap_rd=alwayspass cap_wr=alwaysfail

0x8 int 2 0 cap_rd=alwayspass cap_wr=alwaysfail

0x9 int 2 0 cap_rd=alwayspass cap_wr=alwaysfail

0xa int 5 0 cap_rd=alwayspass cap_wr=alwaysfail

0xb int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0xc int 31 0 cap_rd=alwayspass cap_wr=alwaysfail

0xd int 31 0 cap_rd=alwayspass cap_wr=alwaysfail

0xe int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0xf string "\\resource\\lbsagpspsy_name.rsc" 0 cap_rd=alwayspass cap_wr=alwaysfail

0x10000000 int 2000000 0 cap_rd=alwayspass cap_wr=alwaysfail

</codeblock> </stepxmp>

<info>For a full description of the meanings of these keys, see <xref href="GUID-DA2DC704-CE65-54FB-9049-4E1C73092EDF-GENID-1-12-1-19-1-1-10-1-5-1-5-1-8-1.dita">Positioning

Plug-in Information API</xref>. </info>

<info>The important keys for this task are as shown in the following table: </info>

<stepxmp><table id="GUID-A227F71E-9B87-54D7-ABDF-4C29D1CF6F37">

<tgroup cols="4"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/>

<thead>

<row>

<entry>Key name</entry>

<entry>Key value</entry>

<entry>Meaning</entry>

<entry>Description</entry>

</row>

</thead>

<tbody>

<row>

<entry><p> <codeph>KPSYTimeToFirstFix</codeph>  </p> </entry>

<entry><p> <codeph>0x4</codeph>  </p> </entry>

<entry><p>Time to First Fix </p> </entry>

<entry><p>This must be the same time as the <codeph>TimeToFirstFix</codeph> value

in your Integration Module .ini file. </p> <p> <b>Important note: In the PSY

file the time is specified in microseconds. In the Integration Module .ini

file the time is specified in milliseconds.</b>  </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYTimeToNextFix</codeph>  </p> </entry>

<entry><p> <codeph>0x5</codeph>  </p> </entry>

<entry><p>Time to Next Fix </p> </entry>

<entry><p>This must be the same time as the <codeph>TimeToNextFix</codeph> value

in your Integration Module .ini file. </p> <p> <b>Important note: In the PSY

file the time is specified in microseconds. In the Integration Module .ini

file the time is specified in milliseconds.</b>  </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYHorizontalAccuracy</codeph>  </p> </entry>

<entry><p> <codeph>0x6</codeph>  </p> </entry>

<entry><p>Horizontal Accuracy </p> </entry>

<entry><p>This must be the same as the <codeph>HorizontalAccuracy</codeph> value

in your Integration Module .ini file. The value is specified in metres. </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYVerticalAccuracy</codeph>  </p> </entry>

<entry><p> <codeph>0x7</codeph>  </p> </entry>

<entry><p>Vertical Accuracy </p> </entry>

<entry><p>This must be the same as the <codeph>VerticalAccuracy</codeph> value

in your Integration Module .ini file. The value is specified in metres. </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYCostIndicator</codeph>  </p> </entry>

<entry><p>0x8 </p> </entry>

<entry><p>Cost Indicator </p> </entry>

<entry><p>This must be the same as the <codeph>CostIndicator</codeph> value

in your Integration Module .ini file. The value is an integer taken from the <xref href="GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D.dita#GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D/GUID-78C084A0-43F8-3040-BD98-70E2E62A5D45"><apiname>TPositionQuality::TCostIndicator</apiname></xref> enum. </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYPowerConsumption</codeph>  </p> </entry>

<entry><p> <codeph>0x9</codeph>  </p> </entry>

<entry><p>Power Consumption </p> </entry>

<entry><p>This must be the same as the <codeph>PowerConsumption</codeph> value

in your Integration Module .ini file. The value is an integer taken from the <xref href="GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D.dita#GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D/GUID-AD77543D-625A-39CF-A1D5-F5B5636E17F7"><apiname>TPositionQuality::TPowerConsumption</apiname></xref> enum. </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYTechnologyType</codeph>  </p> </entry>

<entry><p> <codeph>0xa</codeph>  </p> </entry>

<entry><p>Technology Type </p> </entry>

<entry><p>This must be the same as the <codeph>TechnologyType</codeph> value

in your Integration Module .ini file. The value is taken from the <xref href="GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26.dita#GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26/GUID-03AF8C51-1CAF-3F4C-BED1-17844FAE8423"><apiname>TPositionModuleInfo::_TTechnologyType</apiname></xref> enum. </p> <p> <b>Important

note: In the PSY file the value is specified as decimal integer. In the Integration

Module .ini file the value is specified in binary.</b>  </p> <p>In the files

shown above, the value of 5 for this key specifies that the PSY/Integration

Module supports a technology type of <codeph>ETechnologyTerminal</codeph> + <codeph>ETechnologyAssisted</codeph> =

1 + 4 = 0101 in binary. </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYCapabilities</codeph>  </p> </entry>

<entry><p> <codeph>0xc</codeph>  </p> </entry>

<entry><p>Device Capabilities </p> </entry>

<entry><p>This must be the same as the <codeph>Capabilities</codeph> value

in your Integration Module .ini file. The value is taken from the <xref href="GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26.dita#GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26/GUID-4A84D57F-D202-3F79-8094-139D69630C6D"><apiname>TPositionModuleInfo::_Capabilities</apiname></xref> enum. </p> <p> <b>Important

note: In the PSY file the value is specified as a decimal integer. In the

Integration Module .ini file the value is specified in binary.</b>  </p> <p>In

the files shown above the value of 31 for this key specifies that the PSY/Integration

Module supports the capabilities: <codeph>ECapabilityHorizontal + ECapabilityVertical

+ ECapabilitySpeed +                         ECapabilityDirection + ECapabilitySatellite </codeph> =

31 decimal or 11111 in binary. </p> </entry>

</row>

<row>

<entry><p> <codeph>KPSYClassesSupported</codeph>  </p> </entry>

<entry><p> <codeph>0xd</codeph>  </p> </entry>

<entry><p>Supported Positioning classes </p> </entry>

<entry><p>This must be the same as the <codeph>ClassesSupported</codeph> value

in your Integration Module .ini file. The value is taken from the <xref href="GUID-BC8B2D08-1B64-35BB-8F58-4E7123650BD7.dita"><apiname>_TPositionInfoClassType</apiname></xref> enum. </p> <p> <b>Important

note: In the PSY file the value is specified as decimal integer. In the Integration

Module .ini file the value is specified in binary.</b>  </p> <p>In the files

shown above the value of 31 for this key specifies that the PSY/Integration

Module supports the positioning classes: <codeph>EPositionGpsMeasurementInfoClass

+ EPositionCourseInfoClass +                         EPositionGenericInfoClass

+ EPositionInfoClass</codeph> = 31 decimal or 11111 in binary. </p> </entry>

</row>

</tbody>

</tgroup>

</table> </stepxmp>

</step>

<step id="GUID-CFB743FE-C90C-569D-B1CD-433930702B07"><cmd>If you want to use

the GPS PSY with your Integration Module, modify the Central Repository initialisation

file(s) for the PSY so that the values are the same as those in your Integration

Module .ini file. </cmd>

<info>The Central Repository initialisation file for the GPS PSY implementation

with the Symbian platform is <filepath>datasourcemodules\lbsposfwadaptation\lbsgpsagpspsy\lbsagpspsy\cenrep\102869C7.txt</filepath>.

It contains the following: </info>

<stepxmp><codeblock id="GUID-63A5B375-F712-5515-A985-5F54BCD52AD9" xml:space="preserve">

cenrep

version 1

[owner]

0x101f97b2

[defaultmeta]

 0

[platsec]

 cap_rd=ReadDeviceData cap_wr=WriteDeviceData

[Main]

0x1 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0x2 int 0 0 cap_rd=alwayspass cap_wr=alwaysfail

0x3 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0x4 int 90000000 0 cap_rd=alwayspass cap_wr=alwaysfail

0x5 int 1000000 0 cap_rd=alwayspass cap_wr=alwaysfail

0x6 real 5.4 0 cap_rd=alwayspass cap_wr=alwaysfail

0x7 real 5.4 0 cap_rd=alwayspass cap_wr=alwaysfail

0x8 int 2 0 cap_rd=alwayspass cap_wr=alwaysfail

0x9 int 2 0 cap_rd=alwayspass cap_wr=alwaysfail

0xa int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0xb int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0xc int 31 0 cap_rd=alwayspass cap_wr=alwaysfail

0xd int 31 0 cap_rd=alwayspass cap_wr=alwaysfail

0xe int 1 0 cap_rd=alwayspass cap_wr=alwaysfail

0xf string "\\resource\\lbsgpspsy_name.rsc" 0 cap_rd=alwayspass cap_wr=alwaysfail

0x10000000 int 2000000 0 cap_rd=alwayspass cap_wr=alwaysfail

</codeblock> </stepxmp>

<info>This is the same as the repository file for the A-GPS implementation

[1], except the value for key <codeph>0xa</codeph> (Technology Type) is <codeph>ETechnologyTerminal</codeph> =

1, to indicate that the PSY uses autonomous GPS. </info>

<info>See step 1 above for details about which values you may need to change

so that this file accurately describes the properties of your A-GPS Integration

Module. </info>

</step>

<step id="GUID-CC2CC449-7A14-5143-9B87-80D1D887234E"><cmd>Make a binary version

of the Central Repository initialisation file(s) and install them on the device. </cmd>

<info>The LBS build process makes a binary version of the PSY Central Repository

initialisation files and copies them to <filepath>epoc32\winscw\c\private\10202BE9</filepath>. </info>

<info>To rebuild the A-GPS PSY Central Repository initialisation file you

can use the makefile <filepath>createlbsagpspsyrep.mk</filepath> in <filepath>datasourcemodules\lbsposfwadaptation\lbsgpsagpspsy\lbsagpspsy\group</filepath>. </info>

<info>To rebuild the GPS PSY Central Repository initialisation file you can

use the makefile <filepath>createlbsgpspsyrep.mk</filepath> in <filepath>datasourcemodules\lbsposfwadaptation\lbsgpsagpspsy\lbsgpspsy\group</filepath>. </info>

<info>Use the <xref href="GUID-9BB4A44E-6870-5A25-8EA8-0B0F1565213F.dita">ROM macros</xref> to

copy the GPS/A-GPS PSY DLL and the repository files into a device ROM. </info>

</step>

</steps>

</taskbody><related-links>

<link href="GUID-D0C20045-FCC5-53CB-BBDB-7AA058C9139E.dita"><linktext>GPS/A-GPS

PSY Overview</linktext></link>

<link href="GUID-9BB4A44E-6870-5A25-8EA8-0B0F1565213F.dita"><linktext>Include the

GPS/A-GPS PSY in ROM</linktext></link>

</related-links></task>