xref: /wlan-dirver/qca-wifi-host-cmn/htc/htc.c (revision 8cfe6b10058a04cafb17eed051f2ddf11bee8931)
1 /*
2  * Copyright (c) 2013-2021 The Linux Foundation. All rights reserved.
3  * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for
6  * any purpose with or without fee is hereby granted, provided that the
7  * above copyright notice and this permission notice appear in all
8  * copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17  * PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 #include "htc_debug.h"
21 #include "htc_internal.h"
22 #include "htc_credit_history.h"
23 #include "htc_hang_event.h"
24 #include <hif.h>
25 #include <qdf_nbuf.h>           /* qdf_nbuf_t */
26 #include <qdf_types.h>          /* qdf_print */
27 
28 #define MAX_HTC_RX_BUNDLE  2
29 
30 #if defined(WLAN_DEBUG) || defined(DEBUG)
31 static ATH_DEBUG_MASK_DESCRIPTION g_htc_debug_description[] = {
32 	{ATH_DEBUG_SEND, "Send"},
33 	{ATH_DEBUG_RECV, "Recv"},
34 	{ATH_DEBUG_SYNC, "Sync"},
35 	{ATH_DEBUG_DUMP, "Dump Data (RX or TX)"},
36 	{ATH_DEBUG_SETUP, "Setup"},
37 };
38 
39 ATH_DEBUG_INSTANTIATE_MODULE_VAR(htc,
40 				 "htc",
41 				 "Host Target Communications",
42 				 ATH_DEBUG_MASK_DEFAULTS | ATH_DEBUG_INFO |
43 				 ATH_DEBUG_SETUP,
44 				 ATH_DEBUG_DESCRIPTION_COUNT
45 					 (g_htc_debug_description),
46 				 g_htc_debug_description);
47 
48 #endif
49 
50 #if defined(WMI_MULTI_MAC_SVC)
51 static const uint32_t svc_id[] = {WMI_CONTROL_SVC, WMI_CONTROL_SVC_WMAC1,
52 						WMI_CONTROL_SVC_WMAC2};
53 #else
54 static const uint32_t svc_id[] = {WMI_CONTROL_SVC};
55 #endif
56 
57 extern unsigned int htc_credit_flow;
58 
59 static void reset_endpoint_states(HTC_TARGET *target);
60 
61 static void destroy_htc_tx_ctrl_packet(HTC_PACKET *pPacket)
62 {
63 	qdf_nbuf_t netbuf;
64 
65 	netbuf = (qdf_nbuf_t) GET_HTC_PACKET_NET_BUF_CONTEXT(pPacket);
66 	if (netbuf)
67 		qdf_nbuf_free(netbuf);
68 	qdf_mem_free(pPacket);
69 }
70 
71 static HTC_PACKET *build_htc_tx_ctrl_packet(qdf_device_t osdev)
72 {
73 	HTC_PACKET *pPacket = NULL;
74 	qdf_nbuf_t netbuf;
75 
76 	do {
77 		pPacket = (HTC_PACKET *) qdf_mem_malloc(sizeof(HTC_PACKET));
78 		if (!pPacket)
79 			break;
80 		netbuf = qdf_nbuf_alloc(osdev, HTC_CONTROL_BUFFER_SIZE,
81 					20, 4, true);
82 		if (!netbuf) {
83 			qdf_mem_free(pPacket);
84 			pPacket = NULL;
85 			break;
86 		}
87 		SET_HTC_PACKET_NET_BUF_CONTEXT(pPacket, netbuf);
88 	} while (false);
89 
90 	return pPacket;
91 }
92 
93 void htc_free_control_tx_packet(HTC_TARGET *target, HTC_PACKET *pPacket)
94 {
95 
96 #ifdef TODO_FIXME
97 	LOCK_HTC(target);
98 	HTC_PACKET_ENQUEUE(&target->ControlBufferTXFreeList, pPacket);
99 	UNLOCK_HTC(target);
100 	/* TODO_FIXME netbufs cannot be RESET! */
101 #else
102 	destroy_htc_tx_ctrl_packet(pPacket);
103 #endif
104 
105 }
106 
107 HTC_PACKET *htc_alloc_control_tx_packet(HTC_TARGET *target)
108 {
109 #ifdef TODO_FIXME
110 	HTC_PACKET *pPacket;
111 
112 	LOCK_HTC(target);
113 	pPacket = htc_packet_dequeue(&target->ControlBufferTXFreeList);
114 	UNLOCK_HTC(target);
115 
116 	return pPacket;
117 #else
118 	return build_htc_tx_ctrl_packet(target->osdev);
119 #endif
120 }
121 
122 /* Set the target failure handling callback */
123 void htc_set_target_failure_callback(HTC_HANDLE HTCHandle,
124 				     HTC_TARGET_FAILURE Callback)
125 {
126 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
127 
128 	target->HTCInitInfo.TargetFailure = Callback;
129 }
130 
131 void htc_dump(HTC_HANDLE HTCHandle, uint8_t CmdId, bool start)
132 {
133 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
134 
135 	hif_dump(target->hif_dev, CmdId, start);
136 }
137 
138 void htc_ce_tasklet_debug_dump(HTC_HANDLE htc_handle)
139 {
140 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
141 
142 	if (!target->hif_dev)
143 		return;
144 
145 	hif_display_stats(target->hif_dev);
146 }
147 
148 #ifdef FEATURE_RUNTIME_PM
149 /**
150  * htc_dec_return_wmi_runtime_cnt: Decrement htc wmi runtime count
151  * @target: HTC target
152  *
153  * Return: value of runtime count after decrement
154  */
155 static inline
156 int32_t htc_dec_return_wmi_runtime_cnt(HTC_TARGET *target)
157 {
158 	return qdf_atomic_dec_return(&target->htc_wmi_runtime_cnt);
159 }
160 
161 /**
162  * htc_init_wmi_runtime_cnt: Initialize htc wmi runtime count
163  * @target: HTC target
164  *
165  * Return: None
166  */
167 static inline
168 void htc_init_wmi_runtime_cnt(HTC_TARGET *target)
169 {
170 	qdf_atomic_init(&target->htc_wmi_runtime_cnt);
171 }
172 #else
173 static inline
174 int32_t htc_dec_return_wmi_runtime_cnt(HTC_TARGET *target)
175 {
176 	return -1;
177 }
178 
179 static inline
180 void htc_init_wmi_runtime_cnt(HTC_TARGET *target)
181 {
182 }
183 #endif
184 /* cleanup the HTC instance */
185 static void htc_cleanup(HTC_TARGET *target)
186 {
187 	HTC_PACKET *pPacket;
188 	int i;
189 	HTC_ENDPOINT *endpoint;
190 	HTC_PACKET_QUEUE *pkt_queue;
191 	qdf_nbuf_t netbuf;
192 
193 	while (htc_dec_return_htt_runtime_cnt((void *)target) >= 0)
194 		hif_rtpm_put(HIF_RTPM_PUT_ASYNC, HIF_RTPM_ID_HTT);
195 
196 	while (htc_dec_return_wmi_runtime_cnt((void *)target) >= 0)
197 		hif_rtpm_put(HIF_RTPM_PUT_ASYNC, HIF_RTPM_ID_WMI);
198 
199 	if (target->hif_dev) {
200 		hif_detach_htc(target->hif_dev);
201 		hif_mask_interrupt_call(target->hif_dev);
202 		target->hif_dev = NULL;
203 	}
204 
205 	while (true) {
206 		pPacket = allocate_htc_packet_container(target);
207 		if (!pPacket)
208 			break;
209 		qdf_mem_free(pPacket);
210 	}
211 
212 	LOCK_HTC_TX(target);
213 	pPacket = target->pBundleFreeList;
214 	target->pBundleFreeList = NULL;
215 	UNLOCK_HTC_TX(target);
216 	while (pPacket) {
217 		HTC_PACKET *pPacketTmp = (HTC_PACKET *) pPacket->ListLink.pNext;
218 		netbuf = GET_HTC_PACKET_NET_BUF_CONTEXT(pPacket);
219 		if (netbuf)
220 			qdf_nbuf_free(netbuf);
221 		pkt_queue = pPacket->pContext;
222 		if (pkt_queue)
223 			qdf_mem_free(pkt_queue);
224 		qdf_mem_free(pPacket);
225 		pPacket = pPacketTmp;
226 	}
227 
228 #ifdef TODO_FIXME
229 	while (true) {
230 		pPacket = htc_alloc_control_tx_packet(target);
231 		if (!pPacket)
232 			break;
233 		netbuf = (qdf_nbuf_t) GET_HTC_PACKET_NET_BUF_CONTEXT(pPacket);
234 		if (netbuf)
235 			qdf_nbuf_free(netbuf);
236 		qdf_mem_free(pPacket);
237 	}
238 #endif
239 	HTC_INFO("%s: Non flow ctrl enabled endpoints nbuf map: %d, unamp: %d",
240 		 __func__, target->nbuf_nfc_map_count,
241 		 target->nbuf_nfc_unmap_count);
242 
243 	htc_flush_endpoint_txlookupQ(target, ENDPOINT_0, true);
244 
245 	qdf_spinlock_destroy(&target->HTCLock);
246 	qdf_spinlock_destroy(&target->HTCRxLock);
247 	qdf_spinlock_destroy(&target->HTCTxLock);
248 	for (i = 0; i < ENDPOINT_MAX; i++) {
249 		endpoint = &target->endpoint[i];
250 		qdf_spinlock_destroy(&endpoint->lookup_queue_lock);
251 	}
252 
253 	/* free our instance */
254 	qdf_mem_free(target);
255 }
256 
257 #ifdef FEATURE_RUNTIME_PM
258 /**
259  * htc_runtime_pm_init(): runtime pm related initialization
260  * @target: HTC target
261  *
262  * need to initialize a work item.
263  */
264 static void htc_runtime_pm_init(HTC_TARGET *target)
265 {
266 	qdf_create_work(0, &target->queue_kicker, htc_kick_queues, target);
267 }
268 
269 /**
270  * htc_runtime_suspend() - runtime suspend HTC
271  *
272  * @htc_ctx: HTC context pointer
273  *
274  * This is a dummy function for symmetry.
275  *
276  * Return: 0 for success
277  */
278 int htc_runtime_suspend(HTC_HANDLE htc_ctx)
279 {
280 	return 0;
281 }
282 
283 /**
284  * htc_runtime_resume(): resume htc
285  *
286  * The htc message queue needs to be kicked off after
287  * a runtime resume.  Otherwise messages would get stuck.
288  *
289  * @htc_ctx: HTC context pointer
290  *
291  * Return: 0 for success;
292  */
293 int htc_runtime_resume(HTC_HANDLE htc_ctx)
294 {
295 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_ctx);
296 
297 	if (!target)
298 		return 0;
299 
300 	qdf_sched_work(0, &target->queue_kicker);
301 	return 0;
302 }
303 
304 /**
305  * htc_runtime_pm_deinit(): runtime pm related de-intialization
306  *
307  * need to de-initialize the work item.
308  *
309  * @target: HTC target pointer
310  *
311  */
312 static void htc_runtime_pm_deinit(HTC_TARGET *target)
313 {
314 	if (!target)
315 		return;
316 
317 	qdf_destroy_work(0, &target->queue_kicker);
318 }
319 
320 int32_t htc_dec_return_htt_runtime_cnt(HTC_HANDLE htc)
321 {
322 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc);
323 
324 	return qdf_atomic_dec_return(&target->htc_htt_runtime_cnt);
325 }
326 
327 /**
328  * htc_init_htt_runtime_cnt: Initialize htc htt runtime count
329  * @target: HTC target
330  *
331  * Return: None
332  */
333 static inline
334 void htc_init_htt_runtime_cnt(HTC_TARGET *target)
335 {
336 	qdf_atomic_init(&target->htc_htt_runtime_cnt);
337 }
338 #else
339 static inline void htc_runtime_pm_init(HTC_TARGET *target) { }
340 static inline void htc_runtime_pm_deinit(HTC_TARGET *target) { }
341 
342 static inline
343 void htc_init_htt_runtime_cnt(HTC_TARGET *target)
344 {
345 }
346 #endif
347 
348 #if defined(DEBUG_HL_LOGGING) && defined(CONFIG_HL_SUPPORT)
349 static
350 void htc_update_rx_bundle_stats(void *ctx, uint8_t no_of_pkt_in_bundle)
351 {
352 	HTC_TARGET *target = (HTC_TARGET *)ctx;
353 
354 	no_of_pkt_in_bundle--;
355 	if (target && (no_of_pkt_in_bundle < HTC_MAX_MSG_PER_BUNDLE_RX))
356 		target->rx_bundle_stats[no_of_pkt_in_bundle]++;
357 }
358 #else
359 static
360 void htc_update_rx_bundle_stats(void *ctx, uint8_t no_of_pkt_in_bundle)
361 {
362 }
363 #endif
364 
365 #ifdef WLAN_DEBUG_LINK_VOTE
366 static qdf_atomic_t htc_link_vote_ids[HTC_LINK_VOTE_INVALID_MAX_USER_ID];
367 
368 static void htc_init_link_vote_ids(void)
369 {
370 	uint32_t i;
371 
372 	for (i = HTC_LINK_VOTE_INVALID_MIN_USER_ID;
373 	     i < HTC_LINK_VOTE_INVALID_MAX_USER_ID; i++)
374 		qdf_atomic_init(&htc_link_vote_ids[i]);
375 }
376 
377 void htc_log_link_user_votes(void)
378 {
379 	uint32_t i;
380 	uint32_t link_vote;
381 
382 	for (i = HTC_LINK_VOTE_INVALID_MIN_USER_ID + 1;
383 	     i < HTC_LINK_VOTE_INVALID_MAX_USER_ID; i++) {
384 		link_vote = qdf_atomic_read(&htc_link_vote_ids[i]);
385 		if (link_vote)
386 			HTC_NOFL_INFO("Link vote %d user id: %d",
387 				      link_vote, i);
388 	}
389 }
390 
391 void htc_vote_link_down(HTC_HANDLE htc_handle, enum htc_link_vote_user_id id)
392 {
393 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
394 
395 	if (!target->hif_dev)
396 		return;
397 	if (id >= HTC_LINK_VOTE_INVALID_MAX_USER_ID ||
398 	    id <= HTC_LINK_VOTE_INVALID_MIN_USER_ID) {
399 		HTC_ERROR("invalid id: %d", id);
400 		return;
401 	}
402 
403 	hif_vote_link_down(target->hif_dev);
404 	qdf_atomic_dec(&htc_link_vote_ids[id]);
405 }
406 
407 void htc_vote_link_up(HTC_HANDLE htc_handle, enum htc_link_vote_user_id id)
408 {
409 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
410 
411 	if (!target->hif_dev)
412 		return;
413 	if (id >= HTC_LINK_VOTE_INVALID_MAX_USER_ID ||
414 	    id <= HTC_LINK_VOTE_INVALID_MIN_USER_ID) {
415 		HTC_ERROR("invalid link vote user id: %d", id);
416 		return;
417 	}
418 
419 	hif_vote_link_up(target->hif_dev);
420 	qdf_atomic_inc(&htc_link_vote_ids[id]);
421 }
422 #else
423 static inline
424 void htc_init_link_vote_ids(void)
425 {
426 }
427 #endif
428 
429 /* registered target arrival callback from the HIF layer */
430 HTC_HANDLE htc_create(void *ol_sc, struct htc_init_info *pInfo,
431 			qdf_device_t osdev, uint32_t con_mode)
432 {
433 	struct hif_msg_callbacks htcCallbacks;
434 	HTC_ENDPOINT *pEndpoint = NULL;
435 	HTC_TARGET *target = NULL;
436 	int i;
437 
438 	if (!ol_sc) {
439 		HTC_ERROR("%s: ol_sc = NULL", __func__);
440 		return NULL;
441 	}
442 	HTC_TRACE("+htc_create ..  HIF :%pK", ol_sc);
443 
444 	A_REGISTER_MODULE_DEBUG_INFO(htc);
445 
446 	target = (HTC_TARGET *) qdf_mem_malloc(sizeof(HTC_TARGET));
447 	if (!target)
448 		return NULL;
449 
450 	htc_runtime_pm_init(target);
451 	htc_credit_history_init();
452 	qdf_spinlock_create(&target->HTCLock);
453 	qdf_spinlock_create(&target->HTCRxLock);
454 	qdf_spinlock_create(&target->HTCTxLock);
455 	for (i = 0; i < ENDPOINT_MAX; i++) {
456 		pEndpoint = &target->endpoint[i];
457 		qdf_spinlock_create(&pEndpoint->lookup_queue_lock);
458 	}
459 	target->is_nodrop_pkt = false;
460 	target->htc_hdr_length_check = false;
461 	target->wmi_ep_count = 1;
462 
463 	do {
464 		qdf_mem_copy(&target->HTCInitInfo, pInfo,
465 			     sizeof(struct htc_init_info));
466 		target->host_handle = pInfo->pContext;
467 		target->osdev = osdev;
468 		target->con_mode = con_mode;
469 
470 		/* If htc_ready_timeout_ms is not configured from CFG,
471 		 * assign the default timeout value here.
472 		 */
473 
474 		if (!target->HTCInitInfo.htc_ready_timeout_ms)
475 			target->HTCInitInfo.htc_ready_timeout_ms =
476 							HTC_CONTROL_RX_TIMEOUT;
477 
478 		reset_endpoint_states(target);
479 
480 		INIT_HTC_PACKET_QUEUE(&target->ControlBufferTXFreeList);
481 
482 		for (i = 0; i < HTC_PACKET_CONTAINER_ALLOCATION; i++) {
483 			HTC_PACKET *pPacket = (HTC_PACKET *)
484 					qdf_mem_malloc(sizeof(HTC_PACKET));
485 			if (pPacket)
486 				free_htc_packet_container(target, pPacket);
487 		}
488 
489 #ifdef TODO_FIXME
490 		for (i = 0; i < NUM_CONTROL_TX_BUFFERS; i++) {
491 			pPacket = build_htc_tx_ctrl_packet();
492 			if (!pPacket)
493 				break;
494 			htc_free_control_tx_packet(target, pPacket);
495 		}
496 #endif
497 
498 		/* setup HIF layer callbacks */
499 		qdf_mem_zero(&htcCallbacks, sizeof(struct hif_msg_callbacks));
500 		htcCallbacks.Context = target;
501 		htcCallbacks.rxCompletionHandler = htc_rx_completion_handler;
502 		htcCallbacks.txCompletionHandler = htc_tx_completion_handler;
503 		htcCallbacks.txResourceAvailHandler =
504 						 htc_tx_resource_avail_handler;
505 		htcCallbacks.fwEventHandler = htc_fw_event_handler;
506 		htcCallbacks.update_bundle_stats = htc_update_rx_bundle_stats;
507 		target->hif_dev = ol_sc;
508 
509 		/* Get HIF default pipe for HTC message exchange */
510 		pEndpoint = &target->endpoint[ENDPOINT_0];
511 
512 		hif_post_init(target->hif_dev, target, &htcCallbacks);
513 		hif_get_default_pipe(target->hif_dev, &pEndpoint->UL_PipeID,
514 				     &pEndpoint->DL_PipeID);
515 		hif_set_initial_wakeup_cb(target->hif_dev,
516 					  pInfo->target_initial_wakeup_cb,
517 					  pInfo->target_psoc);
518 
519 	} while (false);
520 
521 	htc_recv_init(target);
522 	htc_init_htt_runtime_cnt(target);
523 	htc_init_wmi_runtime_cnt(target);
524 
525 	HTC_TRACE("-htc_create: (0x%pK)", target);
526 
527 	htc_hang_event_notifier_register(target);
528 
529 	htc_init_link_vote_ids();
530 
531 	hif_rtpm_register(HIF_RTPM_ID_WMI, NULL);
532 	hif_rtpm_register(HIF_RTPM_ID_HTT, NULL);
533 
534 	return (HTC_HANDLE) target;
535 }
536 
537 void htc_destroy(HTC_HANDLE HTCHandle)
538 {
539 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
540 
541 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC,
542 			("+htc_destroy ..  Destroying :0x%pK\n", target));
543 
544 	htc_hang_event_notifier_unregister();
545 
546 	if (target) {
547 		hif_stop(htc_get_hif_device(HTCHandle));
548 		htc_cleanup(target);
549 		hif_rtpm_deregister(HIF_RTPM_ID_HTT);
550 		hif_rtpm_deregister(HIF_RTPM_ID_WMI);
551 	}
552 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("-htc_destroy\n"));
553 	htc_credit_history_deinit();
554 }
555 
556 /* get the low level HIF device for the caller , the caller may wish to do low
557  * level HIF requests
558  */
559 void *htc_get_hif_device(HTC_HANDLE HTCHandle)
560 {
561 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
562 
563 	return target->hif_dev;
564 }
565 
566 static void htc_control_tx_complete(void *Context, HTC_PACKET *pPacket)
567 {
568 	HTC_TARGET *target = (HTC_TARGET *) Context;
569 
570 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC,
571 			("+-htc_control_tx_complete 0x%pK (l:%d)\n", pPacket,
572 			 pPacket->ActualLength));
573 	htc_free_control_tx_packet(target, pPacket);
574 }
575 
576 /* TODO, this is just a temporary max packet size */
577 #define MAX_MESSAGE_SIZE 1536
578 
579 /**
580  * htc_setup_epping_credit_allocation() - allocate credits/HTC buffers to WMI
581  * @scn: pointer to hif_opaque_softc
582  * @pEntry: pointer to tx credit allocation entry
583  * @credits: number of credits
584  *
585  * Return: None
586  */
587 static void
588 htc_setup_epping_credit_allocation(struct hif_opaque_softc *scn,
589 			   struct htc_service_tx_credit_allocation *pEntry,
590 			   int credits)
591 {
592 	switch (hif_get_bus_type(scn)) {
593 	case QDF_BUS_TYPE_PCI:
594 	case QDF_BUS_TYPE_USB:
595 		pEntry++;
596 		pEntry->service_id = WMI_DATA_BE_SVC;
597 		pEntry->CreditAllocation = (credits >> 1);
598 
599 		pEntry++;
600 		pEntry->service_id = WMI_DATA_BK_SVC;
601 		pEntry->CreditAllocation = (credits >> 1);
602 		break;
603 	case QDF_BUS_TYPE_SDIO:
604 		pEntry++;
605 		pEntry->service_id = WMI_DATA_BE_SVC;
606 		pEntry->CreditAllocation = credits;
607 		break;
608 	default:
609 		break;
610 	}
611 }
612 
613 /**
614  * htc_setup_target_buffer_assignments() - setup target buffer assignments
615  * @target: HTC Target Pointer
616  *
617  * Return: A_STATUS
618  */
619 static
620 A_STATUS htc_setup_target_buffer_assignments(HTC_TARGET *target)
621 {
622 	struct htc_service_tx_credit_allocation *pEntry;
623 	A_STATUS status;
624 	int credits;
625 	int creditsPerMaxMsg;
626 
627 	creditsPerMaxMsg = MAX_MESSAGE_SIZE / target->TargetCreditSize;
628 	if (MAX_MESSAGE_SIZE % target->TargetCreditSize)
629 		creditsPerMaxMsg++;
630 
631 	/* TODO, this should be configured by the caller! */
632 
633 	credits = target->TotalTransmitCredits;
634 	pEntry = &target->ServiceTxAllocTable[0];
635 
636 	status = A_OK;
637 	/*
638 	 * Allocate all credits/HTC buffers to WMI.
639 	 * no buffers are used/required for data. data always
640 	 * remains on host.
641 	 */
642 	if (HTC_IS_EPPING_ENABLED(target->con_mode)) {
643 		pEntry++;
644 		pEntry->service_id = WMI_CONTROL_SVC;
645 		pEntry->CreditAllocation = credits;
646 		/* endpoint ping is a testing tool directly on top of HTC in
647 		 * both target and host sides.
648 		 * In target side, the endppint ping fw has no wlan stack and
649 		 * FW mboxping app directly sits on HTC and it simply drops
650 		 * or loops back TX packets. For rx perf, FW mboxping app
651 		 * generates packets and passes packets to HTC to send to host.
652 		 * There is no WMI message exchanges between host and target
653 		 * in endpoint ping case.
654 		 * In host side, the endpoint ping driver is a Ethernet driver
655 		 * and it directly sits on HTC. Only HIF, HTC, QDF, ADF are
656 		 * used by the endpoint ping driver. There is no wifi stack
657 		 * at all in host side also. For tx perf use case,
658 		 * the user space mboxping app sends the raw packets to endpoint
659 		 * ping driver and it directly forwards to HTC for transmission
660 		 * to stress the bus. For the rx perf, HTC passes the received
661 		 * packets to endpoint ping driver and it is passed to the user
662 		 * space through the Ethernet interface.
663 		 * For credit allocation, in SDIO bus case, only BE service is
664 		 * used for tx/rx perf testing so that all credits are given
665 		 * to BE service. In PCIe and USB bus case, endpoint ping uses
666 		 * both BE and BK services to stress the bus so that the total
667 		 * credits are equally distributed to BE and BK services.
668 		 */
669 
670 		htc_setup_epping_credit_allocation(target->hif_dev,
671 						   pEntry, credits);
672 	} else {
673 		int i;
674 		uint32_t max_wmi_svc = (sizeof(svc_id) / sizeof(uint32_t));
675 
676 		if ((target->wmi_ep_count == 0) ||
677 				(target->wmi_ep_count > max_wmi_svc))
678 			return A_ERROR;
679 
680 		/*
681 		 * Divide credit among number of endpoints for WMI
682 		 */
683 		credits = credits / target->wmi_ep_count;
684 		for (i = 0; i < target->wmi_ep_count; i++) {
685 			status = A_OK;
686 			pEntry++;
687 			pEntry->service_id = svc_id[i];
688 			pEntry->CreditAllocation = credits;
689 		}
690 	}
691 
692 	if (A_SUCCESS(status)) {
693 		int i;
694 
695 		for (i = 0; i < HTC_MAX_SERVICE_ALLOC_ENTRIES; i++) {
696 			if (target->ServiceTxAllocTable[i].service_id != 0) {
697 				AR_DEBUG_PRINTF(ATH_DEBUG_INIT,
698 						("SVS Index : %d TX : 0x%2.2X : alloc:%d",
699 						 i,
700 						 target->ServiceTxAllocTable[i].
701 						 service_id,
702 						 target->ServiceTxAllocTable[i].
703 						 CreditAllocation));
704 			}
705 		}
706 	}
707 
708 	return status;
709 }
710 
711 uint8_t htc_get_credit_allocation(HTC_TARGET *target, uint16_t service_id)
712 {
713 	uint8_t allocation = 0;
714 	int i;
715 
716 	for (i = 0; i < HTC_MAX_SERVICE_ALLOC_ENTRIES; i++) {
717 		if (target->ServiceTxAllocTable[i].service_id == service_id) {
718 			allocation =
719 				target->ServiceTxAllocTable[i].CreditAllocation;
720 		}
721 	}
722 
723 	if (0 == allocation) {
724 		AR_DEBUG_PRINTF(ATH_DEBUG_RSVD1,
725 			("HTC Service TX : 0x%2.2X : allocation is zero!\n",
726 				 service_id));
727 	}
728 
729 	return allocation;
730 }
731 
732 QDF_STATUS htc_wait_target(HTC_HANDLE HTCHandle)
733 {
734 	QDF_STATUS status = QDF_STATUS_SUCCESS;
735 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
736 	HTC_READY_EX_MSG *pReadyMsg;
737 	struct htc_service_connect_req connect;
738 	struct htc_service_connect_resp resp;
739 	HTC_READY_MSG *rdy_msg;
740 	uint16_t htc_rdy_msg_id;
741 	uint8_t i = 0;
742 	HTC_PACKET *rx_bundle_packet, *temp_bundle_packet;
743 
744 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC,
745 			("htc_wait_target - Enter (target:0x%pK)\n", HTCHandle));
746 	AR_DEBUG_PRINTF(ATH_DEBUG_RSVD1, ("+HWT\n"));
747 
748 	do {
749 
750 		status = hif_start(target->hif_dev);
751 		if (QDF_IS_STATUS_ERROR(status)) {
752 			AR_DEBUG_PRINTF(ATH_DEBUG_ERROR,
753 					("hif_start failed\n"));
754 			break;
755 		}
756 
757 		status = htc_wait_recv_ctrl_message(target);
758 
759 		if (QDF_IS_STATUS_ERROR(status))
760 			break;
761 
762 		if (target->CtrlResponseLength < (sizeof(HTC_READY_EX_MSG))) {
763 			AR_DEBUG_PRINTF(ATH_DEBUG_ERR,
764 					("Invalid HTC Ready Msg Len:%d!\n",
765 					 target->CtrlResponseLength));
766 			status = QDF_STATUS_E_BADMSG;
767 			break;
768 		}
769 
770 		pReadyMsg = (HTC_READY_EX_MSG *) target->CtrlResponseBuffer;
771 
772 		rdy_msg = &pReadyMsg->Version2_0_Info;
773 		htc_rdy_msg_id =
774 			HTC_GET_FIELD(rdy_msg, HTC_READY_MSG, MESSAGEID);
775 		if (htc_rdy_msg_id != HTC_MSG_READY_ID) {
776 			AR_DEBUG_PRINTF(ATH_DEBUG_ERR,
777 					("Invalid HTC Ready Msg : 0x%X!\n",
778 					 htc_rdy_msg_id));
779 			status = QDF_STATUS_E_BADMSG;
780 			break;
781 		}
782 
783 		target->TotalTransmitCredits = HTC_GET_FIELD(rdy_msg,
784 						HTC_READY_MSG, CREDITCOUNT);
785 		if (target->HTCInitInfo.cfg_wmi_credit_cnt &&
786 			(target->HTCInitInfo.cfg_wmi_credit_cnt <
787 						target->TotalTransmitCredits))
788 			/*
789 			 * If INI configured value is less than FW advertised,
790 			 * then use INI configured value, otherwise use FW
791 			 * advertised.
792 			 */
793 			target->TotalTransmitCredits =
794 				target->HTCInitInfo.cfg_wmi_credit_cnt;
795 
796 		target->TargetCreditSize =
797 			(int)HTC_GET_FIELD(rdy_msg, HTC_READY_MSG, CREDITSIZE);
798 		target->MaxMsgsPerHTCBundle =
799 			(uint8_t) pReadyMsg->MaxMsgsPerHTCBundle;
800 		UPDATE_ALT_CREDIT(target, pReadyMsg->AltDataCreditSize);
801 		/* for old fw this value is set to 0. But the minimum value
802 		 * should be 1, i.e., no bundling
803 		 */
804 		if (target->MaxMsgsPerHTCBundle < 1)
805 			target->MaxMsgsPerHTCBundle = 1;
806 
807 		AR_DEBUG_PRINTF(ATH_DEBUG_INIT,
808 				("Target Ready! TX resource : %d size:%d, MaxMsgsPerHTCBundle = %d",
809 				 target->TotalTransmitCredits,
810 				 target->TargetCreditSize,
811 				 target->MaxMsgsPerHTCBundle));
812 
813 		if ((0 == target->TotalTransmitCredits)
814 		    || (0 == target->TargetCreditSize)) {
815 			status = QDF_STATUS_E_ABORTED;
816 			break;
817 		}
818 
819 		/* Allocate expected number of RX bundle buffer allocation */
820 		if (HTC_RX_BUNDLE_ENABLED(target)) {
821 			temp_bundle_packet = NULL;
822 			for (i = 0; i < MAX_HTC_RX_BUNDLE; i++) {
823 				rx_bundle_packet =
824 					allocate_htc_bundle_packet(target);
825 				if (rx_bundle_packet)
826 					rx_bundle_packet->ListLink.pNext =
827 						(DL_LIST *)temp_bundle_packet;
828 				else
829 					break;
830 
831 				temp_bundle_packet = rx_bundle_packet;
832 			}
833 			LOCK_HTC_TX(target);
834 			target->pBundleFreeList = temp_bundle_packet;
835 			UNLOCK_HTC_TX(target);
836 		}
837 
838 		/* done processing */
839 		target->CtrlResponseProcessing = false;
840 
841 		htc_setup_target_buffer_assignments(target);
842 
843 		/* setup our pseudo HTC control endpoint connection */
844 		qdf_mem_zero(&connect, sizeof(connect));
845 		qdf_mem_zero(&resp, sizeof(resp));
846 		connect.EpCallbacks.pContext = target;
847 		connect.EpCallbacks.EpTxComplete = htc_control_tx_complete;
848 		connect.EpCallbacks.EpRecv = htc_control_rx_complete;
849 		connect.MaxSendQueueDepth = NUM_CONTROL_TX_BUFFERS;
850 		connect.service_id = HTC_CTRL_RSVD_SVC;
851 
852 		/* connect fake service */
853 		status = htc_connect_service((HTC_HANDLE) target,
854 					     &connect, &resp);
855 
856 	} while (false);
857 
858 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("htc_wait_target - Exit (%d)\n",
859 			status));
860 	AR_DEBUG_PRINTF(ATH_DEBUG_RSVD1, ("-HWT\n"));
861 	return status;
862 }
863 
864 /* start HTC, this is called after all services are connected */
865 static A_STATUS htc_config_target_hif_pipe(HTC_TARGET *target)
866 {
867 
868 	return A_OK;
869 }
870 
871 static void reset_endpoint_states(HTC_TARGET *target)
872 {
873 	HTC_ENDPOINT *pEndpoint;
874 	int i;
875 
876 	for (i = ENDPOINT_0; i < ENDPOINT_MAX; i++) {
877 		pEndpoint = &target->endpoint[i];
878 		pEndpoint->service_id = 0;
879 		pEndpoint->MaxMsgLength = 0;
880 		pEndpoint->MaxTxQueueDepth = 0;
881 		pEndpoint->Id = i;
882 		INIT_HTC_PACKET_QUEUE(&pEndpoint->TxQueue);
883 		INIT_HTC_PACKET_QUEUE(&pEndpoint->TxLookupQueue);
884 		INIT_HTC_PACKET_QUEUE(&pEndpoint->RxBufferHoldQueue);
885 		pEndpoint->target = target;
886 		pEndpoint->TxCreditFlowEnabled = (bool)htc_credit_flow;
887 		pEndpoint->num_requeues_warn = 0;
888 		pEndpoint->total_num_requeues = 0;
889 		qdf_atomic_init(&pEndpoint->TxProcessCount);
890 	}
891 }
892 
893 /**
894  * htc_start() - Main HTC function to trigger HTC start
895  * @HTCHandle: pointer to HTC handle
896  *
897  * Return: QDF_STATUS_SUCCESS for success or an appropriate QDF_STATUS error
898  */
899 QDF_STATUS htc_start(HTC_HANDLE HTCHandle)
900 {
901 	qdf_nbuf_t netbuf;
902 	QDF_STATUS status = QDF_STATUS_SUCCESS;
903 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
904 	HTC_SETUP_COMPLETE_EX_MSG *pSetupComp;
905 	HTC_PACKET *pSendPacket;
906 
907 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("htc_start Enter\n"));
908 
909 	do {
910 
911 		htc_config_target_hif_pipe(target);
912 
913 		/* allocate a buffer to send */
914 		pSendPacket = htc_alloc_control_tx_packet(target);
915 		if (!pSendPacket) {
916 			AR_DEBUG_ASSERT(false);
917 			qdf_print("%s: allocControlTxPacket failed",
918 				  __func__);
919 			status = QDF_STATUS_E_NOMEM;
920 			break;
921 		}
922 
923 		netbuf =
924 		   (qdf_nbuf_t) GET_HTC_PACKET_NET_BUF_CONTEXT(pSendPacket);
925 		/* assemble setup complete message */
926 		qdf_nbuf_put_tail(netbuf, sizeof(HTC_SETUP_COMPLETE_EX_MSG));
927 		pSetupComp =
928 			(HTC_SETUP_COMPLETE_EX_MSG *) qdf_nbuf_data(netbuf);
929 		qdf_mem_zero(pSetupComp, sizeof(HTC_SETUP_COMPLETE_EX_MSG));
930 
931 		HTC_SET_FIELD(pSetupComp, HTC_SETUP_COMPLETE_EX_MSG,
932 			      MESSAGEID, HTC_MSG_SETUP_COMPLETE_EX_ID);
933 
934 		if (!htc_credit_flow) {
935 			AR_DEBUG_PRINTF(ATH_DEBUG_TRC,
936 					("HTC will not use TX credit flow control"));
937 			pSetupComp->SetupFlags |=
938 				HTC_SETUP_COMPLETE_FLAGS_DISABLE_TX_CREDIT_FLOW;
939 		} else {
940 			AR_DEBUG_PRINTF(ATH_DEBUG_TRC,
941 					("HTC using TX credit flow control"));
942 		}
943 
944 		if ((hif_get_bus_type(target->hif_dev) == QDF_BUS_TYPE_SDIO) ||
945 					(hif_get_bus_type(target->hif_dev) ==
946 							 QDF_BUS_TYPE_USB)) {
947 			if (HTC_RX_BUNDLE_ENABLED(target))
948 			pSetupComp->SetupFlags |=
949 				HTC_SETUP_COMPLETE_FLAGS_ENABLE_BUNDLE_RECV;
950 			hif_set_bundle_mode(target->hif_dev, true,
951 				HTC_MAX_MSG_PER_BUNDLE_RX);
952 			pSetupComp->MaxMsgsPerBundledRecv = HTC_MAX_MSG_PER_BUNDLE_RX;
953 		}
954 
955 		SET_HTC_PACKET_INFO_TX(pSendPacket,
956 				       NULL,
957 				       (uint8_t *) pSetupComp,
958 				       sizeof(HTC_SETUP_COMPLETE_EX_MSG),
959 				       ENDPOINT_0, HTC_SERVICE_TX_PACKET_TAG);
960 
961 		status = htc_send_pkt((HTC_HANDLE) target, pSendPacket);
962 		if (QDF_IS_STATUS_ERROR(status))
963 			break;
964 	} while (false);
965 
966 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("htc_start Exit\n"));
967 	return status;
968 }
969 
970 /*flush all queued buffers for surpriseremove case*/
971 void htc_flush_surprise_remove(HTC_HANDLE HTCHandle)
972 {
973 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
974 	int i;
975 	HTC_ENDPOINT *pEndpoint;
976 #ifdef RX_SG_SUPPORT
977 	qdf_nbuf_t netbuf;
978 	qdf_nbuf_queue_t *rx_sg_queue = &target->RxSgQueue;
979 #endif
980 
981 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("+htc_flush_surprise_remove\n"));
982 
983 	/* cleanup endpoints */
984 	for (i = 0; i < ENDPOINT_MAX; i++) {
985 		pEndpoint = &target->endpoint[i];
986 		htc_flush_rx_hold_queue(target, pEndpoint);
987 		htc_flush_endpoint_tx(target, pEndpoint, HTC_TX_PACKET_TAG_ALL);
988 	}
989 
990 	hif_flush_surprise_remove(target->hif_dev);
991 
992 #ifdef RX_SG_SUPPORT
993 	LOCK_HTC_RX(target);
994 	while ((netbuf = qdf_nbuf_queue_remove(rx_sg_queue)) != NULL)
995 		qdf_nbuf_free(netbuf);
996 	RESET_RX_SG_CONFIG(target);
997 	UNLOCK_HTC_RX(target);
998 #endif
999 
1000 	reset_endpoint_states(target);
1001 
1002 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("-htc_flush_surprise_remove\n"));
1003 }
1004 
1005 /* stop HTC communications, i.e. stop interrupt reception, and flush all queued
1006  * buffers
1007  */
1008 void htc_stop(HTC_HANDLE HTCHandle)
1009 {
1010 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
1011 	int i;
1012 	HTC_ENDPOINT *endpoint;
1013 #ifdef RX_SG_SUPPORT
1014 	qdf_nbuf_t netbuf;
1015 	qdf_nbuf_queue_t *rx_sg_queue = &target->RxSgQueue;
1016 #endif
1017 
1018 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("+htc_stop\n"));
1019 
1020 	htc_runtime_pm_deinit(target);
1021 
1022 	HTC_INFO("%s: endpoints cleanup\n", __func__);
1023 	/* cleanup endpoints */
1024 	for (i = 0; i < ENDPOINT_MAX; i++) {
1025 		endpoint = &target->endpoint[i];
1026 		htc_flush_rx_hold_queue(target, endpoint);
1027 		htc_flush_endpoint_tx(target, endpoint, HTC_TX_PACKET_TAG_ALL);
1028 		if (endpoint->ul_is_polled) {
1029 			qdf_timer_stop(&endpoint->ul_poll_timer);
1030 			qdf_timer_free(&endpoint->ul_poll_timer);
1031 		}
1032 	}
1033 
1034 	/* Note: htc_flush_endpoint_tx for all endpoints should be called before
1035 	 * hif_stop - otherwise htc_tx_completion_handler called from
1036 	 * hif_send_buffer_cleanup_on_pipe for residual tx frames in HIF layer,
1037 	 * might queue the packet again to HIF Layer - which could cause tx
1038 	 * buffer leak
1039 	 */
1040 
1041 	HTC_INFO("%s: stopping hif layer\n", __func__);
1042 	hif_stop(target->hif_dev);
1043 
1044 #ifdef RX_SG_SUPPORT
1045 	LOCK_HTC_RX(target);
1046 	while ((netbuf = qdf_nbuf_queue_remove(rx_sg_queue)) != NULL)
1047 		qdf_nbuf_free(netbuf);
1048 	RESET_RX_SG_CONFIG(target);
1049 	UNLOCK_HTC_RX(target);
1050 #endif
1051 
1052 	/**
1053 	 * In SSR case, HTC tx completion callback for wmi will be blocked
1054 	 * by TARGET_STATUS_RESET and HTC packets will be left unfreed on
1055 	 * lookup queue.
1056 	 *
1057 	 * In case of target failing to send wmi_ready_event, the htc connect
1058 	 * msg buffer will be left unmapped and not freed. So calling the
1059 	 * completion handler for this buffer will handle this scenario.
1060 	 */
1061 	HTC_INFO("%s: flush endpoints Tx lookup queue\n", __func__);
1062 	for (i = 0; i < ENDPOINT_MAX; i++) {
1063 		endpoint = &target->endpoint[i];
1064 		if (endpoint->service_id == WMI_CONTROL_SVC)
1065 			htc_flush_endpoint_txlookupQ(target, i, false);
1066 		else if (endpoint->service_id == HTC_CTRL_RSVD_SVC ||
1067 			 (endpoint->service_id == HTT_DATA_MSG_SVC &&
1068 			  !endpoint->ul_is_polled))
1069 			htc_flush_endpoint_txlookupQ(target, i, true);
1070 	}
1071 	HTC_INFO("%s: resetting endpoints state\n", __func__);
1072 
1073 	reset_endpoint_states(target);
1074 
1075 	AR_DEBUG_PRINTF(ATH_DEBUG_TRC, ("-htc_stop\n"));
1076 }
1077 
1078 void htc_dump_credit_states(HTC_HANDLE HTCHandle)
1079 {
1080 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
1081 	HTC_ENDPOINT *pEndpoint;
1082 	int i;
1083 
1084 	for (i = 0; i < ENDPOINT_MAX; i++) {
1085 		pEndpoint = &target->endpoint[i];
1086 		if (0 == pEndpoint->service_id)
1087 			continue;
1088 
1089 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1090 			("--- EP : %d  service_id: 0x%X    --------------\n",
1091 				 pEndpoint->Id, pEndpoint->service_id));
1092 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1093 				(" TxCredits          : %d\n",
1094 				 pEndpoint->TxCredits));
1095 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1096 				(" TxCreditSize       : %d\n",
1097 				 pEndpoint->TxCreditSize));
1098 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1099 				(" TxCreditsPerMaxMsg : %d\n",
1100 				 pEndpoint->TxCreditsPerMaxMsg));
1101 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1102 				(" TxQueueDepth       : %d\n",
1103 				 HTC_PACKET_QUEUE_DEPTH(&pEndpoint->TxQueue)));
1104 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1105 				("----------------------------------------\n"));
1106 	}
1107 }
1108 
1109 bool htc_get_endpoint_statistics(HTC_HANDLE HTCHandle,
1110 				   HTC_ENDPOINT_ID Endpoint,
1111 				   enum htc_endpoint_stat_action Action,
1112 				   struct htc_endpoint_stats *pStats)
1113 {
1114 #ifdef HTC_EP_STAT_PROFILING
1115 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
1116 	bool clearStats = false;
1117 	bool sample = false;
1118 
1119 	switch (Action) {
1120 	case HTC_EP_STAT_SAMPLE:
1121 		sample = true;
1122 		break;
1123 	case HTC_EP_STAT_SAMPLE_AND_CLEAR:
1124 		sample = true;
1125 		clearStats = true;
1126 		break;
1127 	case HTC_EP_STAT_CLEAR:
1128 		clearStats = true;
1129 		break;
1130 	default:
1131 		break;
1132 	}
1133 
1134 	A_ASSERT(Endpoint < ENDPOINT_MAX);
1135 
1136 	/* lock out TX and RX while we sample and/or clear */
1137 	LOCK_HTC_TX(target);
1138 	LOCK_HTC_RX(target);
1139 
1140 	if (sample) {
1141 		A_ASSERT(pStats);
1142 		/* return the stats to the caller */
1143 		qdf_mem_copy(pStats, &target->endpoint[Endpoint].endpoint_stats,
1144 			 sizeof(struct htc_endpoint_stats));
1145 	}
1146 
1147 	if (clearStats) {
1148 		/* reset stats */
1149 		qdf_mem_zero(&target->endpoint[Endpoint].endpoint_stats,
1150 			  sizeof(struct htc_endpoint_stats));
1151 	}
1152 
1153 	UNLOCK_HTC_RX(target);
1154 	UNLOCK_HTC_TX(target);
1155 
1156 	return true;
1157 #else
1158 	return false;
1159 #endif
1160 }
1161 
1162 void *htc_get_targetdef(HTC_HANDLE htc_handle)
1163 {
1164 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
1165 
1166 	return hif_get_targetdef(target->hif_dev);
1167 }
1168 
1169 #ifdef IPA_OFFLOAD
1170 /**
1171  * htc_ipa_get_ce_resource() - get uc resource on lower layer
1172  * @htc_handle: htc context
1173  * @ce_sr: copyengine source ring base physical address
1174  * @ce_sr_ring_size: copyengine source ring size
1175  * @ce_reg_paddr: copyengine register physical address
1176  *
1177  * Return: None
1178  */
1179 void htc_ipa_get_ce_resource(HTC_HANDLE htc_handle,
1180 			     qdf_shared_mem_t **ce_sr,
1181 			     uint32_t *ce_sr_ring_size,
1182 			     qdf_dma_addr_t *ce_reg_paddr)
1183 {
1184 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
1185 
1186 	if (target->hif_dev)
1187 		hif_ipa_get_ce_resource(target->hif_dev,
1188 					ce_sr, ce_sr_ring_size, ce_reg_paddr);
1189 }
1190 #endif /* IPA_OFFLOAD */
1191 
1192 #if defined(DEBUG_HL_LOGGING) && defined(CONFIG_HL_SUPPORT)
1193 
1194 void htc_dump_bundle_stats(HTC_HANDLE HTCHandle)
1195 {
1196 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
1197 	int total, i;
1198 
1199 	total = 0;
1200 	for (i = 0; i < HTC_MAX_MSG_PER_BUNDLE_RX; i++)
1201 		total += target->rx_bundle_stats[i];
1202 
1203 	if (total) {
1204 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY, ("RX Bundle stats:\n"));
1205 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY, ("Total RX packets: %d\n",
1206 						total));
1207 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY, (
1208 				"Number of bundle: Number of packets\n"));
1209 		for (i = 0; i < HTC_MAX_MSG_PER_BUNDLE_RX; i++)
1210 			AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1211 					("%10d:%10d(%2d%s)\n", (i+1),
1212 					 target->rx_bundle_stats[i],
1213 					 ((target->rx_bundle_stats[i]*100)/
1214 					  total), "%"));
1215 	}
1216 
1217 
1218 	total = 0;
1219 	for (i = 0; i < HTC_MAX_MSG_PER_BUNDLE_TX; i++)
1220 		total += target->tx_bundle_stats[i];
1221 
1222 	if (total) {
1223 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY, ("TX Bundle stats:\n"));
1224 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY, ("Total TX packets: %d\n",
1225 						total));
1226 		AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1227 				("Number of bundle: Number of packets\n"));
1228 		for (i = 0; i < HTC_MAX_MSG_PER_BUNDLE_TX; i++)
1229 			AR_DEBUG_PRINTF(ATH_DEBUG_ANY,
1230 					("%10d:%10d(%2d%s)\n", (i+1),
1231 					 target->tx_bundle_stats[i],
1232 					 ((target->tx_bundle_stats[i]*100)/
1233 					  total), "%"));
1234 	}
1235 }
1236 
1237 void htc_clear_bundle_stats(HTC_HANDLE HTCHandle)
1238 {
1239 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(HTCHandle);
1240 
1241 	qdf_mem_zero(&target->rx_bundle_stats, sizeof(target->rx_bundle_stats));
1242 	qdf_mem_zero(&target->tx_bundle_stats, sizeof(target->tx_bundle_stats));
1243 }
1244 #endif
1245 
1246 /**
1247  * htc_can_suspend_link - API to query HIF for link status
1248  * @htc_handle: HTC Handle
1249  *
1250  * API for upper layers to call HIF to query if the link can suspend
1251  *
1252  * Return: void
1253  */
1254 bool htc_can_suspend_link(HTC_HANDLE htc_handle)
1255 {
1256 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
1257 
1258 	if (!target->hif_dev)
1259 		return false;
1260 
1261 	return hif_can_suspend_link(target->hif_dev);
1262 }
1263 
1264 #ifdef FEATURE_RUNTIME_PM
1265 int htc_pm_runtime_get(HTC_HANDLE htc_handle)
1266 {
1267 	return hif_rtpm_get(HIF_RTPM_GET_ASYNC, HIF_RTPM_ID_HTT);
1268 }
1269 
1270 int htc_pm_runtime_put(HTC_HANDLE htc_handle)
1271 {
1272 	return hif_rtpm_put(HIF_RTPM_PUT_ASYNC, HIF_RTPM_ID_HTT);
1273 }
1274 #endif
1275 
1276 /**
1277  * htc_set_wmi_endpoint_count: Set number of WMI endpoint
1278  * @htc_handle: HTC handle
1279  * @wmi_ep_count: WMI endpoint count
1280  *
1281  * return: None
1282  */
1283 void htc_set_wmi_endpoint_count(HTC_HANDLE htc_handle, uint8_t wmi_ep_count)
1284 {
1285 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
1286 
1287 	target->wmi_ep_count = wmi_ep_count;
1288 }
1289 
1290 /**
1291  * htc_get_wmi_endpoint_count: Get number of WMI endpoint
1292  * @htc_handle: HTC handle
1293  *
1294  * return: WMI endpoint count
1295  */
1296 uint8_t htc_get_wmi_endpoint_count(HTC_HANDLE htc_handle)
1297 {
1298 	HTC_TARGET *target = GET_HTC_TARGET_FROM_HANDLE(htc_handle);
1299 
1300 	return target->wmi_ep_count;
1301 }
1302