diff --git a/dp/wifi3.0/dp_main.c b/dp/wifi3.0/dp_main.c index 0e4e32e745..d54f9182af 100644 --- a/dp/wifi3.0/dp_main.c +++ b/dp/wifi3.0/dp_main.c @@ -224,8 +224,6 @@ dp_pdev_deinit_wifi3(struct cdp_soc_t *psoc, uint8_t pdev_id, int force); static void dp_soc_detach_wifi3(struct cdp_soc_t *txrx_soc); static void dp_soc_deinit_wifi3(struct cdp_soc_t *txrx_soc); -void *dp_soc_init(struct dp_soc *soc, HTC_HANDLE htc_handle, - struct hif_opaque_softc *hif_handle); static void dp_pdev_detach(struct cdp_pdev *txrx_pdev, int force); static QDF_STATUS dp_pdev_detach_wifi3(struct cdp_soc_t *psoc, uint8_t pdev_id, @@ -303,7 +301,7 @@ static QDF_STATUS dp_umac_reset_handle_post_reset_complete(struct dp_soc *soc); #define RNG_ERR "SRNG setup failed for" -/** +/* * default_dscp_tid_map - Default DSCP-TID mapping * * DSCP TID @@ -327,7 +325,7 @@ static uint8_t default_dscp_tid_map[DSCP_TID_MAP_MAX] = { 7, 7, 7, 7, 7, 7, 7, 7, }; -/** +/* * default_pcp_tid_map - Default PCP-TID mapping * * PCP TID @@ -344,8 +342,8 @@ static uint8_t default_pcp_tid_map[PCP_TID_MAP_MAX] = { 0, 1, 2, 3, 4, 5, 6, 7, }; -/** - * @brief Cpu to tx ring map +/* + * Cpu to tx ring map */ uint8_t dp_cpu_ring_map[DP_NSS_CPU_RING_MAP_MAX][WLAN_CFG_INT_NUM_CONTEXTS_MAX] = { @@ -362,7 +360,10 @@ dp_cpu_ring_map[DP_NSS_CPU_RING_MAP_MAX][WLAN_CFG_INT_NUM_CONTEXTS_MAX] = { qdf_export_symbol(dp_cpu_ring_map); /** - * @brief Select the type of statistics + * enum dp_stats_type - Select the type of statistics + * @STATS_FW: Firmware-based statistic + * @STATS_HOST: Host-based statistic + * @STATS_TYPE_MAX: maximum enumeration */ enum dp_stats_type { STATS_FW = 0, @@ -371,14 +372,14 @@ enum dp_stats_type { }; /** - * @brief General Firmware statistics options - * + * enum dp_fw_stats - General Firmware statistics options + * @TXRX_FW_STATS_INVALID: statistic is not available */ enum dp_fw_stats { TXRX_FW_STATS_INVALID = -1, }; -/** +/* * dp_stats_mapping_table - Firmware and Host statistics * currently supported */ @@ -543,12 +544,6 @@ uint32_t dp_soc_get_mon_mask_for_interrupt_mode(struct dp_soc *soc, int intr_ctx return wlan_cfg_get_rx_mon_ring_mask(soc->wlan_cfg_ctx, intr_ctx_num); } -/** - * dp_soc_reset_mon_intr_mask() - reset mon intr mask - * @soc: pointer to dp_soc handle - * - * Return: - */ void dp_soc_reset_mon_intr_mask(struct dp_soc *soc) { int i; @@ -561,7 +556,7 @@ void dp_soc_reset_mon_intr_mask(struct dp_soc *soc) qdf_export_symbol(dp_soc_reset_mon_intr_mask); -/* +/** * dp_service_lmac_rings()- timer to reap lmac rings * @arg: SoC Handle * @@ -642,7 +637,7 @@ void dp_peer_mec_flush_entries(struct dp_soc *soc) } /** - * dp_print_mec_entries() - Dump MEC entries in table + * dp_print_mec_stats() - Dump MEC entries in table * @soc: Datapath soc handle * * Return: none @@ -781,9 +776,9 @@ static int dp_peer_update_ast_wifi3(struct cdp_soc_t *soc_hdl, return status; } -/* +/** * dp_peer_reset_ast_entries() - Deletes all HMWDS entries for a peer - * @soc_handle: Datapath SOC handle + * @soc: Datapath SOC handle * @peer: DP peer * @arg: callback argument * @@ -802,12 +797,13 @@ dp_peer_reset_ast_entries(struct dp_soc *soc, struct dp_peer *peer, void *arg) } } -/* +/** * dp_wds_reset_ast_wifi3() - Reset the is_active param for ast entry - * @soc_handle: Datapath SOC handle + * @soc_hdl: Datapath SOC handle * @wds_macaddr: WDS entry MAC Address - * @peer_macaddr: WDS entry MAC Address + * @peer_mac_addr: WDS entry MAC Address * @vdev_id: id of vdev handle + * * Return: QDF_STATUS */ static QDF_STATUS dp_wds_reset_ast_wifi3(struct cdp_soc_t *soc_hdl, @@ -861,9 +857,9 @@ static QDF_STATUS dp_wds_reset_ast_wifi3(struct cdp_soc_t *soc_hdl, return QDF_STATUS_SUCCESS; } -/* +/** * dp_wds_reset_ast_table_wifi3() - Reset the is_active param for all ast entry - * @soc: Datapath SOC handle + * @soc_hdl: Datapath SOC handle * @vdev_id: id of vdev object * * Return: QDF_STATUS @@ -886,7 +882,7 @@ dp_wds_reset_ast_table_wifi3(struct cdp_soc_t *soc_hdl, return QDF_STATUS_SUCCESS; } -/* +/** * dp_peer_flush_ast_entries() - Delete all wds and hmwds ast entries of a peer * @soc: Datapath SOC * @peer: Datapath peer @@ -912,9 +908,9 @@ dp_peer_flush_ast_entries(struct dp_soc *soc, struct dp_peer *peer, void *arg) } } -/* +/** * dp_wds_flush_ast_table_wifi3() - Delete all wds and hmwds ast entry - * @soc: Datapath SOC handle + * @soc_hdl: Datapath SOC handle * * Return: None */ @@ -932,7 +928,7 @@ static void dp_wds_flush_ast_table_wifi3(struct cdp_soc_t *soc_hdl) } #if defined(IPA_WDS_EASYMESH_FEATURE) && defined(FEATURE_AST) -/* +/** * dp_peer_send_wds_disconnect() - Send Disconnect event to IPA for each peer * @soc: Datapath SOC * @peer: Datapath peer @@ -965,12 +961,11 @@ dp_peer_send_wds_disconnect(struct dp_soc *soc, struct dp_peer *peer) * and return ast entry information * of first ast entry found in the * table with given mac address + * @soc_hdl: data path soc handle + * @ast_mac_addr: AST entry mac address + * @ast_entry_info: ast entry information * - * @soc : data path soc handle - * @ast_mac_addr : AST entry mac address - * @ast_entry_info : ast entry information - * - * return : true if ast entry found with ast_mac_addr + * Return: true if ast entry found with ast_mac_addr * false if ast entry not found */ static bool dp_peer_get_ast_info_by_soc_wifi3 @@ -1017,13 +1012,12 @@ static bool dp_peer_get_ast_info_by_soc_wifi3 * dp_peer_get_ast_info_by_pdevid_wifi3() - search the soc AST hash table * and return ast entry information * if mac address and pdev_id matches + * @soc_hdl: data path soc handle + * @ast_mac_addr: AST entry mac address + * @pdev_id: pdev_id + * @ast_entry_info: ast entry information * - * @soc : data path soc handle - * @ast_mac_addr : AST entry mac address - * @pdev_id : pdev_id - * @ast_entry_info : ast entry information - * - * return : true if ast entry found with ast_mac_addr + * Return: true if ast entry found with ast_mac_addr * false if ast entry not found */ static bool dp_peer_get_ast_info_by_pdevid_wifi3 @@ -1072,13 +1066,12 @@ static bool dp_peer_get_ast_info_by_pdevid_wifi3 /** * dp_peer_ast_entry_del_by_soc() - delete the ast entry from soc AST hash table * with given mac address + * @soc_handle: data path soc handle + * @mac_addr: AST entry mac address + * @callback: callback function to called on ast delete response from FW + * @cookie: argument to be passed to callback * - * @soc : data path soc handle - * @ast_mac_addr : AST entry mac address - * @callback : callback function to called on ast delete response from FW - * @cookie : argument to be passed to callback - * - * return : QDF_STATUS_SUCCESS if ast entry found with ast_mac_addr and delete + * Return: QDF_STATUS_SUCCESS if ast entry found with ast_mac_addr and delete * is sent * QDF_STATUS_E_INVAL false if ast entry not found */ @@ -1132,14 +1125,13 @@ static QDF_STATUS dp_peer_ast_entry_del_by_soc(struct cdp_soc_t *soc_handle, /** * dp_peer_ast_entry_del_by_pdev() - delete the ast entry from soc AST hash * table if mac address and pdev_id matches + * @soc_handle: data path soc handle + * @mac_addr: AST entry mac address + * @pdev_id: pdev id + * @callback: callback function to called on ast delete response from FW + * @cookie: argument to be passed to callback * - * @soc : data path soc handle - * @ast_mac_addr : AST entry mac address - * @pdev_id : pdev id - * @callback : callback function to called on ast delete response from FW - * @cookie : argument to be passed to callback - * - * return : QDF_STATUS_SUCCESS if ast entry found with ast_mac_addr and delete + * Return: QDF_STATUS_SUCCESS if ast entry found with ast_mac_addr and delete * is sent * QDF_STATUS_E_INVAL false if ast entry not found */ @@ -1276,7 +1268,7 @@ dp_is_reo_ring_num_in_nf_grp2(struct dp_soc *soc, int ring_num) * @ring_type: SRNG type * @ring_num: ring num * - * Return: near ful irq mask pointer + * Return: near-full irq mask pointer */ static inline uint8_t *dp_srng_get_near_full_irq_mask(struct dp_soc *soc, @@ -1595,9 +1587,9 @@ static int dp_srng_calculate_msi_group(struct dp_soc *soc, return QDF_STATUS_SUCCESS; } -/* +/** * dp_get_num_msi_available()- API to get number of MSIs available - * @dp_soc: DP soc Handle + * @soc: DP soc Handle * @interrupt_mode: Mode of interrupts * * Return: Number of MSIs available or 0 in case of integrated @@ -1608,13 +1600,6 @@ static int dp_get_num_msi_available(struct dp_soc *soc, int interrupt_mode) return 0; } #else -/* - * dp_get_num_msi_available()- API to get number of MSIs available - * @dp_soc: DP soc Handle - * @interrupt_mode: Mode of interrupts - * - * Return: Number of MSIs available or 0 in case of integrated - */ static int dp_get_num_msi_available(struct dp_soc *soc, int interrupt_mode) { int msi_data_count; @@ -1754,7 +1739,7 @@ configure_msi2: /** * dp_print_mlo_ast_stats() - Print AST stats for MLO peers * - * @soc : core DP soc context + * @soc: core DP soc context * * Return: void */ @@ -1764,14 +1749,6 @@ static void dp_print_mlo_ast_stats(struct dp_soc *soc) soc->arch_ops.print_mlo_ast_stats(soc); } -/** - * dp_print_peer_ast_entries() - Dump AST entries of peer - * @soc: Datapath soc handle - * @peer: Datapath peer - * @arg: argument to iterate function - * - * return void - */ void dp_print_peer_ast_entries(struct dp_soc *soc, struct dp_peer *peer, void *arg) { @@ -1808,12 +1785,6 @@ dp_print_peer_ast_entries(struct dp_soc *soc, struct dp_peer *peer, void *arg) } } -/** - * dp_print_ast_stats() - Dump AST table contents - * @soc: Datapath soc handle - * - * return void - */ void dp_print_ast_stats(struct dp_soc *soc) { DP_PRINT_STATS("AST Stats:"); @@ -1849,7 +1820,7 @@ void dp_print_ast_stats(struct dp_soc *soc) * @peer: Datapath peer handle * @arg: argument to iter function * - * return void + * Return: void */ static void dp_print_peer_info(struct dp_soc *soc, struct dp_peer *peer, void *arg) @@ -1880,7 +1851,7 @@ dp_print_peer_info(struct dp_soc *soc, struct dp_peer *peer, void *arg) * dp_print_peer_table() - Dump all Peer stats * @vdev: Datapath Vdev handle * - * return void + * Return: void */ static void dp_print_peer_table(struct dp_vdev *vdev) { @@ -1897,6 +1868,7 @@ static void dp_print_peer_table(struct dp_vdev *vdev) * @ring_params: per ring specific parameters * @ring_type: Ring type * @ring_num: Ring number for a given ring type + * @num_entries: number of entries to fill * * Fill the ring params with the interrupt threshold * configuration parameters available in the per ring type wlan_srng_cfg @@ -2292,13 +2264,6 @@ update_flag: pdev->rx_fast_flag = rx_fast_flag; } -/* - * dp_srng_free() - Free SRNG memory - * @soc : Data path soc handle - * @srng : SRNG pointer - * - * return: None - */ void dp_srng_free(struct dp_soc *soc, struct dp_srng *srng) { if (srng->alloc_size && srng->base_vaddr_unaligned) { @@ -2316,8 +2281,9 @@ void dp_srng_free(struct dp_soc *soc, struct dp_srng *srng) qdf_export_symbol(dp_srng_free); #ifdef DISABLE_MON_RING_MSI_CFG -/* +/** * dp_skip_msi_cfg() - Check if msi cfg has to be skipped for ring_type + * @soc: DP SoC context * @ring_type: sring type * * Return: True if msi cfg should be skipped for srng type else false @@ -2363,17 +2329,6 @@ static bool dp_check_umac_reset_in_progress(struct dp_soc *soc) } #endif -/* - * dp_srng_init_idx() - Initialize SRNG - * @soc : Data path soc handle - * @srng : SRNG pointer - * @ring_type : Ring Type - * @ring_num: Ring number - * @mac_id: mac_id - * @idx: ring index - * - * return: QDF_STATUS - */ QDF_STATUS dp_srng_init_idx(struct dp_soc *soc, struct dp_srng *srng, int ring_type, int ring_num, int mac_id, uint32_t idx) @@ -2441,16 +2396,6 @@ QDF_STATUS dp_srng_init_idx(struct dp_soc *soc, struct dp_srng *srng, qdf_export_symbol(dp_srng_init_idx); -/* - * dp_srng_init() - Initialize SRNG - * @soc : Data path soc handle - * @srng : SRNG pointer - * @ring_type : Ring Type - * @ring_num: Ring number - * @mac_id: mac_id - * - * return: QDF_STATUS - */ QDF_STATUS dp_srng_init(struct dp_soc *soc, struct dp_srng *srng, int ring_type, int ring_num, int mac_id) { @@ -2458,16 +2403,7 @@ QDF_STATUS dp_srng_init(struct dp_soc *soc, struct dp_srng *srng, int ring_type, } qdf_export_symbol(dp_srng_init); -/* - * dp_srng_alloc() - Allocate memory for SRNG - * @soc : Data path soc handle - * @srng : SRNG pointer - * @ring_type : Ring Type - * @num_entries: Number of entries - * @cached: cached flag variable - * - * return: QDF_STATUS - */ + QDF_STATUS dp_srng_alloc(struct dp_soc *soc, struct dp_srng *srng, int ring_type, uint32_t num_entries, bool cached) @@ -2510,15 +2446,6 @@ QDF_STATUS dp_srng_alloc(struct dp_soc *soc, struct dp_srng *srng, qdf_export_symbol(dp_srng_alloc); -/* - * dp_srng_deinit() - Internal function to deinit SRNG rings used by data path - * @soc: DP SOC handle - * @srng: source ring structure - * @ring_type: type of ring - * @ring_num: ring number - * - * Return: None - */ void dp_srng_deinit(struct dp_soc *soc, struct dp_srng *srng, int ring_type, int ring_num) { @@ -2607,14 +2534,6 @@ static inline void dp_srng_record_timer_exit(struct dp_soc *dp_soc, #endif /* WLAN_FEATURE_DP_EVENT_HISTORY */ -/* - * dp_should_timer_irq_yield() - Decide if the bottom half should yield - * @soc: DP soc handle - * @work_done: work done in softirq context - * @start_time: start time for the softirq - * - * Return: enum with yield code - */ enum timer_yield_status dp_should_timer_irq_yield(struct dp_soc *soc, uint32_t work_done, uint64_t start_time) @@ -2765,7 +2684,7 @@ uint32_t dp_service_near_full_srngs(void *dp_ctx, uint32_t dp_budget, int cpu) #ifndef QCA_HOST_MODE_WIFI_DISABLED -/* +/** * dp_srng_get_cpu() - Get the smp processor id for srng processing * * Return: smp processor id @@ -2775,10 +2694,10 @@ static inline int dp_srng_get_cpu(void) return smp_processor_id(); } -/* +/** * dp_service_srngs() - Top level interrupt handler for DP Ring interrupts * @dp_ctx: DP SOC handle - * @budget: Number of frames/descriptors that can be processed in one shot + * @dp_budget: Number of frames/descriptors that can be processed in one shot * @cpu: CPU on which this instance is running * * Return: remaining budget/quota for the soc device @@ -2918,7 +2837,7 @@ budget_done: #else /* QCA_HOST_MODE_WIFI_DISABLED */ -/* +/** * dp_srng_get_cpu() - Get the smp processor id for srng processing * * Return: smp processor id @@ -2928,10 +2847,11 @@ static inline int dp_srng_get_cpu(void) return 0; } -/* +/** * dp_service_srngs() - Top level handler for DP Monitor Ring interrupts * @dp_ctx: DP SOC handle - * @budget: Number of frames/descriptors that can be processed in one shot + * @dp_budget: Number of frames/descriptors that can be processed in one shot + * @cpu: CPU on which this instance is running * * Return: remaining budget/quota for the soc device */ @@ -2969,8 +2889,8 @@ budget_done: #endif /* QCA_HOST_MODE_WIFI_DISABLED */ -/* dp_interrupt_timer()- timer poll for interrupts - * +/** + * dp_interrupt_timer() - timer poll for interrupts * @arg: SoC Handle * * Return: @@ -3079,7 +2999,7 @@ static inline bool dp_is_mon_mask_valid(struct dp_soc *soc, } #endif -/* +/** * dp_soc_attach_poll() - Register handlers for DP interrupts * @txrx_soc: DP SOC handle * @@ -3134,7 +3054,7 @@ static QDF_STATUS dp_soc_attach_poll(struct cdp_soc_t *txrx_soc) /** * dp_soc_set_interrupt_mode() - Set the interrupt mode in soc - * soc: DP soc handle + * @soc: DP soc handle * * Set the appropriate interrupt mode flag in the soc */ @@ -3164,7 +3084,7 @@ static void dp_soc_set_interrupt_mode(struct dp_soc *soc) static QDF_STATUS dp_soc_interrupt_attach(struct cdp_soc_t *txrx_soc); #if defined(DP_INTR_POLL_BOTH) -/* +/** * dp_soc_interrupt_attach_wrapper() - Register handlers for DP interrupts * @txrx_soc: DP SOC handle * @@ -3210,12 +3130,12 @@ static QDF_STATUS dp_soc_interrupt_attach_wrapper(struct cdp_soc_t *txrx_soc) #ifdef QCA_SUPPORT_LEGACY_INTERRUPTS /** - * dp_soc_interrupt_map_calculate_wifi3_pci_legacy() + * dp_soc_interrupt_map_calculate_wifi3_pci_legacy() - * Calculate interrupt map for legacy interrupts * @soc: DP soc handle * @intr_ctx_num: Interrupt context number * @irq_id_map: IRQ map - * num_irq_r: Number of interrupts assigned for this context + * @num_irq_r: Number of interrupts assigned for this context * * Return: void */ @@ -3268,16 +3188,6 @@ static void dp_soc_interrupt_map_calculate_wifi3_pci_legacy(struct dp_soc *soc, *num_irq_r = num_irq; } #else -/** - * dp_soc_interrupt_map_calculate_wifi3_pci_legacy() - * Calculate interrupt map for legacy interrupts - * @soc: DP soc handle - * @intr_ctx_num: Interrupt context number - * @irq_id_map: IRQ map - * num_irq_r: Number of interrupts assigned for this context - * - * Return: void - */ static void dp_soc_interrupt_map_calculate_wifi3_pci_legacy(struct dp_soc *soc, int intr_ctx_num, int *irq_id_map, @@ -3464,7 +3374,7 @@ static void dp_soc_interrupt_map_calculate(struct dp_soc *soc, int intr_ctx_num, * @soc: DP soc handle * @num_irq: IRQ number * @irq_id_map: IRQ map - * intr_id: interrupt context ID + * @intr_id: interrupt context ID * * Return: 0 for success. nonzero for failure. */ @@ -3501,9 +3411,9 @@ static inline bool dp_skip_rx_mon_ring_mask_set(struct dp_soc *soc) } #endif -/* +/** * dp_soc_ppeds_stop() - Stop PPE DS processing - * @txrx_soc: DP SOC handle + * @soc_handle: DP SOC handle * * Return: none */ @@ -3515,12 +3425,6 @@ static void dp_soc_ppeds_stop(struct cdp_soc_t *soc_handle) soc->arch_ops.txrx_soc_ppeds_stop(soc); } -/* - * dp_soc_interrupt_detach() - Deregister any allocations done for interrupts - * @txrx_soc: DP SOC handle - * - * Return: none - */ void dp_soc_interrupt_detach(struct cdp_soc_t *txrx_soc) { struct dp_soc *soc = (struct dp_soc *)txrx_soc; @@ -3560,7 +3464,7 @@ void dp_soc_interrupt_detach(struct cdp_soc_t *txrx_soc) DP_MON_INVALID_LMAC_ID); } -/* +/** * dp_soc_interrupt_attach() - Register handlers for DP interrupts * @txrx_soc: DP SOC handle * @@ -3706,13 +3610,6 @@ static QDF_STATUS dp_soc_interrupt_attach(struct cdp_soc_t *txrx_soc) #define AVG_MSDUS_PER_FLOW 128 #define AVG_MSDUS_PER_MPDU 4 -/* - * dp_hw_link_desc_pool_banks_free() - Free h/w link desc pool banks - * @soc: DP SOC handle - * @mac_id: mac id - * - * Return: none - */ void dp_hw_link_desc_pool_banks_free(struct dp_soc *soc, uint32_t mac_id) { struct qdf_mem_multi_page_t *pages; @@ -3743,19 +3640,6 @@ void dp_hw_link_desc_pool_banks_free(struct dp_soc *soc, uint32_t mac_id) qdf_export_symbol(dp_hw_link_desc_pool_banks_free); -/* - * dp_hw_link_desc_pool_banks_alloc() - Allocate h/w link desc pool banks - * @soc: DP SOC handle - * @mac_id: mac id - * - * Allocates memory pages for link descriptors, the page size is 4K for - * MCL and 2MB for WIN. if the mac_id is invalid link descriptor pages are - * allocated for regular RX/TX and if the there is a proper mac_id link - * descriptors are allocated for RX monitor mode. - * - * Return: QDF_STATUS_SUCCESS: Success - * QDF_STATUS_E_FAILURE: Failure - */ QDF_STATUS dp_hw_link_desc_pool_banks_alloc(struct dp_soc *soc, uint32_t mac_id) { hal_soc_handle_t hal_soc = soc->hal_soc; @@ -3857,7 +3741,7 @@ QDF_STATUS dp_hw_link_desc_pool_banks_alloc(struct dp_soc *soc, uint32_t mac_id) return QDF_STATUS_SUCCESS; } -/* +/** * dp_hw_link_desc_ring_free() - Free h/w link desc rings * @soc: DP SOC handle * @@ -3894,7 +3778,7 @@ static void dp_hw_link_desc_ring_free(struct dp_soc *soc) } } -/* +/** * dp_hw_link_desc_ring_alloc() - Allocate hw link desc rings * @soc: DP SOC handle * @@ -3991,7 +3875,7 @@ fail: qdf_export_symbol(dp_hw_link_desc_pool_banks_alloc); -/* +/** * dp_hw_link_desc_ring_init() - Initialize hw link desc rings * @soc: DP SOC handle * @@ -4009,7 +3893,7 @@ static QDF_STATUS dp_hw_link_desc_ring_init(struct dp_soc *soc) return QDF_STATUS_SUCCESS; } -/* +/** * dp_hw_link_desc_ring_deinit() - Reset hw link desc rings * @soc: DP SOC handle * @@ -4020,13 +3904,6 @@ static void dp_hw_link_desc_ring_deinit(struct dp_soc *soc) dp_srng_deinit(soc, &soc->wbm_idle_link_ring, WBM_IDLE_LINK, 0); } -/* - * dp_hw_link_desc_ring_replenish() - Replenish hw link desc rings - * @soc: DP SOC handle - * @mac_id: mac id - * - * Return: None - */ void dp_link_desc_ring_replenish(struct dp_soc *soc, uint32_t mac_id) { uint32_t cookie = 0; @@ -4274,8 +4151,8 @@ static void dp_ipa_hal_tx_init_alt_data_ring(struct dp_soc *soc) #endif /* IPA_OFFLOAD */ -/* - * dp_soc_reset_ring_map() - Reset cpu ring map +/** + * dp_soc_reset_cpu_ring_map() - Reset cpu ring map * @soc: Datapath soc handler * * This api resets the default cpu ring map @@ -4325,15 +4202,16 @@ static void dp_soc_reset_cpu_ring_map(struct dp_soc *soc) } } -/* +/** * dp_soc_ring_if_nss_offloaded() - find if ring is offloaded to NSS - * @dp_soc - DP soc handle - * @ring_type - ring type - * @ring_num - ring_num + * @soc: DP soc handle + * @ring_type: ring type + * @ring_num: ring_num * - * return 0 or 1 + * Return: 0 if the ring is not offloaded, non-0 if it is offloaded */ -static uint8_t dp_soc_ring_if_nss_offloaded(struct dp_soc *soc, enum hal_ring_type ring_type, int ring_num) +static uint8_t dp_soc_ring_if_nss_offloaded(struct dp_soc *soc, + enum hal_ring_type ring_type, int ring_num) { uint8_t nss_config = wlan_cfg_get_dp_soc_nss_cfg(soc->wlan_cfg_ctx); uint8_t status = 0; @@ -4352,11 +4230,11 @@ static uint8_t dp_soc_ring_if_nss_offloaded(struct dp_soc *soc, enum hal_ring_ty return status; } -/* +/** * dp_soc_disable_unused_mac_intr_mask() - reset interrupt mask for * unused WMAC hw rings - * @dp_soc - DP Soc handle - * @mac_num - wmac num + * @soc: DP Soc handle + * @mac_num: wmac num * * Return: Return void */ @@ -4389,10 +4267,10 @@ static void dp_soc_disable_unused_mac_intr_mask(struct dp_soc *soc, #ifdef IPA_OFFLOAD #ifdef IPA_WDI3_VLAN_SUPPORT -/* +/** * dp_soc_reset_ipa_vlan_intr_mask() - reset interrupt mask for IPA offloaded - * ring for vlan tagged traffic - * @dp_soc - DP Soc handle + * ring for vlan tagged traffic + * @soc: DP Soc handle * * Return: Return void */ @@ -4434,9 +4312,9 @@ void dp_soc_reset_ipa_vlan_intr_mask(struct dp_soc *soc) { } #endif /* IPA_OFFLOAD */ -/* +/** * dp_soc_reset_intr_mask() - reset interrupt mask - * @dp_soc - DP Soc handle + * @soc: DP Soc handle * * Return: Return void */ @@ -4855,11 +4733,11 @@ static void dp_ipa_get_tx_comp_ring_size(int tx_comp_ring_num, } #endif /* IPA_OFFLOAD */ -/* +/** * dp_reo_frag_dst_set() - configure reo register to set the * fragment destination ring - * @soc : Datapath soc - * @frag_dst_ring : output parameter to set fragment destination ring + * @soc: Datapath soc + * @frag_dst_ring: output parameter to set fragment destination ring * * Based on offload_radio below fragment destination rings is selected * 0 - TCL @@ -4871,7 +4749,7 @@ static void dp_ipa_get_tx_comp_ring_size(int tx_comp_ring_num, * 6 - FW * 7 - alternate select * - * return: void + * Return: void */ static void dp_reo_frag_dst_set(struct dp_soc *soc, uint8_t *frag_dst_ring) { @@ -5152,7 +5030,7 @@ static QDF_STATUS dp_lro_hash_setup(struct dp_soc *soc, struct dp_pdev *pdev) } #if defined(WLAN_MAX_PDEVS) && (WLAN_MAX_PDEVS == 1) -/* +/** * dp_reap_timer_init() - initialize the reap timer * @soc: data path SoC handle * @@ -5168,7 +5046,7 @@ static void dp_reap_timer_init(struct dp_soc *soc) dp_monitor_vdev_timer_init(soc); } -/* +/** * dp_reap_timer_deinit() - de-initialize the reap timer * @soc: data path SoC handle * @@ -5206,7 +5084,7 @@ static void dp_reap_timer_deinit(struct dp_soc *soc) #endif #ifdef QCA_HOST2FW_RXBUF_RING -/* +/** * dp_rxdma_ring_alloc() - allocate the RXDMA rings * @soc: data path SoC handle * @pdev: Physical device handle @@ -5235,7 +5113,7 @@ static int dp_rxdma_ring_alloc(struct dp_soc *soc, struct dp_pdev *pdev) return QDF_STATUS_SUCCESS; } -/* +/** * dp_rxdma_ring_setup() - configure the RXDMA rings * @soc: data path SoC handle * @pdev: Physical device handle @@ -5262,7 +5140,7 @@ static int dp_rxdma_ring_setup(struct dp_soc *soc, struct dp_pdev *pdev) return QDF_STATUS_SUCCESS; } -/* +/** * dp_rxdma_ring_cleanup() - Deinit the RXDMA rings and reap timer * @soc: data path SoC handle * @pdev: Physical device handle @@ -5279,7 +5157,7 @@ static void dp_rxdma_ring_cleanup(struct dp_soc *soc, struct dp_pdev *pdev) dp_reap_timer_deinit(soc); } -/* +/** * dp_rxdma_ring_free() - Free the RXDMA rings * @pdev: Physical device handle * @@ -5315,8 +5193,8 @@ static void dp_rxdma_ring_free(struct dp_pdev *pdev) #endif /** - * dp_dscp_tid_map_setup(): Initialize the dscp-tid maps - * @pdev - DP_PDEV handle + * dp_dscp_tid_map_setup() - Initialize the dscp-tid maps + * @pdev: DP_PDEV handle * * Return: void */ @@ -5343,8 +5221,8 @@ dp_dscp_tid_map_setup(struct dp_pdev *pdev) } /** - * dp_pcp_tid_map_setup(): Initialize the pcp-tid maps - * @pdev - DP_PDEV handle + * dp_pcp_tid_map_setup() - Initialize the pcp-tid maps + * @pdev: DP_PDEV handle * * Return: void */ @@ -5680,7 +5558,7 @@ dp_soc_rx_reinject_ring_history_attach(struct dp_soc *soc) * initialized or not. We do not want to fail the driver load in case of * failure to allocate memory for debug history. * - * Returns: None + * Return: None */ static void dp_soc_rx_history_attach(struct dp_soc *soc) { @@ -5804,7 +5682,7 @@ static void dp_soc_mon_status_ring_history_detach(struct dp_soc *soc) * initialized or not. We do not want to fail the driver load in case of * failure to allocate memory for debug history. * - * Returns: None + * Return: None */ static void dp_soc_tx_history_attach(struct dp_soc *soc) { @@ -5827,7 +5705,7 @@ static void dp_soc_tx_history_attach(struct dp_soc *soc) * This function frees the memory for recording the tx tcl ring and * the tx comp ring entries. * - * Returns: None + * Return: None */ static void dp_soc_tx_history_detach(struct dp_soc *soc) { @@ -5850,13 +5728,6 @@ static inline void dp_soc_tx_history_detach(struct dp_soc *soc) #endif /* WLAN_FEATURE_DP_TX_DESC_HISTORY */ #ifdef WLAN_SUPPORT_RX_FLOW_TAG -/** - * dp_rx_fst_attach_wrapper() - wrapper API for dp_rx_fst_attach - * @soc: SoC handle - * @pdev: Pdev handle - * - * Return: Handle to flow search table entry - */ QDF_STATUS dp_rx_fst_attach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) { @@ -5891,13 +5762,6 @@ dp_rx_fst_attach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) return ret; } -/** - * dp_rx_fst_detach_wrapper() - wrapper API for dp_rx_fst_detach - * @soc: SoC handle - * @pdev: Pdev handle - * - * Return: None - */ void dp_rx_fst_detach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) { @@ -5923,65 +5787,37 @@ dp_rx_fst_detach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) pdev->rx_fst = NULL; } #elif defined(WLAN_SUPPORT_RX_FISA) -/** - * dp_rx_fst_attach_wrapper() - wrapper API for dp_rx_fst_attach - * @soc: SoC handle - * @pdev: Pdev handle - * - * Return: Handle to flow search table entry - */ QDF_STATUS dp_rx_fst_attach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) { return dp_rx_fst_attach(soc, pdev); } -/** - * dp_rx_fst_detach_wrapper() - wrapper API for dp_rx_fst_detach - * @soc: SoC handle - * @pdev: Pdev handle - * - * Return: None - */ void dp_rx_fst_detach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) { dp_rx_fst_detach(soc, pdev); } #else -/** - * dp_rx_fst_attach_wrapper() - wrapper API for dp_rx_fst_attach - * @soc: SoC handle - * @pdev: Pdev handle - * - * Return: Handle to flow search table entry - */ QDF_STATUS dp_rx_fst_attach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) { return QDF_STATUS_SUCCESS; } -/** - * dp_rx_fst_detach_wrapper() - wrapper API for dp_rx_fst_detach - * @soc: SoC handle - * @pdev: Pdev handle - * - * Return: None - */ void dp_rx_fst_detach_wrapper(struct dp_soc *soc, struct dp_pdev *pdev) { } #endif -/* -* dp_pdev_attach_wifi3() - attach txrx pdev -* @txrx_soc: Datapath SOC handle -* @params: Params for PDEV attach -* -* Return: QDF_STATUS -*/ +/** + * dp_pdev_attach_wifi3() - attach txrx pdev + * @txrx_soc: Datapath SOC handle + * @params: Params for PDEV attach + * + * Return: QDF_STATUS + */ static inline QDF_STATUS dp_pdev_attach_wifi3(struct cdp_soc_t *txrx_soc, struct cdp_pdev_attach_params *params) @@ -6166,7 +6002,8 @@ static void dp_vdev_stats_hw_offload_target_config(struct dp_soc *soc, * dp_vdev_stats_hw_offload_target_clear() - Clear HW vdev stats on target * @soc: Datapath soc handle * @pdev_id: pdev_id (0,1,2) - * @bitmask: bitmask with vdev_id(s) for which stats are to be cleared on HW + * @vdev_id_bitmask: bitmask with vdev_id(s) for which stats are to be + * cleared on HW * * Return: none */ @@ -6276,7 +6113,7 @@ dp_pdev_deinit_wifi3(struct cdp_soc_t *psoc, uint8_t pdev_id, return QDF_STATUS_SUCCESS; } -/* +/** * dp_pdev_post_attach() - Do post pdev attach after dev_alloc_name * @txrx_pdev: Datapath PDEV handle * @@ -6293,9 +6130,9 @@ static void dp_pdev_post_attach(struct cdp_pdev *txrx_pdev) } } -/* +/** * dp_pdev_post_attach_wifi3() - attach txrx pdev post - * @psoc: Datapath soc handle + * @soc: Datapath soc handle * @pdev_id: pdev id of pdev * * Return: QDF_STATUS @@ -6318,7 +6155,7 @@ static int dp_pdev_post_attach_wifi3(struct cdp_soc_t *soc, return QDF_STATUS_SUCCESS; } -/* +/** * dp_pdev_detach() - Complete rest of pdev detach * @txrx_pdev: Datapath PDEV handle * @force: Force deinit @@ -6348,7 +6185,7 @@ static void dp_pdev_detach(struct cdp_pdev *txrx_pdev, int force) dp_context_free_mem(soc, DP_PDEV_TYPE, pdev); } -/* +/** * dp_pdev_detach_wifi3() - detach txrx pdev * @psoc: Datapath soc handle * @pdev_id: pdev id of pdev @@ -6377,10 +6214,6 @@ static QDF_STATUS dp_pdev_detach_wifi3(struct cdp_soc_t *psoc, uint8_t pdev_id, return QDF_STATUS_SUCCESS; } -/* - * dp_reo_desc_freelist_destroy() - Flush REO descriptors from deferred freelist - * @soc: DP SOC handle - */ #ifndef DP_UMAC_HW_RESET_SUPPORT static inline #endif @@ -6406,10 +6239,10 @@ void dp_reo_desc_freelist_destroy(struct dp_soc *soc) } #ifdef WLAN_DP_FEATURE_DEFERRED_REO_QDESC_DESTROY -/* +/** * dp_reo_desc_deferred_freelist_create() - Initialize the resources used * for deferred reo desc list - * @psoc: Datapath soc handle + * @soc: Datapath soc handle * * Return: void */ @@ -6421,10 +6254,10 @@ static void dp_reo_desc_deferred_freelist_create(struct dp_soc *soc) soc->reo_desc_deferred_freelist_init = true; } -/* +/** * dp_reo_desc_deferred_freelist_destroy() - loop the deferred free list & * free the leftover REO QDESCs - * @psoc: Datapath soc handle + * @soc: Datapath soc handle * * Return: void */ @@ -6458,7 +6291,7 @@ static inline void dp_reo_desc_deferred_freelist_destroy(struct dp_soc *soc) } #endif /* !WLAN_DP_FEATURE_DEFERRED_REO_QDESC_DESTROY */ -/* +/** * dp_soc_reset_txrx_ring_map() - reset tx ring map * @soc: DP SOC handle * @@ -6471,7 +6304,7 @@ static void dp_soc_reset_txrx_ring_map(struct dp_soc *soc) soc->tx_ring_map[i] = 0; } -/* +/** * dp_soc_print_inactive_objects() - prints inactive peer and vdev list * @soc: DP SOC handle * @@ -6597,7 +6430,7 @@ static void dp_soc_deinit_wifi3(struct cdp_soc_t *txrx_soc) dp_soc_deinit(txrx_soc); } -/* +/** * dp_soc_detach() - Detach rest of txrx SOC * @txrx_soc: DP SOC handle, struct cdp_soc_t is first element of struct dp_soc. * @@ -6632,7 +6465,7 @@ static void dp_soc_detach(struct cdp_soc_t *txrx_soc) qdf_mem_free(soc); } -/* +/** * dp_soc_detach_wifi3() - Detach txrx SOC * @txrx_soc: DP SOC handle, struct cdp_soc_t is first element of struct dp_soc. * @@ -6643,18 +6476,6 @@ static void dp_soc_detach_wifi3(struct cdp_soc_t *txrx_soc) dp_soc_detach(txrx_soc); } -/* - * dp_rxdma_ring_config() - configure the RX DMA rings - * - * This function is used to configure the MAC rings. - * On MCL host provides buffers in Host2FW ring - * FW refills (copies) buffers to the ring and updates - * ring_idx in register - * - * @soc: data path SoC handle - * - * Return: zero on success, non-zero on failure - */ #ifdef QCA_HOST2FW_RXBUF_RING static inline void dp_htt_setup_rxdma_err_dst_ring(struct dp_soc *soc, int mac_id, @@ -6685,6 +6506,17 @@ void dp_rxdma_setup_refill_ring3(struct dp_soc *soc, { } #endif +/** + * dp_rxdma_ring_config() - configure the RX DMA rings + * @soc: data path SoC handle + * + * This function is used to configure the MAC rings. + * On MCL host provides buffers in Host2FW ring + * FW refills (copies) buffers to the ring and updates + * ring_idx in register + * + * Return: zero on success, non-zero on failure + */ static QDF_STATUS dp_rxdma_ring_config(struct dp_soc *soc) { int i; @@ -6799,7 +6631,7 @@ static QDF_STATUS dp_rxdma_ring_config(struct dp_soc *soc) } #endif -/* +/** * dp_rx_target_fst_config() - configure the RXOLE Flow Search Engine * * This function is used to configure the FSE HW block in RX OLE on a @@ -6915,7 +6747,7 @@ static inline QDF_STATUS dp_print_swlm_stats(struct dp_soc *soc) #endif /* !WLAN_DP_FEATURE_SW_LATENCY_MGR */ #ifdef WLAN_SUPPORT_PPEDS -/* +/** * dp_soc_target_ppe_rxole_rxdma_cfg() - Configure the RxOLe and RxDMA for PPE * @soc: DP Tx/Rx handle * @@ -7002,7 +6834,7 @@ static void dp_register_umac_reset_handlers(struct dp_soc *soc) { } #endif -/* +/** * dp_soc_attach_target_wifi3() - SOC initialization in the target * @cdp_soc: Opaque Datapath SOC handle * @@ -7106,7 +6938,7 @@ dp_soc_attach_target_wifi3(struct cdp_soc_t *cdp_soc) return QDF_STATUS_SUCCESS; } -/* +/** * dp_vdev_id_map_tbl_add() - Add vdev into vdev_id table * @soc: SoC handle * @vdev: vdev handle @@ -7138,7 +6970,7 @@ static void dp_vdev_id_map_tbl_add(struct dp_soc *soc, qdf_spin_unlock_bh(&soc->vdev_map_lock); } -/* +/** * dp_vdev_id_map_tbl_remove() - remove vdev from vdev_id table * @soc: SoC handle * @vdev: vdev handle @@ -7156,13 +6988,13 @@ static void dp_vdev_id_map_tbl_remove(struct dp_soc *soc, qdf_spin_unlock_bh(&soc->vdev_map_lock); } -/* +/** * dp_vdev_pdev_list_add() - add vdev into pdev's list * @soc: soc handle * @pdev: pdev handle * @vdev: vdev handle * - * return: none + * Return: none */ static void dp_vdev_pdev_list_add(struct dp_soc *soc, struct dp_pdev *pdev, @@ -7181,7 +7013,7 @@ static void dp_vdev_pdev_list_add(struct dp_soc *soc, qdf_spin_unlock_bh(&pdev->vdev_list_lock); } -/* +/** * dp_vdev_pdev_list_remove() - remove vdev from pdev's list * @soc: SoC handle * @pdev: pdev handle @@ -7216,7 +7048,7 @@ static void dp_vdev_pdev_list_remove(struct dp_soc *soc, } #ifdef QCA_SUPPORT_EAPOL_OVER_CONTROL_PORT -/* +/** * dp_vdev_init_rx_eapol() - initializing osif_rx_eapol * @vdev: Datapath VDEV handle * @@ -7227,7 +7059,7 @@ static inline void dp_vdev_init_rx_eapol(struct dp_vdev *vdev) vdev->osif_rx_eapol = NULL; } -/* +/** * dp_vdev_register_rx_eapol() - Register VDEV operations for rx_eapol * @vdev: DP vdev handle * @txrx_ops: Tx and Rx operations @@ -7267,9 +7099,9 @@ static inline void dp_vdev_save_mld_addr(struct dp_vdev *vdev, #endif #ifdef DP_TRAFFIC_END_INDICATION -/* - * dp_tx_traffic_end_indication_attach() - Initialize data end indication - * related members in VDEV +/** + * dp_tx_vdev_traffic_end_indication_attach() - Initialize data end indication + * related members in VDEV * @vdev: DP vdev handle * * Return: None @@ -7280,7 +7112,7 @@ dp_tx_vdev_traffic_end_indication_attach(struct dp_vdev *vdev) qdf_nbuf_queue_init(&vdev->end_ind_pkt_q); } -/* +/** * dp_tx_vdev_traffic_end_indication_detach() - De-init data end indication * related members in VDEV * @vdev: DP vdev handle @@ -7305,14 +7137,14 @@ dp_tx_vdev_traffic_end_indication_detach(struct dp_vdev *vdev) {} #endif -/* -* dp_vdev_attach_wifi3() - attach txrx vdev -* @txrx_pdev: Datapath PDEV handle -* @pdev_id: PDEV ID for vdev creation -* @vdev_info: parameters used for vdev creation -* -* Return: status -*/ +/** + * dp_vdev_attach_wifi3() - attach txrx vdev + * @cdp_soc: CDP SoC context + * @pdev_id: PDEV ID for vdev creation + * @vdev_info: parameters used for vdev creation + * + * Return: status + */ static QDF_STATUS dp_vdev_attach_wifi3(struct cdp_soc_t *cdp_soc, uint8_t pdev_id, struct cdp_vdev_info *vdev_info) @@ -7470,7 +7302,7 @@ fail0: #ifndef QCA_HOST_MODE_WIFI_DISABLED /** - * dp_vdev_fetch_tx_handlers() - Fetch Tx handlers + * dp_vdev_fetch_tx_handler() - Fetch Tx handlers * @vdev: struct dp_vdev * * @soc: struct dp_soc * * @ctx: struct ol_txrx_hardtart_ctxt * @@ -7537,7 +7369,7 @@ static inline void dp_vdev_fetch_tx_handler(struct dp_vdev *vdev, /** * dp_vdev_register_wifi3() - Register VDEV operations from osif layer - * @soc: Datapath soc handle + * @soc_hdl: Datapath soc handle * @vdev_id: id of Datapath VDEV handle * @osif_vdev: OSIF vdev handle * @txrx_ops: Tx and Rx operations @@ -7639,8 +7471,9 @@ void dp_mlo_peer_delete(struct dp_soc *soc, struct dp_peer *peer, void *arg) #endif /** * dp_vdev_flush_peers() - Forcibily Flush peers of vdev - * @vdev: Datapath VDEV handle + * @vdev_handle: Datapath VDEV handle * @unmap_only: Flag to indicate "only unmap" + * @mlo_peers_only: true if only MLO peers should be flushed * * Return: void */ @@ -7703,7 +7536,7 @@ static void dp_vdev_flush_peers(struct cdp_vdev *vdev_handle, } #ifdef QCA_VDEV_STATS_HW_OFFLOAD_SUPPORT -/* +/** * dp_txrx_alloc_vdev_stats_id()- Allocate vdev_stats_id * @soc_hdl: Datapath soc handle * @vdev_stats_id: Address of vdev_stats_id @@ -7733,7 +7566,7 @@ static QDF_STATUS dp_txrx_alloc_vdev_stats_id(struct cdp_soc_t *soc_hdl, return QDF_STATUS_E_FAILURE; } -/* +/** * dp_txrx_reset_vdev_stats_id() - Reset vdev_stats_id in dp_soc * @soc_hdl: Datapath soc handle * @vdev_stats_id: vdev_stats_id to reset in dp_soc @@ -7756,7 +7589,7 @@ static void dp_txrx_reset_vdev_stats_id(struct cdp_soc_t *soc, uint8_t vdev_stats_id) {} #endif -/* +/** * dp_vdev_detach_wifi3() - Detach txrx vdev * @cdp_soc: Datapath soc handle * @vdev_id: VDEV Id @@ -7955,10 +7788,10 @@ static inline void dp_peer_ast_handle_roam_del(struct dp_soc *soc, #endif #ifdef QCA_VDEV_STATS_HW_OFFLOAD_SUPPORT -/* +/** * dp_peer_hw_txrx_stats_init() - Initialize hw_txrx_stats_en in dp_peer * @soc: Datapath soc handle - * @peer: Datapath peer handle + * @txrx_peer: Datapath peer handle * * Return: none */ @@ -8071,7 +7904,7 @@ void dp_txrx_peer_stats_clr(struct dp_txrx_peer *txrx_peer) dp_peer_jitter_stats_ctx_clr(txrx_peer); } -/* +/** * dp_peer_create_wifi3() - attach txrx peer * @soc_hdl: Datapath soc handle * @vdev_id: id of vdev @@ -8418,12 +8251,12 @@ QDF_STATUS dp_peer_mlo_setup( return QDF_STATUS_SUCCESS; } -/* +/** * dp_mlo_peer_authorize() - authorize MLO peer * @soc: soc handle * @peer: pointer to link peer * - * return void + * Return: void */ static void dp_mlo_peer_authorize(struct dp_soc *soc, struct dp_peer *peer) @@ -8503,14 +8336,17 @@ static inline bool dp_is_vdev_subtype_p2p(struct dp_vdev *vdev) return false; } -/* +/** * dp_peer_setup_get_reo_hash() - get reo dest ring and hash values for a peer * @vdev: Datapath VDEV handle + * @setup_info: * @reo_dest: pointer to default reo_dest ring for vdev to be populated * @hash_based: pointer to hash value (enabled/disabled) to be populated + * @lmac_peer_id_msb: * * If IPA is enabled in ini, for SAP mode, disable hash based * steering, use default reo_dst ring for RX. Use config values for other modes. + * * Return: None */ static void dp_peer_setup_get_reo_hash(struct dp_vdev *vdev, @@ -8555,11 +8391,13 @@ static void dp_peer_setup_get_reo_hash(struct dp_vdev *vdev, #else -/* +/** * dp_peer_setup_get_reo_hash() - get reo dest ring and hash values for a peer * @vdev: Datapath VDEV handle + * @setup_info: * @reo_dest: pointer to default reo_dest ring for vdev to be populated * @hash_based: pointer to hash value (enabled/disabled) to be populated + * @lmac_peer_id_msb: * * Use system config values for hash based steering. * Return: None @@ -8577,12 +8415,12 @@ static void dp_peer_setup_get_reo_hash(struct dp_vdev *vdev, } #endif /* IPA_OFFLOAD */ -/* +/** * dp_peer_setup_wifi3() - initialize the peer * @soc_hdl: soc handle object - * @vdev_id : vdev_id of vdev object + * @vdev_id: vdev_id of vdev object * @peer_mac: Peer's mac address - * @peer_setup_info: peer setup info for MLO + * @setup_info: peer setup info for MLO * * Return: QDF_STATUS */ @@ -8697,8 +8535,8 @@ fail: return status; } -/* - * dp_cp_peer_del_resp_handler - Handle the peer delete response +/** + * dp_cp_peer_del_resp_handler() - Handle the peer delete response * @soc_hdl: Datapath SOC handle * @vdev_id: id of virtual device object * @mac_addr: Mac address of the peer @@ -8760,7 +8598,7 @@ static QDF_STATUS dp_cp_peer_del_resp_handler(struct cdp_soc_t *soc_hdl, return QDF_STATUS_SUCCESS; } -/* +/** * dp_set_ba_aging_timeout() - set ba aging timeout per AC * @txrx_soc: cdp soc handle * @ac: Access category @@ -8776,7 +8614,7 @@ static void dp_set_ba_aging_timeout(struct cdp_soc_t *txrx_soc, hal_set_ba_aging_timeout(soc->hal_soc, ac, value); } -/* +/** * dp_get_ba_aging_timeout() - get ba aging timeout per AC * @txrx_soc: cdp soc handle * @ac: access category @@ -8792,7 +8630,7 @@ static void dp_get_ba_aging_timeout(struct cdp_soc_t *txrx_soc, hal_get_ba_aging_timeout(soc->hal_soc, ac, value); } -/* +/** * dp_set_pdev_reo_dest() - set the reo destination ring for this pdev * @txrx_soc: cdp soc handle * @pdev_id: id of physical device object @@ -8816,7 +8654,7 @@ dp_set_pdev_reo_dest(struct cdp_soc_t *txrx_soc, uint8_t pdev_id, return QDF_STATUS_E_FAILURE; } -/* +/** * dp_get_pdev_reo_dest() - get the reo destination for this pdev * @txrx_soc: cdp soc handle * @pdev_id: id of physical device object @@ -8837,18 +8675,21 @@ dp_get_pdev_reo_dest(struct cdp_soc_t *txrx_soc, uint8_t pdev_id) } #ifdef WLAN_SUPPORT_MSCS -/* - * dp_record_mscs_params - MSCS parameters sent by the STA in - * the MSCS Request to the AP. The AP makes a note of these - * parameters while comparing the MSDUs sent by the STA, to - * send the downlink traffic with correct User priority. - * @soc - Datapath soc handle - * @peer_mac - STA Mac address - * @vdev_id - ID of the vdev handle - * @mscs_params - Structure having MSCS parameters obtained +/** + * dp_record_mscs_params() - Record MSCS parameters sent by the STA in + * the MSCS Request to the AP. + * @soc_hdl: Datapath soc handle + * @peer_mac: STA Mac address + * @vdev_id: ID of the vdev handle + * @mscs_params: Structure having MSCS parameters obtained * from handshake - * @active - Flag to set MSCS active/inactive - * return type - QDF_STATUS - Success/Invalid + * @active: Flag to set MSCS active/inactive + * + * The AP makes a note of these parameters while comparing the MSDUs + * sent by the STA, to send the downlink traffic with correct User + * priority. + * + * Return: QDF_STATUS - Success/Invalid */ static QDF_STATUS dp_record_mscs_params(struct cdp_soc_t *soc_hdl, uint8_t *peer_mac, @@ -8907,7 +8748,7 @@ fail: } #endif -/* +/** * dp_get_sec_type() - Get the security type * @soc: soc handle * @vdev_id: id of dp handle @@ -8941,12 +8782,14 @@ static int dp_get_sec_type(struct cdp_soc_t *soc, uint8_t vdev_id, return sec_type; } -/* +/** * dp_peer_authorize() - authorize txrx peer - * @soc: soc handle + * @soc_hdl: soc handle * @vdev_id: id of dp handle * @peer_mac: mac of datapath PEER handle - * @authorize + * @authorize: + * + * Return: QDF_STATUS * */ static QDF_STATUS @@ -8977,13 +8820,13 @@ dp_peer_authorize(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, return status; } -/* +/** * dp_peer_get_authorize() - get peer authorize status - * @soc: soc handle + * @soc_hdl: soc handle * @vdev_id: id of dp handle * @peer_mac: mac of datapath PEER handle * - * Retusn: true is peer is authorized, false otherwise + * Return: true is peer is authorized, false otherwise */ static bool dp_peer_get_authorize(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, @@ -9006,13 +8849,6 @@ dp_peer_get_authorize(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, return authorize; } -/** - * dp_vdev_unref_delete() - check and process vdev delete - * @soc : DP specific soc pointer - * @vdev: DP specific vdev pointer - * @mod_id: module id - * - */ void dp_vdev_unref_delete(struct dp_soc *soc, struct dp_vdev *vdev, enum dp_mod_id mod_id) { @@ -9086,12 +8922,6 @@ free_vdev: qdf_export_symbol(dp_vdev_unref_delete); -/* - * dp_peer_unref_delete() - unref and delete peer - * @peer_handle: Datapath peer handle - * @mod_id: ID of module releasing reference - * - */ void dp_peer_unref_delete(struct dp_peer *peer, enum dp_mod_id mod_id) { struct dp_vdev *vdev = peer->vdev; @@ -9171,12 +9001,6 @@ void dp_peer_unref_delete(struct dp_peer *peer, enum dp_mod_id mod_id) qdf_export_symbol(dp_peer_unref_delete); -/* - * dp_txrx_peer_unref_delete() - unref and delete peer - * @handle: Datapath txrx ref handle - * @mod_id: Module ID of the caller - * - */ void dp_txrx_peer_unref_delete(dp_txrx_ref_handle handle, enum dp_mod_id mod_id) { @@ -9185,8 +9009,8 @@ void dp_txrx_peer_unref_delete(dp_txrx_ref_handle handle, qdf_export_symbol(dp_txrx_peer_unref_delete); -/* - * dp_peer_delete_wifi3() – Delete txrx peer +/** + * dp_peer_delete_wifi3() - Delete txrx peer * @soc_hdl: soc handle * @vdev_id: id of dp handle * @peer_mac: mac of datapath PEER handle @@ -9294,8 +9118,8 @@ static QDF_STATUS dp_update_roaming_peer_wifi3(struct cdp_soc_t *soc_hdl, return QDF_STATUS_SUCCESS; } #endif -/* - * dp_get_vdev_mac_addr_wifi3() – Detach txrx peer +/** + * dp_get_vdev_mac_addr_wifi3() - Detach txrx peer * @soc_hdl: Datapath soc handle * @vdev_id: virtual interface id * @@ -9319,9 +9143,9 @@ static uint8_t *dp_get_vdev_mac_addr_wifi3(struct cdp_soc_t *soc_hdl, return mac; } -/* +/** * dp_vdev_set_wds() - Enable per packet stats - * @soc: DP soc handle + * @soc_hdl: DP soc handle * @vdev_id: id of DP VDEV handle * @val: value * @@ -9366,7 +9190,7 @@ static int dp_get_opmode(struct cdp_soc_t *soc_hdl, uint8_t vdev_id) * @soc_hdl: ol_txrx_soc_handle handle * @vdev_id: vdev id for which os rx handles are needed * @stack_fn_p: pointer to stack function pointer - * @osif_handle_p: pointer to ol_osif_vdev_handle + * @osif_vdev_p: pointer to ol_osif_vdev_handle * * Return: void */ @@ -9391,7 +9215,7 @@ void dp_get_os_rx_handles_from_vdev_wifi3(struct cdp_soc_t *soc_hdl, } /** - * dp_get_ctrl_pdev_from_vdev() - Get control pdev of vdev + * dp_get_ctrl_pdev_from_vdev_wifi3() - Get control pdev of vdev * @soc_hdl: datapath soc handle * @vdev_id: virtual device/interface id * @@ -9429,7 +9253,7 @@ static int32_t dp_get_tx_pending(struct cdp_pdev *pdev_handle) /** * dp_get_peer_mac_from_peer_id() - get peer mac - * @pdev_handle: Datapath PDEV handle + * @soc: CDP SoC handle * @peer_id: Peer ID * @peer_mac: MAC addr of PEER * @@ -9472,8 +9296,8 @@ void dp_vdev_set_mesh_mode(struct cdp_vdev *vdev_hdl, uint32_t val) ~DP_TX_MESH_ENABLED; } -/* - * dp_peer_set_mesh_rx_filter() - to set the mesh rx filter +/** + * dp_vdev_set_mesh_rx_filter() - to set the mesh rx filter * @vdev_hdl: virtual device object * @val: value to be set * @@ -9489,9 +9313,9 @@ void dp_vdev_set_mesh_rx_filter(struct cdp_vdev *vdev_hdl, uint32_t val) } #endif -/* +/** * dp_vdev_set_hlos_tid_override() - to set hlos tid override - * @vdev_hdl: virtual device object + * @vdev: virtual device object * @val: value to be set * * Return: void @@ -9508,10 +9332,9 @@ void dp_vdev_set_hlos_tid_override(struct dp_vdev *vdev, uint32_t val) ~DP_TXRX_HLOS_TID_OVERRIDE_ENABLED; } -/* +/** * dp_vdev_get_hlos_tid_override() - to get hlos tid override flag * @vdev_hdl: virtual device object - * @val: value to be set * * Return: 1 if this flag is set */ @@ -9611,14 +9434,6 @@ bool dp_check_pdev_exists(struct dp_soc *soc, struct dp_pdev *data) return false; } -/** - * dp_rx_bar_stats_cb(): BAR received stats callback - * @soc: SOC handle - * @cb_ctxt: Call back context - * @reo_status: Reo status - * - * return: void - */ void dp_rx_bar_stats_cb(struct dp_soc *soc, void *cb_ctxt, union hal_reo_status *reo_status) { @@ -9645,12 +9460,6 @@ void dp_rx_bar_stats_cb(struct dp_soc *soc, void *cb_ctxt, } -/** - * dp_aggregate_vdev_stats(): Consolidate stats at VDEV level - * @vdev: DP VDEV handle - * - * return: void - */ void dp_aggregate_vdev_stats(struct dp_vdev *vdev, struct cdp_vdev_stats *vdev_stats) { @@ -9854,8 +9663,8 @@ static void dp_pdev_getstats(struct cdp_pdev *pdev_handle, /** * dp_get_device_stats() - get interface level packet stats - * @soc: soc handle - * @id : vdev_id or pdev_id based on type + * @soc_hdl: soc handle + * @id: vdev_id or pdev_id based on type * @stats: cdp network device stats structure * @type: device type pdev/vdev * @@ -9955,17 +9764,13 @@ char *dp_srng_get_str_from_hal_ring_type(enum hal_ring_type ring_type) return "Invalid"; } -/* - * dp_print_napi_stats(): NAPI stats - * @soc - soc handle - */ void dp_print_napi_stats(struct dp_soc *soc) { hif_print_napi_stats(soc->hif_handle); } /** - * dp_txrx_host_peer_stats_clr): Reinitialize the txrx peer stats + * dp_txrx_host_peer_stats_clr() - Reinitialize the txrx peer stats * @soc: Datapath soc * @peer: Datatpath peer * @arg: argument to iter function @@ -10020,9 +9825,9 @@ static inline void dp_srng_clear_ring_usage_wm_stats(struct dp_soc *soc) #endif /** - * dp_txrx_host_stats_clr(): Reinitialize the txrx stats + * dp_txrx_host_stats_clr() - Reinitialize the txrx stats * @vdev: DP_VDEV handle - * @dp_soc: DP_SOC handle + * @soc: DP_SOC handle * * Return: QDF_STATUS */ @@ -10231,14 +10036,6 @@ void dp_get_peer_tx_per(struct cdp_peer_stats *peer_stats) peer_stats->tx.per = 0; } -/** - * dp_get_peer_stats()- Get peer stats - * @peer: Datapath peer - * @peer_stats: buffer for peer stats - * - * Return: none - */ - void dp_get_peer_stats(struct dp_peer *peer, struct cdp_peer_stats *peer_stats) { dp_get_peer_calibr_stats(peer, peer_stats); @@ -10252,7 +10049,7 @@ void dp_get_peer_stats(struct dp_peer *peer, struct cdp_peer_stats *peer_stats) dp_get_peer_tx_per(peer_stats); } -/* +/** * dp_get_host_peer_stats()- function to print peer stats * @soc: dp_soc handle * @mac_addr: mac address of the peer @@ -10306,8 +10103,8 @@ dp_get_host_peer_stats(struct cdp_soc_t *soc, uint8_t *mac_addr) return QDF_STATUS_SUCCESS; } -/* * - * dp_dump_wbm_idle_hptp() -dump wbm idle ring, hw hp tp info. +/** + * dp_dump_wbm_idle_hptp() - dump wbm idle ring, hw hp tp info. * @soc: dp soc. * @pdev: dp pdev. * @@ -10393,7 +10190,7 @@ static void dp_txrx_stats_help(void) #ifdef DP_UMAC_HW_RESET_SUPPORT /** - * dp_umac_rst_skel_enable_update(): Update skel dbg flag for umac reset + * dp_umac_rst_skel_enable_update() - Update skel dbg flag for umac reset * @soc: dp soc handle * @en: ebable/disable * @@ -10407,7 +10204,7 @@ static void dp_umac_rst_skel_enable_update(struct dp_soc *soc, bool en) } /** - * dp_umac_rst_skel_enable_get(): Get skel dbg flag for umac reset + * dp_umac_rst_skel_enable_get() - Get skel dbg flag for umac reset * @soc: dp soc handle * * Return: enable/disable flag @@ -10429,7 +10226,7 @@ static bool dp_umac_rst_skel_enable_get(struct dp_soc *soc) /** * dp_print_host_stats()- Function to print the stats aggregated at host - * @vdev_handle: DP_VDEV handle + * @vdev: DP_VDEV handle * @req: host stats type * @soc: dp soc handler * @@ -10517,8 +10314,8 @@ dp_print_host_stats(struct dp_vdev *vdev, return 0; } -/* - * dp_pdev_tid_stats_ingress_inc +/** + * dp_pdev_tid_stats_ingress_inc() - increment ingress_stack counter * @pdev: pdev handle * @val: increase in value * @@ -10530,8 +10327,8 @@ dp_pdev_tid_stats_ingress_inc(struct dp_pdev *pdev, uint32_t val) pdev->stats.tid_stats.ingress_stack += val; } -/* - * dp_pdev_tid_stats_osif_drop +/** + * dp_pdev_tid_stats_osif_drop() - increment osif_drop counter * @pdev: pdev handle * @val: increase in value * @@ -10543,10 +10340,10 @@ dp_pdev_tid_stats_osif_drop(struct dp_pdev *pdev, uint32_t val) pdev->stats.tid_stats.osif_drop += val; } -/* +/** * dp_get_fw_peer_stats()- function to print peer stats * @soc: soc handle - * @pdev_id : id of the pdev handle + * @pdev_id: id of the pdev handle * @mac_addr: mac address of the peer * @cap: Type of htt stats requested * @is_wait: if set, wait on completion from firmware response @@ -10620,14 +10417,14 @@ struct httstats_cmd_req { u_int8_t stats_id; }; -/* +/** * dp_get_htt_stats: function to process the httstas request * @soc: DP soc handle * @pdev_id: id of pdev handle * @data: pointer to request data * @data_len: length for request data * - * return: QDF_STATUS + * Return: QDF_STATUS */ static QDF_STATUS dp_get_htt_stats(struct cdp_soc_t *soc, uint8_t pdev_id, void *data, @@ -10651,7 +10448,7 @@ dp_get_htt_stats(struct cdp_soc_t *soc, uint8_t pdev_id, void *data, } /** - * dp_set_pdev_tidmap_prty_wifi3(): update tidmap priority in pdev + * dp_set_pdev_tidmap_prty_wifi3() - update tidmap priority in pdev * @pdev: DP_PDEV handle * @prio: tidmap priority value passed by the user * @@ -10668,13 +10465,13 @@ static QDF_STATUS dp_set_pdev_tidmap_prty_wifi3(struct dp_pdev *pdev, return QDF_STATUS_SUCCESS; } -/* +/** * dp_get_peer_param: function to get parameters in peer * @cdp_soc: DP soc handle * @vdev_id: id of vdev handle * @peer_mac: peer mac address * @param: parameter type to be set - * @val : address of buffer + * @val: address of buffer * * Return: val */ @@ -10686,7 +10483,7 @@ static QDF_STATUS dp_get_peer_param(struct cdp_soc_t *cdp_soc, uint8_t vdev_id, return QDF_STATUS_SUCCESS; } -/* +/** * dp_set_peer_param: function to set parameters in peer * @cdp_soc: DP soc handle * @vdev_id: id of vdev handle @@ -10735,12 +10532,12 @@ static QDF_STATUS dp_set_peer_param(struct cdp_soc_t *cdp_soc, uint8_t vdev_id, return QDF_STATUS_SUCCESS; } -/* - * dp_get_pdev_param: function to get parameters from pdev +/** + * dp_get_pdev_param() - function to get parameters from pdev * @cdp_soc: DP soc handle * @pdev_id: id of pdev handle * @param: parameter type to be get - * @value : buffer for value + * @val: buffer for value * * Return: status */ @@ -10789,8 +10586,8 @@ static QDF_STATUS dp_get_pdev_param(struct cdp_soc_t *cdp_soc, uint8_t pdev_id, return QDF_STATUS_SUCCESS; } -/* - * dp_set_pdev_param: function to set parameters in pdev +/** + * dp_set_pdev_param() - function to set parameters in pdev * @cdp_soc: DP soc handle * @pdev_id: id of pdev handle * @param: parameter type to be set @@ -10990,8 +10787,8 @@ static inline void dp_rx_update_peer_delay_stats(struct dp_soc *soc, } #endif -/* - * dp_calculate_delay_stats: function to get rx delay stats +/** + * dp_calculate_delay_stats() - function to get rx delay stats * @cdp_soc: DP soc handle * @vdev_id: id of DP vdev handle * @nbuf: skb @@ -11298,13 +11095,13 @@ dp_set_vdev_param(struct cdp_soc_t *cdp_soc, uint8_t vdev_id, return QDF_STATUS_SUCCESS; } -/* +/** * dp_set_psoc_param: function to set parameters in psoc - * @cdp_soc : DP soc handle + * @cdp_soc: DP soc handle * @param: parameter type to be set * @val: value of parameter to be set * - * return: QDF_STATUS + * Return: QDF_STATUS */ static QDF_STATUS dp_set_psoc_param(struct cdp_soc_t *cdp_soc, @@ -11373,13 +11170,13 @@ dp_set_psoc_param(struct cdp_soc_t *cdp_soc, return QDF_STATUS_SUCCESS; } -/* +/** * dp_get_psoc_param: function to get parameters in soc - * @cdp_soc : DP soc handle + * @cdp_soc: DP soc handle * @param: parameter type to be set * @val: address of buffer * - * return: status + * Return: status */ static QDF_STATUS dp_get_psoc_param(struct cdp_soc_t *cdp_soc, enum cdp_psoc_param_type param, @@ -11414,9 +11211,9 @@ static QDF_STATUS dp_get_psoc_param(struct cdp_soc_t *cdp_soc, return QDF_STATUS_SUCCESS; } -/* - * dp_set_vdev_dscp_tid_map_wifi3(): Update Map ID selected for particular vdev - * @soc: DP_SOC handle +/** + * dp_set_vdev_dscp_tid_map_wifi3() - Update Map ID selected for particular vdev + * @cdp_soc: CDP SOC handle * @vdev_id: id of DP_VDEV handle * @map_id:ID of map that needs to be updated * @@ -11437,7 +11234,7 @@ static QDF_STATUS dp_set_vdev_dscp_tid_map_wifi3(ol_txrx_soc_handle cdp_soc, vdev, CDP_UPDATE_DSCP_TO_TID_MAP, val); - /* Updatr flag for transmit tid classification */ + /* Update flag for transmit tid classification */ if (vdev->dscp_tid_map_id < soc->num_hw_dscp_tid_map) vdev->skip_sw_tid_classification |= DP_TX_HW_DSCP_TID_MAP_VALID; @@ -11471,12 +11268,13 @@ static int dp_txrx_get_ratekbps(int preamb, int mcs, } #endif -/* dp_txrx_get_pdev_stats - Returns cdp_pdev_stats +/** + * dp_txrx_get_pdev_stats() - Returns cdp_pdev_stats * @soc: DP soc handle * @pdev_id: id of DP pdev handle * @pdev_stats: buffer to copy to * - * return : status success/failure + * Return: status success/failure */ static QDF_STATUS dp_txrx_get_pdev_stats(struct cdp_soc_t *soc, uint8_t pdev_id, @@ -11494,11 +11292,12 @@ dp_txrx_get_pdev_stats(struct cdp_soc_t *soc, uint8_t pdev_id, return QDF_STATUS_SUCCESS; } -/* dp_txrx_update_vdev_me_stats(): Update vdev ME stats sent from CDP +/** + * dp_txrx_update_vdev_me_stats() - Update vdev ME stats sent from CDP * @vdev: DP vdev handle * @buf: buffer containing specific stats structure * - * Returns: void + * Return: void */ static void dp_txrx_update_vdev_me_stats(struct dp_vdev *vdev, void *buf) @@ -11528,11 +11327,12 @@ static void dp_txrx_update_vdev_me_stats(struct dp_vdev *vdev, host_stats->mcast_en.clone_fail); } -/* dp_txrx_update_vdev_igmp_me_stats(): Update vdev IGMP ME stats sent from CDP +/** + * dp_txrx_update_vdev_igmp_me_stats() - Update vdev IGMP ME stats sent from CDP * @vdev: DP vdev handle * @buf: buffer containing specific stats structure * - * Returns: void + * Return: void */ static void dp_txrx_update_vdev_igmp_me_stats(struct dp_vdev *vdev, void *buf) @@ -11551,13 +11351,14 @@ static void dp_txrx_update_vdev_igmp_me_stats(struct dp_vdev *vdev, host_stats->igmp_mcast_en.igmp_ucast_converted); } -/* dp_txrx_update_vdev_host_stats(): Update stats sent through CDP - * @soc: DP soc handle +/** + * dp_txrx_update_vdev_host_stats() - Update stats sent through CDP + * @soc_hdl: DP soc handle * @vdev_id: id of DP vdev handle * @buf: buffer containing specific stats structure * @stats_id: stats type * - * Returns: QDF_STATUS + * Return: QDF_STATUS */ static QDF_STATUS dp_txrx_update_vdev_host_stats(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, @@ -11589,12 +11390,14 @@ static QDF_STATUS dp_txrx_update_vdev_host_stats(struct cdp_soc_t *soc_hdl, return QDF_STATUS_SUCCESS; } -/* dp_txrx_get_peer_stats - will return cdp_peer_stats +/** + * dp_txrx_get_peer_stats() - will return cdp_peer_stats * @soc: soc handle * @vdev_id: id of vdev handle * @peer_mac: mac of DP_PEER handle * @peer_stats: buffer to copy to - * return : status success/failure + * + * Return: status success/failure */ static QDF_STATUS dp_txrx_get_peer_stats(struct cdp_soc_t *soc, uint8_t vdev_id, @@ -11621,13 +11424,15 @@ dp_txrx_get_peer_stats(struct cdp_soc_t *soc, uint8_t vdev_id, return QDF_STATUS_SUCCESS; } -/* dp_txrx_get_peer_stats_param - will return specified cdp_peer_stats - * @param soc - soc handle - * @param vdev_id - vdev_id of vdev object - * @param peer_mac - mac address of the peer - * @param type - enum of required stats - * @param buf - buffer to hold the value - * return : status success/failure +/** + * dp_txrx_get_peer_stats_param() - will return specified cdp_peer_stats + * @soc: soc handle + * @vdev_id: vdev_id of vdev object + * @peer_mac: mac address of the peer + * @type: enum of required stats + * @buf: buffer to hold the value + * + * Return: status success/failure */ static QDF_STATUS dp_txrx_get_peer_stats_param(struct cdp_soc_t *soc, uint8_t vdev_id, @@ -11666,12 +11471,13 @@ dp_txrx_get_peer_stats_param(struct cdp_soc_t *soc, uint8_t vdev_id, return ret; } -/* dp_txrx_reset_peer_stats - reset cdp_peer_stats for particular peer - * @soc: soc handle +/** + * dp_txrx_reset_peer_stats() - reset cdp_peer_stats for particular peer + * @soc_hdl: soc handle * @vdev_id: id of vdev handle * @peer_mac: mac of DP_PEER handle * - * return : QDF_STATUS + * Return: QDF_STATUS */ #ifdef WLAN_FEATURE_11BE_MLO static QDF_STATUS @@ -11739,11 +11545,14 @@ dp_txrx_reset_peer_stats(struct cdp_soc_t *soc, uint8_t vdev_id, } #endif -/* dp_txrx_get_vdev_stats - Update buffer with cdp_vdev_stats - * @vdev_handle: DP_VDEV handle +/** + * dp_txrx_get_vdev_stats() - Update buffer with cdp_vdev_stats + * @soc_hdl: CDP SoC handle + * @vdev_id: vdev Id * @buf: buffer for vdev stats + * @is_aggregate: are aggregate stats being collected * - * return : int + * Return: int */ static int dp_txrx_get_vdev_stats(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, void *buf, bool is_aggregate) @@ -11768,8 +11577,8 @@ static int dp_txrx_get_vdev_stats(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, return 0; } -/* - * dp_get_total_per(): get total per +/** + * dp_get_total_per() - get total per * @soc: DP soc handle * @pdev_id: id of DP_PDEV handle * @@ -11791,8 +11600,8 @@ static int dp_get_total_per(struct cdp_soc_t *soc, uint8_t pdev_id) ((pdev->stats.tx.tx_success.num) + (pdev->stats.tx.retries))); } -/* - * dp_txrx_stats_publish(): publish pdev stats into a buffer +/** + * dp_txrx_stats_publish() - publish pdev stats into a buffer * @soc: DP soc handle * @pdev_id: id of DP_PDEV handle * @buf: to hold pdev_stats @@ -11847,8 +11656,8 @@ dp_txrx_stats_publish(struct cdp_soc_t *soc, uint8_t pdev_id, return TXRX_STATS_LEVEL; } -/* - * dp_get_obss_stats(): Get Pdev OBSS stats from Fw +/** + * dp_get_obss_stats() - Get Pdev OBSS stats from Fw * @soc: DP soc handle * @pdev_id: id of DP_PDEV handle * @buf: to hold pdev obss stats @@ -11900,8 +11709,8 @@ dp_get_obss_stats(struct cdp_soc_t *soc, uint8_t pdev_id, return status; } -/* - * dp_clear_pdev_obss_pd_stats(): Clear pdev obss stats +/** + * dp_clear_pdev_obss_pd_stats() - Clear pdev obss stats * @soc: DP soc handle * @pdev_id: id of DP_PDEV handle * @req: Pointer to CDP TxRx stats request mac_id will be @@ -11941,8 +11750,8 @@ dp_clear_pdev_obss_pd_stats(struct cdp_soc_t *soc, uint8_t pdev_id, } /** - * dp_set_pdev_dscp_tid_map_wifi3(): update dscp tid map in pdev - * @soc: soc handle + * dp_set_pdev_dscp_tid_map_wifi3() - update dscp tid map in pdev + * @soc_handle: soc handle * @pdev_id: id of DP_PDEV handle * @map_id: ID of map that needs to be updated * @tos: index value in map @@ -11976,13 +11785,13 @@ dp_set_pdev_dscp_tid_map_wifi3(struct cdp_soc_t *soc_handle, } #ifdef WLAN_SYSFS_DP_STATS -/* - * dp_sysfs_event_trigger(): Trigger event to wait for firmware +/** + * dp_sysfs_event_trigger() - Trigger event to wait for firmware * stats request response. * @soc: soc handle * @cookie_val: cookie value * - * @Return: QDF_STATUS + * Return: QDF_STATUS */ static QDF_STATUS dp_sysfs_event_trigger(struct dp_soc *soc, uint32_t cookie_val) @@ -12008,14 +11817,6 @@ dp_sysfs_event_trigger(struct dp_soc *soc, uint32_t cookie_val) return status; } #else /* WLAN_SYSFS_DP_STATS */ -/* - * dp_sysfs_event_trigger(): Trigger event to wait for firmware - * stats request response. - * @soc: soc handle - * @cookie_val: cookie value - * - * @Return: QDF_STATUS - */ static QDF_STATUS dp_sysfs_event_trigger(struct dp_soc *soc, uint32_t cookie_val) { @@ -12024,11 +11825,11 @@ dp_sysfs_event_trigger(struct dp_soc *soc, uint32_t cookie_val) #endif /* WLAN_SYSFS_DP_STATS */ /** - * dp_fw_stats_process(): Process TXRX FW stats request. - * @vdev_handle: DP VDEV handle + * dp_fw_stats_process() - Process TXRX FW stats request. + * @vdev: DP VDEV handle * @req: stats request * - * return: QDF_STATUS + * Return: QDF_STATUS */ static QDF_STATUS dp_fw_stats_process(struct dp_vdev *vdev, @@ -12099,7 +11900,7 @@ dp_fw_stats_process(struct dp_vdev *vdev, /** * dp_txrx_stats_request - function to map to firmware and host stats - * @soc: soc handle + * @soc_handle: soc handle * @vdev_id: virtual device ID * @req: stats request * @@ -12174,9 +11975,11 @@ fail0: return status; } -/* +/** * dp_txrx_dump_stats() - Dump statistics - * @value - Statistics option + * @psoc: CDP soc handle + * @value: Statistics option + * @level: verbosity level */ static QDF_STATUS dp_txrx_dump_stats(struct cdp_soc_t *psoc, uint16_t value, enum qdf_stats_verbosity_level level) @@ -12452,8 +12255,9 @@ QDF_STATUS dp_sysfs_initialize_stats(struct dp_soc *soc_hdl) /** * dp_txrx_clear_dump_stats() - clear dumpStats - * @soc- soc handle - * @value - stats option + * @soc_hdl: soc handle + * @pdev_id: pdev ID + * @value: stats option * * Return: 0 - Success, non-zero - failure */ @@ -12491,7 +12295,7 @@ QDF_STATUS dp_txrx_clear_dump_stats(struct cdp_soc_t *soc_hdl, uint8_t pdev_id, * dp_update_flow_control_parameters() - API to store datapath * config parameters * @soc: soc handle - * @cfg: ini parameter handle + * @params: ini parameter handle * * Return: void */ @@ -12573,8 +12377,8 @@ void dp_update_soft_irq_limits(struct dp_soc *soc, uint32_t tx_limit, /** * dp_update_config_parameters() - API to store datapath * config parameters - * @soc: soc handle - * @cfg: ini parameter handle + * @psoc: soc handle + * @params: ini parameter handle * * Return: status */ @@ -12616,11 +12420,11 @@ static struct cdp_wds_ops dp_ops_wds = { #endif }; -/* - * dp_txrx_data_tx_cb_set(): set the callback for non standard tx - * @soc_hdl - datapath soc handle - * @vdev_id - virtual interface id - * @callback - callback function +/** + * dp_txrx_data_tx_cb_set() - set the callback for non standard tx + * @soc_hdl: datapath soc handle + * @vdev_id: virtual interface id + * @callback: callback function * @ctxt: callback context * */ @@ -12683,7 +12487,7 @@ dp_pdev_set_dp_txrx_handle(struct cdp_soc_t *soc, uint8_t pdev_id, /** * dp_vdev_get_dp_ext_handle() - get dp handle from vdev - * @soc: datapath soc handle + * @soc_hdl: datapath soc handle * @vdev_id: vdev id * * Return: opaque pointer to dp txrx handle @@ -12706,7 +12510,7 @@ static void *dp_vdev_get_dp_ext_handle(ol_txrx_soc_handle soc_hdl, /** * dp_vdev_set_dp_ext_handle() - set dp handle in vdev - * @soc: datapath soc handle + * @soc_hdl: datapath soc handle * @vdev_id: vdev id * @size: size of advance dp handle * @@ -12744,7 +12548,7 @@ dp_vdev_set_dp_ext_handle(ol_txrx_soc_handle soc_hdl, uint8_t vdev_id, * @vdev_id: vdev ID * @action: Add/Delete action * - * Returns: QDF_STATUS. + * Return: QDF_STATUS. */ static QDF_STATUS dp_vdev_inform_ll_conn(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, @@ -12783,7 +12587,7 @@ dp_vdev_inform_ll_conn(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, * @soc_hdl: CDP Soc handle * @value: Enable/Disable value * - * Returns: QDF_STATUS + * Return: QDF_STATUS */ static QDF_STATUS dp_soc_set_swlm_enable(struct cdp_soc_t *soc_hdl, uint8_t value) @@ -12804,7 +12608,7 @@ static QDF_STATUS dp_soc_set_swlm_enable(struct cdp_soc_t *soc_hdl, * dp_soc_is_swlm_enabled() - Check if SWLM is enabled. * @soc_hdl: CDP Soc handle * - * Returns: QDF_STATUS + * Return: QDF_STATUS */ static uint8_t dp_soc_is_swlm_enabled(struct cdp_soc_t *soc_hdl) { @@ -13067,11 +12871,11 @@ dp_dump_pdev_rx_protocol_tag_stats(struct cdp_soc_t *soc, uint8_t pdev_id, #ifndef WLAN_SUPPORT_RX_PROTOCOL_TYPE_TAG /** - * dp_update_pdev_rx_protocol_tag - Add/remove a protocol tag that should be + * dp_update_pdev_rx_protocol_tag() - Add/remove a protocol tag that should be * applied to the desired protocol type packets * @soc: soc handle * @pdev_id: id of cdp_pdev handle - * @enable_rx_protocol_tag - bitmask that indicates what protocol types + * @enable_rx_protocol_tag: bitmask that indicates what protocol types * are enabled for tagging. zero indicates disable feature, non-zero indicates * enable feature * @protocol_type: new protocol type for which the tag is being added @@ -13091,8 +12895,8 @@ dp_update_pdev_rx_protocol_tag(struct cdp_soc_t *soc, uint8_t pdev_id, #ifndef WLAN_SUPPORT_RX_FLOW_TAG /** - * dp_set_rx_flow_tag - add/delete a flow - * @soc: soc handle + * dp_set_rx_flow_tag() - add/delete a flow + * @cdp_soc: CDP soc handle * @pdev_id: id of cdp_pdev handle * @flow_info: flow tuple that is to be added to/deleted from flow search table * @@ -13105,7 +12909,7 @@ dp_set_rx_flow_tag(struct cdp_soc_t *cdp_soc, uint8_t pdev_id, return QDF_STATUS_SUCCESS; } /** - * dp_dump_rx_flow_tag_stats - dump the number of packets tagged for + * dp_dump_rx_flow_tag_stats() - dump the number of packets tagged for * given flow 5-tuple * @cdp_soc: soc handle * @pdev_id: id of cdp_pdev handle @@ -13217,7 +13021,7 @@ static void dp_soc_set_rate_stats_ctx(struct cdp_soc_t *soc_handle, #if defined(FEATURE_PERPKT_INFO) && WDI_EVENT_ENABLE /** - * dp_peer_flush_rate_stats_req(): Flush peer rate stats + * dp_peer_flush_rate_stats_req() - Flush peer rate stats * @soc: Datapath SOC handle * @peer: Datapath peer * @arg: argument to iter function @@ -13239,7 +13043,7 @@ dp_peer_flush_rate_stats_req(struct dp_soc *soc, struct dp_peer *peer, } /** - * dp_flush_rate_stats_req(): Flush peer rate stats in pdev + * dp_flush_rate_stats_req() - Flush peer rate stats in pdev * @soc_hdl: Datapath SOC handle * @pdev_id: pdev_id * @@ -13272,7 +13076,7 @@ dp_flush_rate_stats_req(struct cdp_soc_t *soc_hdl, #if defined(FEATURE_PERPKT_INFO) && WDI_EVENT_ENABLE #ifdef WLAN_FEATURE_11BE_MLO /** - * dp_get_peer_extd_rate_link_stats(): function to get peer + * dp_get_peer_extd_rate_link_stats() - function to get peer * extended rate and link stats * @soc_hdl: dp soc handler * @mac_addr: mac address of peer @@ -13420,7 +13224,7 @@ static void *dp_soc_get_rate_stats_ctx(struct cdp_soc_t *soc_handle) return soc->rate_stats_ctx; } -/* +/** * dp_get_cfg() - get dp cfg * @soc: cdp soc handle * @cfg: cfg enum @@ -13567,7 +13371,7 @@ static uint32_t dp_tx_flow_ctrl_configure_pdev(struct cdp_soc_t *soc_handle, #endif /** - * dp_set_pdev_pcp_tid_map_wifi3(): update pcp tid map in pdev + * dp_set_pdev_pcp_tid_map_wifi3() - update pcp tid map in pdev * @psoc: dp soc handle * @pdev_id: id of DP_PDEV handle * @pcp: pcp value @@ -13588,8 +13392,8 @@ static QDF_STATUS dp_set_pdev_pcp_tid_map_wifi3(ol_txrx_soc_handle psoc, } /** - * dp_set_vdev_pcp_tid_map_wifi3(): update pcp tid map in vdev - * @soc: DP soc handle + * dp_set_vdev_pcp_tid_map_wifi3() - update pcp tid map in vdev + * @soc_hdl: DP soc handle * @vdev_id: id of DP_VDEV handle * @pcp: pcp value * @tid: tid value passed by the user @@ -13649,7 +13453,7 @@ static void dp_drain_txrx(struct cdp_soc_t *soc_handle) #ifdef DP_UMAC_HW_RESET_SUPPORT /** - * dp_reset_interrupt_ring_masks(): Reset rx interrupt masks + * dp_reset_interrupt_ring_masks() - Reset rx interrupt masks * @soc: dp soc handle * * Return: void @@ -13699,7 +13503,7 @@ static void dp_reset_interrupt_ring_masks(struct dp_soc *soc) } /** - * dp_restore_interrupt_ring_masks(): Restore rx interrupt masks + * dp_restore_interrupt_ring_masks() - Restore rx interrupt masks * @soc: dp soc handle * * Return: void @@ -13737,7 +13541,7 @@ static void dp_restore_interrupt_ring_masks(struct dp_soc *soc) } /** - * dp_resume_tx_hardstart(): Restore the old Tx hardstart functions + * dp_resume_tx_hardstart() - Restore the old Tx hardstart functions * @soc: dp soc handle * * Return: void @@ -13767,7 +13571,7 @@ static void dp_resume_tx_hardstart(struct dp_soc *soc) } /** - * dp_pause_tx_hardstart(): Register Tx hardstart functions to drop packets + * dp_pause_tx_hardstart() - Register Tx hardstart functions to drop packets * @soc: dp soc handle * * Return: void @@ -13800,7 +13604,7 @@ static void dp_pause_tx_hardstart(struct dp_soc *soc) } /** - * dp_unregister_notify_umac_pre_reset_fw_callback(): unregister notify_fw_cb + * dp_unregister_notify_umac_pre_reset_fw_callback() - unregister notify_fw_cb * @soc: dp soc handle * * Return: void @@ -13812,7 +13616,7 @@ void dp_unregister_notify_umac_pre_reset_fw_callback(struct dp_soc *soc) } /** - * dp_check_n_notify_umac_prereset_done(): Send pre reset done to firmware + * dp_check_n_notify_umac_prereset_done() - Send pre reset done to firmware * @soc: dp soc handle * * Return: void @@ -13833,7 +13637,7 @@ void dp_check_n_notify_umac_prereset_done(struct dp_soc *soc) } /** - * dp_register_notify_umac_pre_reset_fw_callback(): register notify_fw_cb + * dp_register_notify_umac_pre_reset_fw_callback() - register notify_fw_cb * @soc: dp soc handle * * Return: void @@ -13846,7 +13650,7 @@ void dp_register_notify_umac_pre_reset_fw_callback(struct dp_soc *soc) #ifdef DP_UMAC_HW_HARD_RESET /** - * dp_set_umac_regs(): Reinitialize host umac registers + * dp_set_umac_regs() - Reinitialize host umac registers * @soc: dp soc handle * * Return: void @@ -13900,7 +13704,7 @@ static void dp_set_umac_regs(struct dp_soc *soc) #endif /** - * dp_reinit_rings(): Reinitialize host managed rings + * dp_reinit_rings() - Reinitialize host managed rings * @soc: dp soc handle * * Return: QDF_STATUS @@ -13925,7 +13729,7 @@ static void dp_reinit_rings(struct dp_soc *soc) } /** - * dp_umac_reset_handle_pre_reset(): Handle Umac prereset interrupt from FW + * dp_umac_reset_handle_pre_reset() - Handle Umac prereset interrupt from FW * @soc: dp soc handle * * Return: QDF_STATUS @@ -13945,7 +13749,7 @@ static QDF_STATUS dp_umac_reset_handle_pre_reset(struct dp_soc *soc) } /** - * dp_umac_reset_handle_post_reset(): Handle Umac postreset interrupt from FW + * dp_umac_reset_handle_post_reset() - Handle Umac postreset interrupt from FW * @soc: dp soc handle * * Return: QDF_STATUS @@ -13973,7 +13777,7 @@ static QDF_STATUS dp_umac_reset_handle_post_reset(struct dp_soc *soc) } /** - * dp_umac_reset_handle_post_reset_complete(): Handle Umac postreset_complete + * dp_umac_reset_handle_post_reset_complete() - Handle Umac postreset_complete * interrupt from FW * @soc: dp soc handle * @@ -14027,8 +13831,8 @@ dp_set_pkt_capture_mode(struct cdp_soc_t *soc_handle, bool val) #ifdef HW_TX_DELAY_STATS_ENABLE /** - * dp_enable_disable_vdev_tx_delay_stats(): Start/Stop tx delay stats capture - * @soc: DP soc handle + * dp_enable_disable_vdev_tx_delay_stats() - Start/Stop tx delay stats capture + * @soc_hdl: DP soc handle * @vdev_id: vdev id * @value: value * @@ -14053,10 +13857,10 @@ dp_enable_disable_vdev_tx_delay_stats(struct cdp_soc_t *soc_hdl, /** * dp_check_vdev_tx_delay_stats_enabled() - check the feature is enabled or not - * @soc: DP soc handle + * @soc_hdl: DP soc handle * @vdev_id: vdev id * - * Returns: 1 if enabled, 0 if disabled + * Return: 1 if enabled, 0 if disabled */ static uint8_t dp_check_vdev_tx_delay_stats_enabled(struct cdp_soc_t *soc_hdl, @@ -14098,7 +13902,8 @@ dp_recovery_vdev_flush_peers(struct cdp_soc_t *cdp_soc, #ifdef QCA_GET_TSF_VIA_REG /** * dp_get_tsf_time() - get tsf time - * @soc: Datapath soc handle + * @soc_hdl: Datapath soc handle + * @tsf_id: TSF identifier * @mac_id: mac_id * @tsf: pointer to update tsf value * @tsf_sync_soc_time: pointer to update tsf sync time @@ -14122,7 +13927,7 @@ dp_get_tsf_time(struct cdp_soc_t *soc_hdl, uint32_t tsf_id, uint32_t mac_id, /** * dp_get_tsf2_scratch_reg() - get tsf2 offset from the scratch register - * @soc: Datapath soc handle + * @soc_hdl: Datapath soc handle * @mac_id: mac_id * @value: pointer to update tsf2 offset value * @@ -14137,7 +13942,7 @@ dp_get_tsf2_scratch_reg(struct cdp_soc_t *soc_hdl, uint8_t mac_id, /** * dp_get_tqm_scratch_reg() - get tqm offset from the scratch register - * @soc: Datapath soc handle + * @soc_hdl: Datapath soc handle * @value: pointer to update tqm offset value * * Return: None. @@ -14472,7 +14277,8 @@ static struct cdp_sawf_ops dp_ops_sawf = { * dp_flush_ring_hptp() - Update ring shadow * register HP/TP address when runtime * resume - * @opaque_soc: DP soc context + * @soc: DP soc context + * @hal_srng: srng * * Return: None */ @@ -14542,7 +14348,7 @@ static bool dp_tx_comp_delay_check(struct dp_tx_desc_s *tx_desc) /** * dp_find_missing_tx_comp() - check for leaked descriptor in tx path - * @soc - DP SOC context + * @soc: DP SOC context * * Parse through descriptors in all pools and validate magic number and * completion time. Trigger self recovery if magic value is corrupted. @@ -14707,7 +14513,7 @@ static QDF_STATUS dp_runtime_resume(struct cdp_soc_t *soc_hdl, uint8_t pdev_id) /** * dp_tx_get_success_ack_stats() - get tx success completion count * @soc_hdl: Datapath soc handle - * @vdevid: vdev identifier + * @vdev_id: vdev identifier * * Return: tx success ack count */ @@ -14844,7 +14650,7 @@ dp_txrx_post_data_stall_event(struct cdp_soc_t *soc_hdl, /* rx hw stats event wait timeout in ms */ #define DP_REO_STATUS_STATS_TIMEOUT 850 /** - * dp_txrx_ext_stats_request - request dp txrx extended stats request + * dp_txrx_ext_stats_request() - request dp txrx extended stats request * @soc_hdl: soc handle * @pdev_id: pdev id * @req: stats request @@ -14896,7 +14702,7 @@ dp_txrx_ext_stats_request(struct cdp_soc_t *soc_hdl, uint8_t pdev_id, } /** - * dp_rx_hw_stats_cb - request rx hw stats response callback + * dp_rx_hw_stats_cb() - request rx hw stats response callback * @soc: soc handle * @cb_ctxt: callback context * @reo_status: reo command response status @@ -14939,7 +14745,7 @@ static void dp_rx_hw_stats_cb(struct dp_soc *soc, void *cb_ctxt, } /** - * dp_request_rx_hw_stats - request rx hardware stats + * dp_request_rx_hw_stats() - request rx hardware stats * @soc_hdl: soc handle * @vdev_id: vdev id * @@ -15015,7 +14821,7 @@ dp_request_rx_hw_stats(struct cdp_soc_t *soc_hdl, uint8_t vdev_id) &rx_hw_stats->pending_tid_stats_cnt)); if (soc->is_last_stats_ctx_init) rx_hw_stats->is_query_timeout = true; - /** + /* * If query timeout happened, use the last saved stats * for this time query. */ @@ -15037,7 +14843,7 @@ out: } /** - * dp_reset_rx_hw_ext_stats - Reset rx hardware ext stats + * dp_reset_rx_hw_ext_stats() - Reset rx hardware ext stats * @soc_hdl: soc handle * * Return: None @@ -15511,12 +15317,6 @@ static void dp_soc_txrx_ops_attach(struct dp_soc *soc) #endif }; -/* - * dp_soc_set_txrx_ring_map() - * @dp_soc: DP handler for soc - * - * Return: Void - */ void dp_soc_set_txrx_ring_map(struct dp_soc *soc) { uint32_t i; @@ -15731,14 +15531,14 @@ fail0: /** * dp_soc_init() - Initialize txrx SOC - * @dp_soc: Opaque DP SOC handle + * @soc: Opaque DP SOC handle * @htc_handle: Opaque HTC handle * @hif_handle: Opaque HIF handle * * Return: DP SOC handle on success, NULL on failure */ -void *dp_soc_init(struct dp_soc *soc, HTC_HANDLE htc_handle, - struct hif_opaque_softc *hif_handle) +static void *dp_soc_init(struct dp_soc *soc, HTC_HANDLE htc_handle, + struct hif_opaque_softc *hif_handle) { struct htt_soc *htt_soc = (struct htt_soc *)soc->htt_handle; bool is_monitor_mode = false; @@ -15940,18 +15740,6 @@ fail0: return NULL; } -/** - * dp_soc_init_wifi3() - Initialize txrx SOC - * @soc: Opaque DP SOC handle - * @ctrl_psoc: Opaque SOC handle from control plane(Unused) - * @hif_handle: Opaque HIF handle - * @htc_handle: Opaque HTC handle - * @qdf_osdev: QDF device (Unused) - * @ol_ops: Offload Operations (Unused) - * @device_id: Device ID (Unused) - * - * Return: DP SOC handle on success, NULL on failure - */ void *dp_soc_init_wifi3(struct cdp_soc_t *soc, struct cdp_ctrl_objmgr_psoc *ctrl_psoc, struct hif_opaque_softc *hif_handle, @@ -15963,14 +15751,6 @@ void *dp_soc_init_wifi3(struct cdp_soc_t *soc, #endif -/* - * dp_get_pdev_for_mac_id() - Return pdev for mac_id - * - * @soc: handle to DP soc - * @mac_id: MAC id - * - * Return: Return pdev corresponding to MAC - */ void *dp_get_pdev_for_mac_id(struct dp_soc *soc, uint32_t mac_id) { if (wlan_cfg_per_pdev_lmac_ring(soc->wlan_cfg_ctx)) @@ -16042,7 +15822,7 @@ void dp_set_cfr_rcc(struct cdp_soc_t *soc_hdl, uint8_t pdev_id, bool enable) pdev->cfr_rcc_mode = enable; } -/* +/** * dp_get_cfr_dbg_stats - Get the debug statistics for CFR * @soc_hdl: Datapath soc handle * @pdev_id: id of data path pdev handle @@ -16066,7 +15846,7 @@ dp_get_cfr_dbg_stats(struct cdp_soc_t *soc_hdl, uint8_t pdev_id, sizeof(struct cdp_cfr_rcc_stats)); } -/* +/** * dp_clear_cfr_dbg_stats - Clear debug statistics for CFR * @soc_hdl: Datapath soc handle * @pdev_id: id of data path pdev handle @@ -16267,16 +16047,6 @@ void dp_update_delay_stats(struct cdp_tid_tx_stats *tstats, } } -/** - * dp_get_peer_mac_list(): function to get peer mac list of vdev - * @soc: Datapath soc handle - * @vdev_id: vdev id - * @newmac: Table of the clients mac - * @mac_cnt: No. of MACs required - * @limit: Limit the number of clients - * - * return: no of clients - */ uint16_t dp_get_peer_mac_list(ol_txrx_soc_handle soc, uint8_t vdev_id, u_int8_t newmac[][QDF_MAC_ADDR_SIZE], u_int16_t mac_cnt, bool limit) @@ -16413,7 +16183,7 @@ static void dp_pdev_srng_deinit(struct dp_pdev *pdev) * monitor rings * @pdev: Datapath pdev handle * - * return: QDF_STATUS_SUCCESS on success + * Return: QDF_STATUS_SUCCESS on success * QDF_STATUS_E_NOMEM on failure */ static QDF_STATUS dp_pdev_srng_init(struct dp_pdev *pdev) @@ -16472,7 +16242,7 @@ fail1: /** * dp_pdev_srng_free() - free all pdev srng rings including monitor rings - * pdev: Datapath pdev handle + * @pdev: Datapath pdev handle * */ static void dp_pdev_srng_free(struct dp_pdev *pdev) @@ -16497,9 +16267,9 @@ static void dp_pdev_srng_free(struct dp_pdev *pdev) /** * dp_pdev_srng_alloc() - allocate memory for all pdev srng rings including * monitor rings - * pdev: Datapath pdev handle + * @pdev: Datapath pdev handle * - * return: QDF_STATUS_SUCCESS on success + * Return: QDF_STATUS_SUCCESS on success * QDF_STATUS_E_NOMEM on failure */ static QDF_STATUS dp_pdev_srng_alloc(struct dp_pdev *pdev) @@ -16787,7 +16557,7 @@ static void dp_soc_srng_deinit(struct dp_soc *soc) * dp_soc_srng_init() - Initialize soc level srng rings * @soc: Datapath soc handle * - * return: QDF_STATUS_SUCCESS on success + * Return: QDF_STATUS_SUCCESS on success * QDF_STATUS_E_FAILURE on failure */ static QDF_STATUS dp_soc_srng_init(struct dp_soc *soc) @@ -16978,7 +16748,7 @@ static void dp_soc_srng_free(struct dp_soc *soc) * dp_soc_srng_alloc() - Allocate memory for soc level srng rings * @soc: Datapath soc handle * - * return: QDF_STATUS_SUCCESS on success + * Return: QDF_STATUS_SUCCESS on success * QDF_STATUS_E_NOMEM on failure */ static QDF_STATUS dp_soc_srng_alloc(struct dp_soc *soc) @@ -17518,11 +17288,12 @@ fail0: return QDF_STATUS_E_FAILURE; } -/* +/** * dp_pdev_init_wifi3() - Init txrx pdev + * @txrx_soc: * @htc_handle: HTC handle for host-target interface * @qdf_osdev: QDF OS device - * @force: Force deinit + * @pdev_id: pdev Id * * Return: QDF_STATUS */