Symbian3/PDK/Source/GUID-F9BEC749-D535-55EA-8601-A961EA1E441B.dita
changeset 9 59758314f811
child 12 80ef3a206772
equal deleted inserted replaced
8:ae94777fff8f 9:59758314f811
       
     1 <?xml version="1.0" encoding="utf-8"?>
       
     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
       
     3 <!-- This component and the accompanying materials are made available under the terms of the License 
       
     4 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
       
     6 <!-- Initial Contributors:
       
     7     Nokia Corporation - initial contribution.
       
     8 Contributors: 
       
     9 -->
       
    10 <!DOCTYPE task
       
    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
       
    12 <task id="GUID-F9BEC749-D535-55EA-8601-A961EA1E441B" xml:lang="en"><title>Modifying
       
    13 the Bluetooth GPS PSY Settings </title><shortdesc>This topic describes how to modify the settings of the Bluetooth
       
    14 GPS PSY. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
       
    15 <context><p>The Central Repository initialisation file <codeph>101FE999.txt</codeph> contains
       
    16 the default Bluetooth GPS PSY settings. You can modify the default values
       
    17 in this file. There are two types of information stored in the initialisation
       
    18 file: </p> <ul>
       
    19 <li id="GUID-DC531E09-6CD3-5173-8AD7-37A2F63FB671"><p>Keys and values defined
       
    20 by the Positioning Plug-in Information API. </p> <p>These keys and values
       
    21 define the properties of the Bluetooth GPS PSY and GPS device, such as the
       
    22 time to get a first fix and the typical position fix accuracy. </p> <p>The
       
    23 default values describe the properties of a typical Bluetooth GPS device,
       
    24 and for most purposes it is not necessary to modify them. </p> </li>
       
    25 <li id="GUID-3B2DCDD6-659C-5FD5-92A0-DC84527BF223"><p>Keys and values that
       
    26 define Bluetooth GPS operational properties. </p> <p>The properties describe
       
    27 the behaviour of the Bluetooth GPS PSY in its operation with the GPS device.
       
    28 Properties you can modify include timeouts and buffer size. </p> <p>The operational
       
    29 properties can be read (and some can be set) at runtime using the <xref href="GUID-F84E7419-7F31-5E18-8854-27CB1F9F890E.dita">Bluetooth
       
    30 GPS PSY Settings Storage API</xref>. </p> </li>
       
    31 </ul> </context>
       
    32 <steps id="GUID-9281FD96-F195-5C1B-ACC6-7E2FDC2B4C93">
       
    33 <step id="GUID-76FFFE77-A7E7-5EEE-8936-9B99B29F9ADF"><cmd/>
       
    34 <info>Modify the contents of the Central Repository file <codeph>101FE999.txt</codeph> as
       
    35 described below. </info>
       
    36 </step>
       
    37 <step id="GUID-D38DB3A3-5051-583C-83A5-E298CEC265E0"><cmd/>
       
    38 <info>Rebuild the Bluetooth PSY ROM or rebuild the PSY SIS file. </info>
       
    39 <info>The Central Repository initialisation file <codeph>101FE999.txt</codeph> contains
       
    40 default settings for the PSY. It is shown below: </info>
       
    41 <stepxmp><codeblock id="GUID-2281A55D-259D-5FC4-BE3C-2FCA9E26CE08" xml:space="preserve">
       
    42 cenrep
       
    43 version 1
       
    44 [owner]
       
    45 0x101f97b2
       
    46 [defaultmeta]
       
    47  0
       
    48 [platsec]
       
    49  cap_rd=ReadDeviceData cap_wr=WriteDeviceData
       
    50 [Main]
       
    51 0x1 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    52 0x2 int 0 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    53 0x3 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    54 0x4 int 80000000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    55 0x5 int 1000000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    56 0x6 real 10 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    57 0x7 real 30 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    58 0x8 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    59 0x9 int 3 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    60 0xa int 1 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    61 0xb int 2 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    62 0xc int 95 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    63 0xd int 15 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    64 0xe int 1 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    65 0xf string "\\resource\\nlabtgpspsy_name.rsc" 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    66 0x10000000 int 0 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    67 0x10000001 int 1 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    68 0x10000002 int 1 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    69 0x10000003 int 1 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    70 0x10000004 int 1 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    71 0x10000005 int 1 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    72 0x10000006 int 1 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    73 0x10000007 string "" 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    74 0x10000008 int 0 16777216 cap_rd=alwayspass cap_wr=WriteDeviceData
       
    75 0x11000001 int 100000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    76 0x11000002 real 8 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    77 0x11000003 int 3 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    78 0x11000004 int 300000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    79 0x11000005 int 10 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    80 0x11000006 int 5000000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    81 0x11000007 int 10000000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    82 0x11000008 int 60000000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    83 0x11000009 int 1 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    84 0x1100000a int 20000000 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    85 0x1100000b int 5120 0 cap_rd=alwayspass cap_wr=alwaysfail
       
    86 </codeblock> </stepxmp>
       
    87 <info>The values with keys from 0x1 to 0xf describe the PSY properties defined
       
    88 by the Positioning Plug-in Information API. </info>
       
    89 <info>Generally, you do not need to change these values as they describe typical
       
    90 capabilities of a Bluetooth GPS positioning device. </info>
       
    91 <stepxmp><table id="GUID-CF6C22EF-981F-5271-A65E-6DCBA07E7B9C">
       
    92 <tgroup cols="4"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/>
       
    93 <thead>
       
    94 <row>
       
    95 <entry>Key name</entry>
       
    96 <entry>Key ID</entry>
       
    97 <entry>Meaning</entry>
       
    98 <entry>Default value and description</entry>
       
    99 </row>
       
   100 </thead>
       
   101 <tbody>
       
   102 <row>
       
   103 <entry><p> <xref href="GUID-4C4DCA0A-E524-3383-8151-A68FF8DBF72F.dita"><apiname>KPSYInterfaceVersion</apiname></xref>  </p> </entry>
       
   104 <entry><p> <codeph>0x1</codeph>  </p> </entry>
       
   105 <entry><p>Version of the Positioning Plug-in Information API interface </p> </entry>
       
   106 <entry><p>Version 1. </p> </entry>
       
   107 </row>
       
   108 <row>
       
   109 <entry><p> <xref href="GUID-9E477072-14CC-3247-B39C-909802A49EA9.dita"><apiname>KPSYPriority </apiname></xref>  </p> </entry>
       
   110 <entry><p> <codeph>0x2</codeph>  </p> </entry>
       
   111 <entry><p>PSY priority on installation </p> </entry>
       
   112 <entry><p>Value of 0 specifies this PSY has the highest priority. </p> </entry>
       
   113 </row>
       
   114 <row>
       
   115 <entry><p> <xref href="GUID-C64C26DB-52A1-36B0-B890-6E2879AE4938.dita"><apiname> KPSYStatus</apiname></xref>  </p> </entry>
       
   116 <entry><p> <codeph>0x3</codeph>  </p> </entry>
       
   117 <entry><p>PSY status when it is installed on the system </p> </entry>
       
   118 <entry><p>Value of 1 indicates this PSY is available on installation. </p> </entry>
       
   119 </row>
       
   120 <row>
       
   121 <entry><p> <xref href="GUID-F0018CF3-8D7E-3E5C-8345-779EA09C514D.dita"><apiname>KPSYTimeToFirstFix</apiname></xref>  </p> </entry>
       
   122 <entry><p> <codeph>0x4</codeph>  </p> </entry>
       
   123 <entry><p>Time to First Fix </p> </entry>
       
   124 <entry><p>Large value of 80 seconds because an external Bluetooth GPS device
       
   125 uses autonomous GPS. </p> </entry>
       
   126 </row>
       
   127 <row>
       
   128 <entry><p> <xref href="GUID-FA1D8202-F243-3271-BC24-0092BC803D3A.dita"><apiname>KPSYTimeToNextFix</apiname></xref>  </p> </entry>
       
   129 <entry><p> <codeph>0x5</codeph>  </p> </entry>
       
   130 <entry><p>Time to Next Fix </p> </entry>
       
   131 <entry><p>Value of 1 second (specified as 1000000 microseconds). </p> </entry>
       
   132 </row>
       
   133 <row>
       
   134 <entry><p> <xref href="GUID-7C18FF42-1D28-3C35-B950-80AFDEBCAEE8.dita"><apiname>KPSYHorizontalAccuracy</apiname></xref>  </p> </entry>
       
   135 <entry><p> <codeph>0x6</codeph>  </p> </entry>
       
   136 <entry><p>Horizontal Accuracy </p> </entry>
       
   137 <entry><p>10 metres accuracy. </p> </entry>
       
   138 </row>
       
   139 <row>
       
   140 <entry><p> <xref href="GUID-8F18F9EA-A90F-31BE-968C-C925D4428CBF.dita"><apiname>KPSYVerticalAccuracy</apiname></xref>  </p> </entry>
       
   141 <entry><p> <codeph>0x7</codeph>  </p> </entry>
       
   142 <entry><p>Vertical Accuracy </p> </entry>
       
   143 <entry><p>30 metres accuracy. </p> </entry>
       
   144 </row>
       
   145 <row>
       
   146 <entry><p> <xref href="GUID-0D9A6DA8-0705-3511-8381-E46AAC50E5AB.dita"><apiname>KPSYCostIndicator</apiname></xref>  </p> </entry>
       
   147 <entry><p>0x8 </p> </entry>
       
   148 <entry><p>Cost Indicator </p> </entry>
       
   149 <entry><p> <xref href="GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D.dita#GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D/GUID-6DFD5B58-D59C-33DC-A0E2-4D6A23190778"><apiname>TPositionQuality::ECostZero</apiname></xref> because the PSY
       
   150 uses autonomous GPS. </p> </entry>
       
   151 </row>
       
   152 <row>
       
   153 <entry><p> <xref href="GUID-CC3515E5-4A2D-3371-A4BF-3197AABE7B6F.dita"><apiname>KPSYPowerConsumption</apiname></xref>  </p> </entry>
       
   154 <entry><p> <codeph>0x9</codeph>  </p> </entry>
       
   155 <entry><p>Power Consumption </p> </entry>
       
   156 <entry><p> <xref href="GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D.dita#GUID-1AA235FA-CEC1-3853-8F96-C538C02B596D/GUID-5D12179A-FB8C-3E58-B728-B2DEC3A24231"><apiname>TPositionQuality::EPowerMedium</apiname></xref> indicates medium
       
   157 power consumption. </p> </entry>
       
   158 </row>
       
   159 <row>
       
   160 <entry><p> <xref href="GUID-715DB9BF-8C60-39AA-A653-3C4FFC38B94D.dita"><apiname>KPSYTechnologyType</apiname></xref>  </p> </entry>
       
   161 <entry><p> <codeph>0xa</codeph>  </p> </entry>
       
   162 <entry><p>Technology Type </p> </entry>
       
   163 <entry><p> <xref href="GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26.dita#GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26/GUID-D9D66F7B-86FB-350F-9B12-4E7DEEA4D756"><apiname>TPositionModuleInfo::_ETechnologyTerminal</apiname></xref> indicates
       
   164 the position fix is obtained from the device. </p> </entry>
       
   165 </row>
       
   166 <row>
       
   167 <entry><p> <xref href="GUID-85153FA6-F39E-3654-B69E-D5ED0466F194.dita"><apiname>KPSYDeviceLocation</apiname></xref>  </p> </entry>
       
   168 <entry><p> <codeph>0xb</codeph>  </p> </entry>
       
   169 <entry><p>Device location </p> </entry>
       
   170 <entry><p> <xref href="GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26.dita#GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26/GUID-67DB640A-4871-3B52-81E1-F69E026A0A56"><apiname>TPositionModuleInfo::EDeviceExternal</apiname></xref> = 2. Specifies
       
   171 the GPS device is external to the mobile device. </p> </entry>
       
   172 </row>
       
   173 <row>
       
   174 <entry><p> <xref href="GUID-C3FD0558-0C69-3587-ABFD-61AFBC328A7B.dita"><apiname>KPSYCapabilities</apiname></xref>  </p> </entry>
       
   175 <entry><p> <codeph>0xc</codeph>  </p> </entry>
       
   176 <entry><p>Device Capabilities </p> </entry>
       
   177 <entry><p>Values from <xref href="GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26.dita#GUID-B098F3DB-E2FE-3C5A-8508-4B04D954AB26/GUID-C798CBA5-39BE-3072-9E9B-5910C4835DCC"><apiname>TPositionModuleInfo::_TCapabilities</apiname></xref> indicate
       
   178 the positioning capabilities supported. These are <codeph>ECapabilityHorizontal
       
   179 |                         ECapabilityVertical | ECapabilitySpeed | ECapabilityDirection
       
   180 |                         ECapabilitySatellite | ECapabilityNmea</codeph> =
       
   181 95 decimal. </p> </entry>
       
   182 </row>
       
   183 <row>
       
   184 <entry><p> <xref href="GUID-8B42A620-635D-34A6-B8D4-FA0BC33CDE4B.dita"><apiname>KPSYClassesSupported</apiname></xref>  </p> </entry>
       
   185 <entry><p> <codeph>0xd</codeph>  </p> </entry>
       
   186 <entry><p>Supported Positioning classes </p> </entry>
       
   187 <entry><p>Values from <xref href="GUID-22228828-26F8-3AEE-A90E-29A6F71757BA.dita#GUID-22228828-26F8-3AEE-A90E-29A6F71757BA/GUID-D68E36AD-CEC2-3E2E-995A-92027C389389"><apiname>TPositionModuleInfoClassType::_TPositionInfoClassType</apiname></xref> indicate
       
   188 the classes supported. These are: <codeph>EPositionInfoClass |           
       
   189              EPositionGenericInfoClass | EPositionCourseInfoClass |      
       
   190                   EPositionSatelliteInfoClass </codeph> = 15 decimal. </p> </entry>
       
   191 </row>
       
   192 <row>
       
   193 <entry><p> <xref href="GUID-9449A2EB-85B5-3221-9D12-A543BFD8CE3A.dita"><apiname>KPSYVisibility</apiname></xref>  </p> </entry>
       
   194 <entry><p> <codeph>0xe</codeph>  </p> </entry>
       
   195 <entry><p>Visibility of this PSY to the Location Server </p> </entry>
       
   196 <entry><p>1 defines this PSY as visible. </p> </entry>
       
   197 </row>
       
   198 <row>
       
   199 <entry><p> <xref href="GUID-A6348C78-825B-3CD5-A0B3-12885F9CCCB8.dita"><apiname>KPSYNameResource</apiname></xref>  </p> </entry>
       
   200 <entry><p> <codeph>0xf</codeph>  </p> </entry>
       
   201 <entry><p>PSY display name </p> </entry>
       
   202 <entry><p> <codeph>\\resource\\nlabtgpspsy_name.rsc</codeph>  </p> </entry>
       
   203 </row>
       
   204 </tbody>
       
   205 </tgroup>
       
   206 </table> </stepxmp>
       
   207 <info>The values with keys from <codeph>0x11000001</codeph> to <codeph>0x1100000b</codeph> describe
       
   208 the Bluetooth GPS PSY operational properties. You can change these values
       
   209 from their defaults if you want to modify the behaviour of the PSY. </info>
       
   210 <stepxmp><table id="GUID-234A3608-BFF0-5E7B-BF7E-4C87054461FF">
       
   211 <tgroup cols="5"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/><colspec colname="col4"/>
       
   212 <thead>
       
   213 <row>
       
   214 <entry>Key ID</entry>
       
   215 <entry>Key Name</entry>
       
   216 <entry>Meaning</entry>
       
   217 <entry>Default Value</entry>
       
   218 <entry>Valid Range</entry>
       
   219 </row>
       
   220 </thead>
       
   221 <tbody>
       
   222 <row>
       
   223 <entry><p> <codeph>0x11000001</codeph>  </p> </entry>
       
   224 <entry><p> <xref href="GUID-5CA02509-35A4-3D49-9B3A-1C59274D2D11.dita"><apiname>KBluetoothGpsPsyMsgSendDelay</apiname></xref>  </p> </entry>
       
   225 <entry><p>The minimum delay between messages that are sent to the Bluetooth
       
   226 device. </p> <p>Value is in microseconds. </p> </entry>
       
   227 <entry><p>100000 </p> </entry>
       
   228 <entry><p>[0,60] seconds </p> </entry>
       
   229 </row>
       
   230 <row>
       
   231 <entry><p> <codeph> 0x11000002</codeph>  </p> </entry>
       
   232 <entry><p> <xref href="GUID-88A2ABD4-355E-38DC-A441-368B265258B3.dita"><apiname>KBluetoothGpsPsyUserEquivalentRangeError</apiname></xref> </p> </entry>
       
   233 <entry><p>Defines the user equivalent range error used in GPS data error calculations.
       
   234 User equivalent range error is used for examining GPS positioning accuracy. </p> <p>Value
       
   235 is in metres. </p> </entry>
       
   236 <entry><p>8</p> </entry>
       
   237 <entry><p>[0,1000] metres </p> </entry>
       
   238 </row>
       
   239 <row>
       
   240 <entry><p> <codeph>0x11000003 </codeph>  </p> </entry>
       
   241 <entry><p> <xref href="GUID-9E50BDBA-C1CB-3FF6-A4E7-8125D562F56D.dita"><apiname>KBluetoothGpsPsyNumTestNmeaSentences</apiname></xref>  </p> </entry>
       
   242 <entry><p>The number of test NMEA sentences expected. </p> </entry>
       
   243 <entry><p>3</p> </entry>
       
   244 <entry><p>[0,100000] </p> </entry>
       
   245 </row>
       
   246 <row>
       
   247 <entry><p> <codeph>0x11000004 </codeph>  </p> </entry>
       
   248 <entry><p> <xref href="GUID-7D617B71-40A5-3937-A566-523A1D42316F.dita"><apiname>KBluetoothGpsPsyNormalGpsInitMsgDelay</apiname></xref>  </p> </entry>
       
   249 <entry><p>The delay between the initialisation messages sent to the GPS device. </p> <p>Value
       
   250 is in microseconds. </p> </entry>
       
   251 <entry><p>300000 </p> </entry>
       
   252 <entry><p>[0,10] minutes </p> </entry>
       
   253 </row>
       
   254 <row>
       
   255 <entry><p> <codeph>0x11000005</codeph>  </p> </entry>
       
   256 <entry><p> <xref href="GUID-6AF9A406-5BBB-3AA7-A77E-D99A3C3FAACA.dita"><apiname>KBluetoothGpsPsyNumSetFullPowerMsg</apiname></xref>  </p> </entry>
       
   257 <entry><p>The number of "set full power messages" to send when initialising
       
   258 the GPS device. </p> </entry>
       
   259 <entry><p>10 </p> </entry>
       
   260 <entry><p>[0,100000] </p> </entry>
       
   261 </row>
       
   262 <row>
       
   263 <entry><p> <codeph> 0x11000006</codeph>  </p> </entry>
       
   264 <entry><p> <xref href="GUID-AC1DE252-EC78-35DC-9DEC-5178557B6C26.dita"><apiname>KBluetoothGpsPsyPnokPollingDelay</apiname></xref>  </p> </entry>
       
   265 <entry><p>The delay in waiting for a PNOK compatible BT GPS device to respond
       
   266 to a PNOK polling message. </p> <p>Value is in microseconds. </p> </entry>
       
   267 <entry><p>5000000 </p> </entry>
       
   268 <entry><p>[0,10] minutes </p> </entry>
       
   269 </row>
       
   270 <row>
       
   271 <entry><p> <codeph> 0x11000007</codeph>  </p> </entry>
       
   272 <entry><p> <xref href="GUID-4C2673BA-9EFF-39DF-9AEF-7F6EDBF4C996.dita"><apiname>KBluetoothGpsPsyReconnectionTimeout</apiname></xref>  </p> </entry>
       
   273 <entry><p>The time to wait between re-connection attempts. </p> <p>Value is
       
   274 in microseconds. </p> </entry>
       
   275 <entry><p>10000000 </p> </entry>
       
   276 <entry><p>[0,10] minutes </p> </entry>
       
   277 </row>
       
   278 <row>
       
   279 <entry><p> <codeph>0x11000008</codeph>  </p> </entry>
       
   280 <entry><p> <xref href="GUID-99C00C9E-F69B-3321-BBCC-606CE3E3ECE5.dita"><apiname>KBluetoothGpsPsyInactiveDealy</apiname></xref>  </p> </entry>
       
   281 <entry><p>If the PSY has received no tracking session or location request
       
   282 by the expiry of this timeout, the PSY goes into the standby state. </p> <p>In
       
   283 the standby state, the connection to Bluetooth GPS device is disconnected. </p> <p>Value
       
   284 is in microseconds. </p> </entry>
       
   285 <entry><p>60000000 </p> </entry>
       
   286 <entry><p>[0,10] minutes </p> </entry>
       
   287 </row>
       
   288 <row>
       
   289 <entry><p> <codeph>0x11000009</codeph>  </p> </entry>
       
   290 <entry><p> <xref href="GUID-F268AD43-4229-34F5-8223-388496B2A851.dita"><apiname>KBluetoothGpsPsyUtilisePowerSaving</apiname></xref>  </p> </entry>
       
   291 <entry><p>Boolean value for disabling the sending of power saving NMEA message
       
   292 to the GPS device. Set this to 0 to disable power saving command usage. Any
       
   293 other value enables power saving. </p> </entry>
       
   294 <entry><p>1</p> </entry>
       
   295 <entry><p>0 or 1 </p> </entry>
       
   296 </row>
       
   297 <row>
       
   298 <entry><p> <codeph> 0x1100000a</codeph>  </p> </entry>
       
   299 <entry><p> <xref href="GUID-55B69071-3020-3D35-848D-90E5B5942007.dita"><apiname>KBluetoothGpsPsySateInfoLifeTime</apiname></xref>  </p> </entry>
       
   300 <entry><p>Integer value that specifies the satellite information expiration
       
   301 time. Cached satellite information older than this value is not used. </p> <p>Value
       
   302 is in microseconds. </p> </entry>
       
   303 <entry><p>20000000 </p> </entry>
       
   304 <entry><p>[0,10000] seconds </p> </entry>
       
   305 </row>
       
   306 <row>
       
   307 <entry><p> <codeph> 0x1100000b</codeph>  </p> </entry>
       
   308 <entry><p> <xref href="GUID-5CBB3A4C-67C5-39F5-9D4D-D0A8AD12E9FE.dita"><apiname>KBluetoothGpsPsyNmeaBufferSize</apiname></xref>  </p> </entry>
       
   309 <entry><p>Integer value that specifies the size of NMEA data buffer. The buffer
       
   310 size must be large enough to hold all NMEA data messages that a BT GPS device
       
   311 send in one second. </p> <p>A very large value increases run time RAM usage
       
   312 by the Bluetooth GPS PSY. </p> </entry>
       
   313 <entry><p>5012 </p> </entry>
       
   314 <entry><p>[0, 50*1024] </p> </entry>
       
   315 </row>
       
   316 </tbody>
       
   317 </tgroup>
       
   318 </table> </stepxmp>
       
   319 </step>
       
   320 </steps>
       
   321 </taskbody><related-links>
       
   322 <link href="GUID-E73A181C-0C9B-513C-ABAE-585C80D566DF.dita"><linktext>Bluetooth
       
   323 GPS PSY Overview</linktext></link>
       
   324 <link href="GUID-38A84B6A-BA49-55ED-A4D7-9B4436D00A42.dita"><linktext>Including
       
   325 the Bluetooth GPS PSY in ROM</linktext></link>
       
   326 <link href="GUID-731CE582-91A4-59E0-9004-227FBCFC7D3F.dita"><linktext>Packaging
       
   327 the Bluetooth GPS PSY in a SIS File</linktext></link>
       
   328 <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
       
   329 Plug-in Information API</linktext></link>
       
   330 <link href="GUID-F84E7419-7F31-5E18-8854-27CB1F9F890E.dita"><linktext>Bluetooth
       
   331 GPS PSY Settings Storage API</linktext></link>
       
   332 </related-links></task>