drivers/net/wireless/broadcom/brcm80211/brcmsmac/ucode_loader.c

File Facts

System

Linux kernel

Corpus path

drivers/net/wireless/broadcom/brcm80211/brcmsmac/ucode_loader.c

Extension

.c

Size

3965 bytes

Lines

110

Domain

Driver Families

Bucket

drivers/net

Inferred role

Driver Families: implementation source

Status

source 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 or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• defs.h
• types.h
• ucode_loader.h

Detected Declarations

• function brcms_ucode_data_init
• function brcms_ucode_data_free

Annotated Snippet

#include <defs.h>
#include "types.h"
#include <ucode_loader.h>

enum {
	D11UCODE_NAMETAG_START = 0,
	D11LCN0BSINITVALS24,
	D11LCN0INITVALS24,
	D11LCN1BSINITVALS24,
	D11LCN1INITVALS24,
	D11LCN2BSINITVALS24,
	D11LCN2INITVALS24,
	D11N0ABSINITVALS16,
	D11N0BSINITVALS16,
	D11N0INITVALS16,
	D11UCODE_OVERSIGHT16_MIMO,
	D11UCODE_OVERSIGHT16_MIMOSZ,
	D11UCODE_OVERSIGHT24_LCN,
	D11UCODE_OVERSIGHT24_LCNSZ,
	D11UCODE_OVERSIGHT_BOMMAJOR,
	D11UCODE_OVERSIGHT_BOMMINOR
};

int brcms_ucode_data_init(struct brcms_info *wl, struct brcms_ucode *ucode)
{
	int rc;

	rc = brcms_check_firmwares(wl);

	rc = rc < 0 ? rc :
		brcms_ucode_init_buf(wl, (void **)&ucode->d11lcn0bsinitvals24,
				     D11LCN0BSINITVALS24);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11lcn0initvals24,
				       D11LCN0INITVALS24);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11lcn1bsinitvals24,
				       D11LCN1BSINITVALS24);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11lcn1initvals24,
				       D11LCN1INITVALS24);
	rc = rc < 0 ? rc :
		brcms_ucode_init_buf(wl, (void **)&ucode->d11lcn2bsinitvals24,
				     D11LCN2BSINITVALS24);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11lcn2initvals24,
				       D11LCN2INITVALS24);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11n0absinitvals16,
				       D11N0ABSINITVALS16);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11n0bsinitvals16,
				       D11N0BSINITVALS16);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->d11n0initvals16,
				       D11N0INITVALS16);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->bcm43xx_16_mimo,
				       D11UCODE_OVERSIGHT16_MIMO);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_uint(wl, &ucode->bcm43xx_16_mimosz,
					D11UCODE_OVERSIGHT16_MIMOSZ);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->bcm43xx_24_lcn,
				       D11UCODE_OVERSIGHT24_LCN);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_uint(wl, &ucode->bcm43xx_24_lcnsz,
					D11UCODE_OVERSIGHT24_LCNSZ);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->bcm43xx_bommajor,
				       D11UCODE_OVERSIGHT_BOMMAJOR);
	rc = rc < 0 ?
	     rc : brcms_ucode_init_buf(wl, (void **)&ucode->bcm43xx_bomminor,
				       D11UCODE_OVERSIGHT_BOMMINOR);
	return rc;
}

void brcms_ucode_data_free(struct brcms_ucode *ucode)
{
	brcms_ucode_free_buf((void *)ucode->d11lcn0bsinitvals24);
	brcms_ucode_free_buf((void *)ucode->d11lcn0initvals24);
	brcms_ucode_free_buf((void *)ucode->d11lcn1bsinitvals24);
	brcms_ucode_free_buf((void *)ucode->d11lcn1initvals24);
	brcms_ucode_free_buf((void *)ucode->d11lcn2bsinitvals24);
	brcms_ucode_free_buf((void *)ucode->d11lcn2initvals24);
	brcms_ucode_free_buf((void *)ucode->d11n0absinitvals16);
	brcms_ucode_free_buf((void *)ucode->d11n0bsinitvals16);
	brcms_ucode_free_buf((void *)ucode->d11n0initvals16);
	brcms_ucode_free_buf((void *)ucode->bcm43xx_16_mimo);
	brcms_ucode_free_buf((void *)ucode->bcm43xx_24_lcn);

Annotation

• Immediate include surface: `defs.h`, `types.h`, `ucode_loader.h`.
• Detected declarations: `function brcms_ucode_data_init`, `function brcms_ucode_data_free`.
• Atlas domain: Driver Families / drivers/net.
• Implementation status: source implementation candidate.

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.