Scanner#

Enum sl_bt_scanner_scan_mode_t.

Passive or active scan. Values:

• sl_bt_scanner_scan_mode_passive (0x0): Passive scanning mode where the device only listens to advertising packets and does not transmit packets

• sl_bt_scanner_scan_mode_active (0x1): Active scanning mode where the device sends out a scan request packet upon receiving a scannable advertising packet from a remote device and listens to the scan response packet from the remote device

Default value: sl_bt_scanner_scan_mode_passive.

The time interval when the device starts its last scan until it begins the subsequent scan. In other words, how often to scan

• Time = Value x 0.625 ms

• Range: 0x0004 to 0xFFFF

• Time Range: 2.5 ms to 40.96 s

Default value: 10 ms

A variable delay occurs when switching channels at the end of each scanning interval, which is included in the scanning interval time. During the switch time, advertising packets are not received by the device. The switch time variation is use case dependent. For example, if scanning while keeping active connections, the channel switch time might be longer than when scanning without any active connections. Increasing the scanning interval reduces the amount of time in which the device can't receive advertising packets because it switches channels less often.

After every scan interval, the scanner changes the frequency at which it operates. It cycles through all three advertising channels in a round robin fashion. According to the specification, all three channels must be used by a scanner.

The scan window, i.e., the duration of the scan, which must be less than or equal to the interval

• Time = Value x 0.625 ms

• Range: 0x0004 to 0xFFFF

• Time Range: 2.5 ms to 40.96 s

Default value: 10 ms

Note that the packet reception is aborted if it's started just before the scan window ends.

Enum sl_bt_scanner_scan_mode_t.

Passive or active scan. Values:

• sl_bt_scanner_scan_mode_passive (0x0): Passive scanning mode where the device only listens to advertising packets and does not transmit packets

• sl_bt_scanner_scan_mode_active (0x1): Active scanning mode where the device sends out a scan request packet upon receiving a scannable advertising packet from a remote device and listens to the scan response packet from the remote device

Default value: sl_bt_scanner_scan_mode_passive.

The time interval when the device starts its last scan until it begins the subsequent scan. In other words, how often to scan

• Time = Value x 0.625 ms

• Range: 0x0004 to 0xFFFF

• Time Range: 2.5 ms to 40.96 s

Default value: 10 ms

A variable delay occurs when switching channels at the end of each scanning interval, which is included in the scanning interval time. During the switch time, advertising packets are not received by the device. The switch time variation is use case dependent. For example, if scanning while keeping active connections, the channel switch time might be longer than when scanning without any active connections. Increasing the scanning interval reduces the amount of time in which the device can't receive advertising packets because it switches channels less often.

After every scan interval, the scanner changes the frequency at which it operates. It cycles through all three advertising channels in a round robin fashion. According to the specification, all three channels must be used by a scanner.

The scan window, i.e., the duration of the scan, which must be less than or equal to the interval

• Time = Value x 0.625 ms

• Range: 0x0004 to 0xFFFF

• Time Range: 2.5 ms to 40.96 s

Default value: 10 ms

Note that the packet reception is aborted if it's started just before the scan window ends.

No flags are currently defined. Set this parameter to 0.

Enum sl_bt_scanner_filter_policy_t.

The scanning filter policy to use when scanning is started. The filter policy determines which advertisements and scan responses are delivered to the application. Values:

• sl_bt_scanner_filter_policy_basic_unfiltered (0x0): Advertising and scan response PDUs are processed from all devices. For directed advertising, the target address must additionally match the identity address of the local device or be a Resolvable Private Address that is resolved to the local device by the Bluetooth controller.

• sl_bt_scanner_filter_policy_basic_filtered (0x1): Advertising and scan response PDUs are processed only from devices that the application has added to the Filter Accept List. For directed advertising, the target address must additionally match the identity address of the local device or be a Resolvable Private Address that is resolved to the local device by the Bluetooth controller.

• sl_bt_scanner_filter_policy_extended_unfiltered (0x2): Advertising and scan response PDUs are processed from all devices. For directed advertising, the target address must additionally match the identity address of the local device or be any Resolvable Private Address.

• sl_bt_scanner_filter_policy_extended_filtered (0x3): Advertising and scan response PDUs are processed only from devices that the application has added to the Filter Accept List. For directed advertising, the target address must additionally match the identity address of the local device or be any Resolvable Private Address.

Default value: sl_bt_scanner_filter_policy_basic_unfiltered

Enum sl_bt_scanner_scan_phy_t. The scanning PHY(s) the setting is set for. Values:

• sl_bt_scanner_scan_phy_1m (0x1): 1M PHY

• sl_bt_scanner_scan_phy_coded (0x4): Coded PHY

• sl_bt_scanner_scan_phy_1m_and_coded (0x5): 1M and Coded PHYs

Scan interval is defined as the time interval when the device starts its last scan until it begins the subsequent scan. In other words, how often to scan

• Time = Value x 0.625 ms

• Range: 0x0004 to 0xFFFF

• Time Range: 2.5 ms to 40.96 s

Default value: 10 ms

A variable delay occurs when switching channels at the end of each scanning interval, which is included in the scanning interval time. During the switch time, advertising packets are not received by the device. The switch time variation is use case-dependent. For example, if scanning while keeping active connections, the channel switch time might be longer than when scanning without any active connections. Increasing the scanning interval reduces the amount of time in which the device can't receive advertising packets because it switches channels less often.

After every scan interval, the scanner changes the frequency at which it operates. It cycles through all three advertising channels in a round robin fashion. According to the specification, all three channels must be used by a scanner.

Scan window defines the duration of the scan which must be less than or equal to the scan_interval

• Time = Value x 0.625 ms

• Range: 0x0004 to 0xFFFF

• Time Range: 2.5 ms to 40.96 s

Default value: 10 ms Note that the packet reception is aborted if it's started just before the scan window ends.

Enum sl_bt_scanner_scan_phy_t. The scanning PHY(s) the setting is set for. Values:

• sl_bt_scanner_scan_phy_1m (0x1): 1M PHY

• sl_bt_scanner_scan_phy_coded (0x4): Coded PHY

• sl_bt_scanner_scan_phy_1m_and_coded (0x5): 1M and Coded PHYs

Enum sl_bt_scanner_scan_mode_t.

The scan mode. Values:

• sl_bt_scanner_scan_mode_passive (0x0): Passive scanning mode where the device only listens to advertising packets and does not transmit packets

• sl_bt_scanner_scan_mode_active (0x1): Active scanning mode where the device sends out a scan request packet upon receiving a scannable advertising packet from a remote device and listens to the scan response packet from the remote device

Default value: sl_bt_scanner_scan_mode_passive.

Enum sl_bt_scanner_scan_phy_t.

The scanning PHY(s).

In simultaneous scanning, the stack alternates the scanning on two PHYs by switching the PHY at every scan interval. When a timing parameter is set differently on 1M and Coded PHY, the stack chooses the most relaxed value for both PHYs during simultaneous scanning, i.e., the largest scan interval or the smallest scan window. If one PHY is set to passive scanning and the other to active scanning, passive scanning is chosen for simultaneous scanning. Values:

• sl_bt_scanner_scan_phy_1m (0x1): Initiate the scanning on the 1M PHY

• sl_bt_scanner_scan_phy_coded (0x4): Initiate the scanning on the Coded PHY

• sl_bt_scanner_scan_phy_1m_and_coded (0x5): Simultaneous scanning by initiating the scanning on the 1M and Coded PHY alternatively

Enum sl_bt_scanner_discover_mode_t. Bluetooth discovery Mode. Values:

• sl_bt_scanner_discover_limited (0x0): Discover only limited discoverable devices.

• sl_bt_scanner_discover_generic (0x1): Discover limited and general discoverable devices.

• sl_bt_scanner_discover_observation (0x2): Discover non-discoverable, limited and general discoverable devices.