drivers/net/wireless/ath/ath12k/core.h
Source file repositories/reference/linux-study-clean/drivers/net/wireless/ath/ath12k/core.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/net/wireless/ath/ath12k/core.h- Extension
.h- Size
- 35325 bytes
- Lines
- 1456
- 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.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/types.hlinux/interrupt.hlinux/irq.hlinux/bitfield.hlinux/dmi.hlinux/ctype.hlinux/firmware.hlinux/of_reserved_mem.hlinux/panic_notifier.hlinux/average.hlinux/of.hlinux/rhashtable.hqmi.hhtc.hwmi.hhal.hdp.hce.hmac.hhw.hreg.hdbring.hfw.hacpi.hwow.hdebugfs_htt_stats.hcoredump.hcmn_defs.hdp_cmn.hthermal.h
Detected Declarations
struct ath12k_skb_cbstruct ath12k_skb_rxcbstruct ath12k_ext_irq_grpstruct ath12k_smbios_bdfstruct he_ppe_thresholdstruct ath12k_hestruct ath12k_tx_confstruct ath12k_key_confstruct ath12k_vif_cachestruct ath12k_rekey_datastruct ath12k_link_vifstruct ath12k_vifstruct ath12k_vif_iterstruct ath12k_htt_data_statsstruct ath12k_htt_tx_statsstruct ath12k_per_ppdu_tx_statsstruct ath12k_link_stastruct ath12k_stastruct ath12k_ftm_event_objstruct ath12k_fw_statsstruct ath12k_dbg_htt_statsstruct ath12k_debugstruct ath12k_pdev_rssi_offsetsstruct ath12kstruct ath12k_incumbent_signal_interferencestruct ath12k_hwstruct ath12k_band_capstruct ath12k_pdev_capstruct mlo_timestampstruct ath12k_pdevstruct ath12k_fw_pdevstruct ath12k_board_datastruct ath12k_reg_freqstruct ath12k_mlo_memorystruct ath12k_hw_linkstruct ath12k_hw_groupstruct ath12k_wsi_infostruct ath12k_dp_profile_paramsstruct ath12k_mem_profile_based_paramstruct ath12k_basestruct ath12k_pdev_mapstruct ath12k_fw_stats_vdevstruct ath12k_fw_stats_bcnstruct ath12k_fw_stats_pdevenum ath12k_bdf_searchenum wme_acenum ath12k_crypt_modeenum ath12k_skb_flags
Annotated Snippet
struct ath12k_skb_cb {
dma_addr_t paddr;
struct ath12k *ar;
struct ieee80211_vif *vif;
dma_addr_t paddr_ext_desc;
u32 cipher;
u8 flags;
u8 link_id;
};
struct ath12k_skb_rxcb {
dma_addr_t paddr;
bool is_first_msdu;
bool is_last_msdu;
bool is_continuation;
bool is_mcbc;
bool is_eapol;
struct hal_rx_desc *rx_desc;
u8 err_rel_src;
u8 err_code;
u8 hw_link_id;
u8 unmapped;
u8 is_frag;
u8 tid;
u16 peer_id;
bool is_end_of_ppdu;
};
enum ath12k_hw_rev {
ATH12K_HW_QCN9274_HW10,
ATH12K_HW_QCN9274_HW20,
ATH12K_HW_WCN7850_HW20,
ATH12K_HW_IPQ5332_HW10,
ATH12K_HW_QCC2072_HW10,
ATH12K_HW_IPQ5424_HW10,
};
enum ath12k_firmware_mode {
/* the default mode, standard 802.11 functionality */
ATH12K_FIRMWARE_MODE_NORMAL,
/* factory tests etc */
ATH12K_FIRMWARE_MODE_FTM,
};
#define ATH12K_IRQ_NUM_MAX 57
#define ATH12K_EXT_IRQ_NUM_MAX 16
#define ATH12K_MAX_TCL_RING_NUM 3
struct ath12k_ext_irq_grp {
struct ath12k_base *ab;
u32 irqs[ATH12K_EXT_IRQ_NUM_MAX];
u32 num_irq;
u32 grp_id;
u64 timestamp;
bool napi_enabled;
struct napi_struct napi;
struct net_device *napi_ndev;
};
enum ath12k_smbios_cc_type {
/* disable country code setting from SMBIOS */
ATH12K_SMBIOS_CC_DISABLE = 0,
/* set country code by ANSI country name, based on ISO3166-1 alpha2 */
ATH12K_SMBIOS_CC_ISO = 1,
/* worldwide regdomain */
ATH12K_SMBIOS_CC_WW = 2,
};
struct ath12k_smbios_bdf {
struct dmi_header hdr;
u8 features_disabled;
/* enum ath12k_smbios_cc_type */
u8 country_code_flag;
/* To set specific country, you need to set country code
* flag=ATH12K_SMBIOS_CC_ISO first, then if country is United
* States, then country code value = 0x5553 ("US",'U' = 0x55, 'S'=
* 0x53). To set country to INDONESIA, then country code value =
* 0x4944 ("IN", 'I'=0x49, 'D'=0x44). If country code flag =
* ATH12K_SMBIOS_CC_WW, then you can use worldwide regulatory
* setting.
*/
u16 cc_code;
u8 bdf_enabled;
u8 bdf_ext[];
Annotation
- Immediate include surface: `linux/types.h`, `linux/interrupt.h`, `linux/irq.h`, `linux/bitfield.h`, `linux/dmi.h`, `linux/ctype.h`, `linux/firmware.h`, `linux/of_reserved_mem.h`.
- Detected declarations: `struct ath12k_skb_cb`, `struct ath12k_skb_rxcb`, `struct ath12k_ext_irq_grp`, `struct ath12k_smbios_bdf`, `struct he_ppe_threshold`, `struct ath12k_he`, `struct ath12k_tx_conf`, `struct ath12k_key_conf`, `struct ath12k_vif_cache`, `struct ath12k_rekey_data`.
- Atlas domain: Driver Families / drivers/net.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.