User Manual

SARA-R4 series-AT commands manual
UBX-17003787 - R16

23Positioning
Page 275 of 401
23.3.4Aiding server configuration +UGSRV
+UGSRV
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
partial No NVM No - +CME Error
23.3.4.1Description
Configures the network connection to a Multi GNSS Assistance (MGA) server. The configuration is saved in
NVM and applied at the next GNSS power cycle. By default, the cellular module connects to u-blox' primary
MGA server; if the connection fails then the cellular module connects to u-blox' secondary MGA server. The set
command registers a token for gathering assistance data from MGA servers.
Setting up Internet connection and network registration is not part of this command and must be handled
by the user separately to this command.
For more details about Multi GNSS Assistance (MGA) feature please refer to AssistNow services.
23.3.4.2Syntax
Type Syntax Response Example
Set AT+UGSRV=[<mga_primary_
server>],[<mga_secondary_server>],
<auth_token>[,<days>[,<period>[,
<resolution>[,<GNSS_types>[,
<mode>[,<datatype>]]]]]]
OK AT+UGSRV="cell-
live1.services.u-blox.com","cell-
live2.services.u-blox.com",
"123456789abcdefghijklm",14,4,1,65,
0,1
OK
Read AT+UGSRV? +UGSRV: <mga_primary_server>,
<mga_secondary_server>,
<auth_token>,<days>,<period>,
<resolution>,<GNSS_types>,
<mode>,<datatype>
OK
+UGSRV: "cell-live1.services.u-
blox.com","cell-
live2.services.u-blox.com",
"123456789abcdefghijklm",14,4,1,65,
0,1
OK
Test AT+UGSRV=? +UGSRV: <mga_primary_server>,
<mga_secondary_server>,<auth_
token>,(list of supported <days>s),
(list of supported <period>s),(list
of supported <resolution>s),(list
of supported <GNSS_types>s),
(list of supported <mode>s),(list of
supported <datatype>s)
OK
+UGSRV: "srv1","srv2","token",(1,2,3,
5,7,10,14),(1-5),(1-3),(1,64,65),(0-2),(0
-15)
OK
23.3.4.3Defined values
Parameter Type Description
<mga_primary_
server>
String Host name of the primary MGA server; the maximum length is 254 characters.
Empty string is not allowed. The default and factory-programmed value is "cell-
live1.services.u-blox.com". If the primary MGA server is omitted, the current stored
value is preserved.
<mga_secondary_
server>
String Host name of the secondary MGA server; the maximum length is 254 characters.
Empty string is not allowed. The default and factory-programmed value is "cell-
live2.services.u-blox.com". If the secondary MGA server is omitted, the current stored
value is preserved.
<auth_token> String Authentication Token for MGA server access.
<days> Number The number of days into the future the Offline data for u-blox 7 and previous version
should be valid for. The allowed values are: 1, 2, 3, 5, 7, 10 and 14. The default and
factory-programmed value is 14.
<period> Number The number of weeks into the future the Offline data for u-blox M8 should be valid
for. The range of the allowed values goes from 1 to 5. The default and factory-
programmed value is 4.
<resolution> Number Resolution of offline data for u-blox M8. Allowed values: