Description

This frame type is emitted whenever the Bluetooth scanner detects an extended advertisement from nearby devices during a GAP scan. This response frame provides valuable information about the detected advertisement including their addresses, advertisement types, signal strengths, and additional data contained within the advertisement payload.

Format

The following table provides the contents of the frame. For details on frame structure, see API frames.

Offset Size Field Name Description

0

8-bit

Start delimiter

Indicates the start of the API frame.

1

16-bit

Length

Number of bytes between the length and the checksum.

3

8-bit

Frame type

Bluetooth Scan Response with extended advertisement (0xB7).

4

48-bit

Source address

The BLE MAC address of the received advertisement.

10

8-bit

Address type

  • 0x0: Public Address Type

  • 0x1: Private randomly generated address

11

8-bit

Advertisement flags

Bit field that indicates advertisement flags:

  • Bit 0: Device is connectable

  • Bit 1-7: Reserved

12

8-bit

RSSI

The received signal strength of advertisement in –dBm.

13

8-bit

Reserved

 

14

8-bit

Adv. SID

Advertising set identifier.

15

8-bit

Primary PHY

The preferred PHY for connecting with this device:

  • 0x1: 1M PHY

  • 0x2: 2M PHY

  • 0x4: LE coded PHY 125k

  • 0x8: LE coded PHY 500k

  • 0xFF: Any PHY supported

16

8-bit

Secondary PHY

The secondary preferred PHY for connecting with this device:

  • 0x1: 1M PHY

  • 0x2: 2M PHY

  • 0x4: LE coded PHY 125k

  • 0x8: LE coded PHY 500k

  • 0xFF: Any PHY supported

17

8-bit

TX power

TX power in dBm

Range: -127 to +126

+127 means information is not available

18

16-bit

Periodic interval

Periodic advertising interval

  • 0: No periodic advertising

  • Range: 0x06 - 0xFFFF in 1.25ms units

  • Time range: 7.5 mSec to 81.92 Seconds

19

8-bit

Data completeness

  • 0x0: All advertisement data has been reported

  • 0x1: Advertisement data incomplete and more will come

  • 0x2: Advertisement data incomplete but no more will come

20

8-bit

Payload Length

Specifies the length of the advertisement payload.

21-n

Variable

Payload

Can contain various advertisement data elements (e.g manufacturing specific data or relevant details about the advertising device).

n+1

8-bit

Checksum

0xFF minus the 8-bit sum of bytes from offset 3 to this byte (between length and checksum).