Bluetooth: btintel_pcie: parse FW memory addresses via mailbox TLV
PATCH v2 1/3 Bluetooth: btintel_pcie: parse FW memory addresses via mailbox TLV
From: Chandrashekar Devegowda <[email protected]>
Implement GP1 mailbox interrupt handling to receive memory region addresses from firmware via a TLV-based protocol. When firmware sends a BUILD_SPECIFIC_RESOURCES_MAPPING mailbox message, the driver reads a TLV table from device memory containing addresses and sizes of debug memory regions (exception dump, DCCM, SDS, ECL, SMEM).
This enables the driver to dynamically discover dump region locations instead of using hardcoded addresses, supporting current and future Intel BT PCIe controller variants.
Replace per-device hardcoded exception memory address and size constants in btintel_pcie_read_hwexp() with the dynamically populated values from dump_info, making exception dump handling consistent with other dump regions.
Key changes:
- Rewrite GP1 handler to parse mailbox registers and queue TLV work
- Add btintel_parse_mbox_tlv() for parsing FW-provided TLV data
- Add mbox_work workqueue for deferred TLV processing
- Store parsed region addresses in btintel_pcie_dump_mem_info
- Add cnvi_bt field to btintel_data for HW variant identification
- Rename fw_git_sha1 to fw_sha for consistency
- Remove hardcoded HWEXP address/size macros and use dump_info
---
changes in v2:
- Add a comment before ALIGN_DOWN()
drivers/bluetooth/btintel.c | 7 + drivers/bluetooth/btintel.h | 1 + drivers/bluetooth/btintel_pcie.c | 349 +++++++++++++++++++++++++++++-- drivers/bluetooth/btintel_pcie.h | 53 ++++- 4 files changed, 387 insertions(+), 23 deletions(-)
drivers/bluetooth/btintel.c +7 -0
@@ -66,6 +66,7 @@ static struct {const char *driver_name;u8 hw_variant;u32 fw_build_num; +u32 fw_sha; } coredump_info; const guid_t btintel_guid_dsm =
@@ -560,6 +561,7 @@ int btintel_version_info_tlv(struct hci_dev *hdev, coredump_info.hw_variant =INTEL_HW_VARIANT (version->cnvi_bt); coredump_info.fw_build_num = version->build_num; + coredump_info.fw_sha = version->git_sha1; bt_dev_info(hdev, "%s timestamp %u.%u buildtype %u build %u", variant, 2000 + (version->timestamp >> 8), version->timestamp & 0xff,
@@ -2337,6 +2339,7 @@ static int btintel_prepare_fw_download_tlv(struct hci_dev *hdev,struct intel_version_tlv *ver, u32 *boot_param) { + struct btintel_data *intel_data = hci_get_priv(hdev);const struct firmware *fw;char fwname[128 ];int err;
@@ -2449,6 +2452,7 @@ static int btintel_prepare_fw_download_tlv(struct hci_dev *hdev,btintel_reset_to_bootloader (hdev); done: + intel_data->cnvi_bt = ver->cnvi_bt;release_firmware (fw);return err; }
@@ -3486,6 +3490,9 @@ int btintel_bootloader_setup_tlv(struct hci_dev *hdev,btintel_version_info_tlv (hdev, &new_ver); +/* Update ver with the operational firmware version */ + *ver = new_ver; + finish:/* Set the event mask for Intel specific vendor events. This enables * a few extra events that are useful during general operation. It
drivers/bluetooth/btintel.h +1 -0
@@ -247,6 +247,7 @@ enum {struct btintel_data { DECLARE_BITMAP(flags, __INTEL_NUM_FLAGS);int (*acpi_reset_method)(struct hci_dev *hdev); +u32 cnvi_bt; };#define btintel_set_flag (hdev, nr) \
drivers/bluetooth/btintel_pcie.c +328 -21
443 lines not on this page · raw message
drivers/bluetooth/btintel_pcie.h +51 -2
107 lines not on this page · raw message
Signature · 1 line
2.54.0
PATCH v2 2/3 Bluetooth: btintel_pcie: sync mbox tlv parsing with GP0 alive interrupt
Performing a target access to read the mbox TLV table while the driver is concurrently posting RX buffers to the firmware causes the hardware to return 0 for the target address, resulting in an invalid/empty TLV parse.
Add a synchronization handshake between the mbox TLV read operation performed by the mbox worker and the GP0 (alive) MSI-X interrupt (which signals completion of RX buffer posting). The worker now waits for the alive interrupt before initiating the target access, ensuring the hardware returns valid data.
---
changes in v2:
- No code change
drivers/bluetooth/btintel_pcie.c | 42 +++++++++++++++++++++++++++++--- drivers/bluetooth/btintel_pcie.h | 10 +++++++- 2 files changed, 48 insertions(+), 4 deletions(-)
drivers/bluetooth/btintel_pcie.c +39 -3
@@ -987,6 +987,24 @@ static int btintel_parse_mbox_tlv(struct btintel_pcie_data *data)struct mbox_tlv *tlv;struct btintel_data *cnvi_data =hci_get_priv (data->hdev);u8 hw_variant =INTEL_HW_VARIANT (cnvi_data->cnvi_bt); +long t; + +/* Wait for GP0 alive interrupt to post RX buffers */ + t =wait_event_timeout (data->mbox_parse_wait_q, +test_bit (BTINTEL_PCIE_MBOX_PARSE_READY , &data->flags), +msecs_to_jiffies (BTINTEL_PCIE_MBOX_INTR_TIMEOUT_MS )); +if (!t) { +bt_dev_warn (data->hdev, +"Timeout (%u ms) waiting for alive interrupt before mbox TLV parse; skipping" , +BTINTEL_PCIE_MBOX_INTR_TIMEOUT_MS ); +return 0 ; + } +clear_bit (BTINTEL_PCIE_MBOX_PARSE_READY , &data->flags); + +bt_dev_info (data->hdev, +"mbox TLV parse started at %lld ns (%lld us after mbox interrupt)" , +ktime_to_ns (ktime_get ()), +ktime_to_us (ktime_sub (ktime_get (), data->mbox_intr_ts)));memset (&data->dump_info,0 ,sizeof (data->dump_info));
@@ -1230,12 +1248,22 @@ static void btintel_pcie_msix_gp1_handler(struct btintel_pcie_data *data)if (target_access && !test_and_set_bit (BTINTEL_PCIE_MAIL_BOX_INTR , &data->flags)) { +/* Arm the mbox<->alive handshake */ +clear_bit (BTINTEL_PCIE_MBOX_PARSE_READY , &data->flags); +set_bit (BTINTEL_PCIE_MBOX_PARSE_PENDING , &data->flags); + data->mbox_intr_ts =ktime_get (); + +bt_dev_info (data->hdev, +"mbox interrupt received at %lld ns; queuing mbox_work" , +ktime_to_ns (data->mbox_intr_ts)); +WRITE_ONCE (data->debug_table_addr, addr);WRITE_ONCE (data->debug_table_size, size);if (!queue_work (data->dump_workqueue, - &data->mbox_work)) -clear_bit (BTINTEL_PCIE_MAIL_BOX_INTR , - &data->flags); + &data->mbox_work)) { +clear_bit (BTINTEL_PCIE_MAIL_BOX_INTR , &data->flags); +clear_bit (BTINTEL_PCIE_MBOX_PARSE_PENDING , &data->flags); + } }/* Mailbox is read, ack to FW */
@@ -1345,6 +1373,12 @@ static void btintel_pcie_msix_gp0_handler(struct btintel_pcie_data *data)if (submit_rx) {btintel_pcie_reset_ia (data);btintel_pcie_start_rx (data); + +/* Complete the mbox<->alive handshake */ +if (test_and_clear_bit (BTINTEL_PCIE_MBOX_PARSE_PENDING , &data->flags)) { +set_bit (BTINTEL_PCIE_MBOX_PARSE_READY , &data->flags); +wake_up (&data->mbox_parse_wait_q); + } }if (signal_waitq) {
@@ -3301,6 +3335,8 @@ static int btintel_pcie_probe(struct pci_dev *pdev,init_waitqueue_head (&data->tx_wait_q); data->tx_wait_done = false; +init_waitqueue_head (&data->mbox_parse_wait_q); + data->workqueue =alloc_ordered_workqueue (KBUILD_MODNAME ,WQ_HIGHPRI );if (!data->workqueue)return -ENOMEM ;
drivers/bluetooth/btintel_pcie.h +9 -1
@@ -125,7 +125,9 @@ enum {BTINTEL_PCIE_FWTRIGGER_DUMP_INPROGRESS ,BTINTEL_PCIE_RECOVERY_IN_PROGRESS ,BTINTEL_PCIE_SETUP_DONE , -BTINTEL_PCIE_MAIL_BOX_INTR +BTINTEL_PCIE_MAIL_BOX_INTR , +BTINTEL_PCIE_MBOX_PARSE_PENDING , +BTINTEL_PCIE_MBOX_PARSE_READY }; enum btintel_pcie_tlv_type {
@@ -178,6 +180,7 @@ enum btintel_pcie_mbox_msg {/* Default interrupt timeout in msec */ #define BTINTEL_DEFAULT_INTR_TIMEOUT_MS 3000 +#define BTINTEL_PCIE_MBOX_INTR_TIMEOUT_MS 500#define BTINTEL_PCIE_DX_TRANSITION_MAX_RETRIES 3
@@ -588,6 +591,11 @@ struct btintel_pcie_data {u32 debug_table_size;struct btintel_pcie_dump_mem_info dump_info;struct btintel_pcie_mbox mbox; + +/* Wait queue for mbox_worker to wait for GP0 alive interrupt */ +wait_queue_head_t mbox_parse_wait_q; +/* Timestamp captured in GP1 handler when mbox interrupt is received */ +ktime_t mbox_intr_ts; }; static inline u32 btintel_pcie_rd_reg32(struct btintel_pcie_data *data,
Signature · 1 line
2.54.0
PATCH v2 3/3 Bluetooth: btintel_pcie: Route debug traces to WiFi DBGC by default
In reply to Kiran KFrom: Catherine L <[email protected]>
Set dbg_output_mode to 0x06 (BTINTEL_PCIE_WIFI_DBGC) by default so firmware debug traces are forwarded to the WiFi DBGC. In this mode:
- Host DBGC fragment/data buffers are NOT allocated.
- Context info publishes dbgc_addr/size as 0.
Add a small helper btintel_pcie_dbg_to_wifi() driven by a cached dbg_path_cache field in struct btintel_pcie_data, initialized to BTINTEL_PCIE_WIFI_DBGC in probe.
---
changes in v2:
- no code change
drivers/bluetooth/btintel_pcie.c | 43 +++++++++++++++++++++++++++++--- drivers/bluetooth/btintel_pcie.h | 16 ++++++++++++ 2 files changed, 55 insertions(+), 4 deletions(-)
drivers/bluetooth/btintel_pcie.c +39 -4
@@ -180,6 +180,15 @@ static inline char *btintel_pcie_alivectxt_state2str(u32 alive_intr_ctxt) } } +/* Returns true when firmware traces are routed to the WiFi DBGC. In that +* mode the host must not allocate DBGC buffers and must not publish their +* addresses in the context info. +*/ +static inline bool btintel_pcie_dbg_to_wifi (struct btintel_pcie_data *data) +{ +return data->dbg_path_cache !=BTINTEL_PCIE_DRAM ; +} +/* This function initializes the memory for DBGC buffers and formats the * DBGC fragment which consists header info and DBGC buffer's LSB, MSB and * size as the payload
@@ -1853,6 +1862,15 @@ static void btintel_pcie_coredump_worker(struct work_struct *work)if (!data->hdev) goto out; +/* When firmware routes debug traces to the WiFi DBGC, no host +* DBGC buffers were allocated, so there is nothing to dump here. +*/ +if (btintel_pcie_dbg_to_wifi (data)) { +bt_dev_info (data->hdev, +"Skipping coredump: debug traces routed to WiFi DBGC" ); + goto out; + } +btintel_pcie_dump_traces (data->hdev); out:/* Release guard last so a new trigger can run only after this
@@ -2223,9 +2241,18 @@ static void btintel_pcie_init_ci(struct btintel_pcie_data *data, ci->num_urbdq1 = data->rxq.count; ci->urbdq_db_vec =BTINTEL_PCIE_RXQ_NUM ; - ci->dbg_output_mode =0x01 ; - ci->dbgc_addr = data->dbgc.frag_p_addr; - ci->dbgc_size = data->dbgc.frag_size; + ci->dbg_output_mode =btintel_pcie_dbg_to_wifi (data) ? +BTINTEL_PCIE_WIFI_DBGC :BTINTEL_PCIE_DRAM ; +if (btintel_pcie_dbg_to_wifi (data)) { +/* Firmware forwards debug traces to the WiFi DBGC, so no +* host DBGC buffer is needed; leave dbgc_addr/size as 0. +*/ + ci->dbgc_addr =0 ; + ci->dbgc_size =0 ; + }else { + ci->dbgc_addr = data->dbgc.frag_p_addr; + ci->dbgc_size = data->dbgc.frag_size; + } ci->dbg_preset =0x00 ; }
@@ -2453,7 +2480,14 @@ static int btintel_pcie_alloc(struct btintel_pcie_data *data) v_addr += ci_size;/* Setup data buffers for dbgc */ - err =btintel_pcie_setup_dbgc (data); +if (btintel_pcie_dbg_to_wifi (data)) { +/* Firmware routes traces to the WiFi DBGC; skip host DBGC +* buffer allocation entirely. +*/ + err =0 ; + }else { + err =btintel_pcie_setup_dbgc (data); + }if (err) goto exit_error_txq;
@@ -3357,6 +3391,7 @@ static int btintel_pcie_probe(struct pci_dev *pdev, data->boot_stage_cache =0x00 ; data->img_resp_cache =0x00 ; + data->dbg_path_cache =BTINTEL_PCIE_WIFI_DBGC ;/* FLR can be invoked by echoing to debugfs path, so explicitly * initialized */
drivers/bluetooth/btintel_pcie.h +16 -0
@@ -94,6 +94,20 @@/* Num of alloc Dbg buff (4) + (LSB(4), MSB(4), Size(4)) for each buffer */ #define BTINTEL_PCIE_DBGC_FRAG_PAYLOAD_SIZE 196 +/* dbg_output_mode values for the context info. +* BTINTEL_PCIE_DRAM: firmware writes traces to host DRAM DBGC buffers. +* BTINTEL_PCIE_WIFI_DBGC: firmware forwards traces to the WiFi DBGC; the +* host does NOT need to allocate DBGC fragment/data buffers and must +* publish dbgc_addr/size as 0 in the context info. +* +* Encoding of BTINTEL_PCIE_WIFI_DBGC (0x06): +* Bit[0] DBGC O/P : 0 = SRAM (don't care, DBGI selected) +* Bit[1] DBGC I/P : 1 = DBGI +* Bits[2:3] DBGI O/P : 01 = WiFi DBGC +*/ +#define BTINTEL_PCIE_DRAM 0x01 +#define BTINTEL_PCIE_WIFI_DBGC 0x06 +/* Causes for the FH register interrupts */ enum msix_fh_int_causes {BTINTEL_PCIE_MSIX_FH_INT_CAUSES_0 =BIT (0 ),/* cause 0 */
@@ -503,6 +517,7 @@ struct btintel_pcie_dump_header {* @hw_init_mask: initial unmaksed hw causes * @boot_stage_cache: cached value of boot stage register * @img_resp_cache: cached value of image response register +* @dbg_path_cache: cached debug output routing mode (BT DRAM or WiFi DBGC) * @cnvi: CNVi register value * @cnvr: CNVr register value * @gp0_received: condition for gp0 interrupt
@@ -550,6 +565,7 @@ struct btintel_pcie_data {u32 boot_stage_cache;u32 img_resp_cache; +u32 dbg_path_cache;u32 cnvi;u32 cnvr;
Signature · 1 line
2.54.0
This is automated email and please do not reply to this email!
Dear submitter,
Thank you for submitting the patches to the linux bluetooth mailing list. This is a CI test results with your patch series:
PW Link:https://patchwork.kernel.org/project/bluetooth/list/?series=1148516
---Test result---
Test Summary:
CheckPatch PASS 4.69 seconds VerifyFixes PASS 0.13 seconds VerifySignedoff PASS 0.13 seconds GitLint PASS 0.95 seconds SubjectPrefix PASS 0.37 seconds BuildKernel PASS 27.70 seconds CheckAllWarning PASS 30.58 seconds CheckSparse PASS 29.12 seconds BuildKernel32 PASS 26.62 seconds CheckKernelLLVM SKIP 0.00 seconds TestRunnerSetup PASS 505.00 seconds IncrementalBuild PASS 29.04 seconds
Details
##############################
Test: CheckKernelLLVM - SKIP
Desc: Build kernel with LLVM + context analysis
Output:
Clang not found
https://github.com/bluez/bluetooth-next/pull/619
---
Regards,
Linux Bluetooth
This series was applied to bluetooth/bluetooth-next.git (master) by Luiz Augusto von Dentz <[email protected]>:
Hello:
This series was applied to bluetooth/bluetooth-next.git (master) by Luiz Augusto von Dentz <[email protected]>:
Quoted 9 lines · On Wed, 19 Aug 2026 20:02:17 +0530 you wrote:
From: Chandrashekar Devegowda <[email protected]>
Implement GP1 mailbox interrupt handling to receive memory region addresses from firmware via a TLV-based protocol. When firmware sends a
BUILD_SPECIFIC_RESOURCES_MAPPINGmailbox message, the driver reads a TLV table from device memory containing addresses and sizes of debug memory regions (exception dump, DCCM, SDS, ECL, SMEM).[...]
Here is the summary with links:
- [v2,1/3] Bluetooth: btintel_pcie: parse FW memory addresses via mailbox TLV
https://git.kernel.org/bluetooth/bluetooth-next/c/6f5f8dcf6244 - [v2,2/3] Bluetooth: btintel_pcie: sync mbox tlv parsing with GP0 alive interrupt https://git.kernel.org/bluetooth/bluetooth-next/c/185b9b3869fa - [v2,3/3] Bluetooth: btintel_pcie: Route debug traces to WiFi DBGC by default https://git.kernel.org/bluetooth/bluetooth-next/c/52eff0428bf2
You are awesome, thank you!
Signature · 2 lines
Deet-doot-dot, I am a bot. https://korg.docs.kernel.org/patchwork/pwbot.html