An OS to build, deploy and securely manage billions of devices

Latest News:

Apache Mynewt 1.13.0, Apache NimBLE 1.8.0 released November 25, 2024)
  • Quick Start
  • About
  • Talks
  • Documentation
  • Download
  • Community
  • CVE
Docs / BLE User Guide / API for btshell app / Advertisement Data Fields
Edit on GitHub
  • Introduction
  • Setup & Get Started
  • Concepts
  • Tutorials
  • Third-party Resources
  • OS User Guide
  • BLE User Guide
    • NimBLE Security
    • NimBLE Setup
    • NimBLE Host
    • btshell Usage API
      • GAP
      • GATT
      • Advertisement Data Fields
    • Bluetooth Mesh
  • Newt Tool Guide
  • Newt Manager Guide
  • Mynewt FAQ
  • Appendix

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.

Advertisement Data Fields¶

Name

Definition

Details

btshell Notes

flags

Indicates 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.

uuid16

16-bit Bluetooth Service UUIDs

Indicates 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_complete

16-bit Bluetooth Service UUIDs

Indicates the Service UUID list is complete. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.

uuid32

32-bit Bluetooth Service UUIDs

Indicates 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_complete

32-bit Bluetooth Service UUIDs

Indicates the Service UUID list is complete. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.

uuid128

Global 128-bit Service UUIDs

More 128-bit Service UUIDs available.

Set repeatedly for multiple service UUIDs.

uuid128_is_complete

Global 128-bit Service UUIDs

Complete list of 128-bit Service UUIDs

tx_power_level

TX Power Level

Indicates 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_range

Slave Connection Interval Range

Contains 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_uuid16

Service Data - 16 bit UUID

Size: 2 or more octets The first 2 octets contain the 16 bit Service UUID followed by additional service data

public_target_address

Public Target Address

Defines 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.

appearance

Appearance

Defines 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_interval

Advertising Interval

Contains the advInterval value as defined in the Core specification, Volume 6, Part B, Section 4.4.2.2.

service_data_uuid32

Service Data - 32 bit UUID

Size: 4 or more octets The first 4 octets contain the 32 bit Service UUID followed by additional service data

service_data_uuid128

Service Data - 128 bit UUID

Size: 16 or more octets The first 16 octets contain the 128 bit Service UUID followed by additional service data

uri

Uniform Resource Identifier (URI)

Scheme name string and URI as a UTF-8 string

mfg_data

Manufacturer Specific data

Size: 2 or more octets The first 2 octets contain the Company Identifier Code followed by additional manufacturer specific data

eddystone_url

Next: Bluetooth Mesh Previous: GATT feature API for btshell

Apache Mynewt is available under Apache License, version 2.0.

Apache

Copyright © 2015-2024 The Apache Software Foundation.
Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.

Slack Icon