Symbian3/PDK/Source/GUID-9BB4A44E-6870-5A25-8EA8-0B0F1565213F.dita
changeset 12 80ef3a206772
parent 9 59758314f811
equal deleted inserted replaced
11:5072524fcc79 12:80ef3a206772
    53 #endif // SYMBIAN_INCLUDE_LOCATION_API_VARIANT2
    53 #endif // SYMBIAN_INCLUDE_LOCATION_API_VARIANT2
    54 
    54 
    55 #endif // SYMBIAN_EXCLUDE_LOCATION
    55 #endif // SYMBIAN_EXCLUDE_LOCATION
    56 
    56 
    57 #endif // __LBS_GPS_AGPS_ADAPTATION_PSY_IBY__
    57 #endif // __LBS_GPS_AGPS_ADAPTATION_PSY_IBY__
    58 </codeblock> </p> <p>The macros are used to copy one of three different ECom resource file to the ECom registry. The file that is copied can specify that the DLL contains two PSY implementations for A-GPS and autonomous GPS, or only one implementation for either A-GPS or autonomous GPS. </p> <p>The files <codeph>102869C7.cre</codeph> and <codeph>10285abc.cre</codeph> are Central Repository initialisation files that define the values specified by the <xref href="GUID-DA2DC704-CE65-54FB-9049-4E1C73092EDF-GENID-1-12-1-18-1-1-10-1-5-1-5-1-8-1.dita">Positioning Plug-in Information API</xref> to register the PSY implementations with the LBS subsystem. File <codeph>102869C7.cre</codeph> contains values for the GPS PSY implementation. File <codeph>10285abc.cre</codeph> contains values for the A-GPS PSY implementation. See <xref href="GUID-3319E01A-F500-5F5C-9798-351C6F3EC583.dita">Updating the GPS/A-GPS Central Repository Initialisation File</xref> for an explanation of values you may have to change in these files. </p> </li> <li id="GUID-C59B1242-38C5-5404-9D68-065E80085BED"><p>To install and configure the GPS/A-GPS PSY to support assisted GPS </p> <p>Use the macro <codeph>SYMBIAN_INCLUDE_LOCATION_AGPS_PM</codeph> when you build the ROM. </p> <p>The example below shows how to configure the GPS/A-GPS PSY for assisted GPS. Note that you may need to specify additional macros depending on which other optional LBS components you also want to install. </p> <p><codeblock id="GUID-4A98B688-13CA-5A04-AE90-916CA49BC442" xml:space="preserve">
    58 </codeblock> </p> <p>The macros are used to copy one of three different ECom resource file to the ECom registry. The file that is copied can specify that the DLL contains two PSY implementations for A-GPS and autonomous GPS, or only one implementation for either A-GPS or autonomous GPS. </p> <p>The files <codeph>102869C7.cre</codeph> and <codeph>10285abc.cre</codeph> are Central Repository initialisation files that define the values specified 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> to register the PSY implementations with the LBS subsystem. File <codeph>102869C7.cre</codeph> contains values for the GPS PSY implementation. File <codeph>10285abc.cre</codeph> contains values for the A-GPS PSY implementation. See <xref href="GUID-3319E01A-F500-5F5C-9798-351C6F3EC583.dita">Updating the GPS/A-GPS Central Repository Initialisation File</xref> for an explanation of values you may have to change in these files. </p> </li> <li id="GUID-C59B1242-38C5-5404-9D68-065E80085BED"><p>To install and configure the GPS/A-GPS PSY to support assisted GPS </p> <p>Use the macro <codeph>SYMBIAN_INCLUDE_LOCATION_AGPS_PM</codeph> when you build the ROM. </p> <p>The example below shows how to configure the GPS/A-GPS PSY for assisted GPS. Note that you may need to specify additional macros depending on which other optional LBS components you also want to install. </p> <p><codeblock id="GUID-4A98B688-13CA-5A04-AE90-916CA49BC442" xml:space="preserve">
    59 buildrom lbs.oby 
    59 buildrom lbs.oby 
    60 -DSYMBIAN_INCLUDE_LOCATION_API_VARIANT2
    60 -DSYMBIAN_INCLUDE_LOCATION_API_VARIANT2
    61 -DSYMBIAN_INCLUDE_LOCATION_AGPS_PM
    61 -DSYMBIAN_INCLUDE_LOCATION_AGPS_PM
    62 </codeblock> </p> </li> <li id="GUID-BF14E3C5-C8DC-5607-B37E-6554C841A4DF"><p>To install and configure the GPS/A-GPS PSY to support only autonomous GPS </p> <p>Use the macro <codeph>SYMBIAN_INCLUDE_LOCATION_GPS_PM</codeph> when you build the ROM. </p> <p>The example below shows how to configure the GPS/A-GPS PSY for autonomous GPS only. Note that you may need to specify additional macros depending on which other optional LBS components you also want to install. </p> <p><codeblock id="GUID-2A666A38-6A2E-55CE-8F25-6AE98E7EE53E" xml:space="preserve">
    62 </codeblock> </p> </li> <li id="GUID-BF14E3C5-C8DC-5607-B37E-6554C841A4DF"><p>To install and configure the GPS/A-GPS PSY to support only autonomous GPS </p> <p>Use the macro <codeph>SYMBIAN_INCLUDE_LOCATION_GPS_PM</codeph> when you build the ROM. </p> <p>The example below shows how to configure the GPS/A-GPS PSY for autonomous GPS only. Note that you may need to specify additional macros depending on which other optional LBS components you also want to install. </p> <p><codeblock id="GUID-2A666A38-6A2E-55CE-8F25-6AE98E7EE53E" xml:space="preserve">
    63 buildrom lbs.oby 
    63 buildrom lbs.oby 
    65 -DSYMBIAN_INCLUDE_LOCATION_GPS_PM
    65 -DSYMBIAN_INCLUDE_LOCATION_GPS_PM
    66 </codeblock> </p> </li> </ol> </section> <section><title> To use the GPS/A-GPS PSY in an emulator </title> <p>The LBS code build process uses the project file <codeph>lbsgpsagpspsy.mmp</codeph> to build the GPS/A-GPS code. This MMP file contains the following commands to copy ECom registration information to the winscw directory: </p> <codeblock id="GUID-B3F4E248-320B-5C73-8002-4B052AAB9058" xml:space="preserve">
    66 </codeblock> </p> </li> </ol> </section> <section><title> To use the GPS/A-GPS PSY in an emulator </title> <p>The LBS code build process uses the project file <codeph>lbsgpsagpspsy.mmp</codeph> to build the GPS/A-GPS code. This MMP file contains the following commands to copy ECom registration information to the winscw directory: </p> <codeblock id="GUID-B3F4E248-320B-5C73-8002-4B052AAB9058" xml:space="preserve">
    67 START RESOURCE  ../data/10285abb.rss
    67 START RESOURCE  ../data/10285abb.rss
    68 TARGETPATH /resource/plugins
    68 TARGETPATH /resource/plugins
    69 TARGET lbsgpsagpspsy.rsc
    69 TARGET lbsgpsagpspsy.rsc
    70 </codeblock> <p>These commands compile and copy the ECom registration information from the resource source file <codeph>10285abb.rss</codeph>, which specifies both the A-GPS and GPS implementations in the library. Therefore on an emulator, the GPS/A-GPS PSY can be used for both A-GPS and autonomous GPS position fixes. </p> </section> </conbody><related-links><link href="GUID-D0C20045-FCC5-53CB-BBDB-7AA058C9139E.dita"><linktext>GPS/A-GPS PSY Overview</linktext> </link> <link href="GUID-DA2DC704-CE65-54FB-9049-4E1C73092EDF-GENID-1-12-1-18-1-1-10-1-5-1-5-1-8-1.dita"><linktext>Positioning Plug-in Information API</linktext> </link> <link href="GUID-5B39D732-7252-57EB-BA74-FC8718ED45E4.dita"><linktext>LBS ROM
    70 </codeblock> <p>These commands compile and copy the ECom registration information from the resource source file <codeph>10285abb.rss</codeph>, which specifies both the A-GPS and GPS implementations in the library. Therefore on an emulator, the GPS/A-GPS PSY can be used for both A-GPS and autonomous GPS position fixes. </p> </section> </conbody><related-links><link href="GUID-D0C20045-FCC5-53CB-BBDB-7AA058C9139E.dita"><linktext>GPS/A-GPS PSY Overview</linktext> </link> <link href="GUID-DA2DC704-CE65-54FB-9049-4E1C73092EDF-GENID-1-12-1-19-1-1-10-1-5-1-5-1-8-1.dita"><linktext>Positioning Plug-in Information API</linktext> </link> <link href="GUID-5B39D732-7252-57EB-BA74-FC8718ED45E4.dita"><linktext>LBS ROM
    71                 macros</linktext> </link> <link href="GUID-D18B4715-3942-52EA-9D2F-E145037FA47A.dita"><linktext>LBS
    71                 macros</linktext> </link> <link href="GUID-D18B4715-3942-52EA-9D2F-E145037FA47A.dita"><linktext>LBS
    72                 Integration and Configuration guide</linktext> </link> </related-links></concept>
    72                 Integration and Configuration guide</linktext> </link> </related-links></concept>