docs: add info about sidewalk location

Added information about the integration of Sidewalk Location services

Signed-off-by: Krzysztof Taborowski <[email protected]>

Author: ktaborowski

doc/releases_and_migration/release_notes_addon_v110.rst

@@ -22,6 +22,7 @@ This release introduces the latest Amazon Sidewalk SDK v1.19 libraries.
   * **DTS (Device Tree) changes** to accommodate LR1110 radio configuration.
   * **New radio architecture** with Zephyr shields for SubGHz radio configuration.
   * **Migration guide** for new radio architecture and shield system.
+  * **Sidewalk Location** services integration.
 
 * Updated:
 

doc/samples/sid_end_device.rst

@@ -172,6 +172,15 @@ The following configuration arguments are available during the build process for
 
 * To enable support for the downlink file transfer over Bluetooth LE, use the ``-DCONFIG_SIDEWALK_FILE_TRANSFER=y`` build flag.
 
+Sidewalk Location services support
+===================================
+
+The Sidewalk Location services support is enabled by default in Sidewalk libraries.
+To test the location services, you can use the Sidewalk Location CLI from DUT variant with ``CONFIG_SIDEWALK_LOCATION_SHELL=y``.
+The location services are available over Bluetooth LE, WiFi and GNSS (lr1110 radio is necessary for GNSS support). BLE only library supports only Bluetooth LE link mode.
+.. TBD: Add link to the Location Services API documentation.
+For more details, see the `Amazon Sidewalk Location Services API documentation`_.
+
 Selecting a sample variant
 **************************
 

doc/samples/variants/dut.rst

@@ -29,3 +29,54 @@ Testing
 
 #. To start testing the application, use the Sidewalk CLI (DUT).
    Type ``sid help`` and press enter to get the list of supported commands.
+
+
+Testing Location Services
+==========================
+
+#. Initialize and start a Sidewalk stack (e.g. for BLE+FSK+LoRa support)
+
+.. code-block:: console
+
+    sid init 7
+    sid start
+
+#. Initialize Location services
+
+.. code-block:: console
+
+    location init
+
+You should see log message with success status.
+
+#. Send location. You can use the following levels:
+   1 - BLE Uplink using Sidewalk Network location
+   2 - (not supported)
+   3 - WiFi (LR1110 radio is necessary for WiFi support)
+   4 - GNSS (LR1110 radio is necessary for GNSS support)
+
+   For WiFi and GNSS, you can test only scanning location with ``location scan`` command.
+
+.. code-block:: console
+
+    location send 1
+
+Check MQTT topic used as Location Destination in AWS MQTT Console. You should see the location data in the following format:
+
+.. code-block:: json
+
+   {
+      "coordinates": [
+         XX.XXXXXX,
+         YY.YYYYYY,
+         0
+      ],
+      "WirelessDeviceId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+      "type": "Point",
+      "properties": {
+         "verticalAccuracy": 0,
+         "horizontalAccuracy": ZZ,
+         "timestamp": "YYYY-MM-DDTHH:MM:SS.ZZZ"
+      }
+   }
+