samples: nrf_cloud: review docs for cell_location

maxd-nordic · maxd-nordic · commit b647c4fbc4bd · 2025-12-08T16:17:19.000+01:00
Fix issues found in the documentation of the cell location samples.
Add examples of connection errors.

Signed-off-by: Maximilian Deubel &lt;maximilian.deubel@nordicsemi.no&gt;
diff --git a/samples/cellular/nrf_cloud_coap_cell_location/README.rst b/samples/cellular/nrf_cloud_coap_cell_location/README.rst
@@ -25,16 +25,8 @@ If it is not, follow the instructions in `Device on-boarding <nrf_cloud_coap_cel
 Overview
 ********
 
-The sample works in both single-cell and multi-cell mode.
-
-After the sample initializes and connects to the network, it enters the single-cell mode and sends a single-cell location request to nRF Cloud.
-For this purpose, the sample uses network data obtained from the :ref:`modem_info_readme` library.
-In the multi-cell mode, the sample requests for neighbor cell measurement using the :ref:`lte_lc_readme` library.
-
-If the modem provides neighbor cell data, the sample sends a multi-cell location request to nRF Cloud.
-Otherwise, the request is single-cell.
-
-In either mode, the sample sends a new location request if a change in cell ID is detected.
+After the sample initializes and connects to the network, it sends a cell location request to nRF Cloud.
+For this purpose, the sample uses network data obtained from the :ref:`lib_location` library.
 
 See the `nRF Cloud Location Services documentation`_ page for additional information.
 
@@ -137,6 +129,26 @@ The network carrier does not provide date and time
    The sample requires the network carrier to provide date and time to the modem.
    Without a valid date and time, the modem cannot generate JWTs with an expiration time.
 
+Credentials are missing on the configured sec tag:
+
+.. note::
+
+   CoAP connections require a different root CA certificate compared to REST and MQTT.
+   It is possible to provision both certificates on the same sec tag.
+
+   .. code-block:: console
+
+      [00:00:03.067,291] <err> nrf_cloud_coap_transport: Could not connect to nRF Cloud CoAP server coap.nrfcloud.com, port: 5684. err: -111
+      [00:00:03.067,321] <err> nrf_cloud_coap_cell_location_sample: Connecting to nRF Cloud failed, error: -111
+
+Credentials are not registered or the device ID does not match the registered one:
+
+   .. code-block:: console
+
+      [00:00:05.081,756] <err> nrf_cloud_coap_transport: Device not authenticated; reconnection required.
+      [00:00:05.081,787] <inf> nrf_cloud_coap_transport: Authorization result_code: 4.01
+      [00:00:05.583,435] <err> nrf_cloud_coap_cell_location_sample: Connecting to nRF Cloud failed, error: -13
+
 Dependencies
 ************
 
diff --git a/samples/cellular/nrf_cloud_coap_cell_location/src/main.c b/samples/cellular/nrf_cloud_coap_cell_location/src/main.c
@@ -176,7 +176,7 @@ int main(void)
 
 	k_sem_take(&lte_connected, K_FOREVER);
 
-	/* A-GNSS/P-GPS needs to know the current time. */
+	/* JWT authentication requires a valid time. */
 	if (IS_ENABLED(CONFIG_DATE_TIME)) {
 		LOG_INF("Waiting for current time");
 
diff --git a/samples/cellular/nrf_cloud_mqtt_cell_location/README.rst b/samples/cellular/nrf_cloud_mqtt_cell_location/README.rst
@@ -25,16 +25,8 @@ If it is not, follow the instructions in `Device on-boarding <nrf_cloud_mqtt_cel
 Overview
 ********
 
-The sample works in both single-cell and multi-cell mode.
-
-After the sample initializes and connects to the network, it enters the single-cell mode and sends a single-cell location request to nRF Cloud.
-For this purpose, the sample uses network data obtained from the :ref:`modem_info_readme` library.
-In the multi-cell mode, the sample requests for neighbor cell measurement using the :ref:`lte_lc_readme` library.
-
-If the modem provides neighbor cell data, the sample sends a multi-cell location request to nRF Cloud.
-Otherwise, the request is single-cell.
-
-In either mode, the sample sends a new location request if a change in cell ID is detected.
+After the sample initializes and connects to the network, it sends a cell location request to nRF Cloud.
+For this purpose, the sample uses network data obtained from the :ref:`lib_location` library.
 
 See the `nRF Cloud Location Services documentation`_ page for additional information.
 
@@ -131,6 +123,21 @@ The network carrier does not provide date and time
    The sample requires the network carrier to provide date and time to the modem.
    Without a valid date and time, the modem cannot generate JWTs with an expiration time.
 
+Credentials are missing on the configured sec tag:
+
+   .. code-block:: console
+
+      [00:00:03.698,913] <err> nrf_cloud_transport: Could not connect to nRF Cloud MQTT Broker mqtt.nrfcloud.com, port: 8883. err: -111
+      [00:00:03.698,974] <err> nrf_cloud_mqtt_cell_location_sample: NRF_CLOUD_EVT_TRANSPORT_CONNECT_ERROR: -9
+
+Credentials are not registered or the device ID does not match the registered one:
+
+   .. code-block:: console
+
+      [00:00:08.287,078] <err> nrf_cloud_transport: MQTT input error: -128
+      [00:00:08.287,139] <err> nrf_cloud_transport: Error disconnecting from cloud: -128
+      [00:00:08.287,170] <err> nrf_cloud_mqtt_cell_location_sample: NRF_CLOUD_EVT_TRANSPORT_DISCONNECTED
+
 Dependencies
 ************
 
diff --git a/samples/cellular/nrf_cloud_mqtt_cell_location/src/main.c b/samples/cellular/nrf_cloud_mqtt_cell_location/src/main.c
@@ -219,7 +219,7 @@ int main(void)
 
 	k_sem_take(&lte_connected, K_FOREVER);
 
-	/* A-GNSS/P-GPS needs to know the current time. */
+	/* Waiting for valid time. */
 	if (IS_ENABLED(CONFIG_DATE_TIME)) {
 		LOG_INF("Waiting for current time");
 
diff --git a/samples/cellular/nrf_cloud_rest_cell_location/README.rst b/samples/cellular/nrf_cloud_rest_cell_location/README.rst
@@ -25,16 +25,8 @@ If it is not, follow the instructions in `Device on-boarding <nrf_cloud_rest_cel
 Overview
 ********
 
-The sample works in both single-cell and multi-cell mode.
-
-After the sample initializes and connects to the network, it enters the single-cell mode and sends a single-cell location request to nRF Cloud.
-For this purpose, the sample uses network data obtained from the :ref:`modem_info_readme` library.
-In the multi-cell mode, the sample requests for neighbor cell measurement using the :ref:`lte_lc_readme` library.
-
-If the modem provides neighbor cell data, the sample sends a multi-cell location request to nRF Cloud.
-Otherwise, the request is single-cell.
-
-In either mode, the sample sends a new location request if a change in cell ID is detected.
+After the sample initializes and connects to the network, it sends a cell location request to nRF Cloud.
+For this purpose, the sample uses network data obtained from the :ref:`lib_location` library.
 
 See the `nRF Cloud Location Services documentation`_ page for additional information.
 
@@ -133,6 +125,26 @@ The network carrier does not provide date and time
    The sample requires the network carrier to provide date and time to the modem.
    Without a valid date and time, the modem cannot generate JWTs with an expiration time.
 
+Credentials are missing on the configured sec tag:
+
+   .. code-block:: console
+
+      [00:00:02.738,159] <err> nrf_cloud_jwt: Failed to generate JWT, error: -8
+      [00:00:02.745,574] <err> nrf_cloud_rest: Failed to auto-generate JWT, error: -8
+      [00:00:02.753,601] <err> nrf_cloud_rest: Could not format HTTP auth header, err: -8
+      [00:00:02.761,962] <err> nrf_cloud_rest_cell_location_sample: Request failed, error: -8
+
+Credentials are not registered or the device ID does not match the registered one:
+
+   .. code-block:: console
+
+      [00:00:07.062,957] <err> nrf_cloud_codec_internal: REST error msg: Auth token is malformed.
+      [00:00:07.071,990] <err> nrf_cloud_rest: nRF Cloud REST error code: 40100
+      [00:00:07.079,437] <err> nrf_cloud_rest: REST request was rejected. Response status: 401
+      [00:00:07.088,226] <err> nrf_cloud_rest: Response body: {"message":"Auth token is malformed.","code":40100}
+      [00:00:07.098,846] <err> nrf_cloud_rest_cell_location_sample: Request failed, error: -77
+      [00:00:07.107,574] <err> nrf_cloud_rest_cell_location_sample: nRF Cloud error code: 40100
+
 Dependencies
 ************
 
diff --git a/samples/cellular/nrf_cloud_rest_cell_location/src/main.c b/samples/cellular/nrf_cloud_rest_cell_location/src/main.c
@@ -189,7 +189,7 @@ int main(void)
 
 	k_sem_take(&lte_connected, K_FOREVER);
 
-	/* A-GNSS/P-GPS needs to know the current time. */
+	/* JWT authentication requires a valid time. */
 	if (IS_ENABLED(CONFIG_DATE_TIME)) {
 		LOG_INF("Waiting for current time");
 
