drivers/bluetooth/btintel_pcie.c

File Facts

System

Linux kernel

Corpus path

drivers/bluetooth/btintel_pcie.c

Extension

.c

Size

88831 bytes

Lines

3189

Domain

Driver Families

Bucket

drivers/bluetooth

Inferred role

Driver Families: operation-table or driver-model contract

Status

pattern implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/kernel.h
• linux/module.h
• linux/firmware.h
• linux/overflow.h
• linux/pci.h
• linux/string.h
• linux/wait.h
• linux/delay.h
• linux/interrupt.h
• linux/acpi.h
• linux/unaligned.h
• linux/devcoredump.h
• net/bluetooth/bluetooth.h
• net/bluetooth/hci_core.h
• net/bluetooth/hci_drv.h
• btintel.h
• btintel_pcie.h

Detected Declarations

• struct btintel_pcie_dev_recovery
• struct btintel_pcie_dbgc_ctxt_buf
• struct btintel_pcie_dbgc_ctxt
• struct btintel_pcie_trigger_evt
• struct btintel_pcie_fwtrigger_evt
• struct tlv
• struct btintel_pcie_causes_list
• struct pldr_mode
• enum btintel_dsm_internal_product_reset_mode
• function btintel_pcie_setup_dbgc
• function ipc_print_ia_ring
• function ipc_print_urbd1
• function btintel_pcie_set_tx_db
• function btintel_pcie_prepare_tx
• function btintel_pcie_dump_debug_registers
• function btintel_pcie_send_sync
• function btintel_pcie_set_rx_db
• function btintel_pcie_prepare_rx
• function btintel_pcie_submit_rx
• function btintel_pcie_start_rx
• function btintel_pcie_reset_ia
• function btintel_pcie_reset_bt
• function btintel_pcie_mac_init
• function btintel_pcie_get_mac_access
• function btintel_pcie_release_mac_access
• function btintel_pcie_read_dram_buffers
• function btintel_pcie_dump_traces
• function btintel_pcie_is_blazariw
• function btintel_pcie_enable_bt
• function btintel_pcie_in_op
• function btintel_pcie_in_iml
• function btintel_pcie_in_d3
• function btintel_pcie_in_d0
• function btintel_pcie_in_device_halt
• function btintel_pcie_wr_sleep_cntrl
• function btintel_pcie_read_device_mem
• function btintel_pcie_in_lockdown
• function btintel_pcie_in_error
• function btintel_pcie_msix_gp1_handler
• function btintel_pcie_msix_gp0_handler
• function btintel_pcie_msix_tx_handle
• function btintel_pcie_recv_event
• function btintel_pcie_recv_frame
• function btintel_pcie_read_hwexp
• function btintel_pcie_dump_fwtrigger_event
• function btintel_pcie_msix_fw_trigger_handler
• function btintel_pcie_msix_hw_exp_handler
• function btintel_pcie_coredump_worker

Annotated Snippet

static struct pci_driver btintel_pcie_driver = {
	.name = KBUILD_MODNAME,
	.id_table = btintel_pcie_table,
	.probe = btintel_pcie_probe,
	.remove = btintel_pcie_remove,
	.driver.pm = pm_sleep_ptr(&btintel_pcie_pm_ops),
#ifdef CONFIG_DEV_COREDUMP
	.driver.coredump = btintel_pcie_coredump
#endif
};

static int __init btintel_pcie_init(void)
{
	return pci_register_driver(&btintel_pcie_driver);
}

static void __exit btintel_pcie_exit(void)
{
	pci_unregister_driver(&btintel_pcie_driver);
	btintel_pcie_free_restart_list();
}

module_init(btintel_pcie_init);
module_exit(btintel_pcie_exit);

MODULE_AUTHOR("Tedd Ho-Jeong An <tedd.an@intel.com>");
MODULE_DESCRIPTION("Intel Bluetooth PCIe transport driver ver " VERSION);
MODULE_VERSION(VERSION);
MODULE_LICENSE("GPL");

Annotation

• Immediate include surface: `linux/kernel.h`, `linux/module.h`, `linux/firmware.h`, `linux/overflow.h`, `linux/pci.h`, `linux/string.h`, `linux/wait.h`, `linux/delay.h`.
• Detected declarations: `struct btintel_pcie_dev_recovery`, `struct btintel_pcie_dbgc_ctxt_buf`, `struct btintel_pcie_dbgc_ctxt`, `struct btintel_pcie_trigger_evt`, `struct btintel_pcie_fwtrigger_evt`, `struct tlv`, `struct btintel_pcie_causes_list`, `struct pldr_mode`, `enum btintel_dsm_internal_product_reset_mode`, `function btintel_pcie_setup_dbgc`.
• Atlas domain: Driver Families / drivers/bluetooth.
• Implementation status: pattern implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.