Skip to main content Link Menu Expand (external link) Document Search Copy Copied

BLE Test Cases

Test Case ID: CMN/EN/API/INF/BV-01: End Node has correct MCU version after launching Sidewalk application

Field Value
Case ID C103619213
Executable by Customer Yes
Test Steps
Step Description Expected Result
1 Check response on command: sid sdk_version Response example: app: 1.19.5-36 (rev. 0)

Test Case ID: BLE/EN/CONN/REG/BV/01: An unregistered End Node successfully completes Sidewalk device registration over BLE

Field Value
Case ID C103619399
Executable by Customer Yes
Test Steps
Step Description Expected Result
1 Run the following commands on the EN device: sid init 1 sid start Each command returns: CMD: ERR: 0
2 Place EN next to a registered GW and wait for BLE registration to complete. Verify registration status with: sid last_status EVENT SID STATUS: State: 1, Reg: 0, Time: 1, Link_Mask: 0 Key check: Reg: 0 (registered)

Test Case ID: BLE/EN/CONN/REG/BV/02: An unregistered End Node successfully completes Sidewalk device registration with use of FFN

Field Value
Case ID C103619414
Executable by Customer Yes
Test Steps
Step Description Expected Result
1 Run the following commands on the EN device: sid init 1 sid start Each command returns: CMD: ERR: 0
2 Place the EN next to a GW Registration process should start automatically
3 Verify registration status with: sid last_status EVENT SID STATUS: State: 1, Reg: 0, Time: 1, Link_Mask: 0 Key check: Reg: 0 (registered)

Test Case ID: BLE/EN/CONN/REG/BV/03: End Node can be deregistered from Sidewalk network

Field Value
Case ID C103619400
Executable by Customer Yes
Test Steps
Step Description Expected Result
1 Run the following command to deregister the device: sid factory_reset CMD: ERR: 0
2 Verify deregistration status with: sid last_status EVENT SID STATUS: State: 1, Reg: 1, Time: 1, Link_Mask: 0 Key check: Reg: 1 (deregistered)
Field Value
Case ID C103619402
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Send 1 downlink packet from AWS IoT to EN with 1 byte payload EVENT SID RECEIVED: TYPE: 1, ID: <id>, LEN: 1, LINK: 1, LINK_MODE: <x>, ACK_REQUESTED: <x>, ACK: <x>, DUP: <x>, RSSI: <x>, SNR: <x> Data: <payload> Key check: ID matches sent packet, LEN: 1
2 Send 1 downlink packet from AWS IoT to EN with 125 bytes payload EVENT SID RECEIVED: TYPE: 1, ID: <id>, LEN: 125, LINK: 1, LINK_MODE: <x>, ACK_REQUESTED: <x>, ACK: <x>, DUP: <x>, RSSI: <x>, SNR: <x> Data: <payload> Key check: ID matches sent packet, LEN: 125
3 Send 1 downlink packet from AWS IoT to EN with 255 bytes payload EVENT SID RECEIVED: TYPE: 1, ID: <id>, LEN: 255, LINK: 1, LINK_MODE: <x>, ACK_REQUESTED: <x>, ACK: <x>, DUP: <x>, RSSI: <x>, SNR: <x> Data: <payload> Key check: ID matches sent packet, LEN: 255
Field Value
Case ID C103619403
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • BT connection is established (sid conn_req 1)
Test Steps
Step Description Expected Result
1 Run the following command on EN to send 1 UL packet with 1 byte payload: sid send <1-byte-payload> CMD: ERR: 0 TYPE: 2 ID: <id> EVENT SID SEND STATUS: SID ERR: 0, TYPE: 2, ID: <id>, LINK: 1 LINK_MODE: 0 ADDITIONAL ATTRS: 0 Key check: SID ERR: 0 (sent successfully), packet received on AWS IoT
2 Run the following command on EN to send 1 UL packet with 125 bytes payload: sid send <125-byte-payload> CMD: ERR: 0 TYPE: 2 ID: <id> EVENT SID SEND STATUS: SID ERR: 0, TYPE: 2, ID: <id>, LINK: 1 LINK_MODE: 0 ADDITIONAL ATTRS: 0 Key check: SID ERR: 0 (sent successfully), packet received on AWS IoT
3 Run the following command on EN to send 1 UL packet with 255 bytes payload: sid send <255-byte-payload> CMD: ERR: 0 TYPE: 2 ID: <id> EVENT SID SEND STATUS: SID ERR: 0, TYPE: 2, ID: <id>, LINK: 1 LINK_MODE: 0 ADDITIONAL ATTRS: 0 Key check: SID ERR: 0 (sent successfully), packet received on AWS IoT

Test Case ID: BLE-EP-CONN-EST-BV/01: Gateway establishes BLE connection on Endpoint’s request

Field Value
Case ID C103619417
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Run the following command on EN: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 1 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (BLE connected)

Test Case ID: BLE/EN/CONN/EST/BV/02: End Node can connect with Gateway via BLE, after reinitializing Sidewalk library

Field Value
Case ID C103619412
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Deinitialize Sidewalk: sid deinit CMD: ERR: 0
2 Initialize and start Sidewalk, then wait for time sync: sid init 1 sid start Each command returns: CMD: ERR: 0 Then wait for time sync: EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 1 Key check: Time: 0 (time synced)
3 Wait for BLE disconnected, verify with: sid last_status EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: BLE: 0 (disconnected)
4 Set connection request on EN: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 1 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (BLE connected)

Test Case ID: BLE/EN/CONN/EST/BV/03: End Node can connect with Gateway via BLE, after restarting Sidewalk library

Field Value
Case ID C103619413
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Stop Sidewalk: sid stop CMD: ERR: 0
2 Start Sidewalk: sid start CMD: ERR: 0
3 Verify BLE is disconnected: sid last_status EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: BLE: 0 (disconnected)
4 Set connection request on EN: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 1 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (BLE connected)

Test Case ID: BLE/EN/CONN/DSC/BV/01: BLE connection between Gateway and End Node is dropped after 30 seconds of being idle

Field Value
Case ID C103619404
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Do not send any UL or DL for 30 seconds. Verify BLE is disconnected: sid last_status EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: BLE: 0 (disconnected after 30s idle)
Field Value
Case ID C103619405
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Wait 15 seconds. Do not send any UL or DL. BLE connection still active BLE: 1
3 Send UL packet from EN: sid send TEST CMD: ERR: 0 TYPE: 2 ID: <id> EVENT SID SEND STATUS: SID ERR: 0, TYPE: 2, ID: <id>, LINK: 1 LINK_MODE: 0 ADDITIONAL ATTRS: 0 Key check: SID ERR: 0 (sent successfully)
4 Wait 30 seconds after UL sent. Verify BLE is disconnected: sid last_status EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: BLE: 0 (disconnected after 30s)
Field Value
Case ID C103619406
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN is time synchronized
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Wait 15 seconds. Do not send any UL or DL. BLE connection still active BLE: 1
3 Send DL packet from AWS IoT to EN via REST API EVENT SID RECEIVED: TYPE: <type>, ID: <id>, LEN: <len>, LINK: 1, LINK_MODE: <x>, ACK_REQUESTED: <x>, ACK: <x>, DUP: <x>, RSSI: <x>, SNR: <x> Data: <payload> Key check: DL received on EN
4 Wait 30 seconds after DL received. Verify BLE is disconnected: sid last_status EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: BLE: 0 (disconnected after 30s)

Test Case ID: BLE/EN/CONN/DSC/BV/06: End Node drops BLE connection after stopping Sidewalk library

Field Value
Case ID C103619410
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Stop Sidewalk: sid stop EVENT SID STATUS: State: 1, Reg: 0, Time: 0, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: Link_Mask: 0, BLE: 0

Test Case ID: BLE/EN/CONN/DSC/BV/07: End Node drops BLE connection after deinitializing Sidewalk library

Field Value
Case ID C103619411
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Deinitialize Sidewalk: sid deinit EVENT SID STATUS: State: 1, Reg: 0, Time: 1, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: Link_Mask: 0, BLE: 0

Test Case ID: BLE/EN/CONN/BCN/BV/01: End Node transmits beacons only when BLE connection is not established

Field Value
Case ID C103619407
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • BT sniffer is ready
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 While BLE connection is active, monitor BT sniffer for 10 seconds No beacons captured by BT sniffer. Key check: Beacon is invisible when BLE connected
3 Wait for BLE to disconnect (idle 30s). Monitor BT sniffer for 10 seconds. BLE disconnected: EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Beacons captured by BT sniffer. Key check: Beacon is visible after BLE disconnected

Test Case ID: BLE/EN/CONN/BCN/BV/02: End Node transmits beacons that contain Identifier (TX-ID) which changes every 15 minutes

Field Value
Case ID C103619416
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
Test Steps
Step Description Expected Result
1 Initialize BLE stack and wait for BLE disconnected: sid init 1 sid start EVENT SID STATUS: State: 1, Reg: 0, Time: 0, Link_Mask: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 0 Key check: BLE disconnected
2 Use BLE sniffer to collect 2 TX-ID rotations (wait up to 20 min each): Monitor beacon TX-ID changes in application specific data TX-ID rotates twice. Each rotation logged with elapsed time. Key check: TX-ID changes observed in beacon data
3 Verify TX-ID rotation interval is within 14~16 minutes Rotation time: 840s~960s (14~16 min). Key check: TX-ID rotates every ~15 minutes per Sidewalk spec

Test Case ID: BLE/EN/CONN/BCN/BV/03: End Node transmits beacons with 160ms interval for the first 30 seconds after starting Sidewalk library

Field Value
Case ID C103619408
Executable by Customer Yes
Preconditions
  • EN is registered in Sidewalk network
  • GW is turned off
  • BT sniffer is ready
Test Steps
Step Description Expected Result
1 Power on device, catch beacons Measure the time between beacons for 30 seconds. The mean interval should be around 160 ms.

Test Case ID: BLE/EN/CONN/BCN/BV/04: End Node transmits beacons with 1 s interval, 30 seconds after starting Sidewalk library

Field Value
Case ID C103619409
Executable by Customer Yes
Preconditions
  • EN is registered in Sidewalk network
  • GW is turned off
  • BT sniffer is ready
Test Steps
Step Description Expected Result
1 Power on device, wait 2 min, catch beacons Measure the time between beacons for 30 seconds. The mean interval should be around 1000ms.

Test Case ID: BLE-EP-CONN-DUP-BV/01: BLE connection is closed after Endpoint receives 10 packets with duplicate SEQ number within one minute (filter duplicates enabled)

Field Value
Case ID C103619419
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • Duplicate filter enabled: sid option -d 0
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Send 1 DL packet from AWS IoT with SEQ number <seq> EVENT SID RECEIVED: TYPE: <type>, ID: <id>, LEN: <len>, LINK: 1, LINK_MODE: <x>, ACK_REQUESTED: <x>, ACK: <x>, DUP: <x>, RSSI: <x>, SNR: <x> Data: <payload> Key check: DL received on EN
3 Send 10 DL packets with the same SEQ number as Step 2, all within 1 minute BLE connection terminated after 10th duplicate DL received: [INFO]: BLE (Disconnected|DISCONNECTED) Key check: BLE disconnected

Test Case ID: BLE-EP-CONN-DUP-BV/02: BLE connection is closed after Endpoint receives 10 packets with various duplicate SEQ numbers within one minute (filter duplicates enabled)

Field Value
Case ID C103619418
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • Duplicate filter enabled: sid option -d 0
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Send 3 DL packets with various SEQ numbers (e.g. SEQ=1, SEQ=2, SEQ=3) EVENT SID RECEIVED: TYPE: <type>, ID: <id>, LEN: <len>, LINK: 1, ... Data: <payload> Key check: All 3 DL packets received on EN
3 Send within 1 minute: 3x DL with SEQ=1, 3x DL with SEQ=2, 4x DL with SEQ=3 BLE connection terminated after 10th duplicate DL received: [INFO]: BLE (Disconnected|DISCONNECTED) Key check: BLE disconnected

Test Case ID: BLE-EP-CONN-DUP-BV/03: BLE connection is not closed after Endpoint receives 10 packets with duplicate SEQ number within one minute (filter duplicates disabled)

Field Value
Case ID C103619420
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • Duplicate filter disabled: sid option -d 1
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Send 1 DL packet from AWS IoT with SEQ number <seq> EVENT SID RECEIVED: TYPE: <type>, ID: <id>, LEN: <len>, LINK: 1, ... Data: <payload> Key check: DL received on EN
3 Send 10 DL packets with the same SEQ number as Step 2, all within 1 minute BLE connection remains active after 10th duplicate DL received. Key check: BLE NOT disconnected

Test Case ID: BLE-EP-CONN-DUP-BV/04: BLE connection is not closed after Endpoint receives 10 packets with various duplicate SEQ numbers within one minute (filter duplicates disabled)

Field Value
Case ID C103619421
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • Duplicate filter disabled: sid option -d 1
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Send 3 DL packets with various SEQ numbers (e.g. SEQ=1, SEQ=2, SEQ=3) EVENT SID RECEIVED: TYPE: <type>, ID: <id>, LEN: <len>, LINK: 1, ... Data: <payload> Key check: All 3 DL packets received on EN
3 Send within 1 minute: 3x DL with SEQ=1, 3x DL with SEQ=2, 4x DL with SEQ=3 BLE connection remains active after 10th duplicate DL received. Key check: BLE NOT disconnected

Test Case ID: BLE-EP-CONN-DUP-BV/05: BLE connection is not closed after 10 packets with duplicate SEQ number reach Endpoint, if not all of those packets are sent within one minute

Field Value
Case ID C103619422
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
  • EN has time synchronized
  • Duplicate filter enabled: sid option -d 0
Test Steps
Step Description Expected Result
1 Verify BLE is disconnected, then set connection request: sid conn_req 1 CMD: ERR: 0 EVENT SID STATUS LINK MODE: LORA: 0, FSK: 0, BLE: 1 Key check: BLE: 1 (connected)
2 Send 1 DL packet from AWS IoT with SEQ number <seq> EVENT SID RECEIVED: TYPE: <type>, ID: <id>, LEN: <len>, LINK: 1, ... Data: <payload> Key check: DL received on EN
3 Send 10 DL packets with the same SEQ number as Step 2, with 7s interval between each (10th duplicate DL received more than 1 minute after 1st duplicate) BLE connection remains active after 10th duplicate DL received. Key check: BLE NOT disconnected (packets spread over >1 minute)

Test Case ID: BLE/EN/NW-SYNC/TIME/BV/01: End Node completes the initial time sync procedure

Field Value
Case ID C103619401
Executable by Customer Yes
Preconditions
  • GW is registered in Sidewalk network
  • EN is registered in Sidewalk network
Test Steps
Step Description Expected Result
1 Initialize and start Sidewalk, then wait for time sync: sid init 1 sid start Each command returns: CMD: ERR: 0 Then wait for time sync: EVENT SID STATUS: State: 0, Reg: 0, Time: 0, Link_Mask: 1 Key check: Time: 0 (time synced)

Back to top

©2023 Amazon.com, Inc. or its affiliates (collectively, “Amazon”). All Rights Reserved.