Overview#

This document contains the full API reference for the Silicon Labs Bluetooth Mesh Software.

The Blue Gecko family of the Silicon Labs' Bluetooth chipsets deliver a high performance, low energy and easy-to-use Bluetooth solution integrated into a small form factor package.

The ultra-low power operating modes and fast wake-up times of the Silicon Labs' energy friendly 32-bit MCUs, combined with the low transmit and receive power consumption of the Bluetooth radio, result in a solution optimized for battery powered applications.

API Payload#

The parameters of a Bluetooth Mesh API command, response, or event are passed between the application and firmware in a payload. For example, a parameter of uint32_t type uses 4 bytes of the payload space. A byte array parameter uses one byte to describe the length of the array. Data in the array is copied into the remaining free payload space.

API Payload Size#

The maximum API payload size is 256 bytes for both NCP and SoC modes. When an application calls a command, the API library checks the payload length and returns error code SL_STATUS_COMMAND_TOO_LONG (0x49) if the payload of input parameters will cause an overflow. Error code SL_STATUS_WOULD_OVERFLOW (0x1d) is returned if the given size of an output parameter is too small for response data.

Decode API Binary Data#

For decoding a message in binary format, see Decode a BGAPI Message.

Deprecations#

Deprecated commands, enumerations, and events are documented in this API reference manual. It is highly recommended to migrate to the replacements as early as possible. A deprecated command may not support new features although it remains functional on current Bluetooth Mesh stack. Deprecated items will be removed in some future release.