drivers/net/wireless/broadcom/brcm80211/brcmfmac/pcie.c

File Facts

System

Linux kernel

Corpus path

drivers/net/wireless/broadcom/brcm80211/brcmfmac/pcie.c

Extension

.c

Size

77287 bytes

Lines

2786

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.
• 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/pci.h
• linux/vmalloc.h
• linux/delay.h
• linux/interrupt.h
• linux/bcma/bcma.h
• linux/sched.h
• linux/sched/signal.h
• linux/kthread.h
• linux/io.h
• linux/random.h
• linux/unaligned.h
• soc.h
• chipcommon.h
• brcmu_utils.h
• brcmu_wifi.h
• brcm_hw_ids.h
• debug.h
• bus.h
• commonring.h
• msgbuf.h
• pcie.h
• firmware.h
• chip.h
• core.h
• common.h

Detected Declarations

• struct brcmf_pcie_console
• struct brcmf_pcie_shared_info
• struct brcmf_otp_params
• struct brcmf_pciedev_info
• struct brcmf_pcie_ringbuf
• struct brcmf_pcie_dhi_ringinfo
• struct brcmf_pcie_reginfo
• struct brcmf_random_seed_footer
• struct brcmf_pcie_drvdata
• enum brcmf_pcie_state
• function brcmf_pcie_read_reg16
• function brcmf_pcie_read_reg32
• function brcmf_pcie_write_reg32
• function brcmf_pcie_read_tcm8
• function brcmf_pcie_read_tcm16
• function brcmf_pcie_write_tcm16
• function brcmf_pcie_read_idx
• function brcmf_pcie_write_idx
• function brcmf_pcie_read_tcm32
• function brcmf_pcie_write_tcm32
• function brcmf_pcie_read_ram32
• function brcmf_pcie_write_ram32
• function brcmf_pcie_copy_dev_tomem
• function CHIPCREGOFFS
• function brcmf_pcie_reset_device
• function brcmf_pcie_attach
• function brcmf_pcie_enter_download_state
• function brcmf_pcie_exit_download_state
• function brcmf_pcie_send_mb_data
• function brcmf_pcie_handle_mb_data
• function brcmf_pcie_bus_console_init
• function brcmf_pcie_bus_console_read
• function brcmf_pcie_intr_disable
• function brcmf_pcie_intr_enable
• function brcmf_pcie_hostready
• function brcmf_pcie_quick_check_isr
• function brcmf_pcie_isr_thread
• function brcmf_pcie_request_irq
• function brcmf_pcie_release_irq
• function brcmf_pcie_ring_mb_write_rptr
• function brcmf_pcie_ring_mb_write_wptr
• function brcmf_pcie_ring_mb_ring_bell
• function brcmf_pcie_ring_mb_update_rptr
• function brcmf_pcie_ring_mb_update_wptr
• function brcmf_pcie_init_dmabuffer_for_device
• function brcmf_pcie_alloc_dma_and_ring
• function brcmf_pcie_release_ringbuffer
• function brcmf_pcie_release_ringbuffers

Annotated Snippet

static struct pci_driver brcmf_pciedrvr = {
	.name = KBUILD_MODNAME,
	.id_table = brcmf_pcie_devid_table,
	.probe = brcmf_pcie_probe,
	.remove = brcmf_pcie_remove,
#ifdef CONFIG_PM
	.driver.pm = &brcmf_pciedrvr_pm,
#endif
	.driver.coredump = brcmf_dev_coredump,
};


int brcmf_pcie_register(void)
{
	brcmf_dbg(PCIE, "Enter\n");
	return pci_register_driver(&brcmf_pciedrvr);
}


void brcmf_pcie_exit(void)
{
	brcmf_dbg(PCIE, "Enter\n");
	pci_unregister_driver(&brcmf_pciedrvr);
}

Annotation

• Immediate include surface: `linux/kernel.h`, `linux/module.h`, `linux/firmware.h`, `linux/pci.h`, `linux/vmalloc.h`, `linux/delay.h`, `linux/interrupt.h`, `linux/bcma/bcma.h`.
• Detected declarations: `struct brcmf_pcie_console`, `struct brcmf_pcie_shared_info`, `struct brcmf_otp_params`, `struct brcmf_pciedev_info`, `struct brcmf_pcie_ringbuf`, `struct brcmf_pcie_dhi_ringinfo`, `struct brcmf_pcie_reginfo`, `struct brcmf_random_seed_footer`, `struct brcmf_pcie_drvdata`, `enum brcmf_pcie_state`.
• Atlas domain: Driver Families / drivers/net.
• Implementation status: pattern implementation candidate.
• 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.