BLE API Reference#

This page is the hub for WiSeConnect Bluetooth Low Energy (BLE) APIs used with the SiWx917 in this guide. It lists official docs.silabs.com pages (page-level links) and maps them to other sections of this guide (linked below). For full function signatures, parameters, structures, and return values, use the WiSeConnect BLE API Reference on docs.silabs.com.

Official Documentation#


Resource	Link
Developing with WiSeConnect SDK	Developing with WiSeConnect SDK
BLE API Reference guide (overview and TOC)	BLE API Reference guide
WiSeConnect status and return codes	WiSeConnect Status Codes

WiSeConnect BLE API Pages by Area#

Use the BLE API Reference left-hand table of contents on docs.silabs.com to open child pages (for example GAP, GATT Server, Register Callbacks). The table below lists the main page-level entry points used across this guide.


Area	Primary documentation
GAP — advertising, scanning, connection, PHY on connection, privacy, SMP-related procedures	GAP
GATT — synchronous client procedures	Synchronous Client
GATT — asynchronous client procedures	Asynchronous Client
GATT — server (database, responses, notify/indicate)	Server
Register callback functions (GAP, GATT, SMP, extended advertising, GATT extended, L2CAP CBFC as documented)	Register Callbacks
Callback typedefs and event-related types	Callbacks Declarations
ATT / MTU and related host paths (as documented)	ATT_MAINTAIN_IN_HOST
Extended BLE / Si91x feature configuration (opermode, feature bits; as referenced from init and extended advertising)	Extended BLE custom feature bitmap

Integration With This Guide#


Guide topic	WiSeConnect API areas (typical)	Guide pages
Stack init, PHY, connection and advertising limits, callback registration	GAP, Register Callbacks, Callbacks	BLE initialization and configuration
Architecture and role summary	(overview)	BLE architecture
NCP / RCP / SoC	(mode-specific; HCI vs SDK as applicable)	Processing modes
GAP roles, extended advertising, privacy, DLE	GAP, Callbacks	GAP and linked GAP topics
GATT server, client, profiles	GATT Server, Synchronous/Asynchronous Client, Register Callbacks	GATT and linked GATT topics
Pairing, bonding, encryption	GAP (SMP), Register Callbacks	SMP, Pairing and bonding
Errors, status codes, debugging	Status codes, GAP, Callbacks	Debugging and error handling

Wi‑Fi prerequisite (SoC/NCP): Wireless initialization uses sl_wifi_init() before BLE; see Wi-Fi Common API and BLE initialization and configuration.

GAP — Procedures and Connection#

Primary reference: GAP

Integration: Peripheral role, Central role, Broadcaster role, Observer role, Extended advertising, LE Privacy, Data length extension.

GATT — Server and Client#

Primary reference: Server, Synchronous Client, Asynchronous Client

Integration: GATT server, GATT client, SIG Profiles Support.

Callbacks and Events#

Primary reference: Register Callbacks, Callbacks Declarations

Integration: BLE initialization and configuration (registration order); the GAP, GATT, and SMP sections of this guide for role-specific callbacks