12. Sidewalk Location Service Test Cases

12.1 LOCSVC-E2E/EP/BLE-GNSS-SCAN/UL/BV/01: Resolve EN location on BLE uplink message containing GNSS scan information

12.1.1 Test Purpose

Send GNSS scan data on a BLE uplink message.

12.1.2 Initial Conditions

The Sidewalk stack (BLE) is initialized and started on the DUT.
DUT is registered with Amazon Sidewalk network.
DUT is time-synced with Amazon Sidewalk network.
Lower Tester operates in BLE mode.

12.1.3 Test Procedure

sequenceDiagram
    participant DUT as DUT
    participant Upper_Tester as Upper Tester
    Note over DUT,Upper_Tester: Sidewalk application started
    Upper_Tester->>DUT: location init
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 0
    Upper_Tester->>DUT: sid conn_req 1
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 1
    Upper_Tester->>DUT: location send 4
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    DUT->>Upper_Tester: SBDT_NDB(4) st 2->3
    DUT->>Upper_Tester: Transfer completed successfully
    DUT->>Upper_Tester: loc send result: 0

sequenceDiagram
    participant REST_API_User as REST API User
    participant Cloud as Cloud
    Note over REST_API_User,Cloud: Query device location
    REST_API_User->>Cloud: get device position with wireless_device_id
    Cloud->>REST_API_User: Returns GeoJSON position (type Point, coordinates [lon, lat, alt], properties: verticalAccuracy, horizontalAccuracy, timestamp)

12.1.4 Expected Results

12.1.4.1 Pass Verdict

The DUT should successfully send the uplink message with GNSS scan information, and the Cloud should be able to resolve the device location based on the GNSS data.

12.2 LOCSVC-E2E/EP/BLE-WIFI-SCAN/UL/BV/02: Resolve EN location on BLE uplink message containing Wi-Fi scan information

12.2.1 Test Purpose

Send Wi-Fi Scan results on a BLE uplink message.

12.2.2 Initial Conditions

The Sidewalk stack (BLE) is initialized and started on the DUT.
DUT is registered with Amazon Sidewalk network.
DUT is time-synced with Amazon Sidewalk network.
Lower Tester operates in BLE mode.

12.2.3 Test Procedure

sequenceDiagram
    participant DUT as DUT
    participant Upper_Tester as Upper Tester
    Note over DUT,Upper_Tester: Sidewalk application started
    Upper_Tester->>DUT: location init
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 0
    Upper_Tester->>DUT: sid conn_req 1
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 1
    Upper_Tester->>DUT: location send 3
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    DUT->>Upper_Tester: SBDT_NDB(3) st 2->3
    DUT->>Upper_Tester: Transfer completed successfully
    DUT->>Upper_Tester: loc send result: 0

sequenceDiagram
    participant REST_API_User as REST API User
    participant Cloud as Cloud
    Note over REST_API_User,Cloud: Query device location
    REST_API_User->>Cloud: get device position with wireless_device_id
    Cloud->>REST_API_User: Returns GeoJSON position (type Point, coordinates [lon, lat, alt], properties: verticalAccuracy, horizontalAccuracy, timestamp)

12.2.4 Expected Results

12.2.4.1 Pass Verdict

The DUT should successfully send the uplink message with Wi-Fi scan information, and the Cloud should resolve the device location.

12.3 LOCSVC-E2E/EP/BLE-GW-LOC/UL/BV/03: Resolve EN location on BLE uplink message with connected GW location

12.3.1 Test Purpose

Send DUT location as a proximity to a GW connected over BLE.

12.3.2 Initial Conditions

The Sidewalk stack (BLE) is initialized and started on the DUT.
DUT is registered with Amazon Sidewalk network.
DUT is time-synced with Amazon Sidewalk network.
Lower Tester operates in BLE mode.

12.3.3 Test Procedure

sequenceDiagram
    participant DUT as DUT
    participant Upper_Tester as Upper Tester
    Note over DUT,Upper_Tester: Sidewalk application started
    Upper_Tester->>DUT: location init
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 0
    Upper_Tester->>DUT: sid conn_req 1
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 1
    Upper_Tester->>DUT: location send 1
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    DUT->>Upper_Tester: SBDT_NDB(1) st 2->3
    DUT->>Upper_Tester: Transfer completed successfully
    DUT->>Upper_Tester: loc send result: 0

sequenceDiagram
    participant REST_API_User as REST API User
    participant Cloud as Cloud
    Note over REST_API_User,Cloud: Query device location
    REST_API_User->>Cloud: get device position with wireless_device_id
    Cloud->>REST_API_User: Returns GeoJSON position (type Point, coordinates [lon, lat, alt], properties: verticalAccuracy, horizontalAccuracy, timestamp)

12.3.4 Expected Results

12.3.4.1 Pass Verdict

The DUT should successfully send the uplink message with gateway location information, and the Cloud should resolve the device location.

12.4 LOCSVC-E2E/EP/LORA-GNSS-SCAN/UL/BV/01: Resolve EN location on LoRa uplink message containing GNSS scan information

12.4.1 Test Purpose

Send GNSS location scan data on LoRa.

12.4.2 Initial Conditions

The Sidewalk stack (LoRa) is initialized and started on the DUT.
DUT is registered with Amazon Sidewalk network.
DUT is time-synced with Amazon Sidewalk network.
Lower Tester operates in LoRa mode.

12.4.3 Test Procedure

sequenceDiagram
    participant DUT as DUT
    participant Upper_Tester as Upper Tester
    Note over DUT,Upper_Tester: Sidewalk application started
    Upper_Tester->>DUT: location init
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 4
    Upper_Tester->>DUT: location send 4
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    DUT->>Upper_Tester: SBDT_NDB(4) st 2->3
    DUT->>Upper_Tester: Transfer completed successfully
    DUT->>Upper_Tester: loc send result: 0

sequenceDiagram
    participant REST_API_User as REST API User
    participant Cloud as Cloud
    Note over REST_API_User,Cloud: Query device location
    REST_API_User->>Cloud: get device position with wireless_device_id
    Cloud->>REST_API_User: Returns GeoJSON position (type Point, coordinates [lon, lat, alt], properties: verticalAccuracy, horizontalAccuracy, timestamp)

12.4.4 Expected Results

12.4.4.1 Pass Verdict

The DUT should successfully send the uplink messages with GNSS scan information via LoRa, and the Cloud should resolve the device location.

12.5 LOCSVC-E2E/EP/LORA-WIFI-SCAN/UL/BV/02: Resolve EN location on LoRa uplink message containing Wi-Fi scan information

12.5.1 Test Purpose

Send Wi-Fi scan data on LoRa.

12.5.2 Initial Conditions

The Sidewalk stack (LoRa) is initialized and started on the DUT.
DUT is registered with Amazon Sidewalk network.
DUT is time-synced with Amazon Sidewalk network.
Lower Tester operates in LoRa mode.

12.5.3 Test Procedure

sequenceDiagram
    participant DUT as DUT
    participant Upper_Tester as Upper Tester
    Note over DUT,Upper_Tester: Sidewalk application started
    Upper_Tester->>DUT: location init
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    Note over DUT,Upper_Tester: Ensure DUT's Link_Mask is 4
    Upper_Tester->>DUT: location send 3
    DUT->>Upper_Tester: #35;SID_ERROR_NONE
    DUT->>Upper_Tester: SBDT_NDB(3) st 2->3
    DUT->>Upper_Tester: Transfer completed successfully
    DUT->>Upper_Tester: loc send result: 0

sequenceDiagram
    participant REST_API_User as REST API User
    participant Cloud as Cloud
    Note over REST_API_User,Cloud: Query device location
    REST_API_User->>Cloud: get device position with wireless_device_id
    Cloud->>REST_API_User: Returns GeoJSON position (type Point, coordinates [lon, lat, alt], properties: verticalAccuracy, horizontalAccuracy, timestamp)

12.5.4 Expected Results

12.5.4.1 Pass Verdict

The DUT should successfully send the uplink message with Wi-Fi scan information via LoRa, and the Cloud should resolve the device location.