Advertisement Data Fields

This part defines the advertisement data fields used in the btshell app. For a complete list of all data types and formats used for Extended Inquiry Response (EIR), Advertising Data (AD), and OOB data blocks, refer to the Supplement to the Bluetooth Core Specification, CSSv6, available for download here.

NameDefinitionDetailsbtshell Notes
flagsIndicates basic information about the advertiser.Flags used over the LE physical channel are:
* Limited Discoverable Mode
* General Discoverable Mode
* BR/EDR Not Supported
* Simultaneous LE and BR/EDR to Same Device Capable (Controller)
* Simultaneous LE and BR/EDR to Same Device Capable (Host)
NimBLE will auto-calculate if set to 0.
uuid1616-bit Bluetooth Service UUIDsIndicates the Service UUID list is incomplete i.e. more 16-bit Service UUIDs available. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.Set repeatedly for multiple service UUIDs.
uuid16_is_complete16-bit Bluetooth Service UUIDsIndicates the Service UUID list is complete. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.
uuid3232-bit Bluetooth Service UUIDsIndicates the Service UUID list is incomplete i.e. more 32-bit Service UUIDs available. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.Set repeatedly for multiple service UUIDs.
uuid32_is_complete32-bit Bluetooth Service UUIDsIndicates the Service UUID list is complete. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.
uuid128Global 128-bit Service UUIDsMore 128-bit Service UUIDs available.Set repeatedly for multiple service UUIDs.
uuid128_is_completeGlobal 128-bit Service UUIDsComplete list of 128-bit Service UUIDs
tx_power_levelTX Power LevelIndicates the transmitted power level of the packet containing the data type. The TX Power Level data type may be used to calculate path loss on a received packet using the following equation:

pathloss = Tx Power Level – RSSI

where “RSSI” is the received signal strength, in dBm, of the packet received.
NimBLE will auto-calculate if set to -128.
slave_interval_rangeSlave Connection Interval RangeContains the Peripheral’s preferred connection interval range, for all logical connections. Size: 4 Octets . The first 2 octets defines the minimum value for the connection interval in the following manner:

connIntervalmin = Conn_Interval_Min * 1.25 ms

Conn_Interval_Min range: 0x0006 to 0x0C80
Value of 0xFFFF indicates no specific minimum.

The other 2 octets defines the maximum value for the connection interval in the following manner:

connIntervalmax = Conn_Interval_Max * 1.25 ms
Conn_Interval_Max range: 0x0006 to 0x0C80
Conn_Interval_Max shall be equal to or greater than the Conn_Interval_Min.
Value of 0xFFFF indicates no specific maximum.
service_data_uuid16Service Data - 16 bit UUIDSize: 2 or more octets
The first 2 octets contain the 16 bit Service UUID followed by additional service data
public_target_addressPublic Target AddressDefines the address of one or more intended recipients of an advertisement when one or more devices were bonded using a public address. This data type shall exist only once. It may be sent in either the Advertising or Scan Response data, but not both.
appearanceAppearanceDefines the external appearance of the device. The Appearance data type shall exist only once. It may be sent in either the Advertising or Scan Response data, but not both.
advertising_intervalAdvertising IntervalContains the advInterval value as defined in the Core specification, Volume 6, Part B, Section 4.4.2.2.
service_data_uuid32Service Data - 32 bit UUIDSize: 4 or more octets
The first 4 octets contain the 32 bit Service UUID followed by additional service data
service_data_uuid128Service Data - 128 bit UUIDSize: 16 or more octets
The first 16 octets contain the 128 bit Service UUID followed by additional service data
uriUniform Resource Identifier (URI)Scheme name string and URI as a UTF-8 string
mfg_dataManufacturer Specific dataSize: 2 or more octets
The first 2 octets contain the Company Identifier Code followed by additional manufacturer specific data
eddystone_url