From 03abb0b8e45d1e75f5d5ad40326a3a855a2221dd Mon Sep 17 00:00:00 2001 From: Jeff Johnson Date: Sat, 3 Dec 2022 12:42:03 -0800 Subject: [PATCH] qcacmn: Fix wlan_cfg documentation The kernel-doc script identified a multitude of documentation issues in the wlan_cfg folder, so fix them. Change-Id: Id6bfb397608de6b858e448a867a3c21dffc9a178 CRs-Fixed: 3352408 --- wlan_cfg/wlan_cfg.c | 43 +-- wlan_cfg/wlan_cfg.h | 688 ++++++++++++++++++++++++-------------------- 2 files changed, 392 insertions(+), 339 deletions(-) diff --git a/wlan_cfg/wlan_cfg.c b/wlan_cfg/wlan_cfg.c index 92531f5044..bf131cdecc 100644 --- a/wlan_cfg/wlan_cfg.c +++ b/wlan_cfg/wlan_cfg.c @@ -2304,10 +2304,7 @@ static struct dp_int_mask_assignment dp_mask_assignment[NUM_INTERRUPT_COMBINATIO #endif #endif -/** - * g_wlan_srng_cfg[] - Per ring_type specific configuration - * - */ +/* g_wlan_srng_cfg[] - Per ring_type specific configuration */ struct wlan_srng_cfg g_wlan_srng_cfg[MAX_RING_TYPES]; /* REO_DST ring configuration */ @@ -2598,8 +2595,8 @@ wlan_soc_ipa_cfg_attach(struct cdp_ctrl_objmgr_psoc *psoc, /** * wlan_soc_ipa_cfg_attach() - Update ipa config in dp soc * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx + * @psoc: Object manager psoc + * @wlan_cfg_ctx: dp soc cfg ctx * * Return: None */ @@ -2652,8 +2649,8 @@ wlan_soc_hw_cc_cfg_attach(struct cdp_ctrl_objmgr_psoc *psoc, /** * wlan_soc_ppe_cfg_attach() - Update ppe config in dp soc * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx + * @psoc: Object manager psoc + * @wlan_cfg_ctx: dp soc cfg ctx * * Return: None */ @@ -2681,6 +2678,7 @@ wlan_soc_ppe_cfg_attach(struct cdp_ctrl_objmgr_psoc *psoc, #if defined(WLAN_FEATURE_11BE_MLO) && defined(WLAN_MLO_MULTI_CHIP) /** * wlan_cfg_get_lsb_set_pos() - returns position of LSB which is set + * @val: value to test * * Return: position of LSB which is set */ @@ -2701,8 +2699,8 @@ static uint8_t wlan_cfg_get_lsb_set_pos(uint8_t val) /** * wlan_multi_soc_mlo_cfg_attach() - Update multi soc mlo config in dp soc * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx + * @psoc: Object manager psoc + * @wlan_cfg_ctx: dp soc cfg ctx * * Return: None */ @@ -2728,8 +2726,8 @@ wlan_multi_soc_mlo_cfg_attach(struct cdp_ctrl_objmgr_psoc *psoc, /** * wlan_soc_mlo_cfg_attach() - Update mlo config in dp soc * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx + * @psoc: Object manager psoc + * @wlan_cfg_ctx: dp soc cfg ctx * * Return: None */ @@ -2751,8 +2749,8 @@ wlan_soc_mlo_cfg_attach(struct cdp_ctrl_objmgr_psoc *psoc, /** * wlan_soc_vdev_hw_stats_cfg_attach() - Update hw vdev stats config in dp soc * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx + * @psoc: Object manager psoc + * @wlan_cfg_ctx: dp soc cfg ctx * * Return: None */ @@ -2799,8 +2797,8 @@ wlan_cfg_soc_update_tgt_params(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, /** * wlan_soc_sawf_stats_cfg_attach() - Update sawf stats config in dp soc * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx + * @psoc: Object manager psoc + * @wlan_cfg_ctx: dp soc cfg ctx * * Return: None */ @@ -2822,14 +2820,6 @@ void wlan_cfg_set_sawf_stats_config(struct wlan_cfg_dp_soc_ctxt *cfg, cfg->sawf_stats = val; } #else -/** - * wlan_soc_sawf_stats_cfg_attach() - Update sawf stats config in dp soc - * cfg context - * @psoc - Object manager psoc - * @wlan_cfg_ctx - dp soc cfg ctx - * - * Return: None - */ static void wlan_soc_sawf_stats_cfg_attach(struct cdp_ctrl_objmgr_psoc *psoc, struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx) @@ -2847,11 +2837,6 @@ void wlan_cfg_set_sawf_stats_config(struct wlan_cfg_dp_soc_ctxt *cfg, } #endif /* CONFIG_SAWF_STATS */ -/** - * wlan_cfg_soc_attach() - Allocate and prepare SoC configuration - * @psoc - Object manager psoc - * Return: wlan_cfg_ctx - Handle to Configuration context - */ struct wlan_cfg_dp_soc_ctxt * wlan_cfg_soc_attach(struct cdp_ctrl_objmgr_psoc *psoc) { diff --git a/wlan_cfg/wlan_cfg.h b/wlan_cfg/wlan_cfg.h index 07c8e55d7a..7824dbe4e7 100644 --- a/wlan_cfg/wlan_cfg.h +++ b/wlan_cfg/wlan_cfg.h @@ -110,10 +110,10 @@ struct wlan_cfg_dp_pdev_ctxt; /** * struct wlan_cfg_tcl_wbm_ring_num_map - TCL WBM Ring number mapping - * @tcl_ring_num - TCL Ring number - * @wbm_ring_num - WBM Ring number - * @wbm_ring_num - WBM RBM ID to be used when enqueuing to TCL - * @for_ipa - whether this TCL/WBM for IPA use or not + * @tcl_ring_num: TCL Ring number + * @wbm_ring_num: WBM Ring number + * @wbm_rbm_id: WBM RBM ID to be used when enqueuing to TCL + * @for_ipa: whether this TCL/WBM for IPA use or not */ struct wlan_cfg_tcl_wbm_ring_num_map { uint8_t tcl_ring_num; @@ -145,8 +145,12 @@ struct wlan_srng_cfg { * 1: Each TCL ring is mapped to one radio/pdev * @num_tx_comp_rings: Number of Tx comp rings supported by device * @num_tcl_data_rings: Number of TCL Data rings supported by device + * @num_nss_tcl_data_rings: * @per_pdev_rx_ring: 0: REO ring is not mapped per radio * 1: Each REO ring is mapped to one radio/pdev + * @per_pdev_lmac_ring: + * @num_reo_dest_rings: + * @num_nss_reo_dest_rings: * @num_tx_desc_pool: Number of Tx Descriptor pools * @num_tx_ext_desc_pool: Number of Tx MSDU extension Descriptor pools * @num_tx_desc: Number of Tx Descriptors per pool @@ -156,14 +160,30 @@ struct wlan_srng_cfg { * @htt_packet_type: Default 802.11 encapsulation type for any VAP created * @int_tx_ring_mask: Bitmap of Tx interrupts mapped to each NAPI/Intr context * @int_rx_ring_mask: Bitmap of Rx interrupts mapped to each NAPI/Intr context + * @int_batch_threshold_ppe2tcl: + * @int_timer_threshold_ppe2tcl: + * @int_batch_threshold_tx: + * @int_timer_threshold_tx: + * @int_batch_threshold_rx: + * @int_timer_threshold_rx: + * @int_batch_threshold_other: + * @int_timer_threshold_other: + * @int_timer_threshold_mon: + * @tx_ring_size: + * @time_control_bp: + * @tx_comp_ring_size: + * @tx_comp_ring_size_nss: * @int_rx_mon_ring_mask: Bitmap of Rx monitor ring interrupts mapped to each * NAPI/Intr context * @int_tx_mon_ring_mask: Bitmap of Tx monitor ring interrupts mapped to each * NAPI/Intr context + * @int_host2rxdma_mon_ring_mask: + * @int_rxdma2host_mon_ring_mask: + * @int_ce_ring_mask: Bitmap of CE interrupts mapped to each NAPI/Intr context * @int_rx_err_ring_mask: Bitmap of Rx err ring interrupts mapped to each * NAPI/Intr context - * @int_wbm_rel_ring_mask: Bitmap of wbm rel ring interrupts mapped to each - * NAPI/Intr context + * @int_rx_wbm_rel_ring_mask: Bitmap of wbm rel ring interrupts mapped to each + * NAPI/Intr context * @int_reo_status_ring_mask: Bitmap of reo status ring interrupts mapped to * each NAPI/Intr context * @int_rxdma2host_ring_mask: @@ -176,10 +196,14 @@ struct wlan_srng_cfg { * interrupt mapped to each NAPI/INTR context * @int_host2txmon_ring_mask: Bitmap of Tx monitor source ring interrupt * mapped to each NAPI/INTR context + * @int_ppeds_wbm_release_ring_mask: + * @int_ppe2tcl_ring_mask: + * @int_reo2ppe_ring_mask: * @int_umac_reset_intr_mask: Bitmap of UMAC reset interrupt mapped to each * NAPI/INTR context - * @int_ce_ring_mask: Bitmap of CE interrupts mapped to each NAPI/Intr context - * @lro_enabled: enable/disable lro feature + * @hw_macid: + * @hw_macid_pdev_id_map: + * @base_hw_macid: * @rx_hash: Enable hash based steering of rx packets * @tso_enabled: enable/disable tso feature * @lro_enabled: enable/disable LRO feature @@ -196,8 +220,13 @@ struct wlan_srng_cfg { * @p2p_tcp_udp_checksumoffload: enable/disable checksum offload for P2P mode * @nan_tcp_udp_checksumoffload: enable/disable checksum offload for NAN mode * @tcp_udp_checksumoffload: enable/disable checksum offload + * @legacy_mode_checksumoffload_disable: + * @defrag_timeout_check: * @nss_cfg: nss configuration + * @tx_flow_stop_queue_threshold: + * @tx_flow_start_queue_offset: * @rx_defrag_min_timeout: rx defrag minimum timeout + * @reo_dst_ring_size: * @wbm_release_ring: wbm release ring size * @tcl_cmd_credit_ring: tcl command/credit ring size * @tcl_status_ring: tcl status ring size @@ -209,16 +238,19 @@ struct wlan_srng_cfg { * @rxdma_refill_ring: rxdma refill ring size * @rxdma_refill_lt_disable: rxdma refill low threshold disable * @rxdma_err_dst_ring: rxdma error destination ring size + * @per_pkt_trace: * @raw_mode_war: enable/disable raw mode war * @enable_data_stall_detection: enable/disable specific data stall detection * @disable_intra_bss_fwd: flag to disable intra bss forwarding * @rxdma1_enable: flag to indicate if rxdma1 is enabled * @delay_mon_replenish: delay monitor buffer replenish - * @tx_desc_limit_0: tx_desc limit for 5G H - * @tx_desc_limit_1: tx_desc limit for 2G - * @tx_desc_limit_2: tx_desc limit for 5G L + * @max_ast_idx: + * @tx_desc_limit_0: tx_desc limit for 5 GHz High + * @tx_desc_limit_1: tx_desc limit for 2 GHz + * @tx_desc_limit_2: tx_desc limit for 5 GHz Low * @tx_device_limit: tx device limit * @tx_sw_internode_queue: tx sw internode queue + * @mon_drop_thresh: * @tx_comp_loop_pkt_limit: Max # of packets to be processed in 1 tx comp loop * @rx_reap_loop_pkt_limit: Max # of packets to be processed in 1 rx reap loop * @rx_hp_oos_update_limit: Max # of HP OOS (out of sync) updates @@ -227,6 +259,7 @@ struct wlan_srng_cfg { * @tx_comp_enable_eol_data_check: flag to enable/disable checking for more data * at end of tx_comp_handler loop. * @rx_sw_desc_weight: rx sw descriptor weight configuration + * @rx_sw_desc_num: * @is_rx_mon_protocol_flow_tag_enabled: flag to enable/disable RX protocol or * flow tagging in monitor/mon-lite mode * @is_rx_flow_tag_enabled: flag to enable/disable RX flow tagging using FSE @@ -239,6 +272,10 @@ struct wlan_srng_cfg { * 5 tuple flow entry * @pktlog_buffer_size: packet log buffer size * @is_rx_fisa_enabled: flag to enable/disable FISA Rx + * @is_rx_fisa_lru_del_enabled: + * @is_tso_desc_attach_defer: + * @delayed_replenish_entries: + * @reo_rings_mapping: * @pext_stats_enabled: Flag to enable and disabled peer extended stats * @is_rx_buff_pool_enabled: flag to enable/disable emergency RX buffer * pool support @@ -246,31 +283,50 @@ struct wlan_srng_cfg { * pool support * @rx_pending_high_threshold: threshold of starting pkt drop * @rx_pending_low_threshold: threshold of stopping pkt drop + * @is_poll_mode_enabled: * @is_swlm_enabled: flag to enable/disable SWLM + * @fst_in_cmem: * @tx_per_pkt_vdev_id_check: Enable tx perpkt vdev id check + * @radio0_rx_default_reo: + * @radio1_rx_default_reo: + * @radio2_rx_default_reo: * @wow_check_rx_pending_enable: Enable RX frame pending check in WoW + * @jitter_stats_enabled: true if jitter stats are enabled * @ipa_tx_ring_size: IPA tx ring size * @ipa_tx_comp_ring_size: IPA tx completion ring size * @ipa_tx_alt_ring_size: IPA tx alt ring size * @ipa_tx_alt_comp_ring_size: IPA tx alt completion ring size - * @hw_cc_conv_enabled: cookie conversion enabled + * @hw_cc_enabled: cookie conversion enabled * @tcl_wbm_map_array: TCL-WBM map array + * @ppe_enable: + * @reo2ppe_ring: + * @ppe2tcl_ring: + * @ppe_release_ring: + * @ppe_wbm_release_ring: + * @ppe_num_tx_desc: + * @ppe_tx_comp_napi_budget: * @pkt_capture_mode: Packet capture mode config * @rx_mon_buf_ring_size: Rx monitor buf ring size * @tx_mon_buf_ring_size: Tx monitor buf ring size + * @rx_rel_wbm2sw_ring_id: Rx WBM2SW ring id * @tx_rings_grp_bitmap: bitmap of group intr contexts which have - * non-zero tx ring mask + * non-zero tx ring mask * @mlo_chip_rx_ring_map: map of chip_id to rx ring map * @vdev_stats_hw_offload_config: HW vdev stats config * @vdev_stats_hw_offload_timer: HW vdev stats timer duration + * @num_rxdma_dst_rings_per_pdev: Number of Rx DMA rings per pdev * @txmon_hw_support: TxMON HW support + * @txmon_sw_peer_filtering: TxMON sw peer filtering support * @num_rxdma_status_rings_per_pdev: Num RXDMA status rings + * @tx_capt_max_mem_allowed: Max memory for Tx packet capture + * @sawf_enabled: Is SAWF enabled + * @sawf_stats: SAWF Statistics * @mpdu_retry_threshold_1: MPDU retry threshold 1 to increment tx bad count * @mpdu_retry_threshold_2: MPDU retry threshold 2 to increment tx bad count - * napi_scale_factor: scaling factor to be used for napi polls + * @napi_scale_factor: scaling factor to be used for napi polls * @notify_frame_support: flag indicating capability to mark notify frames - * @is_handle_invalid_decap_type_disabled: flag to indicate if invalid decap type - * handling is disabled + * @is_handle_invalid_decap_type_disabled: flag to indicate if invalid decap + * type handling is disabled */ struct wlan_cfg_dp_soc_ctxt { int num_int_ctxts; @@ -464,13 +520,15 @@ struct wlan_cfg_dp_soc_ctxt { /** * struct wlan_cfg_dp_pdev_ctxt - Configuration parameters for pdev (radio) - * @rx_dma_buf_ring_size - Size of RxDMA buffer ring - * @dma_mon_buf_ring_size - Size of RxDMA Monitor buffer ring - * @dma_rx_mon_dest_ring_size - Size of RxDMA Monitor Destination ring - * @dma_tx_mon_dest_ring_size - Size of Tx Monitor Destination ring - * @dma_mon_status_ring_size - Size of RxDMA Monitor Status ring - * @rxdma_monitor_desc_ring - rxdma monitor desc ring size - * @dma_tx_mon_buf_ring_size - Tx monitor BUF Ring size + * @rx_dma_buf_ring_size: Size of RxDMA buffer ring + * @dma_mon_buf_ring_size: Size of RxDMA Monitor buffer ring + * @dma_rx_mon_dest_ring_size: Size of RxDMA Monitor Destination ring + * @dma_tx_mon_dest_ring_size: Size of Tx Monitor Destination ring + * @dma_mon_status_ring_size: Size of RxDMA Monitor Status ring + * @rxdma_monitor_desc_ring: rxdma monitor desc ring size + * @num_mac_rings: Number of mac rings + * @nss_enabled: 1 - NSS enabled, 0 - NSS disabled + * @dma_tx_mon_buf_ring_size: Tx monitor BUF Ring size */ struct wlan_cfg_dp_pdev_ctxt { int rx_dma_buf_ring_size; @@ -516,7 +574,7 @@ struct wlan_dp_prealloc_cfg { /** * wlan_cfg_soc_attach() - Attach configuration interface for SoC - * @ctrl_obj - PSOC object + * @psoc: PSOC object * * Allocates context for Soc configuration parameters, * Read configuration information from device tree/ini file and @@ -525,7 +583,7 @@ struct wlan_dp_prealloc_cfg { * Return: Handle to configuration context */ struct wlan_cfg_dp_soc_ctxt * -wlan_cfg_soc_attach(struct cdp_ctrl_objmgr_psoc *ctrl_obj); +wlan_cfg_soc_attach(struct cdp_ctrl_objmgr_psoc *psoc); /** * wlan_cfg_soc_detach() - Detach soc configuration handle @@ -538,8 +596,8 @@ wlan_cfg_soc_attach(struct cdp_ctrl_objmgr_psoc *ctrl_obj); void wlan_cfg_soc_detach(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); /** - * wlan_cfg_pdev_attach() Attach configuration interface for pdev - * @ctrl_obj - PSOC object + * wlan_cfg_pdev_attach() - Attach configuration interface for pdev + * @ctrl_obj: PSOC object * * Allocates context for pdev configuration parameters, * Read configuration information from device tree/ini file and @@ -551,8 +609,8 @@ struct wlan_cfg_dp_pdev_ctxt * wlan_cfg_pdev_attach(struct cdp_ctrl_objmgr_psoc *ctrl_obj); /** - * wlan_cfg_pdev_detach() Detach and free pdev configuration handle - * @wlan_cfg_pdev_ctx - PDEV Configuration Handle + * wlan_cfg_pdev_detach() - Detach and free pdev configuration handle + * @wlan_cfg_pdev_ctx: PDEV Configuration Handle * * Return: void */ @@ -583,8 +641,8 @@ int wlan_cfg_set_reo_status_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_set_mon_delayed_replenish_entries() - number of buffers to replenish * for monitor buffer ring at initialization - * @wlan_cfg_ctx - Configuration Handle - * @replenish_entries - number of entries to replenish at initialization + * @wlan_cfg_ctx: Configuration Handle + * @replenish_entries: number of entries to replenish at initialization * */ void wlan_cfg_set_mon_delayed_replenish_entries(struct wlan_cfg_dp_soc_ctxt @@ -594,8 +652,7 @@ void wlan_cfg_set_mon_delayed_replenish_entries(struct wlan_cfg_dp_soc_ctxt /** * wlan_cfg_get_mon_delayed_replenish_entries() - get num of buffer to replenish * for monitor buffer ring at initialization - * @wlan_cfg_ctx - Configuration Handle - * @replenish_entries - number of entries to replenish at initialization + * @wlan_cfg_ctx: Configuration Handle * * Return: delayed_replenish_entries; */ @@ -603,7 +660,7 @@ int wlan_cfg_get_mon_delayed_replenish_entries(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); /** * wlan_cfg_get_num_contexts() - Number of interrupt contexts to be registered - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * For WIN, DP_NUM_INTERRUPT_CONTEXTS will be equal to number of CPU cores. * Each context (for linux it is a NAPI context) will have a tx_ring_mask, @@ -617,8 +674,8 @@ int wlan_cfg_get_num_contexts(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); /** * wlan_cfg_get_tx_ring_mask() - Return Tx interrupt mask mapped to an * interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @wlan_cfg_ctx: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_tx_ring_mask[context] */ @@ -627,7 +684,7 @@ int wlan_cfg_get_tx_ring_mask(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, /** * wlan_cfg_get_tcl_wbm_ring_num_for_index() - Get TCL/WBM ring number for index - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * @index: index for which TCL/WBM ring numbers are needed * @tcl: pointer to TCL ring number, to be filled * @wbm: pointer to WBM ring number to be filled @@ -650,7 +707,7 @@ void wlan_cfg_get_tcl_wbm_ring_num_for_index(struct wlan_cfg_dp_soc_ctxt *wlan_c /** * wlan_cfg_get_wbm_ring_num_for_index() - Get WBM ring number for index - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * @index: index for which WBM ring numbers is needed * * Return: WBM Ring number for the index @@ -664,7 +721,7 @@ int wlan_cfg_get_wbm_ring_num_for_index(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ct /** * wlan_cfg_get_rbm_id_for_index() - Get WBM RBM ID for TX ring index - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * @index: TCL index for which WBM rbm value is needed * * The function fills in wbm rbm value corresponding to a TX ring index in @@ -684,8 +741,8 @@ int wlan_cfg_get_rbm_id_for_index(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, int /** * wlan_cfg_get_rx_ring_mask() - Return Rx interrupt mask mapped to an * interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @wlan_cfg_ctx: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_rx_ring_mask[context] */ @@ -695,8 +752,8 @@ int wlan_cfg_get_rx_ring_mask(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, /** * wlan_cfg_get_rx_mon_ring_mask() - Return Rx monitor ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @wlan_cfg_ctx: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_rx_mon_ring_mask[context] */ @@ -706,8 +763,8 @@ int wlan_cfg_get_rx_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, /** * wlan_cfg_set_tx_mon_ring_mask() - Set Tx monitor ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * @mask: Interrupt mask * * Return: None @@ -718,8 +775,8 @@ void wlan_cfg_set_tx_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_get_tx_mon_ring_mask() - Return Tx monitor ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @wlan_cfg_ctx: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_tx_mon_ring_mask[context] */ @@ -729,50 +786,52 @@ int wlan_cfg_get_tx_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, /** * wlan_cfg_set_rxdma2host_ring_mask() - Set rxdma2host ring interrupt mask * for the given interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context + * @mask: Interrupt mask * */ void wlan_cfg_set_rxdma2host_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, - int context, int mask); + int context, int mask); /** * wlan_cfg_get_rxdma2host_ring_mask() - Return rxdma2host ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_rxdma2host_ring_mask[context] */ int wlan_cfg_get_rxdma2host_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, - int context); + int context); /** * wlan_cfg_set_host2rxdma_ring_mask() - Set host2rxdma ring interrupt mask * for the given interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context + * @mask: Interrupt mask * */ void wlan_cfg_set_host2rxdma_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, - int context, int mask); + int context, int mask); /** * wlan_cfg_get_host2rxdma_ring_mask() - Return host2rxdma ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_host2rxdma_ring_mask[context] */ int wlan_cfg_get_host2rxdma_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, - int context); + int context); /** * wlan_cfg_get_rx_near_full_grp_1_mask() - Return REO near full interrupt mask * mapped to an interrupt context * @cfg: Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: REO near full interrupt mask[context] */ @@ -783,7 +842,7 @@ int wlan_cfg_get_rx_near_full_grp_1_mask(struct wlan_cfg_dp_soc_ctxt *cfg, * wlan_cfg_get_rx_near_full_grp_2_mask() - Return REO near full interrupt mask * mapped to an interrupt context * @cfg: Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: REO near full interrupt mask[context] */ @@ -794,7 +853,7 @@ int wlan_cfg_get_rx_near_full_grp_2_mask(struct wlan_cfg_dp_soc_ctxt *cfg, * wlan_cfg_get_tx_ring_near_full_mask() - Return tx completion ring near full * interrupt mask mapped to an interrupt context * @cfg: Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: tx completion near full interrupt mask[context] */ @@ -803,8 +862,9 @@ int wlan_cfg_get_tx_ring_near_full_mask(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_set_host2rxdma_mon_ring_mask() - Set host2rxdma monitor ring * interrupt mask for the given interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context + * @mask: Interrupt mask * */ void wlan_cfg_set_host2rxdma_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, @@ -813,8 +873,8 @@ void wlan_cfg_set_host2rxdma_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_get_host2rxdma_mon_ring_mask() - Return host2rxdma monitoe ring * interrupt mask mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_host2rxdma_mon_ring_mask[context] */ @@ -825,8 +885,9 @@ int wlan_cfg_get_host2rxdma_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, * wlan_cfg_set_rxdma2host_mon_ring_mask() - Set rxdma2host monitor * destination ring interrupt mask * for the given interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context + * @mask: Interrupt mask * */ void wlan_cfg_set_rxdma2host_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, @@ -836,8 +897,8 @@ void wlan_cfg_set_rxdma2host_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, * wlan_cfg_get_rxdma2host_mon_ring_mask() - Return rxdma2host monitor * destination ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_rxdma2host_mon_ring_mask[context] */ @@ -845,22 +906,22 @@ int wlan_cfg_get_rxdma2host_mon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, int context); /** - * wlan_cfg_set_hw_macidx() - Set HW MAC Idx for the given PDEV index + * wlan_cfg_set_hw_mac_idx() - Set HW MAC Idx for the given PDEV index * - * @wlan_cfg_ctx - Configuration Handle - * @pdev_idx - Index of SW PDEV - * @hw_macid - HW MAC Id + * @cfg: Configuration Handle + * @pdev_idx: Index of SW PDEV + * @hw_macid: HW MAC Id * */ -void wlan_cfg_set_hw_mac_idx - (struct wlan_cfg_dp_soc_ctxt *cfg, int pdev_idx, int hw_macid); +void wlan_cfg_set_hw_mac_idx(struct wlan_cfg_dp_soc_ctxt *cfg, + int pdev_idx, int hw_macid); /** * wlan_cfg_get_hw_mac_idx() - Get 0 based HW MAC index for the given * PDEV index * - * @wlan_cfg_ctx - Configuration Handle - * @pdev_idx - Index of SW PDEV + * @cfg: Configuration Handle + * @pdev_idx: Index of SW PDEV * * Return: HW MAC index */ @@ -869,8 +930,8 @@ int wlan_cfg_get_hw_mac_idx(struct wlan_cfg_dp_soc_ctxt *cfg, int pdev_idx); /** * wlan_cfg_get_target_pdev_id() - Get target PDEV ID for HW MAC ID * - * @wlan_cfg_ctx - Configuration Handle - * @hw_macid - Index of hw mac + * @cfg: Configuration Handle + * @hw_macid: Index of hw mac * * Return: PDEV ID */ @@ -881,9 +942,9 @@ wlan_cfg_get_target_pdev_id(struct wlan_cfg_dp_soc_ctxt *cfg, int hw_macid); * wlan_cfg_set_pdev_idx() - Set 0 based host PDEV index for the given * hw mac index * - * @wlan_cfg_ctx - Configuration Handle - * @pdev_idx - Index of SW PDEV - * @hw_macid - Index of hw mac + * @cfg: Configuration Handle + * @pdev_idx: Index of SW PDEV + * @hw_macid: Index of hw mac * * Return: PDEV index */ @@ -894,8 +955,8 @@ void wlan_cfg_set_pdev_idx * wlan_cfg_get_pdev_idx() - Get 0 based PDEV index for the given * hw mac index * - * @wlan_cfg_ctx - Configuration Handle - * @hw_macid - Index of hw mac + * @cfg: Configuration Handle + * @hw_macid: Index of hw mac * * Return: PDEV index */ @@ -904,8 +965,8 @@ int wlan_cfg_get_pdev_idx(struct wlan_cfg_dp_soc_ctxt *cfg, int hw_macid); /** * wlan_cfg_get_rx_err_ring_mask() - Return Rx monitor ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_rx_err_ring_mask[context] */ @@ -915,8 +976,8 @@ int wlan_cfg_get_rx_err_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, int /** * wlan_cfg_get_rx_wbm_rel_ring_mask() - Return Rx monitor ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_wbm_rel_ring_mask[context] */ @@ -926,8 +987,8 @@ int wlan_cfg_get_rx_wbm_rel_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, int /** * wlan_cfg_get_reo_status_ring_mask() - Return Rx monitor ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_reo_status_ring_mask[context] */ @@ -937,8 +998,8 @@ int wlan_cfg_get_reo_status_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, int /** * wlan_cfg_get_ce_ring_mask() - Return CE ring interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @wlan_cfg_ctx: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_ce_ring_mask[context] */ @@ -948,8 +1009,8 @@ int wlan_cfg_get_ce_ring_mask(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx, /** * wlan_cfg_get_umac_reset_intr_mask() - Get UMAC reset interrupt mask * mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_umac_reset_intr_mask[context] */ @@ -958,7 +1019,7 @@ int wlan_cfg_get_umac_reset_intr_mask(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_get_max_clients() - Return maximum number of peers/stations * supported by device - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: max_clients */ @@ -967,200 +1028,201 @@ uint32_t wlan_cfg_get_max_clients(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); /** * wlan_cfg_max_alloc_size() - Return Maximum allocation size for any dynamic * memory allocation request for this device - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: max_alloc_size */ uint32_t wlan_cfg_max_alloc_size(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_per_pdev_tx_ring() - Return true if Tx rings are mapped as * one per radio - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: per_pdev_tx_ring */ int wlan_cfg_per_pdev_tx_ring(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_num_tx_comp_rings() - Number of Tx comp rings (HOST mode) - * @wlan_cfg_ctx + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tx_comp_rings */ int wlan_cfg_num_tx_comp_rings(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_num_tcl_data_rings() - Number of TCL Data rings (HOST mode) - * @wlan_cfg_ctx + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tcl_data_rings */ int wlan_cfg_num_tcl_data_rings(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_num_nss_tcl_data_rings() - Number of TCL Data rings (NSS offload) - * @wlan_cfg_ctx + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tcl_data_rings */ int wlan_cfg_num_nss_tcl_data_rings(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_per_pdev_rx_ring() - Return true if Rx rings are mapped as * one per radio - * @wlan_cfg_ctx + * @wlan_cfg_ctx: Configuration Handle * * Return: per_pdev_rx_ring */ int wlan_cfg_per_pdev_rx_ring(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_per_pdev_lmac_ring() - Return true if error rings are mapped as * one per radio - * @wlan_cfg_ctx + * @wlan_cfg_ctx: Configuration Handle * * Return: return 1 if per pdev error ring else 0 */ int wlan_cfg_per_pdev_lmac_ring(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_num_reo_dest_rings() - Number of REO Data rings (HOST mode) - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_reo_dest_rings */ int wlan_cfg_num_reo_dest_rings(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_num_nss_reo_dest_rings() - Number of REO Data rings (NSS offload) - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_reo_dest_rings */ int wlan_cfg_num_nss_reo_dest_rings(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_pkt_type() - Default 802.11 encapsulation type - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: htt_pkt_type_ethernet */ int wlan_cfg_pkt_type(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_get_num_tx_desc_pool() - Number of Tx Descriptor pools for the * device - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tx_desc_pool */ int wlan_cfg_get_num_tx_desc_pool(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_set_num_tx_desc_pool() - Set the number of Tx Descriptor pools for the * device - * @wlan_cfg_ctx - Configuration Handle - * @num_pool - Number of pool + * @cfg: Configuration Handle + * @num_pool: Number of pool */ void wlan_cfg_set_num_tx_desc_pool(struct wlan_cfg_dp_soc_ctxt *cfg, int num_pool); -/* +/** * wlan_cfg_get_num_tx_ext_desc_pool() - Number of Tx MSDU ext Descriptor * pools - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tx_ext_desc_pool */ int wlan_cfg_get_num_tx_ext_desc_pool( struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_get_reo_dst_ring_size() - Get REO destination ring size * - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: reo_dst_ring_size */ int wlan_cfg_get_reo_dst_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* - * wlan_cfg_set_num_tx_desc_pool() - Set the REO Destination ring size +/** + * wlan_cfg_set_reo_dst_ring_size() - Set the REO Destination ring size * - * @wlan_cfg_ctx - Configuration Handle - * @reo_dst_ring_size - REO Destination ring size + * @cfg: Configuration Handle + * @reo_dst_ring_size: REO Destination ring size */ void wlan_cfg_set_reo_dst_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg, int reo_dst_ring_size); -/* +/** * wlan_cfg_set_raw_mode_war() - Set raw mode war configuration * - * @wlan_cfg_ctx - Configuration Handle - * @raw_mode_war - raw mode war configuration + * @cfg: Configuration Handle + * @raw_mode_war: raw mode war configuration */ void wlan_cfg_set_raw_mode_war(struct wlan_cfg_dp_soc_ctxt *cfg, bool raw_mode_war); -/* +/** * wlan_cfg_get_raw_mode_war() - Get raw mode war configuration * - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: reo_dst_ring_size */ bool wlan_cfg_get_raw_mode_war(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_set_num_tx_ext_desc_pool() - Set the number of Tx MSDU ext Descriptor * pools - * @wlan_cfg_ctx - Configuration Handle - * @num_pool - Number of pool + * @cfg: Configuration Handle + * @num_pool: Number of pool */ void wlan_cfg_set_num_tx_ext_desc_pool(struct wlan_cfg_dp_soc_ctxt *cfg, int num_pool); -/* +/** * wlan_cfg_get_num_tx_desc() - Number of Tx Descriptors per pool - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tx_desc */ int wlan_cfg_get_num_tx_desc(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_get_min_tx_desc() - Minimum number of Tx Descriptors per pool - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tx_desc */ int wlan_cfg_get_min_tx_desc(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* +/** * wlan_cfg_set_num_tx_desc() - Set the number of Tx Descriptors per pool * - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * @num_desc: Number of descriptor */ void wlan_cfg_set_num_tx_desc(struct wlan_cfg_dp_soc_ctxt *cfg, int num_desc); -/* +/** * wlan_cfg_get_num_tx_ext_desc() - Number of Tx MSDU extension Descriptors * per pool - * @wlan_cfg_ctx - Configuration Handle + * @wlan_cfg_ctx: Configuration Handle * * Return: num_tx_ext_desc */ int wlan_cfg_get_num_tx_ext_desc(struct wlan_cfg_dp_soc_ctxt *wlan_cfg_ctx); -/* - * wlan_cfg_set_num_tx_ext_desc() - Set the number of Tx MSDU extension Descriptors - * per pool - * @wlan_cfg_ctx - Configuration Handle - * @num_desc: Number of descriptor +/** + * wlan_cfg_set_num_tx_ext_desc() - Set the number of Tx MSDU extension + * Descriptors per pool + * @cfg: Configuration Handle + * @num_ext_desc: Number of descriptor */ -void wlan_cfg_set_num_tx_ext_desc(struct wlan_cfg_dp_soc_ctxt *cfg, int num_ext_desc); +void wlan_cfg_set_num_tx_ext_desc(struct wlan_cfg_dp_soc_ctxt *cfg, + int num_ext_desc); -/* +/** * wlan_cfg_max_peer_id() - Get maximum peer ID * @cfg: Configuration Handle * @@ -1168,422 +1230,427 @@ void wlan_cfg_set_num_tx_ext_desc(struct wlan_cfg_dp_soc_ctxt *cfg, int num_ext_ */ uint32_t wlan_cfg_max_peer_id(struct wlan_cfg_dp_soc_ctxt *cfg); -/* - * wlan_cfg_get_dma_mon_buf_ring_size() - Return Size of monitor buffer ring - * @wlan_cfg_pdev_ctx +/** + * wlan_cfg_get_dma_mon_buf_ring_size(): Return Size of monitor buffer ring + * @wlan_cfg_pdev_ctx: pdev configuration context * * Return: dma_mon_buf_ring_size */ int wlan_cfg_get_dma_mon_buf_ring_size( struct wlan_cfg_dp_pdev_ctxt *wlan_cfg_pdev_ctx); -/* +/** * wlan_cfg_get_dma_mon_stat_ring_size() - Return size of Monitor Status ring - * @wlan_cfg_pdev_ctx + * @wlan_cfg_pdev_ctx: pdev configuration context * * Return: dma_mon_stat_ring_size */ int wlan_cfg_get_dma_mon_stat_ring_size( struct wlan_cfg_dp_pdev_ctxt *wlan_cfg_pdev_ctx); -/* +/** * wlan_cfg_get_dma_mon_desc_ring_size - Get rxdma monitor size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: rxdma monitor desc ring size */ int wlan_cfg_get_dma_mon_desc_ring_size(struct wlan_cfg_dp_pdev_ctxt *cfg); -/* +/** * wlan_cfg_get_rx_dma_buf_ring_size() - Return Size of RxDMA buffer ring - * @wlan_cfg_pdev_ctx + * @wlan_cfg_pdev_ctx: pdev configuration context * * Return: rx_dma_buf_ring_size */ int wlan_cfg_get_rx_dma_buf_ring_size( struct wlan_cfg_dp_pdev_ctxt *wlan_cfg_pdev_ctx); -/* +/** * wlan_cfg_rx_pending_hl_threshold() - Return high threshold of rx pending - * @wlan_cfg_pdev_ctx + * @cfg: pdev configuration context * * Return: rx_pending_high_threshold */ uint32_t wlan_cfg_rx_pending_hl_threshold(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_rx_pending_lo_threshold() - Return low threshold of rx pending - * @wlan_cfg_pdev_ctx + * @cfg: soc configuration context * * Return: rx_pending_low_threshold */ uint32_t wlan_cfg_rx_pending_lo_threshold(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_num_mac_rings() - Return the number of MAC RX DMA rings * per pdev - * @wlan_cfg_pdev_ctx + * @cfg: pdev configuration context * * Return: number of mac DMA rings per pdev */ int wlan_cfg_get_num_mac_rings(struct wlan_cfg_dp_pdev_ctxt *cfg); -/* +/** * wlan_cfg_is_lro_enabled - Return LRO enabled/disabled - * @wlan_cfg_dp_soc_ctxt + * @cfg: soc configuration context * * Return: true - LRO enabled false - LRO disabled */ bool wlan_cfg_is_lro_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_is_gro_enabled - Return GRO enabled/disabled - * @wlan_cfg_dp_soc_ctxt + * @cfg: soc configuration context * * Return: true - GRO enabled false - GRO disabled */ bool wlan_cfg_is_gro_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_is_rx_hash_enabled - Return RX hash enabled/disabled - * @wlan_cfg_dp_soc_ctxt + * @cfg: soc configuration context * * Return: true - enabled false - disabled */ bool wlan_cfg_is_rx_hash_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_is_ipa_enabled - Return IPA enabled/disabled - * @wlan_cfg_dp_soc_ctxt + * @cfg: soc configuration context * * Return: true - enabled false - disabled */ bool wlan_cfg_is_ipa_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_set_rx_hash - set rx hash enabled/disabled - * @wlan_cfg_soc_ctx - * @rx_hash + * @cfg: soc configuration context + * @rx_hash: true - enabled false - disabled */ void wlan_cfg_set_rx_hash(struct wlan_cfg_dp_soc_ctxt *cfg, bool rx_hash); -/* +/** * wlan_cfg_get_dp_pdev_nss_enabled - Return pdev nss enabled/disabled - * @wlan_cfg_pdev_ctx + * @cfg: pdev configuration context * * Return: 1 - enabled 0 - disabled */ int wlan_cfg_get_dp_pdev_nss_enabled(struct wlan_cfg_dp_pdev_ctxt *cfg); -/* +/** * wlan_cfg_set_dp_pdev_nss_enabled - set pdev nss enabled/disabled - * @wlan_cfg_pdev_ctx + * @cfg: pdev configuration context + * @nss_enabled: 1 - enabled 0 - disabled */ -void wlan_cfg_set_dp_pdev_nss_enabled(struct wlan_cfg_dp_pdev_ctxt *cfg, int nss_enabled); +void wlan_cfg_set_dp_pdev_nss_enabled(struct wlan_cfg_dp_pdev_ctxt *cfg, + int nss_enabled); -/* +/** * wlan_cfg_get_dp_soc_nss_cfg - Return soc nss config - * @wlan_cfg_pdev_ctx + * @cfg: soc configuration context * * Return: nss_cfg */ int wlan_cfg_get_dp_soc_nss_cfg(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_set_dp_soc_nss_cfg - set soc nss config - * @wlan_cfg_pdev_ctx + * @cfg: soc configuration context + * @nss_cfg: NSS configuration * */ void wlan_cfg_set_dp_soc_nss_cfg(struct wlan_cfg_dp_soc_ctxt *cfg, int nss_cfg); -/* +/** * wlan_cfg_get_int_timer_threshold_ppe2tcl - Get intr mitigation for ppe2tcl - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Timer threshold */ int wlan_cfg_get_int_timer_threshold_ppe2tcl(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_int_batch_threshold_ppe2tcl - Get intr mitigation for ppe2tcl - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Batch threshold */ int wlan_cfg_get_int_batch_threshold_ppe2tcl(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_int_batch_threshold_tx - Get interrupt mitigation cfg for Tx - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Batch threshold */ int wlan_cfg_get_int_batch_threshold_tx(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_int_timer_threshold_tx - Get interrupt mitigation cfg for Tx - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Timer threshold */ int wlan_cfg_get_int_timer_threshold_tx(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_int_batch_threshold_rx - Get interrupt mitigation cfg for Rx - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Batch threshold */ int wlan_cfg_get_int_batch_threshold_rx(struct wlan_cfg_dp_soc_ctxt *cfg); -/* - * wlan_cfg_get_int_batch_threshold_rx - Get interrupt mitigation cfg for Rx - * @wlan_cfg_soc_ctx +/** + * wlan_cfg_get_int_timer_threshold_rx - Get interrupt mitigation cfg for Rx + * @cfg: soc configuration context * * Return: Timer threshold */ int wlan_cfg_get_int_timer_threshold_rx(struct wlan_cfg_dp_soc_ctxt *cfg); -/* - * wlan_cfg_get_int_batch_threshold_tx - Get interrupt mitigation cfg for other srngs - * @wlan_cfg_soc_ctx +/** + * wlan_cfg_get_int_batch_threshold_other - Get interrupt mitigation cfg for + * other srngs + * @cfg: soc configuration context * * Return: Batch threshold */ int wlan_cfg_get_int_batch_threshold_other(struct wlan_cfg_dp_soc_ctxt *cfg); -/* - * wlan_cfg_get_int_batch_threshold_tx - Get interrupt mitigation cfg for other srngs - * @wlan_cfg_soc_ctx +/** + * wlan_cfg_get_int_timer_threshold_other - Get interrupt mitigation cfg for + * other srngs + * @cfg: soc configuration context * * Return: Timer threshold */ int wlan_cfg_get_int_timer_threshold_other(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_int_timer_threshold_mon - Get int mitigation cfg for mon srngs - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Timer threshold */ int wlan_cfg_get_int_timer_threshold_mon(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_checksum_offload - Get checksum offload enable or disable status - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Checksum offload enable or disable */ int wlan_cfg_get_checksum_offload(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_nan_checksum_offload - Get checksum offload enable/disable val - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Checksum offload enable or disable value for NAN mode */ int wlan_cfg_get_nan_checksum_offload(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_p2p_checksum_offload - Get checksum offload enable/disable val - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Checksum offload enable or disable value for P2P mode */ int wlan_cfg_get_p2p_checksum_offload(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_tx_ring_size - Get Tx DMA ring size (TCL Data Ring) - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Tx Ring Size */ int wlan_cfg_tx_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_time_control_bp - Get time for interval in bp prints - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: interval time */ int wlan_cfg_time_control_bp(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_tx_comp_ring_size - Get Tx completion ring size (WBM Ring) - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: Tx Completion ring size */ int wlan_cfg_tx_comp_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_wbm_release_ring_size - Get wbm_release_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: wbm_release_ring size */ int wlan_cfg_get_dp_soc_wbm_release_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tcl_cmd_credit_ring_size - Get command/credit ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tcl_cmd_credit_ring size */ int wlan_cfg_get_dp_soc_tcl_cmd_credit_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tcl_status_ring_size - Get tcl_status_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tcl_status_ring size */ int wlan_cfg_get_dp_soc_tcl_status_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_reo_reinject_ring_size - Get reo_reinject_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: reo_reinject_ring size */ int wlan_cfg_get_dp_soc_reo_reinject_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_rx_release_ring_size - Get rx_release_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: rx_release_ring size */ int wlan_cfg_get_dp_soc_rx_release_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_reo_exception_ring_size - Get reo_exception_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: reo_exception_ring size */ int wlan_cfg_get_dp_soc_reo_exception_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_reo_cmd_ring_size - Get reo_cmd_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: reo_cmd_ring size */ int wlan_cfg_get_dp_soc_reo_cmd_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_reo_status_ring_size - Get reo_status_ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: reo_status_ring size */ int wlan_cfg_get_dp_soc_reo_status_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tx_desc_limit_0 - Get tx desc limit for 5G H - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tx desc limit for 5G H */ int wlan_cfg_get_dp_soc_tx_desc_limit_0(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tx_desc_limit_1 - Get tx desc limit for 2G - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tx desc limit for 2G */ int wlan_cfg_get_dp_soc_tx_desc_limit_1(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tx_desc_limit_2 - Get tx desc limit for 5G L - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tx desc limit for 5G L */ int wlan_cfg_get_dp_soc_tx_desc_limit_2(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tx_device_limit - Get tx device limit - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tx device limit */ int wlan_cfg_get_dp_soc_tx_device_limit(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_tx_sw_internode_queue - Get tx sw internode queue - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: tx sw internode queue */ int wlan_cfg_get_dp_soc_tx_sw_internode_queue(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_rxdma_refill_ring_size - Get rxdma refill ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: rxdma refill ring size */ int wlan_cfg_get_dp_soc_rxdma_refill_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_rxdma_refill_lt_disable - Get RxDMA refill LT status - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: true if Low threshold disable else false */ bool wlan_cfg_get_dp_soc_rxdma_refill_lt_disable(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_rxdma_err_dst_ring_size - Get rxdma dst ring size - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: rxdma error dst ring size */ int wlan_cfg_get_dp_soc_rxdma_err_dst_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_rx_sw_desc_weight - Get rx sw desc weight - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: rx_sw_desc_weight */ int wlan_cfg_get_dp_soc_rx_sw_desc_weight(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_rx_sw_desc_num - Get rx sw desc num - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * * Return: rx_sw_desc_num */ int wlan_cfg_get_dp_soc_rx_sw_desc_num(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_caps - Get dp capabilities - * @wlan_cfg_soc_ctx + * @cfg: soc configuration context * @dp_caps: enum for dp capabilities * * Return: bool if a dp capabilities is enabled @@ -1614,7 +1681,7 @@ int wlan_cfg_get_defrag_timeout_check(struct wlan_cfg_dp_soc_ctxt *cfg); * wlan_cfg_get_rx_flow_search_table_size() - Return the size of Rx FST * in number of entries * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: rx_fst_size */ @@ -1624,7 +1691,7 @@ wlan_cfg_get_rx_flow_search_table_size(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_rx_fst_get_max_search() - Return the max skid length for FST search * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: max_search */ @@ -1634,7 +1701,7 @@ uint8_t wlan_cfg_rx_fst_get_max_search(struct wlan_cfg_dp_soc_ctxt *cfg); * wlan_cfg_rx_fst_get_hash_key() - Return Toeplitz Hash Key used for FST * search * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: 320-bit Hash Key */ @@ -1643,7 +1710,7 @@ uint8_t *wlan_cfg_rx_fst_get_hash_key(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_rx_flow_tag_enabled() - set rx flow tag enabled flag in * DP soc context - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: Rx flow tag feature flag value * * Return: None @@ -1654,7 +1721,7 @@ void wlan_cfg_set_rx_flow_tag_enabled(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_is_rx_flow_tag_enabled() - get rx flow tag enabled flag from * DP soc context - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: true if feature is enabled, else false */ @@ -1663,7 +1730,7 @@ bool wlan_cfg_is_rx_flow_tag_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_rx_flow_search_table_per_pdev() - Set flag to indicate that * Rx FST is per pdev - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: boolean flag indicating Rx FST per pdev or per SOC * * Return: None @@ -1674,7 +1741,7 @@ wlan_cfg_set_rx_flow_search_table_per_pdev(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_is_rx_flow_search_table_per_pdev() - get RX FST flag for per pdev - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: true if Rx FST is per pdev, else false */ @@ -1683,7 +1750,7 @@ wlan_cfg_is_rx_flow_search_table_per_pdev(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_rx_flow_search_table_size() - set RX FST size in DP SoC context - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: Rx FST size in number of entries * * Return: None @@ -1695,7 +1762,7 @@ wlan_cfg_set_rx_flow_search_table_size(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_set_rx_mon_protocol_flow_tag_enabled() - set mon rx tag enabled flag * in DP soc context - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: Rx protocol or flow tag feature flag value in monitor mode from INI * * Return: None @@ -1707,7 +1774,7 @@ wlan_cfg_set_rx_mon_protocol_flow_tag_enabled(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_is_rx_mon_protocol_flow_tag_enabled() - get mon rx tag enabled flag * from DP soc context - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: true if feature is enabled in monitor mode for protocol or flow * tagging in INI, false otherwise @@ -1718,7 +1785,7 @@ wlan_cfg_is_rx_mon_protocol_flow_tag_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_tx_per_pkt_vdev_id_check() - set flag to enable perpkt * vdev id check in tx. - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: feature flag value * * Return: None @@ -1730,7 +1797,7 @@ wlan_cfg_set_tx_per_pkt_vdev_id_check(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_is_tx_per_pkt_vdev_id_check_enabled() - get flag to check if * perpkt vdev id check is enabled in tx. - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: true if feature is enabled, false otherwise */ @@ -1740,7 +1807,7 @@ wlan_cfg_is_tx_per_pkt_vdev_id_check_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_fill_interrupt_mask() - set interrupt mask * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @wlan_cfg_ctx: soc configuration context * @num_dp_msi: Number of DP interrupts available (0 for integrated) * @interrupt_mode: Type of interrupt * @is_monitor_mode: is monitor mode enabled @@ -1810,7 +1877,7 @@ uint32_t wlan_cfg_get_reo_rings_mapping(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_peer_ext_stats() - set peer extended stats * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: Flag value read from INI * * Return: void @@ -1822,7 +1889,7 @@ wlan_cfg_set_peer_ext_stats(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_set_peer_jitter_stats() - set peer jitter stats * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * @val: Flag value read from INI * * Return: bool @@ -1835,7 +1902,7 @@ wlan_cfg_set_peer_jitter_stats(struct wlan_cfg_dp_soc_ctxt *cfg, * wlan_cfg_is_peer_ext_stats_enabled() - Check if peer extended * stats are enabled * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: bool */ @@ -1845,7 +1912,7 @@ wlan_cfg_is_peer_ext_stats_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_is_peer_jitter_stats_enabled() - check if jitter stats are enabled * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: bool */ @@ -1855,7 +1922,7 @@ wlan_cfg_is_peer_jitter_stats_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_is_poll_mode_enabled() - Check if poll mode is enabled * - * @wlan_cfg_dp_soc_ctxt: soc configuration context + * @cfg: soc configuration context * * Return: bool */ @@ -1879,34 +1946,34 @@ bool wlan_cfg_is_fst_in_cmem_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); bool wlan_cfg_is_swlm_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); #ifdef IPA_OFFLOAD -/* +/** * wlan_cfg_ipa_tx_ring_size - Get Tx DMA ring size (TCL Data Ring) - * @wlan_cfg_soc_ctx: dp cfg context + * @cfg: dp cfg context * * Return: IPA Tx Ring Size */ uint32_t wlan_cfg_ipa_tx_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_ipa_tx_comp_ring_size - Get Tx completion ring size (WBM Ring) - * @wlan_cfg_soc_ctx: dp cfg context + * @cfg: dp cfg context * * Return: IPA Tx Completion ring size */ uint32_t wlan_cfg_ipa_tx_comp_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_ipa_tx_alt_ring_size - Get Tx alt DMA ring size (TCL Data Ring) - * @wlan_cfg_soc_ctx: dp cfg context + * @cfg: dp cfg context * * Return: IPA Tx alt Ring Size */ int wlan_cfg_ipa_tx_alt_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_ipa_tx_alt_comp_ring_size - Get Tx alt comp DMA ring size * (TCL Data Ring) - * @wlan_cfg_soc_ctx: dp cfg context + * @cfg: dp cfg context * * Return: IPA Tx alt comp Ring Size */ @@ -1953,7 +2020,7 @@ uint8_t wlan_cfg_radio2_default_reo_get(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_rxdma1_enable() - Enable rxdma1 - * @cfg: soc configuration context + * @wlan_cfg_ctx: soc configuration context * * Return: None */ @@ -1988,54 +2055,54 @@ wlan_cfg_set_delay_mon_replenish(struct wlan_cfg_dp_soc_ctxt *cfg, bool val); void wlan_cfg_dp_soc_ctx_dump(struct wlan_cfg_dp_soc_ctxt *cfg); #ifdef WLAN_SUPPORT_PPEDS -/* +/** * wlan_cfg_get_dp_soc_is_ppe_enabled() - API to get ppe enable flag - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: true if ppe is enabled else return false */ bool wlan_cfg_get_dp_soc_is_ppe_enabled(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_reo2ppe_ring_size() - get ppe rx ring size - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: size of reo2ppe ring */ int wlan_cfg_get_dp_soc_reo2ppe_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_ppe2tcl_ring_size() - get ppe tx ring size - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: size of ppe2tcl ring */ int wlan_cfg_get_dp_soc_ppe2tcl_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_ppe_release_ring_size() - get ppe tx comp ring size - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: size of ppe release ring */ int wlan_cfg_get_dp_soc_ppe_release_ring_size(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_ppe_num_tx_desc() - Number of ppeds tx Descriptors - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: num_tx_desc */ int wlan_cfg_get_dp_soc_ppe_num_tx_desc(struct wlan_cfg_dp_soc_ctxt *cfg); -/* +/** * wlan_cfg_get_dp_soc_ppe_tx_comp_napi_budget() - ppeds Tx comp napi budget - * @ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: napi budget */ @@ -2081,8 +2148,8 @@ wlan_cfg_get_dp_soc_ppe_tx_comp_napi_budget(struct wlan_cfg_dp_soc_ctxt *cfg) /** * wlan_cfg_get_prealloc_cfg() - Get dp prealloc related cfg param - * @ctrl_psoc - PSOC object - * @cfg - cfg ctx where values will be populated + * @ctrl_psoc: PSOC object + * @cfg: cfg ctx where values will be populated * * Return: None */ @@ -2139,9 +2206,9 @@ int wlan_cfg_get_dma_rx_mon_dest_ring_size(struct wlan_cfg_dp_pdev_ctxt *cfg); */ int wlan_cfg_get_dma_tx_mon_dest_ring_size(struct wlan_cfg_dp_pdev_ctxt *cfg); -/* +/** * wlan_cfg_get_rx_rel_ring_id() - get wbm2sw ring id for Rx release ring - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle * * Return: wbm2sw ring id */ @@ -2151,6 +2218,7 @@ wlan_cfg_get_rx_rel_ring_id(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_set_rx_rel_ring_id() - set wbm2sw ring id for Rx release ring * @cfg: soc configuration context + * @wbm2sw_ring_id: wbm2sw ring id * * Return: None */ @@ -2237,10 +2305,12 @@ uint8_t wlan_cfg_mlo_rx_ring_map_get(struct wlan_cfg_dp_soc_ctxt *cfg); #endif -/* +/** * wlan_cfg_set_host2txmon_ring_mask() - Set host2txmon ring * interrupt mask mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle + * @cfg: Configuration Handle + * @context: interrupt context + * @mask: interrupt mask * * Return: None */ @@ -2249,8 +2319,8 @@ void wlan_cfg_set_host2txmon_ring_mask(struct wlan_cfg_dp_soc_ctxt *cfg, /** * wlan_cfg_get_host2txmon_ring_mask() - Return host2txmon ring * interrupt mask mapped to an interrupt context - * @wlan_cfg_ctx - Configuration Handle - * @context - Numerical ID identifying the Interrupt/NAPI context + * @cfg: Configuration Handle + * @context: Numerical ID identifying the Interrupt/NAPI context * * Return: int_host2txmon_ring_mask[context] */ @@ -2279,9 +2349,9 @@ void wlan_cfg_set_txmon_sw_peer_filtering(struct wlan_cfg_dp_soc_ctxt *cfg, bool wlan_cfg_get_txmon_sw_peer_filtering(struct wlan_cfg_dp_soc_ctxt *cfg); #ifdef WLAN_TX_PKT_CAPTURE_ENH -/* +/** * wlan_cfg_get_tx_capt_max_mem - Get max memory allowed for TX capture feature - * @wlan_cfg_soc_ctx + * @cfg: Configuration Handle * * Return: user given size in bytes */ @@ -2294,8 +2364,6 @@ wlan_cfg_get_tx_capt_max_mem(struct wlan_cfg_dp_soc_ctxt *cfg) /** * wlan_cfg_get_napi_scale_factor() - Get napi scale factor - * - * * @cfg: soc configuration context * * Return: napi scale factor @@ -2304,8 +2372,8 @@ uint8_t wlan_cfg_get_napi_scale_factor(struct wlan_cfg_dp_soc_ctxt *cfg); /** * wlan_cfg_soc_update_tgt_params() - Update band specific params - * @wlan_cfg_ctx - SOC cfg context - * @ctrl_obj - PSOC object + * @wlan_cfg_ctx: SOC cfg context + * @ctrl_obj: PSOC object * * Return: void */