Set command

nRF93M1 Cellular AT Commands

The set command starts a cloud-based location flow.

Syntax:

%NRFCLOUDLOCATION=<method>,<fetch_result>

The set command parameters and their defined values are the following:

<method>
Integer, 1–7. Data collection method.
1 – Single-cell.
2 – Multicell.
3 – Single-cell and multicell.
4 – Wi-Fi only.
5 – Single-cell and Wi-Fi.
6 – Multicell and Wi-Fi.
7 – All.
<fetch_result>
Integer, 0–1. Specifies whether the modem reports a location result after sending the collected data to nRF Cloud.
0 – Report an acknowledgment without returning a location result.
1 – Report the location result.

When <fetch_result> is 0, a Unsolicited Result Code (URC) is sent with an acknowledgment, such as the following:

%NRFCLOUDLOCATION: ACK RECEIVED

When <fetch_result> is 1, a URC is sent with the location result:

%NRFCLOUDLOCATION: <lat>,<lon>,<unc>,<fulfilled_method>

The response parameters and their defined values are the following:

<lat>
Integer. Latitude.
<lon>
Integer. Longitude.
<unc>
Integer. Uncertainty in meters.
<fulfilled_method>
Integer. Method used by the cloud to determine the location.
The fulfilled method can differ from the requested <method> when multiple data sources are allowed.
1 – Single-cell.
2 – Multicell.
4 – Wi-Fi.
Note: During a cloud transaction, unsolicited %COAP result codes can be emitted.
Warning:
Multicell and Wi-Fi positioning do not work if the module is in RRC Connected mode.

The following command example collects single-cell data without sending it to the cloud:

AT%NRFCLOUDLOCATION=1,0
%COAP: RESPONSE,2.05
%NRFCLOUDLOCATION: ACK RECEIVED
OK

The following command example collects single-cell data and requests a location from the cloud:

AT%NRFCLOUDLOCATION=1,1
%COAP: RESPONSE,2.05
%COAP: DATA,HEX,bf01fb404ebf3c5f2bdf8202fb4037c68853f6f81a03186404655343454c4cff
%NRFCLOUDLOCATION: 61.494029,23.775517,100,1
OK

The following command example allows single-cell and multicell positioning. The cloud fulfills the request with multicell positioning:

AT%NRFCLOUDLOCATION=3,1
%COAP: RESPONSE,2.05
%COAP: DATA,HEX,bf01fb404ebf3c5f2bdf8202fb4037c68853f6f81a03186404654d43454c4cff
%NRFCLOUDLOCATION: 61.494029,23.775517,100,2
OK