User Manual

Table Of Contents
SARA-R4 series-AT commands manual
UBX-17003787 - R16
23Positioning
Page 284 of 401
23.4CellLocate and hybrid positioning
23.4.1Ask for localization information +ULOC
+ULOC
SARA-R410M-02B SARA-R410M-52B SARA-R410M-63B SARA-R410M-73B SARA-R410M-83B
SARA-R412M
Modules
SARA-N4
Syntax PIN required Settings saved Can be aborted Response time Error referenceAttributes
full No No No < 10 s +CME Error
23.4.1.1Description
Requests cellular module to provide the location data; the location can be determined using:
GNSS receiver
CellLocate
®
(location based on network cells data)
Combination of both technologies (hybrid)
The final result code indicates if sending the command request to the localization information process was
successful or not. The URC is issued to provide the requested information via +ULOC set command.
The GNSS interface and CellLocate
®
can be used at the same time: if the GNSS sensor is reserved to another
interface an error result code is provided ("+CME ERROR: GPS busy" if +CMEE: 2).
It is possible to configure the hybrid positioning through +ULOCGNSS and +ULOCCELL AT commands even if
it is running: the parameters are stored in NVM and will be applied at the next +ULOC command.
If the +ULOC command is sent while a previous +ULOC activity is still in progress the previous activity is
aborted, the available position is immediately output and the next +ULOC request is served.
The data connection cannot be immediately dropped at the +ULOC timeout expiration. This could lead to
a delay in the expected response time.
Depending on the aiding chosen, a data connection could be required; see the AT+UGPS command
description.
If no position is available (no GNSS coverage, no network information and no previous data available) then
the <lat> latitude and <long> longitude will be set to '0'.
If the previous position degradated by the elapsed time satisfies the desired accuracy then the sensor '0'
is reported in the information text response.
If multi-hypothesis is required the GNSS solution and the CellLocate
®
solutions are reported, if available.
If no GNSS or CellLocate
®
solutions are present, the previous position degradated is used instead.
If a valid GNSS fix with an accuracy below the required value (<accuracy>) occurs before the end of the
network scan, the GNSS-only solution will be available, even if multi-hypothesis has been required.
23.4.1.2Syntax
Type Syntax Response Example
Set AT+ULOC=<mode>,<sensor>,
<response_type>,<timeout>,
<accuracy>[,<num_hypothesis>]
OK AT+ULOC=2,3,0,120,1
OK
Read AT+ULOC? +ULOC: <mode>,<sensor>,
<response_type>,<timeout>,
<accuracy>,<num_hypotesis>
OK
+ULOC: 2,3,1,0,20,0
OK
Test AT+ULOC=? +ULOC: (list of supported <mode>s),
(list of supported <sensor>s),(list
of supported <response_type>s),
(list of supported <timeout>s),(list
of supported <accuracy>s),(list of
supported <num_hypotesis>s)
OK
+ULOC: (0-2),(0-3),(0-2),(1-999),(1-
999999),(1-16)
OK