From: Roland Schober <rolandschober1968@gmail.com>
To: linux-bluetooth@vger.kernel.org
Cc: Roland Schober <rolandschober1968@gmail.com>
Subject: [PATCH BlueZ v3 9/9] monitor: Add PAwR HCI events decoding
Date: Thu, 19 Nov 2026 09:16:21 +0100 [thread overview]
Message-ID: <20261119081621.112623-10-rolandschober1968@gmail.com> (raw)
In-Reply-To: <20261119081621.112623-1-rolandschober1968@gmail.com>
Decode the LE Meta events introduced by Periodic Advertising with
Responses (PAwR) in Bluetooth 5.4:
- LE Periodic Advertising Sync Established [v2]
- LE Periodic Advertising Report [v2]
- LE Periodic Advertising Sync Transfer Received [v2]
- LE Periodic Advertising Subevent Data Request
- LE Periodic Advertising Response Report
- LE Enhanced Connection Complete [v2]
The [v2] events reuse the decoding of the events they extend, and
LE Enhanced Connection Complete [v2] is tracked like [v1], both by the
decoder and by the analyze mode, and is matched with the LE Create
Connection command which started the connection.
> HCI Event: LE Meta Event (0x3e) plen 4
LE Periodic Advertising Subevent Data Request (0x27)
Handle: 0x00
Subevent start: 0 (0x00)
Subevent data count: 4 (0x04)
> HCI Event: LE Meta Event (0x3e) plen 22
LE Periodic Advertising Response Report (0x28)
Handle: 0x00
Subevent: 2 (0x02)
TX status: AUX_SYNC_SUBEVENT_IND was transmitted (0x00)
Num responses: 2
Entry 0
TX power: not available (0x7f)
RSSI: -55 dBm (0xc9)
CTE Type: No Constant Tone Extension (0xff)
Response slot: 0 (0x00)
Data status: Complete
Data length: 5
Data[5]:
04 ff 59 00 2a ..Y.*
Company: Nordic Semiconductor ASA (89)
Data[1]:
2a *
Entry 1
TX power: not available (0x7f)
RSSI: not available (0x7f)
CTE Type: No Constant Tone Extension (0xff)
Response slot: 1 (0x01)
Data status: Failed to receive AUX_SYNC_SUBEVENT_RSP
Data length: 0
Assisted-by: Claude:claude-opus-5-5
Assisted-by: Claude:claude-fable-5-2
---
monitor/analyze.c | 1 +
monitor/bt.h | 90 +++++++++++++++++++++
monitor/packet.c | 197 +++++++++++++++++++++++++++++++++++++++++++++-
3 files changed, 286 insertions(+), 2 deletions(-)
diff --git a/monitor/analyze.c b/monitor/analyze.c
index 5d54ad61b..b16db8bd1 100644
--- a/monitor/analyze.c
+++ b/monitor/analyze.c
@@ -1171,6 +1171,7 @@ static void evt_le_meta_event(struct hci_dev *dev, struct timeval *tv,
evt_le_conn_complete(dev, tv, frame, &iov);
break;
case BT_HCI_EVT_LE_ENHANCED_CONN_COMPLETE:
+ case BT_HCI_EVT_LE_ENHANCED_CONN_COMPLETE_V2:
evt_le_enh_conn_complete(dev, tv, frame, &iov);
break;
case BT_HCI_EVT_LE_CIS_ESTABLISHED:
diff --git a/monitor/bt.h b/monitor/bt.h
index b97592afb..1231f3e84 100644
--- a/monitor/bt.h
+++ b/monitor/bt.h
@@ -4457,6 +4457,96 @@ struct bt_hci_evt_le_big_info_adv_report {
uint8_t encryption;
} __packed;
+#define BT_HCI_EVT_LE_PA_SYNC_ESTABLISHED_V2 0x24
+struct bt_hci_evt_le_per_sync_established_v2 {
+ uint8_t status;
+ uint16_t handle;
+ uint8_t sid;
+ uint8_t addr_type;
+ uint8_t addr[6];
+ uint8_t phy;
+ uint16_t interval;
+ uint8_t clock_accuracy;
+ uint8_t num_subevents;
+ uint8_t subevent_interval;
+ uint8_t response_slot_delay;
+ uint8_t response_slot_spacing;
+} __packed;
+
+#define BT_HCI_EVT_LE_PA_REPORT_V2 0x25
+struct bt_hci_le_pa_report_v2 {
+ uint16_t handle;
+ uint8_t tx_power;
+ int8_t rssi;
+ uint8_t cte_type;
+ uint16_t event_counter;
+ uint8_t subevent;
+ uint8_t data_status;
+ uint8_t data_len;
+ uint8_t data[];
+} __packed;
+
+#define BT_HCI_EVT_LE_PAST_RECEIVED_V2 0x26
+struct bt_hci_evt_le_past_recv_v2 {
+ uint8_t status;
+ uint16_t handle;
+ uint16_t service_data;
+ uint16_t sync_handle;
+ uint8_t sid;
+ uint8_t addr_type;
+ uint8_t addr[6];
+ uint8_t phy;
+ uint16_t interval;
+ uint8_t clock_accuracy;
+ uint8_t num_subevents;
+ uint8_t subevent_interval;
+ uint8_t response_slot_delay;
+ uint8_t response_slot_spacing;
+} __packed;
+
+#define BT_HCI_EVT_LE_PA_SUBEVENT_DATA_REQUEST 0x27
+struct bt_hci_evt_le_pa_subevent_data_request {
+ uint8_t handle;
+ uint8_t subevent_start;
+ uint8_t subevent_data_count;
+} __packed;
+
+#define BT_HCI_EVT_LE_PA_RESPONSE_REPORT 0x28
+struct bt_hci_le_pa_response {
+ int8_t tx_power;
+ int8_t rssi;
+ uint8_t cte_type;
+ uint8_t response_slot;
+ uint8_t data_status;
+ uint8_t data_len;
+ uint8_t data[];
+} __packed;
+
+struct bt_hci_evt_le_pa_response_report {
+ uint8_t handle;
+ uint8_t subevent;
+ uint8_t tx_status;
+ uint8_t num_responses;
+ struct bt_hci_le_pa_response responses[];
+} __packed;
+
+#define BT_HCI_EVT_LE_ENHANCED_CONN_COMPLETE_V2 0x29
+struct bt_hci_evt_le_enhanced_conn_complete_v2 {
+ uint8_t status;
+ uint16_t handle;
+ uint8_t role;
+ uint8_t peer_addr_type;
+ uint8_t peer_addr[6];
+ uint8_t local_rpa[6];
+ uint8_t peer_rpa[6];
+ uint16_t interval;
+ uint16_t latency;
+ uint16_t supv_timeout;
+ uint8_t clock_accuracy;
+ uint8_t adv_handle;
+ uint16_t sync_handle;
+} __packed;
+
#define BT_HCI_EVT_LE_READ_ALL_REMOTE_FEATURES_COMPLETE 0x2B
struct bt_hci_evt_le_read_all_remote_features_complete {
uint8_t status;
diff --git a/monitor/packet.c b/monitor/packet.c
index edf09ac10..df1947ada 100644
--- a/monitor/packet.c
+++ b/monitor/packet.c
@@ -234,6 +234,10 @@ static const struct deferred_data deferred_table[] = {
PENDING_KEY_NONE, 0, 0 },
{ BT_HCI_CMD_LE_EXT_CREATE_CONN_V2, 0x3e, 0x0a,
PENDING_KEY_NONE, 0, 0 },
+ { BT_HCI_CMD_LE_CREATE_CONN, 0x3e, 0x29, PENDING_KEY_NONE, 0, 0 },
+ { BT_HCI_CMD_LE_EXT_CREATE_CONN, 0x3e, 0x29, PENDING_KEY_NONE, 0, 0 },
+ { BT_HCI_CMD_LE_EXT_CREATE_CONN_V2, 0x3e, 0x29,
+ PENDING_KEY_NONE, 0, 0 },
{ }
};
@@ -13925,6 +13929,28 @@ static void le_enhanced_conn_complete_evt(struct timeval *tv, uint16_t index,
(void *)evt->peer_addr, evt->peer_addr_type);
}
+static void le_enhanced_conn_complete_v2_evt(struct timeval *tv,
+ uint16_t index, const void *data, uint8_t size)
+{
+ const struct bt_hci_evt_le_enhanced_conn_complete_v2 *evt = data;
+
+ /* The v2 event starts with the parameters of the v1 event */
+ le_enhanced_conn_complete_evt(tv, index, data, size);
+
+ if (evt->adv_handle == 0xff)
+ print_field("Advertising handle: No Advertising Handle (0xff)");
+ else
+ print_field("Advertising handle: %u (0x%2.2x)",
+ evt->adv_handle, evt->adv_handle);
+
+ if (le16_to_cpu(evt->sync_handle) == 0xffff)
+ print_field("Sync handle: No Sync Handle (0xffff)");
+ else
+ print_field("Sync handle: %u (0x%4.4x)",
+ le16_to_cpu(evt->sync_handle),
+ le16_to_cpu(evt->sync_handle));
+}
+
static void le_direct_adv_report_evt(struct timeval *tv, uint16_t index,
const void *data, uint8_t size)
{
@@ -14153,6 +14179,18 @@ static void le_pa_sync_evt(struct timeval *tv, uint16_t index,
print_field("Advertiser clock accuracy: 0x%2.2x", evt->clock_accuracy);
}
+static void le_pa_sync_v2_evt(struct timeval *tv, uint16_t index,
+ const void *data, uint8_t size)
+{
+ const struct bt_hci_evt_le_per_sync_established_v2 *evt = data;
+
+ /* The v2 event starts with the parameters of the v1 event */
+ le_pa_sync_evt(tv, index, data, size);
+ print_pa_subevents(evt->num_subevents, evt->subevent_interval,
+ evt->response_slot_delay,
+ evt->response_slot_spacing);
+}
+
static const char *pa_cte_type_str(uint8_t cte_type)
{
switch (cte_type) {
@@ -14203,7 +14241,8 @@ static void print_pa_report_info(uint16_t handle, uint8_t tx_power,
}
static void print_pa_report_data(uint8_t data_status, uint8_t data_len,
- const uint8_t *data, uint8_t size)
+ const uint8_t *data, uint8_t size,
+ bool subevents)
{
const char *color_on;
const char *str;
@@ -14227,6 +14266,10 @@ static void print_pa_report_data(uint8_t data_status, uint8_t data_len,
break;
}
+ /* Only the [v2] event, which reports subevents, defines 0xff */
+ if (data_status == 0xff && subevents)
+ str = "Failed to receive AUX_SYNC_SUBEVENT_IND";
+
print_field("Data status: %s%s%s", color_on, str, COLOR_OFF);
print_field("Data length: %u", data_len);
@@ -14247,7 +14290,26 @@ static void le_pa_report_evt(struct timeval *tv, uint16_t index,
print_pa_report_info(evt->handle, evt->tx_power, evt->rssi,
evt->cte_type);
print_pa_report_data(evt->data_status, evt->data_len, evt->data,
- size - sizeof(*evt));
+ size - sizeof(*evt), false);
+}
+
+static void le_pa_report_v2_evt(struct timeval *tv, uint16_t index,
+ const void *data, uint8_t size)
+{
+ const struct bt_hci_le_pa_report_v2 *evt = data;
+
+ print_pa_report_info(evt->handle, evt->tx_power, evt->rssi,
+ evt->cte_type);
+ print_field("Periodic event counter: %u (0x%4.4x)",
+ le16_to_cpu(evt->event_counter),
+ le16_to_cpu(evt->event_counter));
+ if (evt->subevent == 0xff)
+ print_field("Subevent: No subevents (0xff)");
+ else
+ print_field("Subevent: %u (0x%2.2x)", evt->subevent,
+ evt->subevent);
+ print_pa_report_data(evt->data_status, evt->data_len, evt->data,
+ size - sizeof(*evt), true);
}
static void le_pa_sync_lost_evt(struct timeval *tv, uint16_t index,
@@ -14330,6 +14392,113 @@ static void le_past_received_evt(struct timeval *tv, uint16_t index,
print_field("Advertiser clock accuracy: 0x%2.2x", evt->clock_accuracy);
}
+static void le_pa_subevent_data_request_evt(struct timeval *tv,
+ uint16_t index, const void *data, uint8_t size)
+{
+ const struct bt_hci_evt_le_pa_subevent_data_request *evt = data;
+
+ print_field("Handle: 0x%2.2x", evt->handle);
+ print_field("Subevent start: %u (0x%2.2x)", evt->subevent_start,
+ evt->subevent_start);
+ print_field("Subevent data count: %u (0x%2.2x)",
+ evt->subevent_data_count,
+ evt->subevent_data_count);
+}
+
+static void le_pa_response_report_evt(struct timeval *tv, uint16_t index,
+ const void *data, uint8_t size)
+{
+ struct iovec iov = { .iov_base = (void *) data, .iov_len = size };
+ const struct bt_hci_evt_le_pa_response_report *evt;
+ const struct bt_hci_le_pa_response *rsp;
+ const char *color_on;
+ const char *str;
+ uint8_t i;
+
+ evt = util_iov_pull_mem(&iov, sizeof(*evt));
+ if (!evt)
+ return;
+
+ print_field("Handle: 0x%2.2x", evt->handle);
+ print_field("Subevent: %u (0x%2.2x)", evt->subevent, evt->subevent);
+
+ switch (evt->tx_status) {
+ case 0x00:
+ str = "AUX_SYNC_SUBEVENT_IND was transmitted";
+ break;
+ case 0x01:
+ str = "AUX_SYNC_SUBEVENT_IND was not transmitted";
+ break;
+ default:
+ str = "Reserved";
+ break;
+ }
+
+ print_field("TX status: %s (0x%2.2x)", str, evt->tx_status);
+ print_field("Num responses: %u", evt->num_responses);
+
+ for (i = 0; i < evt->num_responses; i++) {
+ rsp = util_iov_pull_mem(&iov, sizeof(*rsp));
+ if (!rsp)
+ break;
+
+ print_field("Entry %u", i);
+ print_pa_tx_power(" ", rsp->tx_power);
+ print_pa_rssi(" ", rsp->rssi);
+
+ print_field(" CTE Type: %s (0x%2.2x)",
+ pa_cte_type_str(rsp->cte_type), rsp->cte_type);
+ print_field(" Response slot: %u (0x%2.2x)",
+ rsp->response_slot, rsp->response_slot);
+
+ switch (rsp->data_status) {
+ case 0x00:
+ str = "Complete";
+ color_on = COLOR_GREEN;
+ break;
+ case 0x01:
+ str = "Incomplete, more data to come";
+ color_on = COLOR_YELLOW;
+ break;
+ case 0xff:
+ str = "Failed to receive AUX_SYNC_SUBEVENT_RSP";
+ color_on = COLOR_RED;
+ break;
+ default:
+ str = "Reserved";
+ color_on = COLOR_RED;
+ break;
+ }
+
+ print_field(" Data status: %s%s%s", color_on, str, COLOR_OFF);
+ print_field(" Data length: %u", rsp->data_len);
+
+ if (!util_iov_pull(&iov, rsp->data_len))
+ break;
+
+ print_eir(" Data", rsp->data, rsp->data_len, true);
+ }
+
+ /* Fewer responses than announced, or octets after the last one */
+ if (i < evt->num_responses || iov.iov_len) {
+ print_text(COLOR_ERROR, " invalid packet size");
+ if (iov.iov_len)
+ print_hex_field(" Data", iov.iov_base, iov.iov_len);
+ }
+}
+
+static void le_past_received_v2_evt(struct timeval *tv, uint16_t index,
+ const void *data, uint8_t size)
+{
+ const struct bt_hci_evt_le_past_recv_v2 *evt = data;
+
+ /* The v2 event starts with the parameters of the v1 event */
+ le_past_received_evt(tv, index, data, size);
+ print_pa_subevents(evt->num_subevents, evt->subevent_interval,
+ evt->response_slot_delay,
+ evt->response_slot_spacing);
+}
+
static void le_cis_established_evt(struct timeval *tv, uint16_t index,
const void *data, uint8_t size)
{
@@ -15484,6 +15653,30 @@ static const struct subevent_data le_meta_event_table[] = {
"LE Broadcast Isochronous Group Info Advertising Report",
le_big_info_evt,
sizeof(struct bt_hci_evt_le_big_info_adv_report) },
+ { BT_HCI_EVT_LE_PA_SYNC_ESTABLISHED_V2,
+ "LE Periodic Advertising Sync Established [v2]",
+ le_pa_sync_v2_evt,
+ sizeof(struct bt_hci_evt_le_per_sync_established_v2), true },
+ { BT_HCI_EVT_LE_PA_REPORT_V2,
+ "LE Periodic Advertising Report [v2]",
+ le_pa_report_v2_evt,
+ sizeof(struct bt_hci_le_pa_report_v2), false },
+ { BT_HCI_EVT_LE_PAST_RECEIVED_V2,
+ "LE Periodic Advertising Sync Transfer Received [v2]",
+ le_past_received_v2_evt,
+ sizeof(struct bt_hci_evt_le_past_recv_v2), true },
+ { BT_HCI_EVT_LE_PA_SUBEVENT_DATA_REQUEST,
+ "LE Periodic Advertising Subevent Data Request",
+ le_pa_subevent_data_request_evt,
+ sizeof(struct bt_hci_evt_le_pa_subevent_data_request), true },
+ { BT_HCI_EVT_LE_PA_RESPONSE_REPORT,
+ "LE Periodic Advertising Response Report",
+ le_pa_response_report_evt,
+ sizeof(struct bt_hci_evt_le_pa_response_report), false },
+ { BT_HCI_EVT_LE_ENHANCED_CONN_COMPLETE_V2,
+ "LE Enhanced Connection Complete [v2]",
+ le_enhanced_conn_complete_v2_evt,
+ sizeof(struct bt_hci_evt_le_enhanced_conn_complete_v2), true },
{ BT_HCI_EVT_LE_READ_ALL_REMOTE_FEATURES_COMPLETE,
"LE Read All Remote Features Complete",
le_read_all_remote_features_complete_evt,
--
2.47.3
next prev parent reply other threads:[~2026-11-19 8:16 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-19 8:16 [PATCH BlueZ v3 0/9] monitor: Decode Periodic Advertising with Responses Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 1/9] monitor: Fix handle decoding of status_handle_rsp Roland Schober
2026-11-19 9:53 ` monitor: Decode Periodic Advertising with Responses bluez.test.bot
2026-11-19 8:16 ` [PATCH BlueZ v3 2/9] monitor: Fix data length of LE PA Report decoding Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 3/9] monitor: Fix PHY decoding of LE Ext Create Connection Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 4/9] monitor: Fix advertising handle of LE PA commands Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 5/9] monitor: Fix TX power and CTE Type of LE PA Report Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 6/9] monitor: Fix LE PAST Received decoding Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 7/9] monitor: Split LE PA Report decoding into helpers Roland Schober
2026-11-19 8:16 ` [PATCH BlueZ v3 8/9] monitor: Add PAwR HCI commands decoding Roland Schober
2026-11-19 8:16 ` Roland Schober [this message]
2026-11-19 16:18 ` [PATCH BlueZ v3 0/9] monitor: Decode Periodic Advertising with Responses Luiz Augusto von Dentz
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261119081621.112623-10-rolandschober1968@gmail.com \
--to=rolandschober1968@gmail.com \
--cc=linux-bluetooth@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.