BLE Developer Guide#

This guide describes Bluetooth Low Energy (BLE) capabilities and usage on the SiWx917 Network Processor (NWP) with the WiSeConnect SDK: GAP and GATT procedures, security (SMP), operating modes, and links to the official BLE API documentation.

Audience#

Integrators and application developers who implement BLE on the SiWx917 NWP using the WiSeConnect SDK (GAP, GATT, SMP, and host–NWP integration for NCP, RCP, or SoC/ACP).

Prerequisites#

WiSeConnect SDK 4.0 or later (see the SDK note under Overview).
Platform: SiWx917 with the NWP used for BLE; operating mode (NCP, RCP, or SoC/ACP) per your product design. See Processing modes.
Background: Familiarity with BLE roles and profiles at the level of the Bluetooth Core Specification or equivalent introductory material. Stack setup, limits, and callbacks are covered in BLE initialization and configuration.

Overview#

The SiWx917 Network Processor (NWP) provides a comprehensive Bluetooth Low Energy (BLE) implementation through the WiSeConnect SDK. The BLE stack is Bluetooth 5.4-compliant and supports multiple concurrent roles, enabling flexible application development for embedded systems.

Note: As of January 2026, WiSeConnect SDK 4.0 is the current version. Examples and APIs in this guide assume WiSeConnect SDK 4.0 or later unless a page states otherwise.

Suggested Reading


Topic	Page
Stack summary, supported roles, dual-role, PHY and feature overview, operating mode summary	BLE architecture
PHY negotiation, connection and advertising limits, initialization, callbacks	BLE initialization and configuration

Document Organization#

Overview and Reference


Page	Description
BLE architecture	Stack, roles, modes at a glance, PHY and limits summary
BLE initialization and configuration	Init sequence, limits, callback registration
BLE API reference	Links to docs.silabs.com BLE pages and in-guide topics
BLE usage scenarios	Hub for scenario-style flows (per-area scenarios below)
Debugging and error handling	Errors, status codes, recovery
BLE appendix	Glossary, acronyms, FAQ, revision history

Processing Modes


Page	Description
Processing modes	NCP vs RCP vs SoC/ACP, selection
NCP mode	Full stack on NWP, host interface
RCP mode	Controller on NWP
SoC / ACP mode	On-chip application processor
Processing modes - usage scenarios	Mode-focused flows

Generic Access Profile (GAP)


Page	Description
GAP — overview	GAP scope and navigation
Peripheral role	Advertising, connections, power save, connection parameters
Central role	Scanning, connection initiation, multi-connection (GAP)
Broadcaster role	Non-connectable advertising, beacons
Observer role	Scanning, periodic advertising sync
Extended advertising	Extended and periodic advertising (detail)
Data length extension	DLE
LE Privacy	Privacy and address rotation
GAP — usage scenarios	GAP-focused scenarios

Generic Attribute Profile (GATT)


Page	Description
GATT — overview	Client, server, ATT/MTU
GATT server	Services, characteristics, notify/indicate
GATT client	Discovery, read/write, subscriptions
SIG profiles support	Standard and custom profiles
GATT — usage scenarios	GATT-focused scenarios

Security Manager Protocol (SMP)


Page	Description
SMP — overview	Pairing, bonding, security features
Pairing and bonding	Procedures and APIs
SMP — usage scenarios	Security-focused scenarios

WiSeConnect SDK Documentation

BLE Developer Guide#

Audience#

Prerequisites#

Overview#

Document Organization#

Related Documentation#