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

Extended Advertising Report. More...

Data Fields

uint8_t num
 The number of Advertising Reports received. More...
 
uint16_t adv_type
 Type of Advertising Packet. More...
 
uint8_t addr_type
 Address type of the advertiser. More...
 
uint8_t * p_addr
 Address of the advertiser. More...
 
uint8_t adv_phy
 The primary PHY configuration of the advertiser. More...
 
uint8_t sec_adv_phy
 The secondary PHY configuration of the advertiser. More...
 
uint8_t adv_sid
 Advertising SID included in the received Advertising Report. More...
 
int8_t tx_pwr
 TX power(in dBm). More...
 
int8_t rssi
 RSSI(in dBm). More...
 
uint16_t perd_adv_intv
 Periodic Advertising interval. More...
 
uint8_t dir_addr_type
 The address type of Direct Advertising PDU. More...
 
uint8_t * p_dir_addr
 Address of Direct Advertising PDU. More...
 
uint8_t len
 Length of Advertising data(in bytes). More...
 
uint8_t * p_data
 Advertising data/Scan Response Data. More...
 

Detailed Description

Extended Advertising Report.

Field Documentation

◆ num

uint8_t st_ble_gap_ext_adv_rept_t::num

The number of Advertising Reports received.

◆ adv_type

uint16_t st_ble_gap_ext_adv_rept_t::adv_type

Type of Advertising Packet.

Bit Number description
0 Connectable advertising.
1 Scannable advertising.
2 Directed advertising.
3 Scan response.
4 Legacy advertising PDU.
5-6 The status of Advertising Data/Scan Response Data.
Data Status:
00b = Complete
01b = Incomplete, more data come
10b = Incomplete, data truncated, no more to come
All other bits Reserved for future use

◆ addr_type

uint8_t st_ble_gap_ext_adv_rept_t::addr_type

Address type of the advertiser.

value description
0x00 Public Address.
0x01 Random Address.
0x02 Public Identity Address which could be resolved in Controller.
0x03 Random Identity Address which could be resolved in Controller.
0xFF Anonymous advertisement.

◆ p_addr

uint8_t* st_ble_gap_ext_adv_rept_t::p_addr

Address of the advertiser.

Note
The BD address setting format is little endian.

◆ adv_phy

uint8_t st_ble_gap_ext_adv_rept_t::adv_phy

The primary PHY configuration of the advertiser.

The primary PHY configuration of the advertiser.

value description
0x01 1M PHY
0x03 Coded PHY

◆ sec_adv_phy

uint8_t st_ble_gap_ext_adv_rept_t::sec_adv_phy

The secondary PHY configuration of the advertiser.

value description
0x00 Nothing has been received with Secondary Advertising Channel.
0x01 The Secondary Advertising PHY configuration was 1M PHY.
0x02 The Secondary Advertising PHY configuration was 2M PHY.
0x03 The Secondary Advertising PHY configuration was Coded PHY.

◆ adv_sid

uint8_t st_ble_gap_ext_adv_rept_t::adv_sid

Advertising SID included in the received Advertising Report.

Valid range is 0 <= adv_sid <= 0x0F and 0xFF.
If the adv_sid is 0xFF, there is no field which includes SID.

◆ tx_pwr

int8_t st_ble_gap_ext_adv_rept_t::tx_pwr

TX power(in dBm).

Valid range is -127 <= tx_pwr <= 20 and 127.
If the tx_pwr is 127, it means that Tx power could not be acquired.

◆ rssi

int8_t st_ble_gap_ext_adv_rept_t::rssi

RSSI(in dBm).

Valid range is -127 <= tx_pwr <= 20 and 127.
If the tx_pwr is 127, it means that RSSI could not be acquired.

◆ perd_adv_intv

uint16_t st_ble_gap_ext_adv_rept_t::perd_adv_intv

Periodic Advertising interval.

If the perd_adv_intv is 0x0000, it means that this advertising is not periodic advertising.
If the perd_adv_intv is 0x0006 - 0xFFFF, it means that this field is the Periodic Advertising interval.
Periodic Advertising interval = per_adv_intr * 1.25ms.

◆ dir_addr_type

uint8_t st_ble_gap_ext_adv_rept_t::dir_addr_type

The address type of Direct Advertising PDU.

value description
0x00 Public Address.
0x01 Random Address.
0x02 Public Identity Address which could be resolved in Controller.
0x03 Random Identity Address which could be resolved in Controller.
0xFE Resolvable Privacy Address which could not be resolved in Controller.

◆ p_dir_addr

uint8_t* st_ble_gap_ext_adv_rept_t::p_dir_addr

Address of Direct Advertising PDU.

Note
The BD address setting format is little endian.

◆ len

uint8_t st_ble_gap_ext_adv_rept_t::len

Length of Advertising data(in bytes).

Valid range is 0 - 229.

◆ p_data

uint8_t* st_ble_gap_ext_adv_rept_t::p_data

Advertising data/Scan Response Data.