diff --git a/htc/htc.c b/htc/htc.c index 391f06f975..4c13703c89 100644 --- a/htc/htc.c +++ b/htc/htc.c @@ -1,6 +1,6 @@ /* * Copyright (c) 2013-2021 The Linux Foundation. All rights reserved. - * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved. + * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved. * * Permission to use, copy, modify, and/or distribute this software for * any purpose with or without fee is hereby granted, provided that the @@ -257,6 +257,7 @@ static void htc_cleanup(HTC_TARGET *target) #ifdef FEATURE_RUNTIME_PM /** * htc_runtime_pm_init(): runtime pm related initialization + * @target: HTC target * * need to initialize a work item. */ @@ -1169,7 +1170,7 @@ void *htc_get_targetdef(HTC_HANDLE htc_handle) /** * htc_ipa_get_ce_resource() - get uc resource on lower layer * @htc_handle: htc context - * @ce_sr_base_paddr: copyengine source ring base physical address + * @ce_sr: copyengine source ring base physical address * @ce_sr_ring_size: copyengine source ring size * @ce_reg_paddr: copyengine register physical address * diff --git a/htc/htc_api.h b/htc/htc_api.h index 7886a5ec1f..7ad6bbcfd5 100644 --- a/htc/htc_api.h +++ b/htc/htc_api.h @@ -1,6 +1,6 @@ /* * Copyright (c) 2013-2014, 2016-2021 The Linux Foundation. All rights reserved. - * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved. + * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved. * * Permission to use, copy, modify, and/or distribute this software for * any purpose with or without fee is hereby granted, provided that the @@ -390,7 +390,7 @@ struct htc_endpoint_stats { }; /** - * htc_link_vote_user_id - user ids for each link vote type + * enum htc_link_vote_user_id - user ids for each link vote type * @HTC_LINK_VOTE_INVALID_MIN_USER_ID: min user id * @HTC_LINK_VOTE_SAP_USER_ID: sap user id * @HTC_LINK_VOTE_GO_USER_ID: go user id @@ -411,7 +411,7 @@ enum htc_link_vote_user_id { /* ------ Function Prototypes ------ */ /** - * htc_create - Create an instance of HTC over the underlying HIF device + * htc_create() - Create an instance of HTC over the underlying HIF device * @HifDevice: hif device handle, * @pInfo: initialization information * @osdev: QDF device structure @@ -423,7 +423,7 @@ HTC_HANDLE htc_create(void *HifDevice, struct htc_init_info *pInfo, qdf_device_t osdev, uint32_t con_mode); /** - * htc_get_hif_device - Get the underlying HIF device handle + * htc_get_hif_device() - Get the underlying HIF device handle * @HTCHandle: handle passed into the AddInstance callback * * Return: opaque HIF device handle usable in HIF API calls. @@ -431,19 +431,22 @@ HTC_HANDLE htc_create(void *HifDevice, struct htc_init_info *pInfo, void *htc_get_hif_device(HTC_HANDLE HTCHandle); /** - * htc_set_credit_distribution - Set credit distribution parameters + * htc_set_credit_distribution() - Set credit distribution parameters * @HTCHandle: HTC handle - * @pCreditDistCont: caller supplied context to pass into distribution functions + * @pCreditDistContext: caller supplied context to pass into distribution + * functions * @CreditDistFunc: Distribution function callback - * @CreditDistInit: Credit Distribution initialization callback + * @CreditInitFunc: Credit Distribution initialization callback * @ServicePriorityOrder: Array containing list of service IDs, lowest index - * @is highestpriority: ListLength - number of elements in ServicePriorityOrder + * is highestpriority + * @ListLength: number of elements in ServicePriorityOrder * * The user can set a custom credit distribution function to handle * special requirementsfor each endpoint. A default credit distribution * routine can be used by setting CreditInitFunc to NULL. The default * credit distribution is only provided for simple "fair" credit distribution * without regard to any prioritization. + * * Return: None */ void htc_set_credit_distribution(HTC_HANDLE HTCHandle, @@ -453,21 +456,21 @@ void htc_set_credit_distribution(HTC_HANDLE HTCHandle, HTC_SERVICE_ID ServicePriorityOrder[], int ListLength); -/*+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - * Wait for the target to indicate the HTC layer is ready - * htc_wait_target - * @HTCHandle - HTC handle +/** + * htc_wait_target() - Wait for the target to indicate the HTC layer is ready + * @HTCHandle: HTC handle * * This API blocks until the target responds with an HTC ready message. * The caller should not connect services until the target has indicated it is * ready. + * * Return: None */ QDF_STATUS htc_wait_target(HTC_HANDLE HTCHandle); /** - * htc_start - Start target service communications - * @HTCHandle - HTC handle + * htc_start() - Start target service communications + * @HTCHandle: HTC handle * * This API indicates to the target that the service connection phase * is completeand the target can freely start all connected services. This @@ -480,10 +483,10 @@ QDF_STATUS htc_wait_target(HTC_HANDLE HTCHandle); QDF_STATUS htc_start(HTC_HANDLE HTCHandle); /** - * htc_connect_service - Connect to an HTC service - * @HTCHandle - HTC handle - * @pReq - connection details - * @pResp - connection response + * htc_connect_service() - Connect to an HTC service + * @HTCHandle: HTC handle + * @pReq: connection details + * @pResp: connection response * * Service connections must be performed before htc_start. * User provides callback handlersfor various endpoint events. @@ -494,41 +497,47 @@ QDF_STATUS htc_connect_service(HTC_HANDLE HTCHandle, struct htc_service_connect_resp *pResp); /** - * htc_dump - HTC register log dump - * @HTCHandle - HTC handle - * @CmdId - Log command - * @start - start/print logs + * htc_dump() - HTC register log dump + * @HTCHandle: HTC handle + * @CmdId: Log command + * @start: start/print logs * * Register logs will be started/printed/ be flushed. + * * Return: None */ void htc_dump(HTC_HANDLE HTCHandle, uint8_t CmdId, bool start); /** - * htc_ce_taklet_debug_dump - Dump ce tasklet rings debug data - * @HTCHandle - HTC handle + * htc_ce_tasklet_debug_dump() - Dump ce tasklet rings debug data + * @htc_handle: HTC handle * * Debug logs will be printed. + * * Return: None */ void htc_ce_tasklet_debug_dump(HTC_HANDLE htc_handle); /** - * htc_send_pkt - Send an HTC packet - * @HTCHandle - HTC handle - * @pPacket - packet to send + * htc_send_pkt() - Send an HTC packet + * @HTCHandle: HTC handle + * @pPacket: packet to send * * Caller must initialize packet using SET_HTC_PACKET_INFO_TX() macro. * This interface is fully asynchronous. On error, HTC SendPkt will * call the registered Endpoint callback to cleanup the packet. + * * Return: QDF_STATUS_SUCCESS */ QDF_STATUS htc_send_pkt(HTC_HANDLE HTCHandle, HTC_PACKET *pPacket); +#ifdef ATH_11AC_TXCOMPACT /** - * htc_send_data_pkt - Send an HTC packet containing a tx descriptor and data - * @HTCHandle - HTC handle - * @pPacket - packet to send + * htc_send_data_pkt() - Send an HTC packet containing a tx descriptor and data + * @HTCHandle: HTC handle + * @netbuf: network buffer containing the packet to send + * @Epid: endpoint id + * @ActualLength: actual length of the packet * * Caller must initialize packet using SET_HTC_PACKET_INFO_TX() macro. * Caller must provide headroom in an initial fragment added to the @@ -536,20 +545,35 @@ QDF_STATUS htc_send_pkt(HTC_HANDLE HTCHandle, HTC_PACKET *pPacket); * This interface is fully asynchronous. On error, htc_send_data_pkt will * call the registered Endpoint EpDataTxComplete callback to cleanup * the packet. - * Return: A_OK + * + * Return: QDF_STATUS */ -#ifdef ATH_11AC_TXCOMPACT QDF_STATUS htc_send_data_pkt(HTC_HANDLE HTCHandle, qdf_nbuf_t netbuf, int Epid, int ActualLength); #else /*ATH_11AC_TXCOMPACT */ +/** + * htc_send_data_pkt() - Send an HTC packet containing a tx descriptor and data + * @HTCHandle: HTC handle + * @pPacket: packet to send + * @more_data: + * + * Caller must initialize packet using SET_HTC_PACKET_INFO_TX() macro. + * Caller must provide headroom in an initial fragment added to the + * network buffer to store a HTC_FRAME_HDR. + * This interface is fully asynchronous. On error, htc_send_data_pkt will + * call the registered Endpoint EpDataTxComplete callback to cleanup + * the packet. + * + * Return: QDF_STATUS + */ QDF_STATUS htc_send_data_pkt(HTC_HANDLE HTCHandle, HTC_PACKET *pPacket, uint8_t more_data); #endif /*ATH_11AC_TXCOMPACT */ /** - * htc_flush_surprise_remove - Flush HTC when target is removed surprisely + * htc_flush_surprise_remove() - Flush HTC when target is removed surprisely * service communications - * @HTCHandle - HTC handle + * @HTCHandle: HTC handle * * All receive and pending TX packets will be flushed. * Return: None @@ -557,8 +581,8 @@ QDF_STATUS htc_send_data_pkt(HTC_HANDLE HTCHandle, HTC_PACKET *pPacket, void htc_flush_surprise_remove(HTC_HANDLE HTCHandle); /** - * htc_stop - Stop HTC service communications - * @HTCHandle - HTC handle + * htc_stop() - Stop HTC service communications + * @HTCHandle: HTC handle * * HTC communications is halted. All receive and pending TX packets * will be flushed. @@ -567,8 +591,8 @@ void htc_flush_surprise_remove(HTC_HANDLE HTCHandle); void htc_stop(HTC_HANDLE HTCHandle); /** - * htc_destroy - Destroy HTC service - * @HTCHandle - HTC handle + * htc_destroy() - Destroy HTC service + * @HTCHandle: HTC handle * * This cleans up all resources allocated by htc_create(). * Return: None @@ -576,10 +600,10 @@ void htc_stop(HTC_HANDLE HTCHandle); void htc_destroy(HTC_HANDLE HTCHandle); /** - * htc_flush_endpoint - Flush pending TX packets - * @HTCHandle - HTC handle - * @Endpoint - Endpoint to flush - * @Tag - flush tag + * htc_flush_endpoint() - Flush pending TX packets + * @HTCHandle: HTC handle + * @Endpoint: Endpoint to flush + * @Tag: flush tag * * The Tag parameter is used to selectively flush packets with matching * tags. The value of 0 forces all packets to be flush regardless of tag @@ -588,8 +612,8 @@ void htc_destroy(HTC_HANDLE HTCHandle); void htc_flush_endpoint(HTC_HANDLE HTCHandle, HTC_ENDPOINT_ID Endpoint, HTC_TX_TAG Tag); /** - * htc_dump_credit_states - Dump credit distribution state - * @HTCHandle - HTC handle + * htc_dump_credit_states() - Dump credit distribution state + * @HTCHandle: HTC handle * * This dumps all credit distribution information to the debugger * Return: None @@ -597,11 +621,11 @@ void htc_flush_endpoint(HTC_HANDLE HTCHandle, HTC_ENDPOINT_ID Endpoint, void htc_dump_credit_states(HTC_HANDLE HTCHandle); /** - * htc_indicate_activity_change - Indicate a traffic activity change on an + * htc_indicate_activity_change() - Indicate a traffic activity change on an * endpoint - * @HTCHandle - HTC handle - * @Endpoint - endpoint in which activity has changed - * @Active - true if active, false if it has become inactive + * @HTCHandle: HTC handle + * @Endpoint: endpoint in which activity has changed + * @Active: true if active, false if it has become inactive * * This triggers the registered credit distribution function to * re-adjust credits for active/inactive endpoints. @@ -611,11 +635,11 @@ void htc_indicate_activity_change(HTC_HANDLE HTCHandle, HTC_ENDPOINT_ID Endpoint, bool Active); /** - * htc_get_endpoint_statistics - Get endpoint statistics - * @HTCHandle - HTC handle - * @Endpoint - Endpoint identifier - * @Action - action to take with statistics - * @pStats - statistics that were sampled (can be NULL if Action is + * htc_get_endpoint_statistics() - Get endpoint statistics + * @HTCHandle: HTC handle + * @Endpoint: Endpoint identifier + * @Action: action to take with statistics + * @pStats: statistics that were sampled (can be NULL if Action is * HTC_EP_STAT_CLEAR) * * Statistics is a compile-time option and this function may return @@ -636,8 +660,8 @@ bool htc_get_endpoint_statistics(HTC_HANDLE HTCHandle, struct htc_endpoint_stats *pStats); /** - * htc_unblock_recv - Unblock HTC message reception - * @HTCHandle - HTC handle + * htc_unblock_recv() - Unblock HTC message reception + * @HTCHandle: HTC handle * * HTC will block the receiver if the EpRecvAlloc callback fails to provide a * packet. The caller can use this API to indicate to HTC when resources @@ -650,9 +674,9 @@ bool htc_get_endpoint_statistics(HTC_HANDLE HTCHandle, void htc_unblock_recv(HTC_HANDLE HTCHandle); /** - * htc_add_receive_pkt_multiple - Add multiple receive packets to HTC - * @HTCHandle - HTC handle - * @pPktQueue - HTC receive packet queue holding packets to add + * htc_add_receive_pkt_multiple() - Add multiple receive packets to HTC + * @HTCHandle: HTC handle + * @pPktQueue: HTC receive packet queue holding packets to add * * User must supply HTC packets for capturing incoming HTC frames. * The caller mmust initialize each HTC packet using the @@ -668,9 +692,9 @@ A_STATUS htc_add_receive_pkt_multiple(HTC_HANDLE HTCHandle, HTC_PACKET_QUEUE *pPktQueue); /** - * htc_is_endpoint_active - Check if an endpoint is marked active - * @HTCHandle - HTC handle - * @Endpoint - endpoint to check for active state + * htc_is_endpoint_active() - Check if an endpoint is marked active + * @HTCHandle: HTC handle + * @Endpoint: endpoint to check for active state * * Return: returns true if Endpoint is Active */ @@ -678,18 +702,18 @@ bool htc_is_endpoint_active(HTC_HANDLE HTCHandle, HTC_ENDPOINT_ID Endpoint); /** - * htc_set_pkt_dbg - Set up debug flag for HTC packets - * @HTCHandle - HTC handle - * @dbg_flag - enable or disable flag + * htc_set_pkt_dbg() - Set up debug flag for HTC packets + * @handle: HTC handle + * @dbg_flag: enable or disable flag * * Return: none */ void htc_set_pkt_dbg(HTC_HANDLE handle, A_BOOL dbg_flag); /** - * htc_set_nodrop_pkt - Set up nodrop pkt flag for mboxping nodrop pkt - * @HTCHandle - HTC handle - * @isNodropPkt - indicates whether it is nodrop pkt + * htc_set_nodrop_pkt() - Set up nodrop pkt flag for mboxping nodrop pkt + * @HTCHandle: HTC handle + * @isNodropPkt: indicates whether it is nodrop pkt * * Return: None * @@ -697,9 +721,9 @@ void htc_set_pkt_dbg(HTC_HANDLE handle, A_BOOL dbg_flag); void htc_set_nodrop_pkt(HTC_HANDLE HTCHandle, A_BOOL isNodropPkt); /** - * htc_enable_hdr_length_check - Set up htc_hdr_length_check flag - * @HTCHandle - HTC handle - * @htc_hdr_length_check - flag to indicate whether htc header length check is + * htc_enable_hdr_length_check() - Set up htc_hdr_length_check flag + * @htc_handle: HTC handle + * @htc_hdr_length_check: flag to indicate whether htc header length check is * required * * Return: None @@ -709,10 +733,10 @@ void htc_enable_hdr_length_check(HTC_HANDLE htc_handle, bool htc_hdr_length_check); /** - * htc_get_num_recv_buffers - Get the number of recv buffers currently queued + * htc_get_num_recv_buffers() - Get the number of recv buffers currently queued * into an HTC endpoint - * @HTCHandle - HTC handle - * @Endpoint - endpoint to check + * @HTCHandle: HTC handle + * @Endpoint: endpoint to check * * Return: returns number of buffers in queue * @@ -721,10 +745,10 @@ int htc_get_num_recv_buffers(HTC_HANDLE HTCHandle, HTC_ENDPOINT_ID Endpoint); /** - * htc_set_target_failure_callback - Set the target failure handling callback + * htc_set_target_failure_callback() - Set the target failure handling callback * in HTC layer - * @HTCHandle - HTC handle - * @Callback - target failure handling callback + * @HTCHandle: HTC handle + * @Callback: target failure handling callback * * Return: None */ @@ -744,7 +768,7 @@ struct ol_ath_htc_stats *ieee80211_ioctl_get_htc_stats(HTC_HANDLE /** * htc_get_tx_queue_depth() - get the tx queue depth of an htc endpoint * @htc_handle: htc handle - * @enpoint_id: endpoint to check + * @endpoint_id: endpoint to check * * Return: htc_handle tx queue depth */ @@ -833,7 +857,7 @@ int32_t htc_dec_return_htt_runtime_cnt(HTC_HANDLE htc) #ifdef WLAN_DEBUG_LINK_VOTE /** - * htc_log_link_user_votes - API to log link user votes + * htc_log_link_user_votes() - API to log link user votes * * API to log the link user votes * @@ -842,7 +866,7 @@ int32_t htc_dec_return_htt_runtime_cnt(HTC_HANDLE htc) void htc_log_link_user_votes(void); /** - * htc_vote_link_down - API to vote for link down + * htc_vote_link_down() - API to vote for link down * @htc_handle: HTC handle * @id: PCIe link vote user id * @@ -853,7 +877,7 @@ void htc_log_link_user_votes(void); void htc_vote_link_down(HTC_HANDLE htc_handle, enum htc_link_vote_user_id id); /** - * htc_vote_link_up - API to vote for link up + * htc_vote_link_up() - API to vote for link up * @htc_handle: HTC Handle * @id: PCIe link vote user id * @@ -885,12 +909,11 @@ void htc_vote_link_up(HTC_HANDLE htc_handle, enum htc_link_vote_user_id id) * user should call this function after htc_connect_service before * queueing any packets to end point * @HTCHandle: htc handle - * @HTC_ENDPOINT_ID: end point id + * @htc_ep_id: end point id * @value: true or false * * Return: None */ - void htc_set_async_ep(HTC_HANDLE HTCHandle, HTC_ENDPOINT_ID htc_ep_id, bool value); diff --git a/htc/htc_credit_history.c b/htc/htc_credit_history.c index 9fdb1b7898..7db450edba 100644 --- a/htc/htc_credit_history.c +++ b/htc/htc_credit_history.c @@ -1,5 +1,6 @@ /* * Copyright (c) 2018,2020-2021 The Linux Foundation. All rights reserved. + * Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved. * * Permission to use, copy, modify, and/or distribute this software for * any purpose with or without fee is hereby granted, provided that the @@ -46,7 +47,8 @@ struct HTC_CREDIT_HISTORY htc_credit_history_buffer[HTC_CREDIT_HISTORY_MAX]; #ifdef QCA_WIFI_EMULATION #define HTC_EMULATION_DELAY_IN_MS 20 /** - * htc_add_delay(): Adds a delay in before proceeding, only for emulation + * htc_add_emulation_delay() - Adds a delay in before proceeding, only for + * emulation * * Return: None */ @@ -78,7 +80,7 @@ void htc_credit_history_init(void) * htc_credit_record() - records tx que state & credit transactions * @type: type of echange can be HTC_REQUEST_CREDIT * or HTC_PROCESS_CREDIT_REPORT - * @tx_credits: current number of tx_credits + * @tx_credit: current number of tx_credits * @htc_tx_queue_depth: current hct tx queue depth * * This function records the credits and pending commands whenever a command is diff --git a/htc/htc_packet.h b/htc/htc_packet.h index 78e0a3b95b..b39b41d927 100644 --- a/htc/htc_packet.h +++ b/htc/htc_packet.h @@ -1,5 +1,6 @@ /* * Copyright (c) 2013-2014, 2016-2017, 2019-2021 The Linux Foundation. All rights reserved. + * Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved. * * Permission to use, copy, modify, and/or distribute this software for * any purpose with or without fee is hereby granted, provided that the @@ -59,7 +60,7 @@ struct htc_tx_packet_info { uint32_t Flags; }; -/** +/* * HTC_TX_PACKET_TAG_XXX - #defines for tagging packets for special handling * HTC_TX_PACKET_TAG_ALL: zero is reserved and used to flush ALL packets * HTC_TX_PACKET_TAG_INTERNAL: internal tags start here @@ -313,8 +314,8 @@ static inline HTC_PACKET *htc_packet_dequeue_tail(HTC_PACKET_QUEUE *queue) /** * htc_packet_set_magic_cookie() - set magic cookie in htc packet - * htc_pkt - pointer to htc packet - * value - value to set in magic cookie + * @htc_pkt: pointer to htc packet + * @value: value to set in magic cookie * * This API sets the magic cookie passed in htc packet. * @@ -327,8 +328,8 @@ static inline void htc_packet_set_magic_cookie(HTC_PACKET *htc_pkt, } /** - * htc_packet_set_magic_cookie() - get magic cookie in htc packet - * htc_pkt - pointer to htc packet + * htc_packet_get_magic_cookie() - get magic cookie in htc packet + * @htc_pkt: pointer to htc packet * * This API returns the magic cookie in htc packet. * diff --git a/htc/htc_send.c b/htc/htc_send.c index 1d9565a459..eacc8dd593 100644 --- a/htc/htc_send.c +++ b/htc/htc_send.c @@ -1,6 +1,6 @@ /* * Copyright (c) 2013-2021 The Linux Foundation. All rights reserved. - * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved. + * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved. * * Permission to use, copy, modify, and/or distribute this software for * any purpose with or without fee is hereby granted, provided that the @@ -52,7 +52,8 @@ static unsigned int ep_debug_mask = #ifdef QCA_WIFI_EMULATION #define HTC_EMULATION_DELAY_IN_MS 20 /** - * htc_add_delay(): Adds a delay in before proceeding, only for emulation + * htc_add_emulation_delay() - Adds a delay in before proceeding, only for + * emulation * * Return: None */ @@ -185,7 +186,7 @@ static void log_packet_info(HTC_TARGET *target, HTC_PACKET *pPacket) } /** - * htc_inc_htt_runtime_cnt: Increment htc htt runtime count + * htc_inc_htt_runtime_cnt() - Increment htc htt runtime count * @target: handle of HTC context * * Return: None @@ -988,7 +989,7 @@ static QDF_STATUS htc_issue_packets(HTC_TARGET *target, #ifdef FEATURE_RUNTIME_PM /** - * extract_htc_pm_packets(): move pm packets from endpoint into queue + * extract_htc_pm_packets() - move pm packets from endpoint into queue * @endpoint: which endpoint to extract packets from * @queue: a queue to store extracted packets in. * @@ -1014,7 +1015,7 @@ static void extract_htc_pm_packets(HTC_ENDPOINT *endpoint, } /** - * queue_htc_pm_packets(): queue pm packets with priority + * queue_htc_pm_packets() - queue pm packets with priority * @endpoint: endpoint to queue packets to * @queue: queue of pm packets to enqueue * @@ -1109,8 +1110,8 @@ htc_send_pkts_get_rtpm_id(HTC_SERVICE_ID service_id) #ifdef SYSTEM_PM_CHECK /** - * extract_htc_system_resume_pkts(): Move system pm resume packets from endpoint - * into queue + * extract_htc_system_resume_pkts() - Move system pm resume packets from + * endpoint into queue * @endpoint: which endpoint to extract packets from * @queue: a queue to store extracted packets in. * @@ -2020,9 +2021,10 @@ qdf_export_symbol(htc_send_pkt); #ifdef ATH_11AC_TXCOMPACT /** * htc_send_data_pkt() - send single data packet on an endpoint - * @HTCHandle: pointer to HTC handle + * @htc_hdl: pointer to HTC handle * @netbuf: network buffer containing the data to be sent - * @ActualLength: length of data that needs to be transmitted + * @ep_id: endpoint identifier + * @actual_length: length of data that needs to be transmitted * * Return: QDF_STATUS_SUCCESS for success or an appropriate QDF_STATUS error */ @@ -2550,9 +2552,9 @@ QDF_STATUS htc_tx_completion_handler(void *Context, #ifdef WLAN_FEATURE_FASTPATH /** - * htc_ctrl_msg_cmpl(): checks for tx completion for the endpoint specified - * @HTC_HANDLE : pointer to the htc target context - * @htc_ep_id : end point id + * htc_ctrl_msg_cmpl() - checks for tx completion for the endpoint specified + * @htc_pdev: pointer to the htc context + * @htc_ep_id: end point id * * checks HTC tx completion * @@ -2599,7 +2601,7 @@ void htc_tx_resource_avail_handler(void *context, uint8_t pipeID) #ifdef FEATURE_RUNTIME_PM /** - * htc_kick_queues(): resumes tx transactions of suspended endpoints + * htc_kick_queues() - resumes tx transactions of suspended endpoints * @context: pointer to the htc target context * * Iterates through the endpoints and provides a context to empty queues