Public Broadcast Profile (PBP)

Public Broadcast Profile (PBP) More...

Macros
#define	BT_PBP_MIN_PBA_SIZE   (BT_UUID_SIZE_16 + 1 + 1)

Enumerations
enum	bt_pbp_announcement_feature { BT_PBP_ANNOUNCEMENT_FEATURE_ENCRYPTION = BIT(0) , BT_PBP_ANNOUNCEMENT_FEATURE_STANDARD_QUALITY = BIT(1) , BT_PBP_ANNOUNCEMENT_FEATURE_HIGH_QUALITY = BIT(2) }
	Public Broadcast Announcement features. More...

Functions
int	bt_pbp_get_announcement (const uint8_t meta[], size_t meta_len, enum bt_pbp_announcement_feature features, struct net_buf_simple *pba_data_buf)
	Creates a Public Broadcast Announcement based on the information received in the features parameter.
int	bt_pbp_parse_announcement (struct bt_data *data, enum bt_pbp_announcement_feature *features, uint8_t **meta)
	Parses the received advertising data corresponding to a Public Broadcast Announcement.

Detailed Description

Public Broadcast Profile (PBP)

[Experimental] Users should note that the APIs can change as a part of ongoing development.

Macro Definition Documentation

BT_PBP_MIN_PBA_SIZE

#define BT_PBP_MIN_PBA_SIZE   (BT_UUID_SIZE_16 + 1 + 1)

#include <zephyr/bluetooth/audio/pbp.h>

Enumeration Type Documentation

bt_pbp_announcement_feature

enum bt_pbp_announcement_feature

#include <zephyr/bluetooth/audio/pbp.h>

Public Broadcast Announcement features.

Enumerator
BT_PBP_ANNOUNCEMENT_FEATURE_ENCRYPTION	Broadcast Streams encryption status.
BT_PBP_ANNOUNCEMENT_FEATURE_STANDARD_QUALITY	Standard Quality Public Broadcast Audio configuration.
BT_PBP_ANNOUNCEMENT_FEATURE_HIGH_QUALITY	High Quality Public Broadcast Audio configuration.

Function Documentation

bt_pbp_get_announcement()

int bt_pbp_get_announcement	(	const uint8_t	meta[],
		size_t	meta_len,
		enum bt_pbp_announcement_feature	features,
		struct net_buf_simple *	pba_data_buf
	)

#include <zephyr/bluetooth/audio/pbp.h>

Creates a Public Broadcast Announcement based on the information received in the features parameter.

Parameters

meta	Metadata to be included in the advertising data
meta_len	Size of the metadata fields to be included in the advertising data
features	Public Broadcast Announcement features
pba_data_buf	Pointer to store the PBA advertising data. Buffer size needs to be meta_len + BT_PBP_MIN_PBA_SIZE.

Returns

0 on success or an appropriate error code.

bt_pbp_parse_announcement()

int bt_pbp_parse_announcement	(	struct bt_data *	data,
		enum bt_pbp_announcement_feature *	features,
		uint8_t **	meta
	)

#include <zephyr/bluetooth/audio/pbp.h>

Parses the received advertising data corresponding to a Public Broadcast Announcement.

Returns the advertised Public Broadcast Announcement features and metadata.

Parameters

[in]	data	Advertising data to be checked
[out]	features	Pointer to public broadcast source features to store the parsed features in
[out]	meta	Pointer to the metadata present in the advertising data

Returns

parsed metadata length on success.

Return values

-EINVAL	if data, features or meta are NULL.
-ENOENT	if data is not of type BT_DATA_SVC_DATA16 or if the UUID in the service data is not BT_UUID_PBA.
-EMSGSIZE	if data is not large enough to contain a PBP announcement.
-EBADMSG	if the data contains invalid data.