From a5c0384ce0756aa40ae195316cb11fa7ab520d42 Mon Sep 17 00:00:00 2001
From: Matthias Ringwald <matthias@ringwald.ch>
Date: Mon, 8 Jul 2024 15:29:22 +0200
Subject: [PATCH] Add PBP

---
 autopts/ptsprojects/stack/layers/__init__.py |   1 +
 autopts/ptsprojects/stack/layers/pbp.py      |  33 +++
 autopts/ptsprojects/stack/stack.py           |   8 +
 autopts/pybtp/btp/__init__.py                |   1 +
 autopts/pybtp/btp/btp.py                     |  11 +
 autopts/pybtp/btp/pbp.py                     | 140 ++++++++++
 autopts/pybtp/defs.py                        |   8 +
 autopts/wid/__init__.py                      |   1 +
 autopts/wid/pbp.py                           | 263 +++++++++++++++++++
 doc/btp_pbp.txt                              |  77 ++++++
 doc/overview.txt                             |   1 +
 11 files changed, 544 insertions(+)
 create mode 100644 autopts/ptsprojects/stack/layers/pbp.py
 create mode 100644 autopts/pybtp/btp/pbp.py
 create mode 100644 autopts/wid/pbp.py
 create mode 100644 doc/btp_pbp.txt

diff --git a/autopts/ptsprojects/stack/layers/__init__.py b/autopts/ptsprojects/stack/layers/__init__.py
index adb4e1e374..4e6a23e041 100644
--- a/autopts/ptsprojects/stack/layers/__init__.py
+++ b/autopts/ptsprojects/stack/layers/__init__.py
@@ -40,4 +40,5 @@
 from .gtbs import *
 from .tmap import *
 from .ots import *
+from .pbp import *
 # GENERATOR append 1
diff --git a/autopts/ptsprojects/stack/layers/pbp.py b/autopts/ptsprojects/stack/layers/pbp.py
new file mode 100644
index 0000000000..6ca5f254ab
--- /dev/null
+++ b/autopts/ptsprojects/stack/layers/pbp.py
@@ -0,0 +1,33 @@
+#
+# auto-pts - The Bluetooth PTS Automation Framework
+#
+# Copyright (c) 2024, BlueKitchen GmbH.
+#
+# This program is free software; you can redistribute it and/or modify it
+# under the terms and conditions of the GNU General Public License,
+# version 2, as published by the Free Software Foundation.
+#
+# This program is distributed in the hope it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+#
+
+from autopts.ptsprojects.stack.common import wait_for_queue_event
+from autopts.pybtp import defs
+
+
+class PBP:
+    def __init__(self):
+        self.event_queues = {
+            defs.PBP_EV_PUBLIC_BROADCAST_ANNOUNCEMENT_FOUND: [],
+        }
+
+    def event_received(self, event_type, event_data):
+        self.event_queues[event_type].append(event_data)
+
+    def wait_public_broadcast_event_found_ev(self, addr_type, addr, broadcast_name, timeout, remove=True):
+        return wait_for_queue_event(
+            self.event_queues[defs.PBP_EV_PUBLIC_BROADCAST_ANNOUNCEMENT_FOUND],
+            lambda ev: (addr_type, addr, broadcast_name) == (ev['addr_type'], ev['addr'], ev['broadcast_name']),
+            timeout, remove)
diff --git a/autopts/ptsprojects/stack/stack.py b/autopts/ptsprojects/stack/stack.py
index 74879f0338..b49aea84a1 100644
--- a/autopts/ptsprojects/stack/stack.py
+++ b/autopts/ptsprojects/stack/stack.py
@@ -52,6 +52,7 @@
     "TBS": 1 << defs.BTP_SERVICE_ID_TBS,
     "TMAP": 1 << defs.BTP_SERVICE_ID_TMAP,
     "OTS": 1 << defs.BTP_SERVICE_ID_OTS,
+    "PBP": 1 << defs.BTP_SERVICE_ID_PBP,
     # GENERATOR append 1
 }
 
@@ -87,6 +88,7 @@ def __init__(self):
         self.gtbs = None
         self.tmap = None
         self.ots = None
+        self.pbp = None
         # GENERATOR append 2
 
     def is_svc_supported(self, svc):
@@ -186,6 +188,9 @@ def tmap_init(self):
     def ots_init(self):
         self.ots = OTS()
 
+    def pbp_init(self):
+        self.pbp = PBP()
+
     # GENERATOR append 3
 
     def cleanup(self):
@@ -267,6 +272,9 @@ def cleanup(self):
         if self.ots:
             self.ots_init()
 
+        if self.pbp:
+            self.pbp_init()
+
         # GENERATOR append 4
 
 
diff --git a/autopts/pybtp/btp/__init__.py b/autopts/pybtp/btp/__init__.py
index e26371ba92..eee1fd0d30 100644
--- a/autopts/pybtp/btp/__init__.py
+++ b/autopts/pybtp/btp/__init__.py
@@ -45,4 +45,5 @@
 from autopts.pybtp.btp.tbs import *
 from autopts.pybtp.btp.tmap import *
 from autopts.pybtp.btp.ots import *
+from autopts.pybtp.btp.pbp import *
 # GENERATOR append 1
diff --git a/autopts/pybtp/btp/btp.py b/autopts/pybtp/btp/btp.py
index c86d1cf3b9..fa7db4d78f 100644
--- a/autopts/pybtp/btp/btp.py
+++ b/autopts/pybtp/btp/btp.py
@@ -129,6 +129,8 @@ def read_supp_svcs():
                  defs.BTP_INDEX_NONE, defs.BTP_SERVICE_ID_TMAP),
     "ots_reg": (defs.BTP_SERVICE_ID_CORE, defs.CORE_REGISTER_SERVICE,
                 defs.BTP_INDEX_NONE, defs.BTP_SERVICE_ID_OTS),
+    "pbp_reg": (defs.BTP_SERVICE_ID_CORE, defs.CORE_REGISTER_SERVICE,
+                defs.BTP_INDEX_NONE, defs.BTP_SERVICE_ID_PBP),
     # GENERATOR append 4
     "read_supp_cmds": (defs.BTP_SERVICE_ID_CORE,
                        defs.CORE_READ_SUPPORTED_COMMANDS,
@@ -704,6 +706,13 @@ def core_reg_svc_ots():
     iutctl.btp_socket.send_wait_rsp(*CORE['ots_reg'])
 
 
+def core_reg_svc_pbp():
+    logging.debug("%s", core_reg_svc_pbp.__name__)
+
+    iutctl = get_iut()
+    iutctl.btp_socket.send_wait_rsp(*CORE['pbp_reg'])
+
+
 # GENERATOR append 1
 
 def core_reg_svc_rsp_succ():
@@ -805,6 +814,7 @@ def init(get_iut_method):
 from .tbs import TBS_EV
 from .tmap import TMAP_EV
 from .ots import OTS_EV
+from .pbp import PBP_EV
 # GENERATOR append 2
 
 from autopts.pybtp.iutctl_common import set_event_handler
@@ -844,6 +854,7 @@ def event_handler(hdr, data):
         defs.BTP_SERVICE_ID_TBS: (TBS_EV, stack.tbs),
         defs.BTP_SERVICE_ID_TMAP: (TMAP_EV, stack.tmap),
         defs.BTP_SERVICE_ID_OTS: (OTS_EV, stack.ots),
+        defs.BTP_SERVICE_ID_PBP: (PBP_EV, stack.pbp),
         # GENERATOR append 3
     }
 
diff --git a/autopts/pybtp/btp/pbp.py b/autopts/pybtp/btp/pbp.py
new file mode 100644
index 0000000000..34af9545b5
--- /dev/null
+++ b/autopts/pybtp/btp/pbp.py
@@ -0,0 +1,140 @@
+#
+# auto-pts - The Bluetooth PTS Automation Framework
+#
+# Copyright (c) 2024, BlueKitchen GmbH.
+#
+# This program is free software; you can redistribute it and/or modify it
+# under the terms and conditions of the GNU General Public License,
+# version 2, as published by the Free Software Foundation.
+#
+# This program is distributed in the hope it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+#
+
+import binascii
+import logging
+import struct
+
+from autopts.pybtp import defs
+from autopts.pybtp.btp.btp import CONTROLLER_INDEX, get_iut_method as get_iut, \
+    btp_hdr_check
+from autopts.pybtp.types import BTPError
+
+log = logging.debug
+
+PBP = {
+    'read_supported_cmds': (defs.BTP_SERVICE_ID_PBP,
+                            defs.PBP_READ_SUPPORTED_COMMANDS,
+                            CONTROLLER_INDEX),
+    'set_public_broadcast_announcement': (defs.BTP_SERVICE_ID_PBP,
+                                          defs.PBP_SET_PUBLIC_BROADCAST_ANNOUNCEMENT,
+                                          CONTROLLER_INDEX),
+    'set_broadcast_name': (defs.BTP_SERVICE_ID_PBP,
+                           defs.PBP_SET_BROADCAST_NAME,
+                           CONTROLLER_INDEX),
+    'broadcast_scan_start': (defs.BTP_SERVICE_ID_PBP,
+                             defs.PBP_BROADCAST_SCAN_START,
+                             CONTROLLER_INDEX),
+    'broadcast_scan_stop': (defs.BTP_SERVICE_ID_PBP,
+                            defs.PBP_BROADCAST_SCAN_STOP,
+                            CONTROLLER_INDEX),
+}
+
+
+def pbp_command_rsp_succ(timeout=20.0):
+    logging.debug("%s", pbp_command_rsp_succ.__name__)
+
+    iutctl = get_iut()
+
+    tuple_hdr, tuple_data = iutctl.btp_socket.read(timeout)
+    logging.debug("received %r %r", tuple_hdr, tuple_data)
+
+    btp_hdr_check(tuple_hdr, defs.BTP_SERVICE_ID_PBP)
+
+    return tuple_data
+
+
+def pbp_set_public_broadcast_announcement(features, metadata):
+    logging.debug(f"{pbp_set_public_broadcast_announcement.__name__}")
+
+    data = bytearray()
+    metadata_len = len(metadata)
+    data += struct.pack('BB', features, metadata_len)
+
+    if metadata_len:
+        data += metadata
+
+    iutctl = get_iut()
+    iutctl.btp_socket.send(*PBP['set_public_broadcast_announcement'], data=data)
+
+    pbp_command_rsp_succ()
+
+
+def pbp_set_broadcast_name(name):
+    logging.debug(f"{pbp_set_broadcast_name.__name__}")
+
+    name_data = name.encode('utf-8')
+    data = bytearray()
+    data += struct.pack('B', len(name_data))
+    data += name_data
+
+    iutctl = get_iut()
+    iutctl.btp_socket.send(*PBP['set_broadcast_name'], data=data)
+
+    pbp_command_rsp_succ()
+
+
+def pbp_broadcast_scan_start():
+    logging.debug(f"{pbp_broadcast_scan_start.__name__}")
+
+    data = bytearray()
+    iutctl = get_iut()
+    iutctl.btp_socket.send(*PBP['broadcast_scan_start'], data=data)
+
+    pbp_command_rsp_succ()
+
+
+def pbp_broadcast_scan_stop():
+    logging.debug(f"{pbp_broadcast_scan_stop.__name__}")
+
+    data = bytearray()
+    iutctl = get_iut()
+    iutctl.btp_socket.send(*PBP['broadcast_scan_stop'], data=data)
+
+    pbp_command_rsp_succ()
+
+
+def pbp_ev_public_broadcast_announcement_found(pbp, data, data_len):
+    logging.debug('%s %r', pbp_ev_public_broadcast_announcement_found.__name__, data)
+
+    fmt = '<B6s3sBHBB'
+    fmt_len = struct.calcsize(fmt)
+    if len(data) < fmt_len:
+        raise BTPError('Invalid data length')
+
+    addr_type, addr, broadcast_id, advertiser_sid, padv_interval, pba_features, broadcast_name_len = \
+        struct.unpack_from(fmt, data)
+
+    addr = binascii.hexlify(addr[::-1]).lower().decode('utf-8')
+    broadcast_id = int.from_bytes(broadcast_id, "little")
+
+    broadcast_name = data[fmt_len:].decode("utf-8")
+
+    ev = {'addr_type': addr_type,
+          'addr': addr,
+          'broadcast_id': broadcast_id,
+          'advertiser_sid': advertiser_sid,
+          'padv_interval': padv_interval,
+          'pba_features': pba_features,
+          'broadcast_name': broadcast_name}
+
+    logging.debug(f'Public Broadcast Announcement received: {ev}')
+
+    pbp.event_received(defs.PBP_EV_PUBLIC_BROADCAST_ANNOUNCEMENT_FOUND, ev)
+
+
+PBP_EV = {
+    defs.PBP_EV_PUBLIC_BROADCAST_ANNOUNCEMENT_FOUND: pbp_ev_public_broadcast_announcement_found,
+}
diff --git a/autopts/pybtp/defs.py b/autopts/pybtp/defs.py
index c8c614816e..94f282cd76 100644
--- a/autopts/pybtp/defs.py
+++ b/autopts/pybtp/defs.py
@@ -52,6 +52,7 @@ def BIT(bit):
 BTP_SERVICE_ID_TBS = 27
 BTP_SERVICE_ID_TMAP = 28
 BTP_SERVICE_ID_OTS = 29
+BTP_SERVICE_ID_PBP = 30
 # GENERATOR append 1
 
 BTP_STATUS_SUCCESS = 0x00
@@ -883,4 +884,11 @@ def BIT(bit):
 OTS_READ_SUPPORTED_COMMANDS = 0x01
 OTS_REGISTER_OBJECT = 0x02
 
+PBP_READ_SUPPORTED_COMMANDS = 0x01
+PBP_SET_PUBLIC_BROADCAST_ANNOUNCEMENT = 0x02
+PBP_SET_BROADCAST_NAME = 0x03
+PBP_BROADCAST_SCAN_START= 0x04
+PBP_BROADCAST_SCAN_STOP = 0x05
+PBP_EV_PUBLIC_BROADCAST_ANNOUNCEMENT_FOUND = 0x80
+
 # GENERATOR append 2
diff --git a/autopts/wid/__init__.py b/autopts/wid/__init__.py
index 11e4af4fce..f8b5d426cc 100644
--- a/autopts/wid/__init__.py
+++ b/autopts/wid/__init__.py
@@ -43,4 +43,5 @@
 from .gtbs import gtbs_wid_hdl
 from .tmap import tmap_wid_hdl
 from .ots import ots_wid_hdl
+from .pbp import pbp_wid_hdl
 # GENERATOR append 1
diff --git a/autopts/wid/pbp.py b/autopts/wid/pbp.py
new file mode 100644
index 0000000000..1dc94ef5b7
--- /dev/null
+++ b/autopts/wid/pbp.py
@@ -0,0 +1,263 @@
+#
+# auto-pts - The Bluetooth PTS Automation Framework
+#
+# Copyright (c) 2024, BlueKitchen GmbH.
+#
+# This program is free software; you can redistribute it and/or modify it
+# under the terms and conditions of the GNU General Public License,
+# version 2, as published by the Free Software Foundation.
+#
+# This program is distributed in the hope it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+#
+
+import logging
+import re
+import struct
+
+from autopts.ptsprojects.stack import get_stack, WildCard
+from autopts.pybtp.defs import AUDIO_METADATA_STREAMING_AUDIO_CONTEXTS, AUDIO_METADATA_PROGRAM_INFO
+from autopts.pybtp.types import WIDParams, CODEC_CONFIG_SETTINGS, create_lc3_ltvs_bytes, BTPError
+from autopts.wid import generic_wid_hdl
+from autopts.pybtp import btp, defs
+from autopts.wid.bap import BAS_CONFIG_SETTINGS
+
+log = logging.debug
+
+
+def pbp_wid_hdl(wid, description, test_case_name):
+    log(f'{pbp_wid_hdl.__name__}, {wid}, {description}, {test_case_name}')
+    return generic_wid_hdl(wid, description, test_case_name, [__name__])
+
+
+def hdl_wid_100(_: WIDParams):
+    """Please synchronize with Broadcast ISO request."""
+
+    stack = get_stack()
+
+    btp.pbp.pbp_broadcast_scan_start()
+
+    ev = stack.pbp.wait_public_broadcast_event_found_ev(WildCard(), WildCard(), WildCard(), 30, False)
+
+    btp.pbp.pbp_broadcast_scan_stop()
+
+    if ev is None:
+        log('No advertisement with Public Broadcast Announcement and Broadcast Name found')
+        return False
+
+    log(f'Public Broadcast Announcement and Broadcast Name found')
+
+    encrypted = (ev['pba_features'] & 1 ) != 0
+    broadcast_id = ev['broadcast_id']
+    addr_type = ev['addr_type']
+    addr = ev['addr']
+
+    if encrypted:
+        stack = get_stack()
+        broadcast_code = stack.bap.broadcast_code
+        if isinstance(broadcast_code, str):
+            # The default broadcast code string from PTS is in big endian
+            broadcast_code = bytes.fromhex(broadcast_code)[::-1]
+
+        # TODO set Broadcast code - BTstack BTP implementation uses default PTS broadcast code
+
+    btp.bap_broadcast_sink_setup()
+
+    btp.bap_broadcast_sink_sync(broadcast_id, ev['advertiser_sid'],
+                                5, 100, False, 0, addr_type, addr)
+
+    ev = stack.bap.wait_bis_found_ev(broadcast_id, 20, False)
+    if ev is None:
+        log(f'BIS not found for broadcast ID {broadcast_id}')
+        return False
+
+    log(f'BIS found')
+
+    return True
+
+
+def hdl_wid_104(_: WIDParams):
+    """Please send non connectable advertise with periodic info."""
+
+    # Periodic adv started within cap_broadcast_adv_start at hdl_wid_552.
+
+    return True
+
+
+def hdl_wid_353(_: WIDParams):
+    """
+    Wait for Broadcast ISO request.
+    """
+
+    return True
+
+
+def hdl_wid_376(_: WIDParams):
+    """
+    Please confirm received streaming data..
+    """
+
+    # get Broadcast ID from Public Broadcast Announcement in WID 100
+    stack = get_stack()
+    ev = stack.pbp.wait_public_broadcast_event_found_ev(WildCard(), WildCard(), WildCard(), 30, False)
+    broadcast_id = ev['broadcast_id']
+    bis_id = 1
+
+    ev = stack.bap.wait_bis_stream_received_ev(broadcast_id, bis_id, 20, False)
+    if ev is None:
+        log(f'BIS Stream receive failed for broadcast ID {broadcast_id}')
+        return False
+
+    return True
+
+
+def hdl_wid_377(_: WIDParams):
+    """
+    Please confirm sent streaming data...
+    """
+
+    return True
+
+
+def hdl_wid_551(params: WIDParams):
+    """Please confirm that IUT received PBP Features value as 0x02"""
+
+    # Search for the pattern in the input string
+    match = re.search(r'0x[0-9A-Fa-f]+', params.description)
+
+    # Extract and print the hex value
+    if match:
+        pba_features =  int(match.group(), 16)
+    else:
+        log(f'Cannot find expected PBP Features')
+        return False
+
+    stack = get_stack()
+
+    btp.pbp.pbp_broadcast_scan_start()
+
+    ev = stack.pbp.wait_public_broadcast_event_found_ev(WildCard(), WildCard(), WildCard(), 30, False)
+
+    btp.pbp.pbp_broadcast_scan_stop()
+
+    if ev is None:
+        log('No advertisement with Public Broadcast Announcement and Broadcast Name found')
+        return False
+
+    log(f'Public Broadcast Announcement with feature %u and Broadcast Name found' % ev['pba_features'])
+
+    return ev['pba_features'] == pba_features
+
+
+def hdl_wid_378(_: WIDParams):
+    """
+    Please confirm received BASE entry
+    """
+
+    # get Broadcast ID and Address from Public Broadcast Announcement in WID 100
+    stack = get_stack()
+    ev = stack.pbp.wait_public_broadcast_event_found_ev(WildCard(), WildCard(), WildCard(), 30, False)
+
+    broadcast_id = ev['broadcast_id']
+    addr_type = ev['addr_type']
+    addr = ev['addr']
+
+    bis_id = 1
+    requested_bis_sync = 1
+    btp.bap_broadcast_sink_bis_sync(broadcast_id, requested_bis_sync, addr_type, addr)
+
+    ev = stack.bap.wait_bis_synced_ev(broadcast_id, bis_id, 20, False)
+    if ev is None:
+        log(f'BIS Sync failed for broadcast ID {broadcast_id}, bis-id {bis_id}')
+        return False
+
+    log(f'BIS Synced')
+    return True
+
+
+wid_552_settings = {
+    # test_case_name: features (1 - encrypted, 2 - std quality, 4 - high quality), bis, qos_name
+    'PBP/PBS/STR/BV-01-C': (2, 1, '16_2_1'),
+    'PBP/PBS/STR/BV-02-C': (4, 1, '48_1_1'),
+    'PBP/PBS/STR/BV-03-C': (3, 1, '16_2_1'),
+    'PBP/PBS/STR/BV-04-C': (5, 1, '48_1_1'),
+    'PBP/PBS/STR/BV-05-C': (2, 2, '16_2_2'),
+    'PBP/PBS/STR/BV-06-C': (2, 1, '24_2_1'),
+    'PBP/PBS/STR/BV-07-C': (2, 2, '24_2_2'),
+    'PBP/PBS/PBM/BV-01-C': (2, 1, '16_2_1'),
+}
+
+
+def hdl_wid_552(params: WIDParams):
+    """
+    Please advertise with Public Broadcast Announcement (0x1856) service data
+    """
+
+    features, bis_count, qos_set_name = wid_552_settings[params.test_case_name]
+
+    # default PTS program info, see TSPX_Program_Info
+    program_info_string = "00112233445566778899AABBCCDDEEFF"
+    program_info = bytes.fromhex(program_info_string)
+    program_info_len = len(program_info)
+    metadata = struct.pack('<BB', program_info_len + 1, AUDIO_METADATA_PROGRAM_INFO) + program_info
+    btp.pbp.pbp_set_public_broadcast_announcement(features, metadata)
+
+    coding_format = 0x06
+    vid = 0x0000
+    cid = 0x0000
+    codec_set_name, *qos_config = BAS_CONFIG_SETTINGS[qos_set_name]
+
+    (sampling_freq, frame_duration, octets_per_frame) = \
+        CODEC_CONFIG_SETTINGS[codec_set_name]
+    audio_locations = 0x01
+    frames_per_sdu = 0x01
+
+    codec_ltvs_bytes = create_lc3_ltvs_bytes(sampling_freq, frame_duration,
+                                             audio_locations, octets_per_frame,
+                                             frames_per_sdu)
+
+    source_id = 0x00
+    subgroup_id = 0x00
+    presentation_delay = 40000
+
+    for i in range(bis_count):
+        btp.cap_broadcast_source_setup_stream(source_id, subgroup_id, coding_format, vid, cid,
+                                              codec_ltvs_bytes, metadata)
+
+    btp.cap_broadcast_source_setup_subgroup(source_id, subgroup_id, coding_format, vid, cid,
+                                            codec_ltvs_bytes, metadata)
+
+    # Zephyr stack generates Broadcast_ID itself
+    broadcast_id = 0x123456
+    encrypted = False
+    broadcast_code = None
+    if (features & 1) != 0:
+        encrypted = True
+        stack = get_stack()
+        broadcast_code = stack.bap.broadcast_code
+        if isinstance(broadcast_code, str):
+            # The default broadcast code string from PTS is in big endian
+            broadcast_code = bytes.fromhex(broadcast_code)[::-1]
+
+    btp.cap_broadcast_source_setup(source_id, broadcast_id, *qos_config, presentation_delay,
+                                   encryption=encrypted, broadcast_code=broadcast_code,
+                                   subgroup_codec_level=True)
+
+    btp.cap_broadcast_adv_start(source_id)
+
+    btp.cap_broadcast_source_start(source_id)
+
+    data = bytearray([j for j in range(0, 41)])
+
+    # PTS does not send an explicit message, but for each
+    # configured SINK it expects to receive any ISO data.
+    for i in range(1, 10):
+        try:
+            btp.bap_send(0, data)
+        except BTPError:
+            # Buffer full
+            pass
+
+    return True
diff --git a/doc/btp_pbp.txt b/doc/btp_pbp.txt
new file mode 100644
index 0000000000..8c29ef752d
--- /dev/null
+++ b/doc/btp_pbp.txt
@@ -0,0 +1,77 @@
+PBP Service (ID 30)
+=====================
+
+Commands and responses:
+
+	Opcode 0x00 - Error response
+
+	Opcode 0x01 - Read Supported Commands command/response
+
+		Controller Index:	<controller id>
+		Command parameters:	<none>
+		Response parameters:	<supported commands> (variable)
+
+		Each bit in response is a flag indicating if command with
+		opcode matching bit number is supported. Bit set to 1 means
+		that command is supported. Bit 0 is reserved and shall always
+		be set to 0. If specific bit is not present in response (less
+		than required bytes received) it shall be assumed that command
+		is not supported.
+
+		In case of an error, the error response will be returned.
+
+	Opcode 0x02: Set Public Broadcast Announcement
+
+		Controller Index:	<controller id>
+		Command parameters:	Features (1 octet)
+							Metadata LTVs len (1 octet)
+							LTVs (varies)
+
+		This command is used to set the Public Broadcast Announcement in broadcast advertisements
+
+		In case of an error, the error response will be returned.
+
+	Opcode 0x03: Set Broadcast Name
+
+		Controller Index:	<controller id>
+		Command parameters:	Name Length (1 octet)
+							Name (<Name Length> octets)
+
+		This command is used to set the Public Broadcast Announcement in broadcast advertisements
+
+		In case of an error, the error response will be returned.
+
+	Opcode 0x04 - Broadcast Scan Start
+		Controller Index:	<controller id>
+		Command parameters:	<none>
+		Response parameters:	<none>
+
+        This command is used to start scanning for Public Broadcast Announcements.
+        In case of an error, the error status response will be returned.
+        In case of a success, the IUT continues processing the command
+        asynchronously.
+
+	Opcode 0x05 - Broadcast Scan Stop
+		Controller Index:	<controller id>
+		Command parameters:	<none>
+		Response parameters:	<none>
+
+        This command is used to stop scanning for Public Broadcast Announcements.
+        In case of an error, the error status response will be returned.
+        In case of a success, the IUT continues processing the command
+        asynchronously.
+
+Events:
+	Opcode 0x80 - Public Broadcast Announcement Found event
+
+		Controller Index:	<controller id>
+		Event parameters:	Address_Type (1 octet)
+					Address (6 octets)
+					Broadcast_ID (3 octets)
+					Advertiser_SID (1 octet)
+					PA_Interval (2 octets)
+					PBA_Features (1 octet)
+					Broadcast_Name_Len (1 octet)
+					Broadcast_Name (<Broadcast_Name_Len> octets)
+
+        This event returns info from scanned Public Broadcast Announcement.
diff --git a/doc/overview.txt b/doc/overview.txt
index 55771421ad..1f39842870 100644
--- a/doc/overview.txt
+++ b/doc/overview.txt
@@ -114,4 +114,5 @@ ID  Name
  27 TBS Service
  28 TMAP Service
  29 OTS Service
+ 30 PBP Service
  # GENERATOR append 1