drivers/net/wireless/ath/ath10k/pci.c

Source file repositories/reference/linux-study-clean/drivers/net/wireless/ath/ath10k/pci.c

File Facts

System: Linux kernel
Corpus path: drivers/net/wireless/ath/ath10k/pci.c
Extension: .c
Size: 97928 bytes
Lines: 3855
Domain: Driver Families
Bucket: drivers/net
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/pci.h
linux/module.h
linux/interrupt.h
linux/spinlock.h
linux/bitops.h
core.h
debug.h
coredump.h
targaddrs.h
bmi.h
hif.h
htc.h
ce.h
pci.h

Detected Declarations

enum ath10k_pci_reset_mode
function ath10k_pci_is_awake
function __ath10k_pci_wake
function __ath10k_pci_sleep
function ath10k_pci_wake_wait
function ath10k_pci_force_wake
function ath10k_pci_force_sleep
function ath10k_pci_wake
function ath10k_pci_sleep
function ath10k_pci_ps_timer
function ath10k_pci_sleep_sync
function ath10k_bus_pci_write32
function ath10k_bus_pci_read32
function ath10k_pci_write32
function ath10k_pci_read32
function ath10k_pci_soc_read32
function ath10k_pci_soc_write32
function ath10k_pci_reg_read32
function ath10k_pci_reg_write32
function ath10k_pci_irq_pending
function ath10k_pci_disable_and_clear_intx_irq
function ath10k_pci_enable_intx_irq
function __ath10k_pci_rx_post_buf
function ath10k_pci_rx_post_pipe
function ath10k_pci_rx_post
function ath10k_pci_rx_replenish_retry
function ath10k_pci_qca988x_targ_cpu_to_ce_addr
function ath10k_pci_qca6174_targ_cpu_to_ce_addr
function ath10k_pci_qca99x0_targ_cpu_to_ce_addr
function ath10k_pci_targ_cpu_to_ce_addr
function ath10k_pci_diag_read_mem
function ath10k_pci_diag_read32
function __ath10k_pci_diag_read_hi
function ath10k_pci_diag_write_mem
function ath10k_pci_diag_write32
function ath10k_pci_htc_tx_cb
function ath10k_pci_process_rx_cb
function ath10k_pci_process_htt_rx_cb
function ath10k_pci_htc_rx_cb
function ath10k_pci_htt_htc_rx_cb
function ath10k_pci_pktlog_rx_cb
function ath10k_pci_htt_tx_cb
function ath10k_pci_htt_rx_deliver
function ath10k_pci_htt_rx_cb
function ath10k_pci_hif_tx_sg
function ath10k_pci_hif_diag_read
function ath10k_pci_hif_get_free_queue_number
function ath10k_pci_dump_registers

Annotated Snippet

static struct pci_driver ath10k_pci_driver = {
	.name = "ath10k_pci",
	.id_table = ath10k_pci_id_table,
	.probe = ath10k_pci_probe,
	.remove = ath10k_pci_remove,
#ifdef CONFIG_PM
	.driver.pm = &ath10k_pci_pm_ops,
#endif
};

static int __init ath10k_pci_init(void)
{
	int ret1, ret2;

	ret1 = pci_register_driver(&ath10k_pci_driver);
	if (ret1)
		printk(KERN_ERR "failed to register ath10k pci driver: %d\n",
		       ret1);

	ret2 = ath10k_ahb_init();
	if (ret2)
		printk(KERN_ERR "ahb init failed: %d\n", ret2);

	if (ret1 && ret2)
		return ret1;

	/* registered to at least one bus */
	return 0;
}
module_init(ath10k_pci_init);

static void __exit ath10k_pci_exit(void)
{
	pci_unregister_driver(&ath10k_pci_driver);
	ath10k_ahb_exit();
}

module_exit(ath10k_pci_exit);

MODULE_AUTHOR("Qualcomm Atheros");
MODULE_DESCRIPTION("Driver support for Qualcomm Atheros PCIe/AHB 802.11ac WLAN devices");
MODULE_LICENSE("Dual BSD/GPL");

/* QCA988x 2.0 firmware files */
MODULE_FIRMWARE(QCA988X_HW_2_0_FW_DIR "/" ATH10K_FW_API2_FILE);
MODULE_FIRMWARE(QCA988X_HW_2_0_FW_DIR "/" ATH10K_FW_API3_FILE);
MODULE_FIRMWARE(QCA988X_HW_2_0_FW_DIR "/" ATH10K_FW_API4_FILE);
MODULE_FIRMWARE(QCA988X_HW_2_0_FW_DIR "/" ATH10K_FW_API5_FILE);
MODULE_FIRMWARE(QCA988X_HW_2_0_FW_DIR "/" ATH10K_BOARD_DATA_FILE);
MODULE_FIRMWARE(QCA988X_HW_2_0_FW_DIR "/" ATH10K_BOARD_API2_FILE);

/* QCA9887 1.0 firmware files */
MODULE_FIRMWARE(QCA9887_HW_1_0_FW_DIR "/" ATH10K_FW_API5_FILE);
MODULE_FIRMWARE(QCA9887_HW_1_0_FW_DIR "/" ATH10K_BOARD_DATA_FILE);
MODULE_FIRMWARE(QCA9887_HW_1_0_FW_DIR "/" ATH10K_BOARD_API2_FILE);

/* QCA6174 2.1 firmware files */
MODULE_FIRMWARE(QCA6174_HW_2_1_FW_DIR "/" ATH10K_FW_API4_FILE);
MODULE_FIRMWARE(QCA6174_HW_2_1_FW_DIR "/" ATH10K_FW_API5_FILE);
MODULE_FIRMWARE(QCA6174_HW_2_1_FW_DIR "/" ATH10K_BOARD_DATA_FILE);
MODULE_FIRMWARE(QCA6174_HW_2_1_FW_DIR "/" ATH10K_BOARD_API2_FILE);

/* QCA6174 3.1 firmware files */
MODULE_FIRMWARE(QCA6174_HW_3_0_FW_DIR "/" ATH10K_FW_API4_FILE);
MODULE_FIRMWARE(QCA6174_HW_3_0_FW_DIR "/" ATH10K_FW_API5_FILE);
MODULE_FIRMWARE(QCA6174_HW_3_0_FW_DIR "/" ATH10K_FW_API6_FILE);
MODULE_FIRMWARE(QCA6174_HW_3_0_FW_DIR "/" ATH10K_BOARD_DATA_FILE);
MODULE_FIRMWARE(QCA6174_HW_3_0_FW_DIR "/" ATH10K_BOARD_API2_FILE);

/* QCA9377 1.0 firmware files */
MODULE_FIRMWARE(QCA9377_HW_1_0_FW_DIR "/" ATH10K_FW_API6_FILE);
MODULE_FIRMWARE(QCA9377_HW_1_0_FW_DIR "/" ATH10K_FW_API5_FILE);
MODULE_FIRMWARE(QCA9377_HW_1_0_FW_DIR "/" ATH10K_BOARD_DATA_FILE);

Annotation

Immediate include surface: `linux/pci.h`, `linux/module.h`, `linux/interrupt.h`, `linux/spinlock.h`, `linux/bitops.h`, `core.h`, `debug.h`, `coredump.h`.
Detected declarations: `enum ath10k_pci_reset_mode`, `function ath10k_pci_is_awake`, `function __ath10k_pci_wake`, `function __ath10k_pci_sleep`, `function ath10k_pci_wake_wait`, `function ath10k_pci_force_wake`, `function ath10k_pci_force_sleep`, `function ath10k_pci_wake`, `function ath10k_pci_sleep`, `function ath10k_pci_ps_timer`.
Atlas domain: Driver Families / drivers/net.
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.