xref: /wlan-dirver/qca-wifi-host-cmn/wmi/src/wmi_unified.c (revision 8ddef7dd9a290d4a9b1efd5d3efacf51d78a1a0d)
1 /*
2  * Copyright (c) 2015-2019 The Linux Foundation. All rights reserved.
3  *
4  * Permission to use, copy, modify, and/or distribute this software for
5  * any purpose with or without fee is hereby granted, provided that the
6  * above copyright notice and this permission notice appear in all
7  * copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
10  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
11  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
12  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16  * PERFORMANCE OF THIS SOFTWARE.
17  */
18 
19 /*
20  * Host WMI unified implementation
21  */
22 #include "htc_api.h"
23 #include "htc_api.h"
24 #include "wmi_unified_priv.h"
25 #include "wmi_unified_api.h"
26 #include "qdf_module.h"
27 #ifdef WMI_EXT_DBG
28 #include "qdf_list.h"
29 #endif
30 
31 #ifndef WMI_NON_TLV_SUPPORT
32 #include "wmi_tlv_helper.h"
33 #endif
34 
35 #include <linux/debugfs.h>
36 
37 #ifdef WMI_EXT_DBG
38 
39 /**
40  * wmi_ext_dbg_msg_enqueue() - enqueue wmi message
41  *
42  * @wmi_handle: wmi handler
43  *
44  * Return: size of wmi message queue after enqueue
45  */
46 static uint32_t wmi_ext_dbg_msg_enqueue(struct wmi_unified *wmi_handle,
47 					struct wmi_ext_dbg_msg *msg)
48 {
49 	uint32_t list_size;
50 
51 	qdf_spinlock_acquire(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
52 	qdf_list_insert_back_size(&wmi_handle->wmi_ext_dbg_msg_queue,
53 				  &msg->node, &list_size);
54 	qdf_spinlock_release(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
55 
56 	return list_size;
57 }
58 
59 /**
60  * wmi_ext_dbg_msg_dequeue() - dequeue wmi message
61  *
62  * @wmi_handle: wmi handler
63  *
64  * Return: wmi msg on success else NULL
65  */
66 static struct wmi_ext_dbg_msg *wmi_ext_dbg_msg_dequeue(struct wmi_unified
67 						       *wmi_handle)
68 {
69 	qdf_list_node_t *list_node = NULL;
70 
71 	qdf_spinlock_acquire(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
72 	qdf_list_remove_front(&wmi_handle->wmi_ext_dbg_msg_queue, &list_node);
73 	qdf_spinlock_release(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
74 
75 	if (!list_node)
76 		return NULL;
77 
78 	return qdf_container_of(list_node, struct wmi_ext_dbg_msg, node);
79 }
80 
81 /**
82  * wmi_ext_dbg_msg_record() - record wmi messages
83  *
84  * @wmi_handle: wmi handler
85  * @buf: wmi message buffer
86  * @len: wmi message length
87  * @type: wmi message type
88  *
89  * Return: QDF_STATUS_SUCCESS on successful recording else failure.
90  */
91 static QDF_STATUS wmi_ext_dbg_msg_record(struct wmi_unified *wmi_handle,
92 					 uint8_t *buf, uint32_t len,
93 					 enum WMI_MSG_TYPE type)
94 {
95 	struct wmi_ext_dbg_msg *msg;
96 	uint32_t list_size;
97 
98 	msg = wmi_ext_dbg_msg_get(len);
99 	if (!msg)
100 		return QDF_STATUS_E_NOMEM;
101 
102 	msg->len = len;
103 	msg->type = type;
104 	qdf_mem_copy(msg->buf, buf, len);
105 	msg->ts = qdf_get_log_timestamp();
106 	list_size = wmi_ext_dbg_msg_enqueue(wmi_handle, msg);
107 
108 	if (list_size >= wmi_handle->wmi_ext_dbg_msg_queue_size) {
109 		msg = wmi_ext_dbg_msg_dequeue(wmi_handle);
110 		wmi_ext_dbg_msg_put(msg);
111 	}
112 
113 	return QDF_STATUS_SUCCESS;
114 }
115 
116 /**
117  * wmi_ext_dbg_msg_cmd_record() - record wmi command messages
118  *
119  * @wmi_handle: wmi handler
120  * @buf: wmi command buffer
121  * @len: wmi command message length
122  *
123  * Return: QDF_STATUS_SUCCESS on successful recording else failure.
124  */
125 static QDF_STATUS wmi_ext_dbg_msg_cmd_record(struct wmi_unified *wmi_handle,
126 					     uint8_t *buf, uint32_t len)
127 {
128 	return wmi_ext_dbg_msg_record(wmi_handle, buf, len,
129 				      WMI_MSG_TYPE_CMD);
130 }
131 
132 /**
133  * wmi_ext_dbg_msg_event_record() - record wmi event messages
134  *
135  * @wmi_handle: wmi handler
136  * @buf: wmi event buffer
137  * @len: wmi event message length
138  *
139  * Return: QDF_STATUS_SUCCESS on successful recording else failure.
140  */
141 static QDF_STATUS wmi_ext_dbg_msg_event_record(struct wmi_unified *wmi_handle,
142 					       uint8_t *buf, uint32_t len)
143 {
144 	uint32_t id;
145 
146 	id = WMI_GET_FIELD(buf, WMI_CMD_HDR, COMMANDID);
147 	if (id != wmi_handle->wmi_events[wmi_diag_event_id])
148 		return wmi_ext_dbg_msg_record(wmi_handle, buf, len,
149 					      WMI_MSG_TYPE_EVENT);
150 
151 	return QDF_STATUS_SUCCESS;
152 }
153 
154 /**
155  * wmi_ext_dbg_msg_queue_init() - create debugfs queue and associated lock
156  *
157  * @wmi_handle: wmi handler
158  *
159  * Return: none
160  */
161 static void wmi_ext_dbg_msg_queue_init(struct wmi_unified *wmi_handle)
162 {
163 	qdf_list_create(&wmi_handle->wmi_ext_dbg_msg_queue,
164 			wmi_handle->wmi_ext_dbg_msg_queue_size);
165 	qdf_spinlock_create(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
166 }
167 
168 /**
169  * wmi_ext_dbg_msg_queue_deinit() - destroy debugfs queue and associated lock
170  *
171  * @wmi_handle: wmi handler
172  *
173  * Return: none
174  */
175 static void wmi_ext_dbg_msg_queue_deinit(struct wmi_unified *wmi_handle)
176 {
177 	qdf_list_destroy(&wmi_handle->wmi_ext_dbg_msg_queue);
178 	qdf_spinlock_destroy(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
179 }
180 
181 /**
182  * wmi_ext_dbg_msg_show() - debugfs function to display whole content of
183  * wmi command/event messages including headers.
184  *
185  * @file: qdf debugfs file handler
186  * @arg: pointer to wmi handler
187  *
188  * Return: QDF_STATUS_SUCCESS if all the messages are shown successfully,
189  * else QDF_STATUS_E_AGAIN if more data to show.
190  */
191 static QDF_STATUS wmi_ext_dbg_msg_show(qdf_debugfs_file_t file, void *arg)
192 {
193 	struct wmi_unified *wmi_handle = (struct wmi_unified *)arg;
194 	struct wmi_ext_dbg_msg *msg;
195 	uint64_t secs, usecs;
196 
197 	msg = wmi_ext_dbg_msg_dequeue(wmi_handle);
198 	if (!msg)
199 		return QDF_STATUS_SUCCESS;
200 
201 	qdf_debugfs_printf(file, "%s: 0x%x\n",
202 			   msg->type == WMI_MSG_TYPE_CMD ? "COMMAND" :
203 			   "EVENT", WMI_GET_FIELD(msg->buf, WMI_CMD_HDR,
204 						  COMMANDID));
205 	qdf_log_timestamp_to_secs(msg->ts, &secs, &usecs);
206 	qdf_debugfs_printf(file, "Time: %llu.%llu\n", secs, usecs);
207 	qdf_debugfs_printf(file, "Length:%d\n", msg->len);
208 	qdf_debugfs_hexdump(file, msg->buf, msg->len,
209 			    WMI_EXT_DBG_DUMP_ROW_SIZE,
210 			    WMI_EXT_DBG_DUMP_GROUP_SIZE);
211 	qdf_debugfs_printf(file, "\n");
212 
213 	if (qdf_debugfs_overflow(file)) {
214 		qdf_spinlock_acquire(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
215 		qdf_list_insert_front(&wmi_handle->wmi_ext_dbg_msg_queue,
216 				      &msg->node);
217 		qdf_spinlock_release(&wmi_handle->wmi_ext_dbg_msg_queue_lock);
218 
219 	} else {
220 		wmi_ext_dbg_msg_put(msg);
221 	}
222 
223 	return QDF_STATUS_E_AGAIN;
224 }
225 
226 /**
227  * wmi_ext_dbg_msg_write() - debugfs write not supported
228  *
229  * @priv: private data
230  * @buf: received data buffer
231  * @len: length of received buffer
232  *
233  * Return: QDF_STATUS_E_NOSUPPORT.
234  */
235 static QDF_STATUS wmi_ext_dbg_msg_write(void *priv, const char *buf,
236 					qdf_size_t len)
237 {
238 	return QDF_STATUS_E_NOSUPPORT;
239 }
240 
241 static struct qdf_debugfs_fops wmi_ext_dbgfs_ops = {
242 	.show		= wmi_ext_dbg_msg_show,
243 	.write		= wmi_ext_dbg_msg_write,
244 	.priv		= NULL,
245 };
246 
247 /**
248  * wmi_ext_debugfs_init() - init debugfs items for extended wmi dump.
249  *
250  * @wmi_handle: wmi handler
251  *
252  * Return: QDF_STATUS_SUCCESS if debugfs is initialized else
253  * QDF_STATUS_E_FAILURE
254  */
255 static QDF_STATUS wmi_ext_dbgfs_init(struct wmi_unified *wmi_handle)
256 {
257 	qdf_dentry_t dentry;
258 
259 	dentry  = qdf_debugfs_create_dir(WMI_EXT_DBG_DIR, NULL);
260 	if (!dentry) {
261 		WMI_LOGE("error while creating extended wmi debugfs dir");
262 		return QDF_STATUS_E_FAILURE;
263 	}
264 
265 	wmi_ext_dbgfs_ops.priv = wmi_handle;
266 	if (!qdf_debugfs_create_file(WMI_EXT_DBG_FILE, WMI_EXT_DBG_FILE_PERM,
267 				     dentry, &wmi_ext_dbgfs_ops)) {
268 		qdf_debugfs_remove_dir(dentry);
269 		WMI_LOGE("error while creating extended wmi debugfs file");
270 		return QDF_STATUS_E_FAILURE;
271 	}
272 
273 	wmi_handle->wmi_ext_dbg_dentry = dentry;
274 	wmi_handle->wmi_ext_dbg_msg_queue_size = WMI_EXT_DBG_QUEUE_SIZE;
275 	wmi_ext_dbg_msg_queue_init(wmi_handle);
276 
277 	return QDF_STATUS_SUCCESS;
278 }
279 
280 /**
281  * wmi_ext_debugfs_deinit() - cleanup/deinit debugfs items of extended wmi dump.
282  *
283  * @wmi_handle: wmi handler
284  *
285  * Return: QDF_STATUS_SUCCESS if cleanup is successful
286  */
287 static QDF_STATUS wmi_ext_dbgfs_deinit(struct wmi_unified *wmi_handle)
288 {
289 	struct wmi_ext_dbg_msg *msg;
290 
291 	while ((msg = wmi_ext_dbg_msg_dequeue(wmi_handle)))
292 		wmi_ext_dbg_msg_put(msg);
293 
294 	wmi_ext_dbg_msg_queue_deinit(wmi_handle);
295 	qdf_debugfs_remove_dir_recursive(wmi_handle->wmi_ext_dbg_dentry);
296 
297 	return QDF_STATUS_SUCCESS;
298 }
299 
300 #endif /*WMI_EXT_DBG */
301 
302 /* This check for CONFIG_WIN temporary added due to redeclaration compilation
303 error in MCL. Error is caused due to inclusion of wmi.h in wmi_unified_api.h
304 which gets included here through ol_if_athvar.h. Eventually it is expected that
305 wmi.h will be removed from wmi_unified_api.h after cleanup, which will need
306 WMI_CMD_HDR to be defined here. */
307 #ifdef CONFIG_WIN
308 /* Copied from wmi.h */
309 #undef MS
310 #define MS(_v, _f) (((_v) & _f##_MASK) >> _f##_LSB)
311 #undef SM
312 #define SM(_v, _f) (((_v) << _f##_LSB) & _f##_MASK)
313 #undef WO
314 #define WO(_f)      ((_f##_OFFSET) >> 2)
315 
316 #undef GET_FIELD
317 #define GET_FIELD(_addr, _f) MS(*((uint32_t *)(_addr) + WO(_f)), _f)
318 #undef SET_FIELD
319 #define SET_FIELD(_addr, _f, _val)  \
320 	    (*((uint32_t *)(_addr) + WO(_f)) = \
321 		(*((uint32_t *)(_addr) + WO(_f)) & ~_f##_MASK) | SM(_val, _f))
322 
323 #define WMI_GET_FIELD(_msg_buf, _msg_type, _f) \
324 	    GET_FIELD(_msg_buf, _msg_type ## _ ## _f)
325 
326 #define WMI_SET_FIELD(_msg_buf, _msg_type, _f, _val) \
327 	    SET_FIELD(_msg_buf, _msg_type ## _ ## _f, _val)
328 
329 #define WMI_EP_APASS           0x0
330 #define WMI_EP_LPASS           0x1
331 #define WMI_EP_SENSOR          0x2
332 
333 /*
334  *  * Control Path
335  *   */
336 typedef PREPACK struct {
337 	uint32_t	commandId:24,
338 			reserved:2, /* used for WMI endpoint ID */
339 			plt_priv:6; /* platform private */
340 } POSTPACK WMI_CMD_HDR;        /* used for commands and events */
341 
342 #define WMI_CMD_HDR_COMMANDID_LSB           0
343 #define WMI_CMD_HDR_COMMANDID_MASK          0x00ffffff
344 #define WMI_CMD_HDR_COMMANDID_OFFSET        0x00000000
345 #define WMI_CMD_HDR_WMI_ENDPOINTID_MASK        0x03000000
346 #define WMI_CMD_HDR_WMI_ENDPOINTID_OFFSET      24
347 #define WMI_CMD_HDR_PLT_PRIV_LSB               24
348 #define WMI_CMD_HDR_PLT_PRIV_MASK              0xff000000
349 #define WMI_CMD_HDR_PLT_PRIV_OFFSET            0x00000000
350 /* end of copy wmi.h */
351 #endif /* CONFIG_WIN */
352 
353 #define WMI_MIN_HEAD_ROOM 64
354 
355 /* WBUFF pool sizes for WMI */
356 /* Allocation of size 256 bytes */
357 #define WMI_WBUFF_POOL_0_SIZE 128
358 /* Allocation of size 512 bytes */
359 #define WMI_WBUFF_POOL_1_SIZE 16
360 /* Allocation of size 1024 bytes */
361 #define WMI_WBUFF_POOL_2_SIZE 8
362 /* Allocation of size 2048 bytes */
363 #define WMI_WBUFF_POOL_3_SIZE 8
364 
365 #ifdef WMI_INTERFACE_EVENT_LOGGING
366 #if (LINUX_VERSION_CODE >= KERNEL_VERSION(4, 3, 0))
367 /* TODO Cleanup this backported function */
368 static int wmi_bp_seq_printf(struct seq_file *m, const char *f, ...)
369 {
370 	va_list args;
371 
372 	va_start(args, f);
373 	seq_vprintf(m, f, args);
374 	va_end(args);
375 
376 	return 0;
377 }
378 #else
379 #define wmi_bp_seq_printf(m, fmt, ...) seq_printf((m), fmt, ##__VA_ARGS__)
380 #endif
381 
382 #ifndef MAX_WMI_INSTANCES
383 #define CUSTOM_MGMT_CMD_DATA_SIZE 4
384 #endif
385 
386 #ifdef CONFIG_MCL
387 /* WMI commands */
388 uint32_t g_wmi_command_buf_idx = 0;
389 struct wmi_command_debug wmi_command_log_buffer[WMI_EVENT_DEBUG_MAX_ENTRY];
390 
391 /* WMI commands TX completed */
392 uint32_t g_wmi_command_tx_cmp_buf_idx = 0;
393 struct wmi_command_debug
394 	wmi_command_tx_cmp_log_buffer[WMI_EVENT_DEBUG_MAX_ENTRY];
395 
396 /* WMI events when processed */
397 uint32_t g_wmi_event_buf_idx = 0;
398 struct wmi_event_debug wmi_event_log_buffer[WMI_EVENT_DEBUG_MAX_ENTRY];
399 
400 /* WMI events when queued */
401 uint32_t g_wmi_rx_event_buf_idx = 0;
402 struct wmi_event_debug wmi_rx_event_log_buffer[WMI_EVENT_DEBUG_MAX_ENTRY];
403 #endif
404 
405 #define WMI_COMMAND_RECORD(h, a, b) {					\
406 	if (wmi_log_max_entry <=					\
407 		*(h->log_info.wmi_command_log_buf_info.p_buf_tail_idx))	\
408 		*(h->log_info.wmi_command_log_buf_info.p_buf_tail_idx) = 0;\
409 	((struct wmi_command_debug *)h->log_info.wmi_command_log_buf_info.buf)\
410 		[*(h->log_info.wmi_command_log_buf_info.p_buf_tail_idx)]\
411 						.command = a;		\
412 	qdf_mem_copy(((struct wmi_command_debug *)h->log_info.		\
413 				wmi_command_log_buf_info.buf)		\
414 		[*(h->log_info.wmi_command_log_buf_info.p_buf_tail_idx)].data,\
415 			b, wmi_record_max_length);			\
416 	((struct wmi_command_debug *)h->log_info.wmi_command_log_buf_info.buf)\
417 		[*(h->log_info.wmi_command_log_buf_info.p_buf_tail_idx)].\
418 		time = qdf_get_log_timestamp();			\
419 	(*(h->log_info.wmi_command_log_buf_info.p_buf_tail_idx))++;	\
420 	h->log_info.wmi_command_log_buf_info.length++;			\
421 }
422 
423 #define WMI_COMMAND_TX_CMP_RECORD(h, a, b) {				\
424 	if (wmi_log_max_entry <=					\
425 		*(h->log_info.wmi_command_tx_cmp_log_buf_info.p_buf_tail_idx))\
426 		*(h->log_info.wmi_command_tx_cmp_log_buf_info.		\
427 				p_buf_tail_idx) = 0;			\
428 	((struct wmi_command_debug *)h->log_info.			\
429 		wmi_command_tx_cmp_log_buf_info.buf)			\
430 		[*(h->log_info.wmi_command_tx_cmp_log_buf_info.		\
431 				p_buf_tail_idx)].			\
432 							command	= a;	\
433 	qdf_mem_copy(((struct wmi_command_debug *)h->log_info.		\
434 				wmi_command_tx_cmp_log_buf_info.buf)	\
435 		[*(h->log_info.wmi_command_tx_cmp_log_buf_info.		\
436 			p_buf_tail_idx)].				\
437 		data, b, wmi_record_max_length);			\
438 	((struct wmi_command_debug *)h->log_info.			\
439 		wmi_command_tx_cmp_log_buf_info.buf)			\
440 		[*(h->log_info.wmi_command_tx_cmp_log_buf_info.		\
441 				p_buf_tail_idx)].			\
442 		time = qdf_get_log_timestamp();				\
443 	(*(h->log_info.wmi_command_tx_cmp_log_buf_info.p_buf_tail_idx))++;\
444 	h->log_info.wmi_command_tx_cmp_log_buf_info.length++;		\
445 }
446 
447 #define WMI_EVENT_RECORD(h, a, b) {					\
448 	if (wmi_log_max_entry <=					\
449 		*(h->log_info.wmi_event_log_buf_info.p_buf_tail_idx))	\
450 		*(h->log_info.wmi_event_log_buf_info.p_buf_tail_idx) = 0;\
451 	((struct wmi_event_debug *)h->log_info.wmi_event_log_buf_info.buf)\
452 		[*(h->log_info.wmi_event_log_buf_info.p_buf_tail_idx)].	\
453 		event = a;						\
454 	qdf_mem_copy(((struct wmi_event_debug *)h->log_info.		\
455 				wmi_event_log_buf_info.buf)		\
456 		[*(h->log_info.wmi_event_log_buf_info.p_buf_tail_idx)].data, b,\
457 		wmi_record_max_length);					\
458 	((struct wmi_event_debug *)h->log_info.wmi_event_log_buf_info.buf)\
459 		[*(h->log_info.wmi_event_log_buf_info.p_buf_tail_idx)].time =\
460 		qdf_get_log_timestamp();				\
461 	(*(h->log_info.wmi_event_log_buf_info.p_buf_tail_idx))++;	\
462 	h->log_info.wmi_event_log_buf_info.length++;			\
463 }
464 
465 #define WMI_RX_EVENT_RECORD(h, a, b) {					\
466 	if (wmi_log_max_entry <=					\
467 		*(h->log_info.wmi_rx_event_log_buf_info.p_buf_tail_idx))\
468 		*(h->log_info.wmi_rx_event_log_buf_info.p_buf_tail_idx) = 0;\
469 	((struct wmi_event_debug *)h->log_info.wmi_rx_event_log_buf_info.buf)\
470 		[*(h->log_info.wmi_rx_event_log_buf_info.p_buf_tail_idx)].\
471 		event = a;						\
472 	qdf_mem_copy(((struct wmi_event_debug *)h->log_info.		\
473 				wmi_rx_event_log_buf_info.buf)		\
474 		[*(h->log_info.wmi_rx_event_log_buf_info.p_buf_tail_idx)].\
475 			data, b, wmi_record_max_length);		\
476 	((struct wmi_event_debug *)h->log_info.wmi_rx_event_log_buf_info.buf)\
477 		[*(h->log_info.wmi_rx_event_log_buf_info.p_buf_tail_idx)].\
478 		time =	qdf_get_log_timestamp();			\
479 	(*(h->log_info.wmi_rx_event_log_buf_info.p_buf_tail_idx))++;	\
480 	h->log_info.wmi_rx_event_log_buf_info.length++;			\
481 }
482 
483 #ifdef CONFIG_MCL
484 uint32_t g_wmi_mgmt_command_buf_idx = 0;
485 struct
486 wmi_command_debug wmi_mgmt_command_log_buffer[WMI_MGMT_EVENT_DEBUG_MAX_ENTRY];
487 
488 /* wmi_mgmt commands TX completed */
489 uint32_t g_wmi_mgmt_command_tx_cmp_buf_idx = 0;
490 struct wmi_command_debug
491 wmi_mgmt_command_tx_cmp_log_buffer[WMI_MGMT_EVENT_DEBUG_MAX_ENTRY];
492 
493 /* wmi_mgmt events when received */
494 uint32_t g_wmi_mgmt_rx_event_buf_idx = 0;
495 struct wmi_event_debug
496 wmi_mgmt_rx_event_log_buffer[WMI_MGMT_EVENT_DEBUG_MAX_ENTRY];
497 
498 /* wmi_diag events when received */
499 uint32_t g_wmi_diag_rx_event_buf_idx = 0;
500 struct wmi_event_debug
501 wmi_diag_rx_event_log_buffer[WMI_DIAG_RX_EVENT_DEBUG_MAX_ENTRY];
502 #endif
503 
504 #define WMI_MGMT_COMMAND_RECORD(h, a, b) {                              \
505 	if (wmi_mgmt_log_max_entry <=                                   \
506 		*(h->log_info.wmi_mgmt_command_log_buf_info.p_buf_tail_idx)) \
507 		*(h->log_info.wmi_mgmt_command_log_buf_info.		\
508 				p_buf_tail_idx) = 0;			\
509 	((struct wmi_command_debug *)h->log_info.                       \
510 		 wmi_mgmt_command_log_buf_info.buf)                     \
511 		[*(h->log_info.wmi_mgmt_command_log_buf_info.p_buf_tail_idx)].\
512 			command = a;                                    \
513 	qdf_mem_copy(((struct wmi_command_debug *)h->log_info.          \
514 				wmi_mgmt_command_log_buf_info.buf)      \
515 		[*(h->log_info.wmi_mgmt_command_log_buf_info.p_buf_tail_idx)].\
516 		data, b,                                                \
517 		wmi_record_max_length);                                	\
518 	((struct wmi_command_debug *)h->log_info.                       \
519 		 wmi_mgmt_command_log_buf_info.buf)                     \
520 		[*(h->log_info.wmi_mgmt_command_log_buf_info.p_buf_tail_idx)].\
521 			time =        qdf_get_log_timestamp();          \
522 	(*(h->log_info.wmi_mgmt_command_log_buf_info.p_buf_tail_idx))++;\
523 	h->log_info.wmi_mgmt_command_log_buf_info.length++;             \
524 }
525 
526 #define WMI_MGMT_COMMAND_TX_CMP_RECORD(h, a, b) {			\
527 	if (wmi_mgmt_log_max_entry <=					\
528 		*(h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.	\
529 			p_buf_tail_idx))				\
530 		*(h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.	\
531 			p_buf_tail_idx) = 0;				\
532 	((struct wmi_command_debug *)h->log_info.			\
533 			wmi_mgmt_command_tx_cmp_log_buf_info.buf)	\
534 		[*(h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.	\
535 				p_buf_tail_idx)].command = a;		\
536 	qdf_mem_copy(((struct wmi_command_debug *)h->log_info.		\
537 				wmi_mgmt_command_tx_cmp_log_buf_info.buf)\
538 		[*(h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.	\
539 			p_buf_tail_idx)].data, b,			\
540 			wmi_record_max_length);				\
541 	((struct wmi_command_debug *)h->log_info.			\
542 			wmi_mgmt_command_tx_cmp_log_buf_info.buf)	\
543 		[*(h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.	\
544 				p_buf_tail_idx)].time =			\
545 		qdf_get_log_timestamp();				\
546 	(*(h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.		\
547 			p_buf_tail_idx))++;				\
548 	h->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.length++;	\
549 }
550 
551 #define WMI_MGMT_RX_EVENT_RECORD(h, a, b) do {				\
552 	if (wmi_mgmt_log_max_entry <=					\
553 		*(h->log_info.wmi_mgmt_event_log_buf_info.p_buf_tail_idx))\
554 		*(h->log_info.wmi_mgmt_event_log_buf_info.p_buf_tail_idx) = 0;\
555 	((struct wmi_event_debug *)h->log_info.wmi_mgmt_event_log_buf_info.buf)\
556 		[*(h->log_info.wmi_mgmt_event_log_buf_info.p_buf_tail_idx)]\
557 					.event = a;			\
558 	qdf_mem_copy(((struct wmi_event_debug *)h->log_info.		\
559 				wmi_mgmt_event_log_buf_info.buf)	\
560 		[*(h->log_info.wmi_mgmt_event_log_buf_info.p_buf_tail_idx)].\
561 			data, b, wmi_record_max_length);		\
562 	((struct wmi_event_debug *)h->log_info.wmi_mgmt_event_log_buf_info.buf)\
563 		[*(h->log_info.wmi_mgmt_event_log_buf_info.p_buf_tail_idx)].\
564 			time = qdf_get_log_timestamp();			\
565 	(*(h->log_info.wmi_mgmt_event_log_buf_info.p_buf_tail_idx))++;	\
566 	h->log_info.wmi_mgmt_event_log_buf_info.length++;		\
567 } while (0);
568 
569 #define WMI_DIAG_RX_EVENT_RECORD(h, a, b) do {                             \
570 	if (wmi_mgmt_log_max_entry <=                                   \
571 		*(h->log_info.wmi_diag_event_log_buf_info.p_buf_tail_idx))\
572 		*(h->log_info.wmi_diag_event_log_buf_info.p_buf_tail_idx) = 0;\
573 	((struct wmi_event_debug *)h->log_info.wmi_diag_event_log_buf_info.buf)\
574 		[*(h->log_info.wmi_diag_event_log_buf_info.p_buf_tail_idx)]\
575 					.event = a;                     \
576 	qdf_mem_copy(((struct wmi_event_debug *)h->log_info.            \
577 				wmi_diag_event_log_buf_info.buf)        \
578 		[*(h->log_info.wmi_diag_event_log_buf_info.p_buf_tail_idx)].\
579 			data, b, wmi_record_max_length);                \
580 	((struct wmi_event_debug *)h->log_info.wmi_diag_event_log_buf_info.buf)\
581 		[*(h->log_info.wmi_diag_event_log_buf_info.p_buf_tail_idx)].\
582 			time = qdf_get_log_timestamp();                 \
583 	(*(h->log_info.wmi_diag_event_log_buf_info.p_buf_tail_idx))++;  \
584 	h->log_info.wmi_diag_event_log_buf_info.length++;               \
585 } while (0);
586 
587 /* These are defined to made it as module param, which can be configured */
588 uint32_t wmi_log_max_entry = WMI_EVENT_DEBUG_MAX_ENTRY;
589 uint32_t wmi_mgmt_log_max_entry = WMI_MGMT_EVENT_DEBUG_MAX_ENTRY;
590 uint32_t wmi_diag_log_max_entry = WMI_DIAG_RX_EVENT_DEBUG_MAX_ENTRY;
591 uint32_t wmi_record_max_length = WMI_EVENT_DEBUG_ENTRY_MAX_LENGTH;
592 uint32_t wmi_display_size = 100;
593 
594 /**
595  * wmi_log_init() - Initialize WMI event logging
596  * @wmi_handle: WMI handle.
597  *
598  * Return: Initialization status
599  */
600 #ifdef CONFIG_MCL
601 static QDF_STATUS wmi_log_init(struct wmi_unified *wmi_handle)
602 {
603 	struct wmi_log_buf_t *cmd_log_buf =
604 			&wmi_handle->log_info.wmi_command_log_buf_info;
605 	struct wmi_log_buf_t *cmd_tx_cmpl_log_buf =
606 			&wmi_handle->log_info.wmi_command_tx_cmp_log_buf_info;
607 
608 	struct wmi_log_buf_t *event_log_buf =
609 			&wmi_handle->log_info.wmi_event_log_buf_info;
610 	struct wmi_log_buf_t *rx_event_log_buf =
611 			&wmi_handle->log_info.wmi_rx_event_log_buf_info;
612 
613 	struct wmi_log_buf_t *mgmt_cmd_log_buf =
614 			&wmi_handle->log_info.wmi_mgmt_command_log_buf_info;
615 	struct wmi_log_buf_t *mgmt_cmd_tx_cmp_log_buf =
616 		&wmi_handle->log_info.wmi_mgmt_command_tx_cmp_log_buf_info;
617 	struct wmi_log_buf_t *mgmt_event_log_buf =
618 			&wmi_handle->log_info.wmi_mgmt_event_log_buf_info;
619 	struct wmi_log_buf_t *diag_event_log_buf =
620 			&wmi_handle->log_info.wmi_diag_event_log_buf_info;
621 
622 	/* WMI commands */
623 	cmd_log_buf->length = 0;
624 	cmd_log_buf->buf_tail_idx = 0;
625 	cmd_log_buf->buf = wmi_command_log_buffer;
626 	cmd_log_buf->p_buf_tail_idx = &g_wmi_command_buf_idx;
627 	cmd_log_buf->size = WMI_EVENT_DEBUG_MAX_ENTRY;
628 
629 	/* WMI commands TX completed */
630 	cmd_tx_cmpl_log_buf->length = 0;
631 	cmd_tx_cmpl_log_buf->buf_tail_idx = 0;
632 	cmd_tx_cmpl_log_buf->buf = wmi_command_tx_cmp_log_buffer;
633 	cmd_tx_cmpl_log_buf->p_buf_tail_idx = &g_wmi_command_tx_cmp_buf_idx;
634 	cmd_tx_cmpl_log_buf->size = WMI_EVENT_DEBUG_MAX_ENTRY;
635 
636 	/* WMI events when processed */
637 	event_log_buf->length = 0;
638 	event_log_buf->buf_tail_idx = 0;
639 	event_log_buf->buf = wmi_event_log_buffer;
640 	event_log_buf->p_buf_tail_idx = &g_wmi_event_buf_idx;
641 	event_log_buf->size = WMI_EVENT_DEBUG_MAX_ENTRY;
642 
643 	/* WMI events when queued */
644 	rx_event_log_buf->length = 0;
645 	rx_event_log_buf->buf_tail_idx = 0;
646 	rx_event_log_buf->buf = wmi_rx_event_log_buffer;
647 	rx_event_log_buf->p_buf_tail_idx = &g_wmi_rx_event_buf_idx;
648 	rx_event_log_buf->size = WMI_EVENT_DEBUG_MAX_ENTRY;
649 
650 	/* WMI Management commands */
651 	mgmt_cmd_log_buf->length = 0;
652 	mgmt_cmd_log_buf->buf_tail_idx = 0;
653 	mgmt_cmd_log_buf->buf = wmi_mgmt_command_log_buffer;
654 	mgmt_cmd_log_buf->p_buf_tail_idx = &g_wmi_mgmt_command_buf_idx;
655 	mgmt_cmd_log_buf->size = WMI_MGMT_EVENT_DEBUG_MAX_ENTRY;
656 
657 	/* WMI Management commands Tx completed*/
658 	mgmt_cmd_tx_cmp_log_buf->length = 0;
659 	mgmt_cmd_tx_cmp_log_buf->buf_tail_idx = 0;
660 	mgmt_cmd_tx_cmp_log_buf->buf = wmi_mgmt_command_tx_cmp_log_buffer;
661 	mgmt_cmd_tx_cmp_log_buf->p_buf_tail_idx =
662 		&g_wmi_mgmt_command_tx_cmp_buf_idx;
663 	mgmt_cmd_tx_cmp_log_buf->size = WMI_MGMT_EVENT_DEBUG_MAX_ENTRY;
664 
665 	/* WMI Management events when received */
666 	mgmt_event_log_buf->length = 0;
667 	mgmt_event_log_buf->buf_tail_idx = 0;
668 	mgmt_event_log_buf->buf = wmi_mgmt_rx_event_log_buffer;
669 	mgmt_event_log_buf->p_buf_tail_idx = &g_wmi_mgmt_rx_event_buf_idx;
670 	mgmt_event_log_buf->size = WMI_MGMT_EVENT_DEBUG_MAX_ENTRY;
671 
672 	/* WMI diag events when received */
673 	diag_event_log_buf->length = 0;
674 	diag_event_log_buf->buf_tail_idx = 0;
675 	diag_event_log_buf->buf = wmi_diag_rx_event_log_buffer;
676 	diag_event_log_buf->p_buf_tail_idx = &g_wmi_diag_rx_event_buf_idx;
677 	diag_event_log_buf->size = WMI_DIAG_RX_EVENT_DEBUG_MAX_ENTRY;
678 
679 	qdf_spinlock_create(&wmi_handle->log_info.wmi_record_lock);
680 	wmi_handle->log_info.wmi_logging_enable = 1;
681 
682 	return QDF_STATUS_SUCCESS;
683 }
684 #else
685 static QDF_STATUS wmi_log_init(struct wmi_unified *wmi_handle)
686 {
687 	struct wmi_log_buf_t *cmd_log_buf =
688 			&wmi_handle->log_info.wmi_command_log_buf_info;
689 	struct wmi_log_buf_t *cmd_tx_cmpl_log_buf =
690 			&wmi_handle->log_info.wmi_command_tx_cmp_log_buf_info;
691 
692 	struct wmi_log_buf_t *event_log_buf =
693 			&wmi_handle->log_info.wmi_event_log_buf_info;
694 	struct wmi_log_buf_t *rx_event_log_buf =
695 			&wmi_handle->log_info.wmi_rx_event_log_buf_info;
696 
697 	struct wmi_log_buf_t *mgmt_cmd_log_buf =
698 			&wmi_handle->log_info.wmi_mgmt_command_log_buf_info;
699 	struct wmi_log_buf_t *mgmt_cmd_tx_cmp_log_buf =
700 		&wmi_handle->log_info.wmi_mgmt_command_tx_cmp_log_buf_info;
701 	struct wmi_log_buf_t *mgmt_event_log_buf =
702 			&wmi_handle->log_info.wmi_mgmt_event_log_buf_info;
703 	struct wmi_log_buf_t *diag_event_log_buf =
704 			&wmi_handle->log_info.wmi_diag_event_log_buf_info;
705 
706 	wmi_handle->log_info.wmi_logging_enable = 0;
707 
708 	/* WMI commands */
709 	cmd_log_buf->length = 0;
710 	cmd_log_buf->buf_tail_idx = 0;
711 	cmd_log_buf->buf = (struct wmi_command_debug *) qdf_mem_malloc(
712 		wmi_log_max_entry * sizeof(struct wmi_command_debug));
713 	cmd_log_buf->size = wmi_log_max_entry;
714 
715 	if (!cmd_log_buf->buf)
716 		return QDF_STATUS_E_NOMEM;
717 
718 	cmd_log_buf->p_buf_tail_idx = &cmd_log_buf->buf_tail_idx;
719 
720 	/* WMI commands TX completed */
721 	cmd_tx_cmpl_log_buf->length = 0;
722 	cmd_tx_cmpl_log_buf->buf_tail_idx = 0;
723 	cmd_tx_cmpl_log_buf->buf = (struct wmi_command_debug *) qdf_mem_malloc(
724 		wmi_log_max_entry * sizeof(struct wmi_command_debug));
725 	cmd_tx_cmpl_log_buf->size = wmi_log_max_entry;
726 
727 	if (!cmd_tx_cmpl_log_buf->buf)
728 		return QDF_STATUS_E_NOMEM;
729 
730 	cmd_tx_cmpl_log_buf->p_buf_tail_idx =
731 		&cmd_tx_cmpl_log_buf->buf_tail_idx;
732 
733 	/* WMI events when processed */
734 	event_log_buf->length = 0;
735 	event_log_buf->buf_tail_idx = 0;
736 	event_log_buf->buf = (struct wmi_event_debug *) qdf_mem_malloc(
737 		wmi_log_max_entry * sizeof(struct wmi_event_debug));
738 	event_log_buf->size = wmi_log_max_entry;
739 
740 	if (!event_log_buf->buf)
741 		return QDF_STATUS_E_NOMEM;
742 
743 	event_log_buf->p_buf_tail_idx = &event_log_buf->buf_tail_idx;
744 
745 	/* WMI events when queued */
746 	rx_event_log_buf->length = 0;
747 	rx_event_log_buf->buf_tail_idx = 0;
748 	rx_event_log_buf->buf = (struct wmi_event_debug *) qdf_mem_malloc(
749 		wmi_log_max_entry * sizeof(struct wmi_event_debug));
750 	rx_event_log_buf->size = wmi_log_max_entry;
751 
752 	if (!rx_event_log_buf->buf)
753 		return QDF_STATUS_E_NOMEM;
754 
755 	rx_event_log_buf->p_buf_tail_idx = &rx_event_log_buf->buf_tail_idx;
756 
757 	/* WMI Management commands */
758 	mgmt_cmd_log_buf->length = 0;
759 	mgmt_cmd_log_buf->buf_tail_idx = 0;
760 	mgmt_cmd_log_buf->buf = (struct wmi_command_debug *) qdf_mem_malloc(
761 		wmi_mgmt_log_max_entry * sizeof(struct wmi_command_debug));
762 	mgmt_cmd_log_buf->size = wmi_mgmt_log_max_entry;
763 
764 	if (!mgmt_cmd_log_buf->buf)
765 		return QDF_STATUS_E_NOMEM;
766 
767 	mgmt_cmd_log_buf->p_buf_tail_idx = &mgmt_cmd_log_buf->buf_tail_idx;
768 
769 	/* WMI Management commands Tx completed*/
770 	mgmt_cmd_tx_cmp_log_buf->length = 0;
771 	mgmt_cmd_tx_cmp_log_buf->buf_tail_idx = 0;
772 	mgmt_cmd_tx_cmp_log_buf->buf = (struct wmi_command_debug *)
773 		qdf_mem_malloc(
774 		wmi_mgmt_log_max_entry *
775 		sizeof(struct wmi_command_debug));
776 	mgmt_cmd_tx_cmp_log_buf->size = wmi_mgmt_log_max_entry;
777 
778 	if (!mgmt_cmd_tx_cmp_log_buf->buf)
779 		return QDF_STATUS_E_NOMEM;
780 
781 	mgmt_cmd_tx_cmp_log_buf->p_buf_tail_idx =
782 		&mgmt_cmd_tx_cmp_log_buf->buf_tail_idx;
783 
784 	/* WMI Management events when received */
785 	mgmt_event_log_buf->length = 0;
786 	mgmt_event_log_buf->buf_tail_idx = 0;
787 
788 	mgmt_event_log_buf->buf = (struct wmi_event_debug *) qdf_mem_malloc(
789 		wmi_mgmt_log_max_entry *
790 		sizeof(struct wmi_event_debug));
791 	mgmt_event_log_buf->size = wmi_mgmt_log_max_entry;
792 
793 	if (!mgmt_event_log_buf->buf)
794 		return QDF_STATUS_E_NOMEM;
795 
796 	mgmt_event_log_buf->p_buf_tail_idx = &mgmt_event_log_buf->buf_tail_idx;
797 
798 	/* WMI diag events when received */
799 	diag_event_log_buf->length = 0;
800 	diag_event_log_buf->buf_tail_idx = 0;
801 
802 	diag_event_log_buf->buf = (struct wmi_event_debug *) qdf_mem_malloc(
803 		wmi_diag_log_max_entry *
804 		sizeof(struct wmi_event_debug));
805 	diag_event_log_buf->size = wmi_diag_log_max_entry;
806 
807 	if (!diag_event_log_buf->buf)
808 		return QDF_STATUS_E_NOMEM;
809 
810 	diag_event_log_buf->p_buf_tail_idx = &diag_event_log_buf->buf_tail_idx;
811 
812 	qdf_spinlock_create(&wmi_handle->log_info.wmi_record_lock);
813 	wmi_handle->log_info.wmi_logging_enable = 1;
814 
815 	return QDF_STATUS_SUCCESS;
816 }
817 #endif
818 
819 /**
820  * wmi_log_buffer_free() - Free all dynamic allocated buffer memory for
821  * event logging
822  * @wmi_handle: WMI handle.
823  *
824  * Return: None
825  */
826 #ifndef CONFIG_MCL
827 static inline void wmi_log_buffer_free(struct wmi_unified *wmi_handle)
828 {
829 	if (wmi_handle->log_info.wmi_command_log_buf_info.buf)
830 		qdf_mem_free(wmi_handle->log_info.wmi_command_log_buf_info.buf);
831 	if (wmi_handle->log_info.wmi_command_tx_cmp_log_buf_info.buf)
832 		qdf_mem_free(
833 		wmi_handle->log_info.wmi_command_tx_cmp_log_buf_info.buf);
834 	if (wmi_handle->log_info.wmi_event_log_buf_info.buf)
835 		qdf_mem_free(wmi_handle->log_info.wmi_event_log_buf_info.buf);
836 	if (wmi_handle->log_info.wmi_rx_event_log_buf_info.buf)
837 		qdf_mem_free(
838 			wmi_handle->log_info.wmi_rx_event_log_buf_info.buf);
839 	if (wmi_handle->log_info.wmi_mgmt_command_log_buf_info.buf)
840 		qdf_mem_free(
841 			wmi_handle->log_info.wmi_mgmt_command_log_buf_info.buf);
842 	if (wmi_handle->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.buf)
843 		qdf_mem_free(
844 		wmi_handle->log_info.wmi_mgmt_command_tx_cmp_log_buf_info.buf);
845 	if (wmi_handle->log_info.wmi_mgmt_event_log_buf_info.buf)
846 		qdf_mem_free(
847 			wmi_handle->log_info.wmi_mgmt_event_log_buf_info.buf);
848 	if (wmi_handle->log_info.wmi_diag_event_log_buf_info.buf)
849 		qdf_mem_free(
850 			wmi_handle->log_info.wmi_diag_event_log_buf_info.buf);
851 	wmi_handle->log_info.wmi_logging_enable = 0;
852 	qdf_spinlock_destroy(&wmi_handle->log_info.wmi_record_lock);
853 }
854 #else
855 static inline void wmi_log_buffer_free(struct wmi_unified *wmi_handle)
856 {
857 	/* Do Nothing */
858 }
859 #endif
860 
861 /**
862  * wmi_print_cmd_log_buffer() - an output agnostic wmi command log printer
863  * @log_buffer: the command log buffer metadata of the buffer to print
864  * @count: the maximum number of entries to print
865  * @print: an abstract print method, e.g. a qdf_print() or seq_printf() wrapper
866  * @print_priv: any data required by the print method, e.g. a file handle
867  *
868  * Return: None
869  */
870 static void
871 wmi_print_cmd_log_buffer(struct wmi_log_buf_t *log_buffer, uint32_t count,
872 			 qdf_abstract_print *print, void *print_priv)
873 {
874 	static const int data_len =
875 		WMI_EVENT_DEBUG_ENTRY_MAX_LENGTH / sizeof(uint32_t);
876 	char str[128];
877 	uint32_t idx;
878 
879 	if (count > log_buffer->size)
880 		count = log_buffer->size;
881 	if (count > log_buffer->length)
882 		count = log_buffer->length;
883 
884 	/* subtract count from index, and wrap if necessary */
885 	idx = log_buffer->size + *log_buffer->p_buf_tail_idx - count;
886 	idx %= log_buffer->size;
887 
888 	print(print_priv, "Time (seconds)      Cmd Id              Payload");
889 	while (count) {
890 		struct wmi_command_debug *cmd_log = (struct wmi_command_debug *)
891 			&((struct wmi_command_debug *)log_buffer->buf)[idx];
892 		uint64_t secs, usecs;
893 		int len = 0;
894 		int i;
895 
896 		qdf_log_timestamp_to_secs(cmd_log->time, &secs, &usecs);
897 		len += scnprintf(str + len, sizeof(str) - len,
898 				 "% 8lld.%06lld    %6u (0x%06x)    ",
899 				 secs, usecs,
900 				 cmd_log->command, cmd_log->command);
901 		for (i = 0; i < data_len; ++i) {
902 			len += scnprintf(str + len, sizeof(str) - len,
903 					 "0x%08x ", cmd_log->data[i]);
904 		}
905 
906 		print(print_priv, str);
907 
908 		--count;
909 		++idx;
910 		if (idx >= log_buffer->size)
911 			idx = 0;
912 	}
913 }
914 
915 /**
916  * wmi_print_event_log_buffer() - an output agnostic wmi event log printer
917  * @log_buffer: the event log buffer metadata of the buffer to print
918  * @count: the maximum number of entries to print
919  * @print: an abstract print method, e.g. a qdf_print() or seq_printf() wrapper
920  * @print_priv: any data required by the print method, e.g. a file handle
921  *
922  * Return: None
923  */
924 static void
925 wmi_print_event_log_buffer(struct wmi_log_buf_t *log_buffer, uint32_t count,
926 			   qdf_abstract_print *print, void *print_priv)
927 {
928 	static const int data_len =
929 		WMI_EVENT_DEBUG_ENTRY_MAX_LENGTH / sizeof(uint32_t);
930 	char str[128];
931 	uint32_t idx;
932 
933 	if (count > log_buffer->size)
934 		count = log_buffer->size;
935 	if (count > log_buffer->length)
936 		count = log_buffer->length;
937 
938 	/* subtract count from index, and wrap if necessary */
939 	idx = log_buffer->size + *log_buffer->p_buf_tail_idx - count;
940 	idx %= log_buffer->size;
941 
942 	print(print_priv, "Time (seconds)      Event Id             Payload");
943 	while (count) {
944 		struct wmi_event_debug *event_log = (struct wmi_event_debug *)
945 			&((struct wmi_event_debug *)log_buffer->buf)[idx];
946 		uint64_t secs, usecs;
947 		int len = 0;
948 		int i;
949 
950 		qdf_log_timestamp_to_secs(event_log->time, &secs, &usecs);
951 		len += scnprintf(str + len, sizeof(str) - len,
952 				 "% 8lld.%06lld    %6u (0x%06x)    ",
953 				 secs, usecs,
954 				 event_log->event, event_log->event);
955 		for (i = 0; i < data_len; ++i) {
956 			len += scnprintf(str + len, sizeof(str) - len,
957 					 "0x%08x ", event_log->data[i]);
958 		}
959 
960 		print(print_priv, str);
961 
962 		--count;
963 		++idx;
964 		if (idx >= log_buffer->size)
965 			idx = 0;
966 	}
967 }
968 
969 inline void
970 wmi_print_cmd_log(wmi_unified_t wmi, uint32_t count,
971 		  qdf_abstract_print *print, void *print_priv)
972 {
973 	wmi_print_cmd_log_buffer(
974 		&wmi->log_info.wmi_command_log_buf_info,
975 		count, print, print_priv);
976 }
977 
978 inline void
979 wmi_print_cmd_tx_cmp_log(wmi_unified_t wmi, uint32_t count,
980 			 qdf_abstract_print *print, void *print_priv)
981 {
982 	wmi_print_cmd_log_buffer(
983 		&wmi->log_info.wmi_command_tx_cmp_log_buf_info,
984 		count, print, print_priv);
985 }
986 
987 inline void
988 wmi_print_mgmt_cmd_log(wmi_unified_t wmi, uint32_t count,
989 		       qdf_abstract_print *print, void *print_priv)
990 {
991 	wmi_print_cmd_log_buffer(
992 		&wmi->log_info.wmi_mgmt_command_log_buf_info,
993 		count, print, print_priv);
994 }
995 
996 inline void
997 wmi_print_mgmt_cmd_tx_cmp_log(wmi_unified_t wmi, uint32_t count,
998 			      qdf_abstract_print *print, void *print_priv)
999 {
1000 	wmi_print_cmd_log_buffer(
1001 		&wmi->log_info.wmi_mgmt_command_tx_cmp_log_buf_info,
1002 		count, print, print_priv);
1003 }
1004 
1005 inline void
1006 wmi_print_event_log(wmi_unified_t wmi, uint32_t count,
1007 		    qdf_abstract_print *print, void *print_priv)
1008 {
1009 	wmi_print_event_log_buffer(
1010 		&wmi->log_info.wmi_event_log_buf_info,
1011 		count, print, print_priv);
1012 }
1013 
1014 inline void
1015 wmi_print_rx_event_log(wmi_unified_t wmi, uint32_t count,
1016 		       qdf_abstract_print *print, void *print_priv)
1017 {
1018 	wmi_print_event_log_buffer(
1019 		&wmi->log_info.wmi_rx_event_log_buf_info,
1020 		count, print, print_priv);
1021 }
1022 
1023 inline void
1024 wmi_print_mgmt_event_log(wmi_unified_t wmi, uint32_t count,
1025 			 qdf_abstract_print *print, void *print_priv)
1026 {
1027 	wmi_print_event_log_buffer(
1028 		&wmi->log_info.wmi_mgmt_event_log_buf_info,
1029 		count, print, print_priv);
1030 }
1031 
1032 
1033 /* debugfs routines*/
1034 
1035 /**
1036  * debug_wmi_##func_base##_show() - debugfs functions to display content of
1037  * command and event buffers. Macro uses max buffer length to display
1038  * buffer when it is wraparound.
1039  *
1040  * @m: debugfs handler to access wmi_handle
1041  * @v: Variable arguments (not used)
1042  *
1043  * Return: Length of characters printed
1044  */
1045 #define GENERATE_COMMAND_DEBUG_SHOW_FUNCS(func_base, wmi_ring_size)	\
1046 	static int debug_wmi_##func_base##_show(struct seq_file *m,	\
1047 						void *v)		\
1048 	{								\
1049 		wmi_unified_t wmi_handle = (wmi_unified_t) m->private;	\
1050 		struct wmi_log_buf_t *wmi_log =				\
1051 			&wmi_handle->log_info.wmi_##func_base##_buf_info;\
1052 		int pos, nread, outlen;					\
1053 		int i;							\
1054 		uint64_t secs, usecs;					\
1055 									\
1056 		qdf_spin_lock(&wmi_handle->log_info.wmi_record_lock);	\
1057 		if (!wmi_log->length) {					\
1058 			qdf_spin_unlock(&wmi_handle->log_info.wmi_record_lock);\
1059 			return wmi_bp_seq_printf(m,			\
1060 			"no elements to read from ring buffer!\n");	\
1061 		}							\
1062 									\
1063 		if (wmi_log->length <= wmi_ring_size)			\
1064 			nread = wmi_log->length;			\
1065 		else							\
1066 			nread = wmi_ring_size;				\
1067 									\
1068 		if (*(wmi_log->p_buf_tail_idx) == 0)			\
1069 			/* tail can be 0 after wrap-around */		\
1070 			pos = wmi_ring_size - 1;			\
1071 		else							\
1072 			pos = *(wmi_log->p_buf_tail_idx) - 1;		\
1073 									\
1074 		outlen = wmi_bp_seq_printf(m, "Length = %d\n", wmi_log->length);\
1075 		qdf_spin_unlock(&wmi_handle->log_info.wmi_record_lock);	\
1076 		while (nread--) {					\
1077 			struct wmi_command_debug *wmi_record;		\
1078 									\
1079 			wmi_record = (struct wmi_command_debug *)	\
1080 			&(((struct wmi_command_debug *)wmi_log->buf)[pos]);\
1081 			outlen += wmi_bp_seq_printf(m, "CMD ID = %x\n",	\
1082 				(wmi_record->command));			\
1083 			qdf_log_timestamp_to_secs(wmi_record->time, &secs,\
1084 				&usecs);				\
1085 			outlen +=					\
1086 			wmi_bp_seq_printf(m, "CMD TIME = [%llu.%06llu]\n",\
1087 				secs, usecs);				\
1088 			outlen += wmi_bp_seq_printf(m, "CMD = ");	\
1089 			for (i = 0; i < (wmi_record_max_length/		\
1090 					sizeof(uint32_t)); i++)		\
1091 				outlen += wmi_bp_seq_printf(m, "%x ",	\
1092 					wmi_record->data[i]);		\
1093 			outlen += wmi_bp_seq_printf(m, "\n");		\
1094 									\
1095 			if (pos == 0)					\
1096 				pos = wmi_ring_size - 1;		\
1097 			else						\
1098 				pos--;					\
1099 		}							\
1100 		return outlen;						\
1101 	}								\
1102 
1103 #define GENERATE_EVENT_DEBUG_SHOW_FUNCS(func_base, wmi_ring_size)	\
1104 	static int debug_wmi_##func_base##_show(struct seq_file *m,	\
1105 						void *v)		\
1106 	{								\
1107 		wmi_unified_t wmi_handle = (wmi_unified_t) m->private;	\
1108 		struct wmi_log_buf_t *wmi_log =				\
1109 			&wmi_handle->log_info.wmi_##func_base##_buf_info;\
1110 		int pos, nread, outlen;					\
1111 		int i;							\
1112 		uint64_t secs, usecs;					\
1113 									\
1114 		qdf_spin_lock(&wmi_handle->log_info.wmi_record_lock);	\
1115 		if (!wmi_log->length) {					\
1116 			qdf_spin_unlock(&wmi_handle->log_info.wmi_record_lock);\
1117 			return wmi_bp_seq_printf(m,			\
1118 			"no elements to read from ring buffer!\n");	\
1119 		}							\
1120 									\
1121 		if (wmi_log->length <= wmi_ring_size)			\
1122 			nread = wmi_log->length;			\
1123 		else							\
1124 			nread = wmi_ring_size;				\
1125 									\
1126 		if (*(wmi_log->p_buf_tail_idx) == 0)			\
1127 			/* tail can be 0 after wrap-around */		\
1128 			pos = wmi_ring_size - 1;			\
1129 		else							\
1130 			pos = *(wmi_log->p_buf_tail_idx) - 1;		\
1131 									\
1132 		outlen = wmi_bp_seq_printf(m, "Length = %d\n", wmi_log->length);\
1133 		qdf_spin_unlock(&wmi_handle->log_info.wmi_record_lock);	\
1134 		while (nread--) {					\
1135 			struct wmi_event_debug *wmi_record;		\
1136 									\
1137 			wmi_record = (struct wmi_event_debug *)		\
1138 			&(((struct wmi_event_debug *)wmi_log->buf)[pos]);\
1139 			qdf_log_timestamp_to_secs(wmi_record->time, &secs,\
1140 				&usecs);				\
1141 			outlen += wmi_bp_seq_printf(m, "Event ID = %x\n",\
1142 				(wmi_record->event));			\
1143 			outlen +=					\
1144 			wmi_bp_seq_printf(m, "Event TIME = [%llu.%06llu]\n",\
1145 				secs, usecs);				\
1146 			outlen += wmi_bp_seq_printf(m, "CMD = ");	\
1147 			for (i = 0; i < (wmi_record_max_length/		\
1148 					sizeof(uint32_t)); i++)		\
1149 				outlen += wmi_bp_seq_printf(m, "%x ",	\
1150 					wmi_record->data[i]);		\
1151 			outlen += wmi_bp_seq_printf(m, "\n");		\
1152 									\
1153 			if (pos == 0)					\
1154 				pos = wmi_ring_size - 1;		\
1155 			else						\
1156 				pos--;					\
1157 		}							\
1158 		return outlen;						\
1159 	}
1160 
1161 GENERATE_COMMAND_DEBUG_SHOW_FUNCS(command_log, wmi_display_size);
1162 GENERATE_COMMAND_DEBUG_SHOW_FUNCS(command_tx_cmp_log, wmi_display_size);
1163 GENERATE_EVENT_DEBUG_SHOW_FUNCS(event_log, wmi_display_size);
1164 GENERATE_EVENT_DEBUG_SHOW_FUNCS(rx_event_log, wmi_display_size);
1165 GENERATE_COMMAND_DEBUG_SHOW_FUNCS(mgmt_command_log, wmi_display_size);
1166 GENERATE_COMMAND_DEBUG_SHOW_FUNCS(mgmt_command_tx_cmp_log,
1167 					wmi_display_size);
1168 GENERATE_EVENT_DEBUG_SHOW_FUNCS(mgmt_event_log, wmi_display_size);
1169 
1170 /**
1171  * debug_wmi_enable_show() - debugfs functions to display enable state of
1172  * wmi logging feature.
1173  *
1174  * @m: debugfs handler to access wmi_handle
1175  * @v: Variable arguments (not used)
1176  *
1177  * Return: always 1
1178  */
1179 static int debug_wmi_enable_show(struct seq_file *m, void *v)
1180 {
1181 	wmi_unified_t wmi_handle = (wmi_unified_t) m->private;
1182 
1183 	return wmi_bp_seq_printf(m, "%d\n",
1184 			wmi_handle->log_info.wmi_logging_enable);
1185 }
1186 
1187 /**
1188  * debug_wmi_log_size_show() - debugfs functions to display configured size of
1189  * wmi logging command/event buffer and management command/event buffer.
1190  *
1191  * @m: debugfs handler to access wmi_handle
1192  * @v: Variable arguments (not used)
1193  *
1194  * Return: Length of characters printed
1195  */
1196 static int debug_wmi_log_size_show(struct seq_file *m, void *v)
1197 {
1198 
1199 	wmi_bp_seq_printf(m, "WMI command/event log max size:%d\n",
1200 				wmi_log_max_entry);
1201 	return wmi_bp_seq_printf(m,
1202 			"WMI management command/events log max size:%d\n",
1203 			wmi_mgmt_log_max_entry);
1204 }
1205 
1206 /**
1207  * debug_wmi_##func_base##_write() - debugfs functions to clear
1208  * wmi logging command/event buffer and management command/event buffer.
1209  *
1210  * @file: file handler to access wmi_handle
1211  * @buf: received data buffer
1212  * @count: length of received buffer
1213  * @ppos: Not used
1214  *
1215  * Return: count
1216  */
1217 #define GENERATE_DEBUG_WRITE_FUNCS(func_base, wmi_ring_size, wmi_record_type)\
1218 	static ssize_t debug_wmi_##func_base##_write(struct file *file,	\
1219 				const char __user *buf,			\
1220 				size_t count, loff_t *ppos)		\
1221 	{								\
1222 		int k, ret;						\
1223 		wmi_unified_t wmi_handle =				\
1224 			((struct seq_file *)file->private_data)->private;\
1225 		struct wmi_log_buf_t *wmi_log = &wmi_handle->log_info.	\
1226 				wmi_##func_base##_buf_info;		\
1227 		char locbuf[50];					\
1228 									\
1229 		if ((!buf) || (count > 50))				\
1230 			return -EFAULT;					\
1231 									\
1232 		if (copy_from_user(locbuf, buf, count))			\
1233 			return -EFAULT;					\
1234 									\
1235 		ret = sscanf(locbuf, "%d", &k);				\
1236 		if ((ret != 1) || (k != 0)) {                           \
1237 			WMI_LOGE("Wrong input, echo 0 to clear the wmi buffer");\
1238 			return -EINVAL;					\
1239 		}							\
1240 									\
1241 		qdf_spin_lock(&wmi_handle->log_info.wmi_record_lock);	\
1242 		qdf_mem_zero(wmi_log->buf, wmi_ring_size *		\
1243 				sizeof(struct wmi_record_type));	\
1244 		wmi_log->length = 0;					\
1245 		*(wmi_log->p_buf_tail_idx) = 0;				\
1246 		qdf_spin_unlock(&wmi_handle->log_info.wmi_record_lock);	\
1247 									\
1248 		return count;						\
1249 	}
1250 
1251 GENERATE_DEBUG_WRITE_FUNCS(command_log, wmi_log_max_entry,
1252 					wmi_command_debug);
1253 GENERATE_DEBUG_WRITE_FUNCS(command_tx_cmp_log, wmi_log_max_entry,
1254 					wmi_command_debug);
1255 GENERATE_DEBUG_WRITE_FUNCS(event_log, wmi_log_max_entry,
1256 					wmi_event_debug);
1257 GENERATE_DEBUG_WRITE_FUNCS(rx_event_log, wmi_log_max_entry,
1258 					wmi_event_debug);
1259 GENERATE_DEBUG_WRITE_FUNCS(mgmt_command_log, wmi_mgmt_log_max_entry,
1260 					wmi_command_debug);
1261 GENERATE_DEBUG_WRITE_FUNCS(mgmt_command_tx_cmp_log,
1262 		wmi_mgmt_log_max_entry, wmi_command_debug);
1263 GENERATE_DEBUG_WRITE_FUNCS(mgmt_event_log, wmi_mgmt_log_max_entry,
1264 					wmi_event_debug);
1265 
1266 /**
1267  * debug_wmi_enable_write() - debugfs functions to enable/disable
1268  * wmi logging feature.
1269  *
1270  * @file: file handler to access wmi_handle
1271  * @buf: received data buffer
1272  * @count: length of received buffer
1273  * @ppos: Not used
1274  *
1275  * Return: count
1276  */
1277 static ssize_t debug_wmi_enable_write(struct file *file, const char __user *buf,
1278 					size_t count, loff_t *ppos)
1279 {
1280 	wmi_unified_t wmi_handle =
1281 		((struct seq_file *)file->private_data)->private;
1282 	int k, ret;
1283 	char locbuf[50];
1284 
1285 	if ((!buf) || (count > 50))
1286 		return -EFAULT;
1287 
1288 	if (copy_from_user(locbuf, buf, count))
1289 		return -EFAULT;
1290 
1291 	ret = sscanf(locbuf, "%d", &k);
1292 	if ((ret != 1) || ((k != 0) && (k != 1)))
1293 		return -EINVAL;
1294 
1295 	wmi_handle->log_info.wmi_logging_enable = k;
1296 	return count;
1297 }
1298 
1299 /**
1300  * debug_wmi_log_size_write() - reserved.
1301  *
1302  * @file: file handler to access wmi_handle
1303  * @buf: received data buffer
1304  * @count: length of received buffer
1305  * @ppos: Not used
1306  *
1307  * Return: count
1308  */
1309 static ssize_t debug_wmi_log_size_write(struct file *file,
1310 		const char __user *buf, size_t count, loff_t *ppos)
1311 {
1312 	return -EINVAL;
1313 }
1314 
1315 /* Structure to maintain debug information */
1316 struct wmi_debugfs_info {
1317 	const char *name;
1318 	const struct file_operations *ops;
1319 };
1320 
1321 #define DEBUG_FOO(func_base) { .name = #func_base,			\
1322 	.ops = &debug_##func_base##_ops }
1323 
1324 /**
1325  * debug_##func_base##_open() - Open debugfs entry for respective command
1326  * and event buffer.
1327  *
1328  * @inode: node for debug dir entry
1329  * @file: file handler
1330  *
1331  * Return: open status
1332  */
1333 #define GENERATE_DEBUG_STRUCTS(func_base)				\
1334 	static int debug_##func_base##_open(struct inode *inode,	\
1335 						struct file *file)	\
1336 	{								\
1337 		return single_open(file, debug_##func_base##_show,	\
1338 				inode->i_private);			\
1339 	}								\
1340 									\
1341 									\
1342 	static struct file_operations debug_##func_base##_ops = {	\
1343 		.open		= debug_##func_base##_open,		\
1344 		.read		= seq_read,				\
1345 		.llseek		= seq_lseek,				\
1346 		.write		= debug_##func_base##_write,		\
1347 		.release	= single_release,			\
1348 	};
1349 
1350 GENERATE_DEBUG_STRUCTS(wmi_command_log);
1351 GENERATE_DEBUG_STRUCTS(wmi_command_tx_cmp_log);
1352 GENERATE_DEBUG_STRUCTS(wmi_event_log);
1353 GENERATE_DEBUG_STRUCTS(wmi_rx_event_log);
1354 GENERATE_DEBUG_STRUCTS(wmi_mgmt_command_log);
1355 GENERATE_DEBUG_STRUCTS(wmi_mgmt_command_tx_cmp_log);
1356 GENERATE_DEBUG_STRUCTS(wmi_mgmt_event_log);
1357 GENERATE_DEBUG_STRUCTS(wmi_enable);
1358 GENERATE_DEBUG_STRUCTS(wmi_log_size);
1359 
1360 struct wmi_debugfs_info wmi_debugfs_infos[NUM_DEBUG_INFOS] = {
1361 	DEBUG_FOO(wmi_command_log),
1362 	DEBUG_FOO(wmi_command_tx_cmp_log),
1363 	DEBUG_FOO(wmi_event_log),
1364 	DEBUG_FOO(wmi_rx_event_log),
1365 	DEBUG_FOO(wmi_mgmt_command_log),
1366 	DEBUG_FOO(wmi_mgmt_command_tx_cmp_log),
1367 	DEBUG_FOO(wmi_mgmt_event_log),
1368 	DEBUG_FOO(wmi_enable),
1369 	DEBUG_FOO(wmi_log_size),
1370 };
1371 
1372 
1373 /**
1374  * wmi_debugfs_create() - Create debug_fs entry for wmi logging.
1375  *
1376  * @wmi_handle: wmi handle
1377  * @par_entry: debug directory entry
1378  * @id: Index to debug info data array
1379  *
1380  * Return: none
1381  */
1382 static void wmi_debugfs_create(wmi_unified_t wmi_handle,
1383 			       struct dentry *par_entry)
1384 {
1385 	int i;
1386 
1387 	if (!par_entry)
1388 		goto out;
1389 
1390 	for (i = 0; i < NUM_DEBUG_INFOS; ++i) {
1391 		wmi_handle->debugfs_de[i] = debugfs_create_file(
1392 				wmi_debugfs_infos[i].name, 0644, par_entry,
1393 				wmi_handle, wmi_debugfs_infos[i].ops);
1394 
1395 		if (!wmi_handle->debugfs_de[i]) {
1396 			WMI_LOGE("debug Entry creation failed!");
1397 			goto out;
1398 		}
1399 	}
1400 
1401 	return;
1402 
1403 out:
1404 	WMI_LOGE("debug Entry creation failed!");
1405 	wmi_log_buffer_free(wmi_handle);
1406 	return;
1407 }
1408 
1409 /**
1410  * wmi_debugfs_remove() - Remove debugfs entry for wmi logging.
1411  * @wmi_handle: wmi handle
1412  * @dentry: debugfs directory entry
1413  * @id: Index to debug info data array
1414  *
1415  * Return: none
1416  */
1417 static void wmi_debugfs_remove(wmi_unified_t wmi_handle)
1418 {
1419 	int i;
1420 	struct dentry *dentry = wmi_handle->log_info.wmi_log_debugfs_dir;
1421 
1422 	if (dentry) {
1423 		for (i = 0; i < NUM_DEBUG_INFOS; ++i) {
1424 			if (wmi_handle->debugfs_de[i])
1425 				wmi_handle->debugfs_de[i] = NULL;
1426 		}
1427 	}
1428 
1429 	if (dentry)
1430 		debugfs_remove_recursive(dentry);
1431 }
1432 
1433 /**
1434  * wmi_debugfs_init() - debugfs functions to create debugfs directory and to
1435  * create debugfs enteries.
1436  *
1437  * @h: wmi handler
1438  *
1439  * Return: init status
1440  */
1441 static QDF_STATUS wmi_debugfs_init(wmi_unified_t wmi_handle, uint32_t pdev_idx)
1442 {
1443 	char buf[32];
1444 
1445 	snprintf(buf, sizeof(buf), "WMI_SOC%u_PDEV%u",
1446 		 wmi_handle->soc->soc_idx, pdev_idx);
1447 
1448 	wmi_handle->log_info.wmi_log_debugfs_dir =
1449 		debugfs_create_dir(buf, NULL);
1450 
1451 	if (!wmi_handle->log_info.wmi_log_debugfs_dir) {
1452 		WMI_LOGE("error while creating debugfs dir for %s", buf);
1453 		return QDF_STATUS_E_FAILURE;
1454 	}
1455 	wmi_debugfs_create(wmi_handle,
1456 			   wmi_handle->log_info.wmi_log_debugfs_dir);
1457 
1458 	return QDF_STATUS_SUCCESS;
1459 }
1460 
1461 /**
1462  * wmi_mgmt_cmd_record() - Wrapper function for mgmt command logging macro
1463  *
1464  * @wmi_handle: wmi handle
1465  * @cmd: mgmt command
1466  * @header: pointer to 802.11 header
1467  * @vdev_id: vdev id
1468  * @chanfreq: channel frequency
1469  *
1470  * Return: none
1471  */
1472 void wmi_mgmt_cmd_record(wmi_unified_t wmi_handle, uint32_t cmd,
1473 			void *header, uint32_t vdev_id, uint32_t chanfreq)
1474 {
1475 
1476 	uint32_t data[CUSTOM_MGMT_CMD_DATA_SIZE];
1477 
1478 	data[0] = ((struct wmi_command_header *)header)->type;
1479 	data[1] = ((struct wmi_command_header *)header)->sub_type;
1480 	data[2] = vdev_id;
1481 	data[3] = chanfreq;
1482 
1483 	qdf_spin_lock_bh(&wmi_handle->log_info.wmi_record_lock);
1484 
1485 	WMI_MGMT_COMMAND_RECORD(wmi_handle, cmd, (uint8_t *)data);
1486 
1487 	qdf_spin_unlock_bh(&wmi_handle->log_info.wmi_record_lock);
1488 }
1489 #else
1490 /**
1491  * wmi_debugfs_remove() - Remove debugfs entry for wmi logging.
1492  * @wmi_handle: wmi handle
1493  * @dentry: debugfs directory entry
1494  * @id: Index to debug info data array
1495  *
1496  * Return: none
1497  */
1498 static void wmi_debugfs_remove(wmi_unified_t wmi_handle) { }
1499 void wmi_mgmt_cmd_record(wmi_unified_t wmi_handle, uint32_t cmd,
1500 			void *header, uint32_t vdev_id, uint32_t chanfreq) { }
1501 static inline void wmi_log_buffer_free(struct wmi_unified *wmi_handle) { }
1502 #endif /*WMI_INTERFACE_EVENT_LOGGING */
1503 qdf_export_symbol(wmi_mgmt_cmd_record);
1504 
1505 int wmi_get_host_credits(wmi_unified_t wmi_handle);
1506 /* WMI buffer APIs */
1507 
1508 #ifdef NBUF_MEMORY_DEBUG
1509 wmi_buf_t
1510 wmi_buf_alloc_debug(wmi_unified_t wmi_handle, uint32_t len,
1511 		    const char *func_name,
1512 		    uint32_t line_num)
1513 {
1514 	wmi_buf_t wmi_buf;
1515 
1516 	if (roundup(len + WMI_MIN_HEAD_ROOM, 4) > wmi_handle->max_msg_len) {
1517 		QDF_ASSERT(0);
1518 		return NULL;
1519 	}
1520 
1521 	wmi_buf = wbuff_buff_get(wmi_handle->wbuff_handle, len, func_name,
1522 				 line_num);
1523 	if (!wmi_buf)
1524 		wmi_buf = qdf_nbuf_alloc_debug(NULL,
1525 					       roundup(len + WMI_MIN_HEAD_ROOM,
1526 						       4),
1527 					       WMI_MIN_HEAD_ROOM, 4, false,
1528 					       func_name, line_num);
1529 	if (!wmi_buf)
1530 		return NULL;
1531 
1532 	/* Clear the wmi buffer */
1533 	OS_MEMZERO(qdf_nbuf_data(wmi_buf), len);
1534 
1535 	/*
1536 	 * Set the length of the buffer to match the allocation size.
1537 	 */
1538 	qdf_nbuf_set_pktlen(wmi_buf, len);
1539 
1540 	return wmi_buf;
1541 }
1542 qdf_export_symbol(wmi_buf_alloc_debug);
1543 
1544 void wmi_buf_free(wmi_buf_t net_buf)
1545 {
1546 	net_buf = wbuff_buff_put(net_buf);
1547 	if (net_buf)
1548 		qdf_nbuf_free(net_buf);
1549 }
1550 qdf_export_symbol(wmi_buf_free);
1551 #else
1552 wmi_buf_t wmi_buf_alloc_fl(wmi_unified_t wmi_handle, uint32_t len,
1553 			   const char *func, uint32_t line)
1554 {
1555 	wmi_buf_t wmi_buf;
1556 
1557 	if (roundup(len + WMI_MIN_HEAD_ROOM, 4) > wmi_handle->max_msg_len) {
1558 		QDF_DEBUG_PANIC("Invalid length %u (via %s:%u)",
1559 				len, func, line);
1560 		return NULL;
1561 	}
1562 
1563 	wmi_buf = wbuff_buff_get(wmi_handle->wbuff_handle, len, __func__,
1564 				 __LINE__);
1565 	if (!wmi_buf)
1566 		wmi_buf = qdf_nbuf_alloc_fl(NULL, roundup(len +
1567 				WMI_MIN_HEAD_ROOM, 4), WMI_MIN_HEAD_ROOM, 4,
1568 				false, func, line);
1569 
1570 	if (!wmi_buf) {
1571 		wmi_nofl_err("%s:%d, failed to alloc len:%d", func, line, len);
1572 		return NULL;
1573 	}
1574 
1575 	/* Clear the wmi buffer */
1576 	OS_MEMZERO(qdf_nbuf_data(wmi_buf), len);
1577 
1578 	/*
1579 	 * Set the length of the buffer to match the allocation size.
1580 	 */
1581 	qdf_nbuf_set_pktlen(wmi_buf, len);
1582 
1583 	return wmi_buf;
1584 }
1585 qdf_export_symbol(wmi_buf_alloc_fl);
1586 
1587 void wmi_buf_free(wmi_buf_t net_buf)
1588 {
1589 	net_buf = wbuff_buff_put(net_buf);
1590 	if (net_buf)
1591 		qdf_nbuf_free(net_buf);
1592 }
1593 qdf_export_symbol(wmi_buf_free);
1594 #endif
1595 
1596 /**
1597  * wmi_get_max_msg_len() - get maximum WMI message length
1598  * @wmi_handle: WMI handle.
1599  *
1600  * This function returns the maximum WMI message length
1601  *
1602  * Return: maximum WMI message length
1603  */
1604 uint16_t wmi_get_max_msg_len(wmi_unified_t wmi_handle)
1605 {
1606 	return wmi_handle->max_msg_len - WMI_MIN_HEAD_ROOM;
1607 }
1608 qdf_export_symbol(wmi_get_max_msg_len);
1609 
1610 #ifdef CONFIG_MCL
1611 #ifndef WMI_CMD_STRINGS
1612 static uint8_t *wmi_id_to_name(uint32_t wmi_command)
1613 {
1614 	return "Invalid WMI cmd";
1615 }
1616 
1617 #endif
1618 
1619 static inline void wmi_log_cmd_id(uint32_t cmd_id, uint32_t tag)
1620 {
1621 	WMI_LOGD("Send WMI command:%s command_id:%d htc_tag:%d\n",
1622 		 wmi_id_to_name(cmd_id), cmd_id, tag);
1623 }
1624 
1625 /**
1626  * wmi_is_pm_resume_cmd() - check if a cmd is part of the resume sequence
1627  * @cmd_id: command to check
1628  *
1629  * Return: true if the command is part of the resume sequence.
1630  */
1631 static bool wmi_is_pm_resume_cmd(uint32_t cmd_id)
1632 {
1633 	switch (cmd_id) {
1634 	case WMI_WOW_HOSTWAKEUP_FROM_SLEEP_CMDID:
1635 	case WMI_PDEV_RESUME_CMDID:
1636 		return true;
1637 
1638 	default:
1639 		return false;
1640 	}
1641 }
1642 #else
1643 static bool wmi_is_pm_resume_cmd(uint32_t cmd_id)
1644 {
1645 	return false;
1646 }
1647 #endif
1648 
1649 static inline void wmi_unified_debug_dump(wmi_unified_t wmi_handle)
1650 {
1651 	wmi_nofl_err("Endpoint ID = %d, Tx Queue Depth = %d, soc_id = %u, target type = %s",
1652 		     wmi_handle->wmi_endpoint_id,
1653 		     htc_get_tx_queue_depth(wmi_handle->htc_handle,
1654 					    wmi_handle->wmi_endpoint_id),
1655 		     wmi_handle->soc->soc_idx,
1656 		     (wmi_handle->target_type ==
1657 		      WMI_TLV_TARGET ? "WMI_TLV_TARGET" :
1658 						"WMI_NON_TLV_TARGET"));
1659 }
1660 
1661 QDF_STATUS wmi_unified_cmd_send_fl(wmi_unified_t wmi_handle, wmi_buf_t buf,
1662 				   uint32_t len, uint32_t cmd_id,
1663 				   const char *func, uint32_t line)
1664 {
1665 	HTC_PACKET *pkt;
1666 	QDF_STATUS status;
1667 	uint16_t htc_tag = 0;
1668 
1669 	if (wmi_get_runtime_pm_inprogress(wmi_handle)) {
1670 		htc_tag = wmi_handle->ops->wmi_set_htc_tx_tag(wmi_handle, buf,
1671 							      cmd_id);
1672 	} else if (qdf_atomic_read(&wmi_handle->is_target_suspended) &&
1673 		   !wmi_is_pm_resume_cmd(cmd_id)) {
1674 		QDF_DEBUG_PANIC("Target is suspended (via %s:%u)", func, line);
1675 		return QDF_STATUS_E_BUSY;
1676 	}
1677 
1678 	if (wmi_handle->wmi_stopinprogress) {
1679 		wmi_nofl_err("%s:%d, WMI stop in progress", func, line);
1680 		return QDF_STATUS_E_INVAL;
1681 	}
1682 
1683 #ifndef WMI_NON_TLV_SUPPORT
1684 	/* Do sanity check on the TLV parameter structure */
1685 	if (wmi_handle->target_type == WMI_TLV_TARGET) {
1686 		void *buf_ptr = (void *)qdf_nbuf_data(buf);
1687 
1688 		if (wmi_handle->ops->wmi_check_command_params(NULL, buf_ptr, len, cmd_id)
1689 			!= 0) {
1690 			wmi_nofl_err("%s:%d, Invalid WMI Param Buffer for Cmd:%d",
1691 				     func, line, cmd_id);
1692 			return QDF_STATUS_E_INVAL;
1693 		}
1694 	}
1695 #endif
1696 
1697 	if (qdf_nbuf_push_head(buf, sizeof(WMI_CMD_HDR)) == NULL) {
1698 		wmi_nofl_err("%s:%d, Failed to send cmd %x, no memory",
1699 			     func, line, cmd_id);
1700 		return QDF_STATUS_E_NOMEM;
1701 	}
1702 
1703 	qdf_mem_zero(qdf_nbuf_data(buf), sizeof(WMI_CMD_HDR));
1704 	WMI_SET_FIELD(qdf_nbuf_data(buf), WMI_CMD_HDR, COMMANDID, cmd_id);
1705 
1706 	qdf_atomic_inc(&wmi_handle->pending_cmds);
1707 	if (qdf_atomic_read(&wmi_handle->pending_cmds) >=
1708 			wmi_handle->wmi_max_cmds) {
1709 		wmi_nofl_err("hostcredits = %d",
1710 			     wmi_get_host_credits(wmi_handle));
1711 		htc_dump_counter_info(wmi_handle->htc_handle);
1712 		qdf_atomic_dec(&wmi_handle->pending_cmds);
1713 		wmi_nofl_err("%s:%d, MAX %d WMI Pending cmds reached",
1714 			     func, line, wmi_handle->wmi_max_cmds);
1715 		wmi_unified_debug_dump(wmi_handle);
1716 		QDF_BUG(0);
1717 		return QDF_STATUS_E_BUSY;
1718 	}
1719 
1720 	pkt = qdf_mem_malloc_fl(sizeof(*pkt), func, line);
1721 	if (!pkt) {
1722 		qdf_atomic_dec(&wmi_handle->pending_cmds);
1723 		return QDF_STATUS_E_NOMEM;
1724 	}
1725 
1726 	SET_HTC_PACKET_INFO_TX(pkt,
1727 			       NULL,
1728 			       qdf_nbuf_data(buf), len + sizeof(WMI_CMD_HDR),
1729 			       wmi_handle->wmi_endpoint_id, htc_tag);
1730 
1731 	SET_HTC_PACKET_NET_BUF_CONTEXT(pkt, buf);
1732 #ifdef CONFIG_MCL
1733 	wmi_log_cmd_id(cmd_id, htc_tag);
1734 #endif
1735 	wmi_ext_dbg_msg_cmd_record(wmi_handle,
1736 				   qdf_nbuf_data(buf), qdf_nbuf_len(buf));
1737 #ifdef WMI_INTERFACE_EVENT_LOGGING
1738 	if (wmi_handle->log_info.wmi_logging_enable) {
1739 		qdf_spin_lock_bh(&wmi_handle->log_info.wmi_record_lock);
1740 		/*
1741 		 * Record 16 bytes of WMI cmd data -
1742 		 * exclude TLV and WMI headers
1743 		 *
1744 		 * WMI mgmt command already recorded in wmi_mgmt_cmd_record
1745 		 */
1746 		if (wmi_handle->ops->is_management_record(cmd_id) == false) {
1747 			WMI_COMMAND_RECORD(wmi_handle, cmd_id,
1748 					qdf_nbuf_data(buf) +
1749 			 wmi_handle->soc->buf_offset_command);
1750 		}
1751 		qdf_spin_unlock_bh(&wmi_handle->log_info.wmi_record_lock);
1752 	}
1753 #endif
1754 
1755 	status = htc_send_pkt(wmi_handle->htc_handle, pkt);
1756 
1757 	if (QDF_STATUS_SUCCESS != status) {
1758 		qdf_atomic_dec(&wmi_handle->pending_cmds);
1759 		wmi_nofl_err("%s:%d, htc_send_pkt failed, status:%d",
1760 			     func, line, status);
1761 		qdf_mem_free(pkt);
1762 		return status;
1763 	}
1764 
1765 	return QDF_STATUS_SUCCESS;
1766 }
1767 qdf_export_symbol(wmi_unified_cmd_send_fl);
1768 
1769 /**
1770  * wmi_unified_get_event_handler_ix() - gives event handler's index
1771  * @wmi_handle: handle to wmi
1772  * @event_id: wmi  event id
1773  *
1774  * Return: event handler's index
1775  */
1776 static int wmi_unified_get_event_handler_ix(wmi_unified_t wmi_handle,
1777 					    uint32_t event_id)
1778 {
1779 	uint32_t idx = 0;
1780 	int32_t invalid_idx = -1;
1781 	struct wmi_soc *soc = wmi_handle->soc;
1782 
1783 	for (idx = 0; (idx < soc->max_event_idx &&
1784 		       idx < WMI_UNIFIED_MAX_EVENT); ++idx) {
1785 		if (wmi_handle->event_id[idx] == event_id &&
1786 		    wmi_handle->event_handler[idx] != NULL) {
1787 			return idx;
1788 		}
1789 	}
1790 
1791 	return invalid_idx;
1792 }
1793 
1794 /**
1795  * wmi_unified_register_event() - register wmi event handler
1796  * @wmi_handle: handle to wmi
1797  * @event_id: wmi event id
1798  * @handler_func: wmi event handler function
1799  *
1800  * Return: 0 on success
1801  */
1802 int wmi_unified_register_event(wmi_unified_t wmi_handle,
1803 				       uint32_t event_id,
1804 				       wmi_unified_event_handler handler_func)
1805 {
1806 	uint32_t idx = 0;
1807 	uint32_t evt_id;
1808 	struct wmi_soc *soc;
1809 
1810 	if (!wmi_handle) {
1811 		WMI_LOGE("WMI handle is NULL");
1812 		return QDF_STATUS_E_FAILURE;
1813 	}
1814 
1815 	soc = wmi_handle->soc;
1816 
1817 	if (event_id >= wmi_events_max ||
1818 		wmi_handle->wmi_events[event_id] == WMI_EVENT_ID_INVALID) {
1819 		QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
1820 			  "%s: Event id %d is unavailable",
1821 					__func__, event_id);
1822 		return QDF_STATUS_E_FAILURE;
1823 	}
1824 	evt_id = wmi_handle->wmi_events[event_id];
1825 	if (wmi_unified_get_event_handler_ix(wmi_handle, evt_id) != -1) {
1826 		QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
1827 			  "%s : event handler already registered 0x%x",
1828 				__func__, evt_id);
1829 		return QDF_STATUS_E_FAILURE;
1830 	}
1831 	if (soc->max_event_idx == WMI_UNIFIED_MAX_EVENT) {
1832 		QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
1833 			  "%s : no more event handlers 0x%x",
1834 					__func__, evt_id);
1835 		return QDF_STATUS_E_FAILURE;
1836 	}
1837 	idx = soc->max_event_idx;
1838 	wmi_handle->event_handler[idx] = handler_func;
1839 	wmi_handle->event_id[idx] = evt_id;
1840 	qdf_spin_lock_bh(&soc->ctx_lock);
1841 	wmi_handle->ctx[idx] = WMI_RX_UMAC_CTX;
1842 	qdf_spin_unlock_bh(&soc->ctx_lock);
1843 	soc->max_event_idx++;
1844 
1845 	return 0;
1846 }
1847 
1848 /**
1849  * wmi_unified_register_event_handler() - register wmi event handler
1850  * @wmi_handle: handle to wmi
1851  * @event_id: wmi event id
1852  * @handler_func: wmi event handler function
1853  * @rx_ctx: rx execution context for wmi rx events
1854  *
1855  * This API is to support legacy requirements. Will be deprecated in future.
1856  * Return: 0 on success
1857  */
1858 int wmi_unified_register_event_handler(wmi_unified_t wmi_handle,
1859 				       wmi_conv_event_id event_id,
1860 				       wmi_unified_event_handler handler_func,
1861 				       uint8_t rx_ctx)
1862 {
1863 	uint32_t idx = 0;
1864 	uint32_t evt_id;
1865 	struct wmi_soc *soc;
1866 
1867 	if (!wmi_handle) {
1868 		WMI_LOGE("WMI handle is NULL");
1869 		return QDF_STATUS_E_FAILURE;
1870 	}
1871 
1872 	soc = wmi_handle->soc;
1873 
1874 	if (event_id >= wmi_events_max ||
1875 		wmi_handle->wmi_events[event_id] == WMI_EVENT_ID_INVALID) {
1876 		QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
1877 			  "%s: Event id %d is unavailable",
1878 					__func__, event_id);
1879 		return QDF_STATUS_E_FAILURE;
1880 	}
1881 	evt_id = wmi_handle->wmi_events[event_id];
1882 
1883 	if (wmi_unified_get_event_handler_ix(wmi_handle, evt_id) != -1) {
1884 		WMI_LOGE("event handler already registered 0x%x",
1885 			  evt_id);
1886 		return QDF_STATUS_E_FAILURE;
1887 	}
1888 	if (soc->max_event_idx == WMI_UNIFIED_MAX_EVENT) {
1889 		WMI_LOGE("no more event handlers 0x%x",
1890 			  evt_id);
1891 		return QDF_STATUS_E_FAILURE;
1892 	}
1893 	QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_DEBUG,
1894 		  "Registered event handler for event 0x%8x", evt_id);
1895 	idx = soc->max_event_idx;
1896 	wmi_handle->event_handler[idx] = handler_func;
1897 	wmi_handle->event_id[idx] = evt_id;
1898 	qdf_spin_lock_bh(&soc->ctx_lock);
1899 	wmi_handle->ctx[idx] = rx_ctx;
1900 	qdf_spin_unlock_bh(&soc->ctx_lock);
1901 	soc->max_event_idx++;
1902 
1903 	return 0;
1904 }
1905 qdf_export_symbol(wmi_unified_register_event_handler);
1906 
1907 /**
1908  * wmi_unified_unregister_event() - unregister wmi event handler
1909  * @wmi_handle: handle to wmi
1910  * @event_id: wmi event id
1911  *
1912  * Return: 0 on success
1913  */
1914 int wmi_unified_unregister_event(wmi_unified_t wmi_handle,
1915 					 uint32_t event_id)
1916 {
1917 	uint32_t idx = 0;
1918 	uint32_t evt_id;
1919 	struct wmi_soc *soc = wmi_handle->soc;
1920 
1921 	if (event_id >= wmi_events_max ||
1922 		wmi_handle->wmi_events[event_id] == WMI_EVENT_ID_INVALID) {
1923 		QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
1924 			  "%s: Event id %d is unavailable",
1925 					__func__, event_id);
1926 		return QDF_STATUS_E_FAILURE;
1927 	}
1928 	evt_id = wmi_handle->wmi_events[event_id];
1929 
1930 	idx = wmi_unified_get_event_handler_ix(wmi_handle, evt_id);
1931 	if (idx == -1) {
1932 		WMI_LOGE("event handler is not registered: evt id 0x%x",
1933 			  evt_id);
1934 		return QDF_STATUS_E_FAILURE;
1935 	}
1936 	wmi_handle->event_handler[idx] = NULL;
1937 	wmi_handle->event_id[idx] = 0;
1938 	--soc->max_event_idx;
1939 	wmi_handle->event_handler[idx] =
1940 		wmi_handle->event_handler[soc->max_event_idx];
1941 	wmi_handle->event_id[idx] =
1942 		wmi_handle->event_id[soc->max_event_idx];
1943 
1944 	return 0;
1945 }
1946 
1947 /**
1948  * wmi_unified_unregister_event_handler() - unregister wmi event handler
1949  * @wmi_handle: handle to wmi
1950  * @event_id: wmi event id
1951  *
1952  * Return: 0 on success
1953  */
1954 int wmi_unified_unregister_event_handler(wmi_unified_t wmi_handle,
1955 					 wmi_conv_event_id event_id)
1956 {
1957 	uint32_t idx = 0;
1958 	uint32_t evt_id;
1959 	struct wmi_soc *soc;
1960 
1961 	if (!wmi_handle) {
1962 		WMI_LOGE("WMI handle is NULL");
1963 		return QDF_STATUS_E_FAILURE;
1964 	}
1965 
1966 	soc = wmi_handle->soc;
1967 
1968 	if (event_id >= wmi_events_max ||
1969 		wmi_handle->wmi_events[event_id] == WMI_EVENT_ID_INVALID) {
1970 		WMI_LOGE("Event id %d is unavailable",
1971 			  event_id);
1972 		return QDF_STATUS_E_FAILURE;
1973 	}
1974 	evt_id = wmi_handle->wmi_events[event_id];
1975 
1976 	idx = wmi_unified_get_event_handler_ix(wmi_handle, evt_id);
1977 	if (idx == -1) {
1978 		WMI_LOGE("event handler is not registered: evt id 0x%x",
1979 			  evt_id);
1980 		return QDF_STATUS_E_FAILURE;
1981 	}
1982 	wmi_handle->event_handler[idx] = NULL;
1983 	wmi_handle->event_id[idx] = 0;
1984 	--soc->max_event_idx;
1985 	wmi_handle->event_handler[idx] =
1986 		wmi_handle->event_handler[soc->max_event_idx];
1987 	wmi_handle->event_id[idx] =
1988 		wmi_handle->event_id[soc->max_event_idx];
1989 
1990 	return 0;
1991 }
1992 qdf_export_symbol(wmi_unified_unregister_event_handler);
1993 
1994 /**
1995  * wmi_process_fw_event_default_ctx() - process in default caller context
1996  * @wmi_handle: handle to wmi
1997  * @htc_packet: pointer to htc packet
1998  * @exec_ctx: execution context for wmi fw event
1999  *
2000  * Event process by below function will be in default caller context.
2001  * wmi internally provides rx work thread processing context.
2002  *
2003  * Return: none
2004  */
2005 static void wmi_process_fw_event_default_ctx(struct wmi_unified *wmi_handle,
2006 		       HTC_PACKET *htc_packet, uint8_t exec_ctx)
2007 {
2008 	wmi_buf_t evt_buf;
2009 	evt_buf = (wmi_buf_t) htc_packet->pPktContext;
2010 
2011 	wmi_handle->rx_ops.wma_process_fw_event_handler_cbk
2012 		(wmi_handle->scn_handle, evt_buf, exec_ctx);
2013 
2014 	return;
2015 }
2016 
2017 void wmi_process_fw_event_worker_thread_ctx(struct wmi_unified *wmi_handle,
2018 					    void *evt_buf)
2019 {
2020 
2021 	qdf_spin_lock_bh(&wmi_handle->eventq_lock);
2022 	qdf_nbuf_queue_add(&wmi_handle->event_queue, evt_buf);
2023 	qdf_spin_unlock_bh(&wmi_handle->eventq_lock);
2024 	qdf_queue_work(0, wmi_handle->wmi_rx_work_queue,
2025 			&wmi_handle->rx_event_work);
2026 
2027 	return;
2028 }
2029 
2030 qdf_export_symbol(wmi_process_fw_event_worker_thread_ctx);
2031 
2032 /**
2033  * wmi_get_pdev_ep: Get wmi handle based on endpoint
2034  * @soc: handle to wmi soc
2035  * @ep: endpoint id
2036  *
2037  * Return: none
2038  */
2039 static struct wmi_unified *wmi_get_pdev_ep(struct wmi_soc *soc,
2040 						HTC_ENDPOINT_ID ep)
2041 {
2042 	uint32_t i;
2043 
2044 	for (i = 0; i < WMI_MAX_RADIOS; i++)
2045 		if (soc->wmi_endpoint_id[i] == ep)
2046 			break;
2047 
2048 	if (i == WMI_MAX_RADIOS)
2049 		return NULL;
2050 
2051 	return soc->wmi_pdev[i];
2052 }
2053 
2054 /**
2055  * wmi_mtrace_rx() - Wrappper function for qdf_mtrace api
2056  * @message_id: 32-Bit Wmi message ID
2057  * @vdev_id: Vdev ID
2058  * @data: Actual message contents
2059  *
2060  * This function converts the 32-bit WMI message ID in 15-bit message ID
2061  * format for qdf_mtrace as in qdf_mtrace message there are only 15
2062  * bits reserved for message ID.
2063  * out of these 15-bits, 8-bits (From LSB) specifies the WMI_GRP_ID
2064  * and remaining 7-bits specifies the actual WMI command. With this
2065  * notation there can be maximum 256 groups and each group can have
2066  * max 128 commands can be supported.
2067  *
2068  * Return: None
2069  */
2070 static void wmi_mtrace_rx(uint32_t message_id, uint16_t vdev_id, uint32_t data)
2071 {
2072 	uint16_t mtrace_message_id;
2073 
2074 	mtrace_message_id = QDF_WMI_MTRACE_CMD_ID(message_id) |
2075 		(QDF_WMI_MTRACE_GRP_ID(message_id) <<
2076 						QDF_WMI_MTRACE_CMD_NUM_BITS);
2077 	qdf_mtrace(QDF_MODULE_ID_WMI, QDF_MODULE_ID_WMA,
2078 		   mtrace_message_id, vdev_id, data);
2079 }
2080 
2081 /**
2082  * wmi_control_rx() - process fw events callbacks
2083  * @ctx: handle to wmi
2084  * @htc_packet: pointer to htc packet
2085  *
2086  * Return: none
2087  */
2088 static void wmi_control_rx(void *ctx, HTC_PACKET *htc_packet)
2089 {
2090 	struct wmi_soc *soc = (struct wmi_soc *) ctx;
2091 	struct wmi_unified *wmi_handle;
2092 	wmi_buf_t evt_buf;
2093 	uint32_t id;
2094 	uint32_t idx = 0;
2095 	enum wmi_rx_exec_ctx exec_ctx;
2096 
2097 	evt_buf = (wmi_buf_t) htc_packet->pPktContext;
2098 
2099 	wmi_handle = wmi_get_pdev_ep(soc, htc_packet->Endpoint);
2100 	if (wmi_handle == NULL) {
2101 		WMI_LOGE
2102 		("unable to get wmi_handle to Endpoint %d\n",
2103 		 htc_packet->Endpoint);
2104 		qdf_nbuf_free(evt_buf);
2105 		return;
2106 	}
2107 
2108 	id = WMI_GET_FIELD(qdf_nbuf_data(evt_buf), WMI_CMD_HDR, COMMANDID);
2109 	idx = wmi_unified_get_event_handler_ix(wmi_handle, id);
2110 	if (qdf_unlikely(idx == A_ERROR)) {
2111 		wmi_debug("no handler registered for event id 0x%x", id);
2112 		qdf_nbuf_free(evt_buf);
2113 		return;
2114 	}
2115 	wmi_mtrace_rx(id, 0xFF, idx);
2116 	qdf_spin_lock_bh(&soc->ctx_lock);
2117 	exec_ctx = wmi_handle->ctx[idx];
2118 	qdf_spin_unlock_bh(&soc->ctx_lock);
2119 
2120 #ifdef WMI_INTERFACE_EVENT_LOGGING
2121 	if (wmi_handle->log_info.wmi_logging_enable) {
2122 		uint8_t *data;
2123 		data = qdf_nbuf_data(evt_buf);
2124 
2125 		qdf_spin_lock_bh(&wmi_handle->log_info.wmi_record_lock);
2126 		/* Exclude 4 bytes of TLV header */
2127 		if (wmi_handle->ops->is_diag_event(id)) {
2128 			WMI_DIAG_RX_EVENT_RECORD(wmi_handle, id,
2129 				((uint8_t *) data +
2130 				wmi_handle->soc->buf_offset_event));
2131 		} else if (wmi_handle->ops->is_management_record(id)) {
2132 			WMI_MGMT_RX_EVENT_RECORD(wmi_handle, id,
2133 				((uint8_t *) data +
2134 				wmi_handle->soc->buf_offset_event));
2135 		} else {
2136 			WMI_RX_EVENT_RECORD(wmi_handle, id, ((uint8_t *) data +
2137 				wmi_handle->soc->buf_offset_event));
2138 		}
2139 		qdf_spin_unlock_bh(&wmi_handle->log_info.wmi_record_lock);
2140 	}
2141 #endif
2142 
2143 	if (exec_ctx == WMI_RX_WORK_CTX) {
2144 		wmi_process_fw_event_worker_thread_ctx
2145 					(wmi_handle, evt_buf);
2146 	} else if (exec_ctx > WMI_RX_WORK_CTX) {
2147 		wmi_process_fw_event_default_ctx
2148 					(wmi_handle, htc_packet, exec_ctx);
2149 	} else {
2150 		WMI_LOGE("Invalid event context %d", exec_ctx);
2151 		qdf_nbuf_free(evt_buf);
2152 	}
2153 
2154 }
2155 
2156 /**
2157  * wmi_process_fw_event() - process any fw event
2158  * @wmi_handle: wmi handle
2159  * @evt_buf: fw event buffer
2160  *
2161  * This function process fw event in caller context
2162  *
2163  * Return: none
2164  */
2165 void wmi_process_fw_event(struct wmi_unified *wmi_handle, wmi_buf_t evt_buf)
2166 {
2167 	__wmi_control_rx(wmi_handle, evt_buf);
2168 }
2169 
2170 /**
2171  * __wmi_control_rx() - process serialize wmi event callback
2172  * @wmi_handle: wmi handle
2173  * @evt_buf: fw event buffer
2174  *
2175  * Return: none
2176  */
2177 void __wmi_control_rx(struct wmi_unified *wmi_handle, wmi_buf_t evt_buf)
2178 {
2179 	uint32_t id;
2180 	uint8_t *data;
2181 	uint32_t len;
2182 	void *wmi_cmd_struct_ptr = NULL;
2183 #ifndef WMI_NON_TLV_SUPPORT
2184 	int tlv_ok_status = 0;
2185 #endif
2186 	uint32_t idx = 0;
2187 
2188 	id = WMI_GET_FIELD(qdf_nbuf_data(evt_buf), WMI_CMD_HDR, COMMANDID);
2189 
2190 	wmi_ext_dbg_msg_event_record(wmi_handle, qdf_nbuf_data(evt_buf),
2191 				     qdf_nbuf_len(evt_buf));
2192 
2193 	if (qdf_nbuf_pull_head(evt_buf, sizeof(WMI_CMD_HDR)) == NULL)
2194 		goto end;
2195 
2196 	data = qdf_nbuf_data(evt_buf);
2197 	len = qdf_nbuf_len(evt_buf);
2198 
2199 #ifndef WMI_NON_TLV_SUPPORT
2200 	if (wmi_handle->target_type == WMI_TLV_TARGET) {
2201 		/* Validate and pad(if necessary) the TLVs */
2202 		tlv_ok_status =
2203 			wmi_handle->ops->wmi_check_and_pad_event(wmi_handle->scn_handle,
2204 							data, len, id,
2205 							&wmi_cmd_struct_ptr);
2206 		if (tlv_ok_status != 0) {
2207 			QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
2208 				  "%s: Error: id=0x%x, wmitlv check status=%d",
2209 				  __func__, id, tlv_ok_status);
2210 			goto end;
2211 		}
2212 	}
2213 #endif
2214 
2215 	idx = wmi_unified_get_event_handler_ix(wmi_handle, id);
2216 	if (idx == A_ERROR) {
2217 		QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_ERROR,
2218 		   "%s : event handler is not registered: event id 0x%x",
2219 			__func__, id);
2220 		goto end;
2221 	}
2222 #ifdef WMI_INTERFACE_EVENT_LOGGING
2223 	if (wmi_handle->log_info.wmi_logging_enable) {
2224 		qdf_spin_lock_bh(&wmi_handle->log_info.wmi_record_lock);
2225 		/* Exclude 4 bytes of TLV header */
2226 		if (wmi_handle->ops->is_diag_event(id)) {
2227 			/*
2228 			 * skip diag event logging in WMI event buffer
2229 			 * as its already logged in WMI RX event buffer
2230 			 */
2231 		} else if (wmi_handle->ops->is_management_record(id)) {
2232 			/*
2233 			 * skip wmi mgmt event logging in WMI event buffer
2234 			 * as its already logged in WMI RX event buffer
2235 			 */
2236 		} else {
2237 			WMI_EVENT_RECORD(wmi_handle, id, ((uint8_t *) data +
2238 					wmi_handle->soc->buf_offset_event));
2239 		}
2240 		qdf_spin_unlock_bh(&wmi_handle->log_info.wmi_record_lock);
2241 	}
2242 #endif
2243 	/* Call the WMI registered event handler */
2244 	if (wmi_handle->target_type == WMI_TLV_TARGET)
2245 		wmi_handle->event_handler[idx] (wmi_handle->scn_handle,
2246 			wmi_cmd_struct_ptr, len);
2247 	else
2248 		wmi_handle->event_handler[idx] (wmi_handle->scn_handle,
2249 			data, len);
2250 
2251 end:
2252 	/* Free event buffer and allocated event tlv */
2253 #ifndef WMI_NON_TLV_SUPPORT
2254 	if (wmi_handle->target_type == WMI_TLV_TARGET)
2255 		wmi_handle->ops->wmi_free_allocated_event(id, &wmi_cmd_struct_ptr);
2256 #endif
2257 
2258 	qdf_nbuf_free(evt_buf);
2259 
2260 }
2261 
2262 #define WMI_WQ_WD_TIMEOUT (30 * 1000) /* 30s */
2263 
2264 static inline void wmi_workqueue_watchdog_warn(uint32_t msg_type_id)
2265 {
2266 	QDF_TRACE(QDF_MODULE_ID_QDF, QDF_TRACE_LEVEL_ERROR,
2267 		  "%s: WLAN_BUG_RCA: Message type %x has exceeded its alloted time of %ds",
2268 		  __func__, msg_type_id, WMI_WQ_WD_TIMEOUT / 1000);
2269 }
2270 
2271 #ifdef CONFIG_SLUB_DEBUG_ON
2272 static void wmi_workqueue_watchdog_bite(void *arg)
2273 {
2274 	struct wmi_wq_dbg_info *info = arg;
2275 
2276 	wmi_workqueue_watchdog_warn(info->wd_msg_type_id);
2277 	qdf_print_thread_trace(info->task);
2278 
2279 	QDF_TRACE(QDF_MODULE_ID_QDF, QDF_TRACE_LEVEL_ERROR,
2280 		  "%s: Going down for WMI WQ Watchdog Bite!", __func__);
2281 	QDF_BUG(0);
2282 }
2283 #else
2284 static inline void wmi_workqueue_watchdog_bite(void *arg)
2285 {
2286 	struct wmi_wq_dbg_info *info = arg;
2287 
2288 	wmi_workqueue_watchdog_warn(info->wd_msg_type_id);
2289 }
2290 #endif
2291 
2292 /**
2293  * wmi_rx_event_work() - process rx event in rx work queue context
2294  * @arg: opaque pointer to wmi handle
2295  *
2296  * This function process any fw event to serialize it through rx worker thread.
2297  *
2298  * Return: none
2299  */
2300 static void wmi_rx_event_work(void *arg)
2301 {
2302 	wmi_buf_t buf;
2303 	struct wmi_unified *wmi = arg;
2304 	qdf_timer_t wd_timer;
2305 	struct wmi_wq_dbg_info info;
2306 
2307 	/* initialize WMI workqueue watchdog timer */
2308 	qdf_timer_init(NULL, &wd_timer, &wmi_workqueue_watchdog_bite,
2309 			&info, QDF_TIMER_TYPE_SW);
2310 	qdf_spin_lock_bh(&wmi->eventq_lock);
2311 	buf = qdf_nbuf_queue_remove(&wmi->event_queue);
2312 	qdf_spin_unlock_bh(&wmi->eventq_lock);
2313 	while (buf) {
2314 		qdf_timer_start(&wd_timer, WMI_WQ_WD_TIMEOUT);
2315 		info.wd_msg_type_id =
2316 		   WMI_GET_FIELD(qdf_nbuf_data(buf), WMI_CMD_HDR, COMMANDID);
2317 		info.wmi_wq = wmi->wmi_rx_work_queue;
2318 		info.task = qdf_get_current_task();
2319 		__wmi_control_rx(wmi, buf);
2320 		qdf_timer_stop(&wd_timer);
2321 		qdf_spin_lock_bh(&wmi->eventq_lock);
2322 		buf = qdf_nbuf_queue_remove(&wmi->event_queue);
2323 		qdf_spin_unlock_bh(&wmi->eventq_lock);
2324 	}
2325 	qdf_timer_free(&wd_timer);
2326 }
2327 
2328 #ifdef FEATURE_RUNTIME_PM
2329 /**
2330  * wmi_runtime_pm_init() - initialize runtime pm wmi variables
2331  * @wmi_handle: wmi context
2332  */
2333 static void wmi_runtime_pm_init(struct wmi_unified *wmi_handle)
2334 {
2335 	qdf_atomic_init(&wmi_handle->runtime_pm_inprogress);
2336 }
2337 
2338 /**
2339  * wmi_set_runtime_pm_inprogress() - set runtime pm progress flag
2340  * @wmi_handle: wmi context
2341  * @val: runtime pm progress flag
2342  */
2343 void wmi_set_runtime_pm_inprogress(wmi_unified_t wmi_handle, A_BOOL val)
2344 {
2345 	qdf_atomic_set(&wmi_handle->runtime_pm_inprogress, val);
2346 }
2347 
2348 /**
2349  * wmi_get_runtime_pm_inprogress() - get runtime pm progress flag
2350  * @wmi_handle: wmi context
2351  */
2352 inline bool wmi_get_runtime_pm_inprogress(wmi_unified_t wmi_handle)
2353 {
2354 	return qdf_atomic_read(&wmi_handle->runtime_pm_inprogress);
2355 }
2356 #else
2357 static void wmi_runtime_pm_init(struct wmi_unified *wmi_handle)
2358 {
2359 }
2360 #endif
2361 
2362 /**
2363  * wmi_unified_get_soc_handle: Get WMI SoC handle
2364  * @param wmi_handle: WMI context got from wmi_attach
2365  *
2366  * return: Pointer to Soc handle
2367  */
2368 void *wmi_unified_get_soc_handle(struct wmi_unified *wmi_handle)
2369 {
2370 	return wmi_handle->soc;
2371 }
2372 
2373 /**
2374  * wmi_interface_logging_init: Interface looging init
2375  * @param wmi_handle: Pointer to wmi handle object
2376  *
2377  * return: None
2378  */
2379 #ifdef WMI_INTERFACE_EVENT_LOGGING
2380 static inline void wmi_interface_logging_init(struct wmi_unified *wmi_handle,
2381 					      uint32_t pdev_idx)
2382 {
2383 	if (QDF_STATUS_SUCCESS == wmi_log_init(wmi_handle)) {
2384 		qdf_spinlock_create(&wmi_handle->log_info.wmi_record_lock);
2385 		wmi_debugfs_init(wmi_handle, pdev_idx);
2386 	}
2387 }
2388 #else
2389 static inline void wmi_interface_logging_init(struct wmi_unified *wmi_handle,
2390 					      uint32_t pdev_idx)
2391 {
2392 }
2393 #endif
2394 
2395 /**
2396  * wmi_target_params_init: Target specific params init
2397  * @param wmi_soc: Pointer to wmi soc object
2398  * @param wmi_handle: Pointer to wmi handle object
2399  *
2400  * return: None
2401  */
2402 #ifndef CONFIG_MCL
2403 static inline void wmi_target_params_init(struct wmi_soc *soc,
2404 				struct wmi_unified *wmi_handle)
2405 {
2406 	wmi_handle->pdev_param = soc->pdev_param;
2407 	wmi_handle->vdev_param = soc->vdev_param;
2408 	wmi_handle->services = soc->services;
2409 }
2410 #else
2411 static inline void wmi_target_params_init(struct wmi_soc *soc,
2412 				struct wmi_unified *wmi_handle)
2413 {
2414 	wmi_handle->services = soc->services;
2415 }
2416 #endif
2417 
2418 /**
2419  * wmi_unified_get_pdev_handle: Get WMI SoC handle
2420  * @param wmi_soc: Pointer to wmi soc object
2421  * @param pdev_idx: pdev index
2422  *
2423  * return: Pointer to wmi handle or NULL on failure
2424  */
2425 void *wmi_unified_get_pdev_handle(struct wmi_soc *soc, uint32_t pdev_idx)
2426 {
2427 	struct wmi_unified *wmi_handle;
2428 
2429 	if (pdev_idx >= WMI_MAX_RADIOS)
2430 		return NULL;
2431 
2432 	if (soc->wmi_pdev[pdev_idx] == NULL) {
2433 		wmi_handle =
2434 			(struct wmi_unified *) qdf_mem_malloc(
2435 					sizeof(struct wmi_unified));
2436 		if (!wmi_handle)
2437 			return NULL;
2438 
2439 		wmi_handle->scn_handle = soc->scn_handle;
2440 		wmi_handle->event_id = soc->event_id;
2441 		wmi_handle->event_handler = soc->event_handler;
2442 		wmi_handle->ctx = soc->ctx;
2443 		wmi_handle->ops = soc->ops;
2444 		qdf_spinlock_create(&wmi_handle->eventq_lock);
2445 		qdf_nbuf_queue_init(&wmi_handle->event_queue);
2446 
2447 		qdf_create_work(0, &wmi_handle->rx_event_work,
2448 				wmi_rx_event_work, wmi_handle);
2449 		wmi_handle->wmi_rx_work_queue =
2450 			qdf_alloc_unbound_workqueue("wmi_rx_event_work_queue");
2451 		if (NULL == wmi_handle->wmi_rx_work_queue) {
2452 			WMI_LOGE("failed to create wmi_rx_event_work_queue");
2453 			goto error;
2454 		}
2455 		wmi_handle->wmi_events = soc->wmi_events;
2456 		wmi_target_params_init(soc, wmi_handle);
2457 		wmi_handle->soc = soc;
2458 		wmi_interface_logging_init(wmi_handle, pdev_idx);
2459 		qdf_atomic_init(&wmi_handle->pending_cmds);
2460 		qdf_atomic_init(&wmi_handle->is_target_suspended);
2461 		wmi_handle->target_type = soc->target_type;
2462 		wmi_handle->wmi_max_cmds = soc->wmi_max_cmds;
2463 
2464 		soc->wmi_pdev[pdev_idx] = wmi_handle;
2465 	} else
2466 		wmi_handle = soc->wmi_pdev[pdev_idx];
2467 
2468 	wmi_handle->wmi_stopinprogress = 0;
2469 	wmi_handle->wmi_endpoint_id = soc->wmi_endpoint_id[pdev_idx];
2470 	wmi_handle->htc_handle = soc->htc_handle;
2471 	wmi_handle->max_msg_len = soc->max_msg_len[pdev_idx];
2472 
2473 	return wmi_handle;
2474 
2475 error:
2476 	qdf_mem_free(wmi_handle);
2477 
2478 	return NULL;
2479 }
2480 qdf_export_symbol(wmi_unified_get_pdev_handle);
2481 
2482 static void (*wmi_attach_register[WMI_MAX_TARGET_TYPE])(wmi_unified_t);
2483 
2484 void wmi_unified_register_module(enum wmi_target_type target_type,
2485 			void (*wmi_attach)(wmi_unified_t wmi_handle))
2486 {
2487 	if (target_type < WMI_MAX_TARGET_TYPE)
2488 		wmi_attach_register[target_type] = wmi_attach;
2489 
2490 	return;
2491 }
2492 qdf_export_symbol(wmi_unified_register_module);
2493 
2494 /**
2495  * wmi_wbuff_register() - register wmi with wbuff
2496  * @wmi_handle: handle to wmi
2497  *
2498  * @Return: void
2499  */
2500 static void wmi_wbuff_register(struct wmi_unified *wmi_handle)
2501 {
2502 	struct wbuff_alloc_request wbuff_alloc[4];
2503 
2504 	wbuff_alloc[0].slot = WBUFF_POOL_0;
2505 	wbuff_alloc[0].size = WMI_WBUFF_POOL_0_SIZE;
2506 	wbuff_alloc[1].slot = WBUFF_POOL_1;
2507 	wbuff_alloc[1].size = WMI_WBUFF_POOL_1_SIZE;
2508 	wbuff_alloc[2].slot = WBUFF_POOL_2;
2509 	wbuff_alloc[2].size = WMI_WBUFF_POOL_2_SIZE;
2510 	wbuff_alloc[3].slot = WBUFF_POOL_3;
2511 	wbuff_alloc[3].size = WMI_WBUFF_POOL_3_SIZE;
2512 
2513 	wmi_handle->wbuff_handle = wbuff_module_register(wbuff_alloc, 4,
2514 							 WMI_MIN_HEAD_ROOM, 4);
2515 }
2516 
2517 /**
2518  * wmi_wbuff_deregister() - deregister wmi with wbuff
2519  * @wmi_handle: handle to wmi
2520  *
2521  * @Return: void
2522  */
2523 static inline void wmi_wbuff_deregister(struct wmi_unified *wmi_handle)
2524 {
2525 	wbuff_module_deregister(wmi_handle->wbuff_handle);
2526 	wmi_handle->wbuff_handle = NULL;
2527 }
2528 
2529 /**
2530  * wmi_unified_attach() -  attach for unified WMI
2531  * @scn_handle: handle to SCN
2532  * @osdev: OS device context
2533  * @target_type: TLV or not-TLV based target
2534  * @use_cookie: cookie based allocation enabled/disabled
2535  * @ops: umac rx callbacks
2536  * @psoc: objmgr psoc
2537  *
2538  * @Return: wmi handle.
2539  */
2540 void *wmi_unified_attach(void *scn_handle,
2541 			 struct wmi_unified_attach_params *param)
2542 {
2543 	struct wmi_unified *wmi_handle;
2544 	struct wmi_soc *soc;
2545 
2546 	soc = (struct wmi_soc *) qdf_mem_malloc(sizeof(struct wmi_soc));
2547 	if (!soc)
2548 		return NULL;
2549 
2550 	wmi_handle =
2551 		(struct wmi_unified *) qdf_mem_malloc(
2552 			sizeof(struct wmi_unified));
2553 	if (!wmi_handle) {
2554 		qdf_mem_free(soc);
2555 		return NULL;
2556 	}
2557 	wmi_handle->soc = soc;
2558 	wmi_handle->soc->soc_idx = param->soc_id;
2559 	wmi_handle->soc->is_async_ep = param->is_async_ep;
2560 	wmi_handle->event_id = soc->event_id;
2561 	wmi_handle->event_handler = soc->event_handler;
2562 	wmi_handle->ctx = soc->ctx;
2563 	wmi_handle->wmi_events = soc->wmi_events;
2564 	wmi_target_params_init(soc, wmi_handle);
2565 	wmi_handle->scn_handle = scn_handle;
2566 	soc->scn_handle = scn_handle;
2567 	qdf_atomic_init(&wmi_handle->pending_cmds);
2568 	qdf_atomic_init(&wmi_handle->is_target_suspended);
2569 	wmi_runtime_pm_init(wmi_handle);
2570 	qdf_spinlock_create(&wmi_handle->eventq_lock);
2571 	qdf_nbuf_queue_init(&wmi_handle->event_queue);
2572 	qdf_create_work(0, &wmi_handle->rx_event_work,
2573 			wmi_rx_event_work, wmi_handle);
2574 	wmi_handle->wmi_rx_work_queue =
2575 		qdf_alloc_unbound_workqueue("wmi_rx_event_work_queue");
2576 	if (NULL == wmi_handle->wmi_rx_work_queue) {
2577 		WMI_LOGE("failed to create wmi_rx_event_work_queue");
2578 		goto error;
2579 	}
2580 	wmi_interface_logging_init(wmi_handle, WMI_HOST_PDEV_ID_0);
2581 	/* Attach mc_thread context processing function */
2582 	wmi_handle->rx_ops.wma_process_fw_event_handler_cbk =
2583 				param->rx_ops->wma_process_fw_event_handler_cbk;
2584 	wmi_handle->target_type = param->target_type;
2585 	soc->target_type = param->target_type;
2586 
2587 	if (param->target_type >= WMI_MAX_TARGET_TYPE)
2588 		goto error;
2589 
2590 	if (wmi_attach_register[param->target_type]) {
2591 		wmi_attach_register[param->target_type](wmi_handle);
2592 	} else {
2593 		WMI_LOGE("wmi attach is not registered");
2594 		goto error;
2595 	}
2596 	/* Assign target cookie capablity */
2597 	wmi_handle->use_cookie = param->use_cookie;
2598 	wmi_handle->osdev = param->osdev;
2599 	wmi_handle->wmi_stopinprogress = 0;
2600 	wmi_handle->wmi_max_cmds = param->max_commands;
2601 	soc->wmi_max_cmds = param->max_commands;
2602 	/* Increase the ref count once refcount infra is present */
2603 	soc->wmi_psoc = param->psoc;
2604 	qdf_spinlock_create(&soc->ctx_lock);
2605 
2606 	soc->ops = wmi_handle->ops;
2607 	soc->wmi_pdev[0] = wmi_handle;
2608 	if (wmi_ext_dbgfs_init(wmi_handle) != QDF_STATUS_SUCCESS)
2609 		WMI_LOGE("failed to initialize wmi extended debugfs");
2610 
2611 	wmi_wbuff_register(wmi_handle);
2612 
2613 	return wmi_handle;
2614 
2615 error:
2616 	qdf_mem_free(soc);
2617 	qdf_mem_free(wmi_handle);
2618 
2619 	return NULL;
2620 }
2621 
2622 /**
2623  * wmi_unified_detach() -  detach for unified WMI
2624  *
2625  * @wmi_handle  : handle to wmi.
2626  *
2627  * @Return: none.
2628  */
2629 void wmi_unified_detach(struct wmi_unified *wmi_handle)
2630 {
2631 	wmi_buf_t buf;
2632 	struct wmi_soc *soc;
2633 	uint8_t i;
2634 
2635 	wmi_wbuff_deregister(wmi_handle);
2636 
2637 	wmi_ext_dbgfs_deinit(wmi_handle);
2638 
2639 	soc = wmi_handle->soc;
2640 	for (i = 0; i < WMI_MAX_RADIOS; i++) {
2641 		if (soc->wmi_pdev[i]) {
2642 			qdf_flush_workqueue(0,
2643 				soc->wmi_pdev[i]->wmi_rx_work_queue);
2644 			qdf_destroy_workqueue(0,
2645 				soc->wmi_pdev[i]->wmi_rx_work_queue);
2646 			wmi_debugfs_remove(soc->wmi_pdev[i]);
2647 			buf = qdf_nbuf_queue_remove(
2648 					&soc->wmi_pdev[i]->event_queue);
2649 			while (buf) {
2650 				qdf_nbuf_free(buf);
2651 				buf = qdf_nbuf_queue_remove(
2652 						&soc->wmi_pdev[i]->event_queue);
2653 			}
2654 
2655 			wmi_log_buffer_free(soc->wmi_pdev[i]);
2656 
2657 			/* Free events logs list */
2658 			if (soc->wmi_pdev[i]->events_logs_list)
2659 				qdf_mem_free(
2660 					soc->wmi_pdev[i]->events_logs_list);
2661 
2662 			qdf_spinlock_destroy(&soc->wmi_pdev[i]->eventq_lock);
2663 			qdf_mem_free(soc->wmi_pdev[i]);
2664 		}
2665 	}
2666 	qdf_spinlock_destroy(&soc->ctx_lock);
2667 
2668 	if (soc->wmi_service_bitmap) {
2669 		qdf_mem_free(soc->wmi_service_bitmap);
2670 		soc->wmi_service_bitmap = NULL;
2671 	}
2672 
2673 	if (soc->wmi_ext_service_bitmap) {
2674 		qdf_mem_free(soc->wmi_ext_service_bitmap);
2675 		soc->wmi_ext_service_bitmap = NULL;
2676 	}
2677 
2678 	/* Decrease the ref count once refcount infra is present */
2679 	soc->wmi_psoc = NULL;
2680 	qdf_mem_free(soc);
2681 }
2682 
2683 /**
2684  * wmi_unified_remove_work() - detach for WMI work
2685  * @wmi_handle: handle to WMI
2686  *
2687  * A function that does not fully detach WMI, but just remove work
2688  * queue items associated with it. This is used to make sure that
2689  * before any other processing code that may destroy related contexts
2690  * (HTC, etc), work queue processing on WMI has already been stopped.
2691  *
2692  * Return: None
2693  */
2694 void
2695 wmi_unified_remove_work(struct wmi_unified *wmi_handle)
2696 {
2697 	wmi_buf_t buf;
2698 
2699 	qdf_flush_workqueue(0, wmi_handle->wmi_rx_work_queue);
2700 	qdf_spin_lock_bh(&wmi_handle->eventq_lock);
2701 	buf = qdf_nbuf_queue_remove(&wmi_handle->event_queue);
2702 	while (buf) {
2703 		qdf_nbuf_free(buf);
2704 		buf = qdf_nbuf_queue_remove(&wmi_handle->event_queue);
2705 	}
2706 	qdf_spin_unlock_bh(&wmi_handle->eventq_lock);
2707 }
2708 
2709 /**
2710  * wmi_htc_tx_complete() - Process htc tx completion
2711  *
2712  * @ctx: handle to wmi
2713  * @htc_packet: pointer to htc packet
2714  *
2715  * @Return: none.
2716  */
2717 static void wmi_htc_tx_complete(void *ctx, HTC_PACKET *htc_pkt)
2718 {
2719 	struct wmi_soc *soc = (struct wmi_soc *) ctx;
2720 	wmi_buf_t wmi_cmd_buf = GET_HTC_PACKET_NET_BUF_CONTEXT(htc_pkt);
2721 	u_int8_t *buf_ptr;
2722 	u_int32_t len;
2723 	struct wmi_unified *wmi_handle;
2724 #ifdef WMI_INTERFACE_EVENT_LOGGING
2725 	uint32_t cmd_id;
2726 #endif
2727 
2728 	ASSERT(wmi_cmd_buf);
2729 	wmi_handle = wmi_get_pdev_ep(soc, htc_pkt->Endpoint);
2730 	if (wmi_handle == NULL) {
2731 		WMI_LOGE("%s: Unable to get wmi handle\n", __func__);
2732 		QDF_ASSERT(0);
2733 		return;
2734 	}
2735 #ifdef WMI_INTERFACE_EVENT_LOGGING
2736 	if (wmi_handle && wmi_handle->log_info.wmi_logging_enable) {
2737 		cmd_id = WMI_GET_FIELD(qdf_nbuf_data(wmi_cmd_buf),
2738 				WMI_CMD_HDR, COMMANDID);
2739 
2740 	qdf_spin_lock_bh(&wmi_handle->log_info.wmi_record_lock);
2741 	/* Record 16 bytes of WMI cmd tx complete data
2742 	- exclude TLV and WMI headers */
2743 	if (wmi_handle->ops->is_management_record(cmd_id)) {
2744 		WMI_MGMT_COMMAND_TX_CMP_RECORD(wmi_handle, cmd_id,
2745 			qdf_nbuf_data(wmi_cmd_buf) +
2746 			wmi_handle->soc->buf_offset_command);
2747 	} else {
2748 		WMI_COMMAND_TX_CMP_RECORD(wmi_handle, cmd_id,
2749 			qdf_nbuf_data(wmi_cmd_buf) +
2750 			wmi_handle->soc->buf_offset_command);
2751 	}
2752 
2753 	qdf_spin_unlock_bh(&wmi_handle->log_info.wmi_record_lock);
2754 	}
2755 #endif
2756 	buf_ptr = (u_int8_t *) wmi_buf_data(wmi_cmd_buf);
2757 	len = qdf_nbuf_len(wmi_cmd_buf);
2758 	qdf_mem_zero(buf_ptr, len);
2759 	wmi_buf_free(wmi_cmd_buf);
2760 	qdf_mem_free(htc_pkt);
2761 	qdf_atomic_dec(&wmi_handle->pending_cmds);
2762 }
2763 
2764 /**
2765  * wmi_connect_pdev_htc_service() -  WMI API to get connect to HTC service
2766  *
2767  * @wmi_handle: handle to WMI.
2768  * @pdev_idx: Pdev index
2769  *
2770  * @Return: QDF_STATUS
2771  */
2772 static QDF_STATUS wmi_connect_pdev_htc_service(struct wmi_soc *soc,
2773 					       uint32_t pdev_idx)
2774 {
2775 	QDF_STATUS status;
2776 	struct htc_service_connect_resp response;
2777 	struct htc_service_connect_req connect;
2778 
2779 	OS_MEMZERO(&connect, sizeof(connect));
2780 	OS_MEMZERO(&response, sizeof(response));
2781 
2782 	/* meta data is unused for now */
2783 	connect.pMetaData = NULL;
2784 	connect.MetaDataLength = 0;
2785 	/* these fields are the same for all service endpoints */
2786 	connect.EpCallbacks.pContext = soc;
2787 	connect.EpCallbacks.EpTxCompleteMultiple =
2788 		NULL /* Control path completion ar6000_tx_complete */;
2789 	connect.EpCallbacks.EpRecv = wmi_control_rx /* Control path rx */;
2790 	connect.EpCallbacks.EpRecvRefill = NULL /* ar6000_rx_refill */;
2791 	connect.EpCallbacks.EpSendFull = NULL /* ar6000_tx_queue_full */;
2792 	connect.EpCallbacks.EpTxComplete =
2793 		wmi_htc_tx_complete /* ar6000_tx_queue_full */;
2794 
2795 	/* connect to control service */
2796 	connect.service_id = soc->svc_ids[pdev_idx];
2797 	status = htc_connect_service(soc->htc_handle, &connect, &response);
2798 
2799 	if (QDF_IS_STATUS_ERROR(status)) {
2800 		WMI_LOGE("Failed to connect to WMI CONTROL service status:%d\n",
2801 			 status);
2802 		return status;
2803 	}
2804 
2805 	if (soc->is_async_ep)
2806 		htc_set_async_ep(soc->htc_handle, response.Endpoint, true);
2807 
2808 	soc->wmi_endpoint_id[pdev_idx] = response.Endpoint;
2809 	soc->max_msg_len[pdev_idx] = response.MaxMsgLength;
2810 
2811 	return QDF_STATUS_SUCCESS;
2812 }
2813 
2814 /**
2815  * wmi_unified_connect_htc_service() -  WMI API to get connect to HTC service
2816  *
2817  * @wmi_handle: handle to WMI.
2818  *
2819  * @Return: status.
2820  */
2821 QDF_STATUS
2822 wmi_unified_connect_htc_service(struct wmi_unified *wmi_handle,
2823 				void *htc_handle)
2824 {
2825 	uint32_t i;
2826 	uint8_t wmi_ep_count;
2827 
2828 	wmi_handle->soc->htc_handle = htc_handle;
2829 
2830 	wmi_ep_count = htc_get_wmi_endpoint_count(htc_handle);
2831 	if (wmi_ep_count > WMI_MAX_RADIOS)
2832 		return QDF_STATUS_E_FAULT;
2833 
2834 	for (i = 0; i < wmi_ep_count; i++)
2835 		wmi_connect_pdev_htc_service(wmi_handle->soc, i);
2836 
2837 	wmi_handle->htc_handle = htc_handle;
2838 	wmi_handle->wmi_endpoint_id = wmi_handle->soc->wmi_endpoint_id[0];
2839 	wmi_handle->max_msg_len = wmi_handle->soc->max_msg_len[0];
2840 
2841 	return QDF_STATUS_SUCCESS;
2842 }
2843 
2844 /**
2845  * wmi_get_host_credits() -  WMI API to get updated host_credits
2846  *
2847  * @wmi_handle: handle to WMI.
2848  *
2849  * @Return: updated host_credits.
2850  */
2851 int wmi_get_host_credits(wmi_unified_t wmi_handle)
2852 {
2853 	int host_credits = 0;
2854 
2855 	htc_get_control_endpoint_tx_host_credits(wmi_handle->htc_handle,
2856 						 &host_credits);
2857 	return host_credits;
2858 }
2859 
2860 /**
2861  * wmi_get_pending_cmds() - WMI API to get WMI Pending Commands in the HTC
2862  *                          queue
2863  *
2864  * @wmi_handle: handle to WMI.
2865  *
2866  * @Return: Pending Commands in the HTC queue.
2867  */
2868 int wmi_get_pending_cmds(wmi_unified_t wmi_handle)
2869 {
2870 	return qdf_atomic_read(&wmi_handle->pending_cmds);
2871 }
2872 
2873 /**
2874  * wmi_set_target_suspend() -  WMI API to set target suspend state
2875  *
2876  * @wmi_handle: handle to WMI.
2877  * @val: suspend state boolean.
2878  *
2879  * @Return: none.
2880  */
2881 void wmi_set_target_suspend(wmi_unified_t wmi_handle, A_BOOL val)
2882 {
2883 	qdf_atomic_set(&wmi_handle->is_target_suspended, val);
2884 }
2885 
2886 /**
2887  * WMI API to set crash injection state
2888  * @param wmi_handle:	handle to WMI.
2889  * @param val:		crash injection state boolean.
2890  */
2891 void wmi_tag_crash_inject(wmi_unified_t wmi_handle, A_BOOL flag)
2892 {
2893 	wmi_handle->tag_crash_inject = flag;
2894 }
2895 
2896 /**
2897  * WMI API to set bus suspend state
2898  * @param wmi_handle:	handle to WMI.
2899  * @param val:		suspend state boolean.
2900  */
2901 void wmi_set_is_wow_bus_suspended(wmi_unified_t wmi_handle, A_BOOL val)
2902 {
2903 	qdf_atomic_set(&wmi_handle->is_wow_bus_suspended, val);
2904 }
2905 
2906 void wmi_set_tgt_assert(wmi_unified_t wmi_handle, bool val)
2907 {
2908 	wmi_handle->tgt_force_assert_enable = val;
2909 }
2910 
2911 /**
2912  * wmi_stop() - generic function to block unified WMI command
2913  * @wmi_handle: handle to WMI.
2914  *
2915  * @Return: success always.
2916  */
2917 int
2918 wmi_stop(wmi_unified_t wmi_handle)
2919 {
2920 	QDF_TRACE(QDF_MODULE_ID_WMI, QDF_TRACE_LEVEL_INFO,
2921 		  "WMI Stop");
2922 	wmi_handle->wmi_stopinprogress = 1;
2923 	return 0;
2924 }
2925 
2926 #ifndef CONFIG_MCL
2927 /**
2928  * API to flush all the previous packets  associated with the wmi endpoint
2929  *
2930  * @param wmi_handle      : handle to WMI.
2931  */
2932 void
2933 wmi_flush_endpoint(wmi_unified_t wmi_handle)
2934 {
2935 	htc_flush_endpoint(wmi_handle->htc_handle,
2936 		wmi_handle->wmi_endpoint_id, 0);
2937 }
2938 qdf_export_symbol(wmi_flush_endpoint);
2939 
2940 /**
2941  * wmi_pdev_id_conversion_enable() - API to enable pdev_id conversion in WMI
2942  *                     By default pdev_id conversion is not done in WMI.
2943  *                     This API can be used enable conversion in WMI.
2944  * @param wmi_handle   : handle to WMI
2945  * Return none
2946  */
2947 void wmi_pdev_id_conversion_enable(wmi_unified_t wmi_handle)
2948 {
2949 	if (wmi_handle->target_type == WMI_TLV_TARGET)
2950 		wmi_handle->ops->wmi_pdev_id_conversion_enable(wmi_handle);
2951 }
2952 
2953 #endif
2954