Tags
- BGM13S22F512GA
- RF Hardware
- Bluetooth Low Energy Reference Designs
- BGM11S12F256GA
- Modules
- Audio and Radio
- Safety Certifications
- BGM123A256
- Bluegiga Legacy Wi-Fi Modules
- Certificates of Compliance
- Bluegiga Legacy Modules
- Bluetooth Low Energy Kits
- EFR32BG1B232F128GM48
- BLE112
- Blue Gecko Bluetooth Low Energy SoCs
- Bluetooth Low Energy
- Bluetooth Classic
- User's Guides
- BGM121A256
- Wi-Fi
- Bluetooth SDK
- Schematic & Layout Files
- BGX13S22GA
- Knowledge Base Articles
- MGM13S02F512GA
- Bluetooth Low Energy Accessories
- Simplicity Studio
- Blue Gecko Bluetooth Low Energy Modules
Top Authors
Archives
- 2016 May
- 2016 June
- 2016 July
- 2016 August
- 2016 September
- 2016 October
- 2016 November
- 2016 December
- 2017 January
- 2017 February
- 2017 March
- 2017 April
- 2017 May
- 2017 June
- 2017 July
- 2017 August
- 2017 September
- 2017 November
- 2017 December
- 2018 January
- 2018 February
- 2018 March
- 2018 April
- 2018 May
- 2018 June
- 2018 July
- 2018 August
- 2018 September
- 2018 November
- 2018 December
- 2019 January
- 2019 February
- 2019 March
- 2019 April
- 2019 June
- 2019 July
- 2019 September
- 2019 October
- 2020 March
- 2020 August
- 2020 October
- 2020 November
- 2021 April
Bluetooth Knowledge Base
KBA_BT_0310: Changes to the le_gap class of API functions
Changes to le_gap APIs
Introduction
In order to support the Bluetooth 5 advertisement extensions and to make the API scalable, several changes have been made to the le_gap class of APIs starting in version 2.8.x of the Silicon Labs Bluetooth SDK.
Discussion
Several of the API functions in the le_gap class have been marked as deprecated and are to be replaced by new API functions as summarized in the following table
Old API
New API
cmd_le_gap_bt5_set_adv_parameters
cmd_le_gap_set_advertise_timing
cmd_le_gap_set_advertise_channel_map
cmd_le_gap_report_scan_request
cmd_le_gap_set_mode
cmd_le_gap_start_advertising
cmd_le_gap_stop_advertising
cmd_experiment_set_coded_phy_advertising
cmd_le_gap_set_advertise_phy
none
cmd_le_gap_set_configuration
cmd_le_gap_clear_configuration
cmd_le_gap_set_scan_parameters
cmd_le_gap_set_discovery_timing
cmd_le_gap_set_discovery_type
cmd_le_gap_discover, cmd_experiment_set_coded_phy_discovery
cmd_le_gap_start_discovery
cmd_le_gap_open
cmd_le_gap_connect
none
cmd_le_gap_set_data_channel_classification
It is worth noting that version 2.8.x of our Bluetooth SDK implements a new feature which can be enabled by calling cmd_le_gap_set configuration. This feature, known as anonymous advertising, causes the address of the advertising device to be omitted from all advertising packets. Another new feature supported in this version is the duration parameter in cmd_le_gap_set_advertise_timing(). This parameter allows the user to specify the duration that advertising will continue for in increments of 10 ms. It is also possible now to mask off certain BLE channels to prevent them from being used. The API function cmd_le_gap_set_data_channel_classification() is provided for this purpose. Please see the API guide for details.
It is recommended to switch to the new style API functions.