Bluetooth LE Profile API document
Bluetooth LE Profile API document Rev.1.00 [May 22, 2020]
st_ble_gap_ext_scan_param_t Struct Reference

Scan parameters. More...

Data Fields

uint8_t o_addr_type
 Own BD Address Type. More...
 
uint8_t filter_policy
 Scan Filter Policy. More...
 
st_ble_gap_scan_phy_param_tp_phy_param_1M
 Scan parameters 1M PHY. More...
 
st_ble_gap_scan_phy_param_tp_phy_param_coded
 Scan parameters Coded PHY. More...
 

Detailed Description

Scan parameters.

Field Documentation

◆ o_addr_type

uint8_t st_ble_gap_ext_scan_param_t::o_addr_type

Own BD Address Type.

In case of passive scan, this field is ignored.

macro description
BLE_GAP_ADDR_PUBLIC(0x00) Public Address
BLE_GAP_ADDR_RAND(0x01) Random Address
BLE_GAP_ADDR_RPA_ID_PUBLIC(0x02) Resolvable Private Address.
If the IRK of local device has not been registered in Resolving List, public address is used.
BLE_GAP_ADDR_RPA_ID_RANDOM(0x03) Resolvable Private Address.
If the IRK of local device has not been registered in Resolving List, the random address set by R_BLE_GAP_SetRandAddr() is used.

◆ filter_policy

uint8_t st_ble_gap_ext_scan_param_t::filter_policy

Scan Filter Policy.

macro description
BLE_GAP_SCAN_ALLOW_ADV_ALL(0x00) Accept all advertising and scan response PDUs except directed advertising PDUs not addressed to local device.
BLE_GAP_SCAN_ALLOW_ADV_WLST(0x01) Accept only advertising and scan response PDUs from remote devices whose address is registered in the White List.
Directed advertising PDUs which are not addressed to local device is ignored.
BLE_GAP_SCAN_ALLOW_ADV_EXCEPT_DIRECTED(0x02) Accept all advertising and scan response PDUs except directed advertising PDUs whose the target address is identity address but doesn't address local device. However directed advertising PDUs whose the target address is the local resolvable private address are accepted.
BLE_GAP_SCAN_ALLOW_ADV_EXCEPT_DIRECTED_WLST(0x03) Accept all advertising and scan response PDUs.
The following are excluded.
  • Advertising and scan response PDUs where the advertiser's identity address is not in the White List.
  • Directed advertising PDUs whose the target address is identity address but doesn't address local device. However directed advertising PDUs whose the target address is the local resolvable private address are accepted.

◆ p_phy_param_1M

st_ble_gap_scan_phy_param_t* st_ble_gap_ext_scan_param_t::p_phy_param_1M

Scan parameters 1M PHY.

When this field is NULL, Controller doesn't set the scan parameters for 1M PHY.

◆ p_phy_param_coded

st_ble_gap_scan_phy_param_t* st_ble_gap_ext_scan_param_t::p_phy_param_coded

Scan parameters Coded PHY.

When this field is NULL, Controller doesn't set the scan parameters for Coded PHY.

Note
If the "Balance" library is used, this field is ignored.