xref: /wlan-dirver/qca-wifi-host-cmn/umac/cmn_services/interface_mgr/inc/wlan_if_mgr_main.h (revision 2f4b444fb7e689b83a4ab0e7b3b38f0bf4def8e0)
1 /*
2  * Copyright (c) 2020, The Linux Foundation. All rights reserved.
3  *
4  * Permission to use, copy, modify, and/or distribute this software for any
5  * purpose with or without fee is hereby granted, provided that the above
6  * copyright notice and this permission notice appear in all copies.
7  *
8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15  */
16 
17 /*
18  * DOC: contains Interface MGR init/deinit public api
19  */
20 
21 #ifndef _WLAN_IF_MGR_MAIN_API_H_
22 #define _WLAN_IF_MGR_MAIN_API_H_
23 
24 #ifdef WLAN_FEATURE_INTERFACE_MGR
25 
26 #include <qdf_atomic.h>
27 #include <wlan_objmgr_psoc_obj.h>
28 #include <wlan_objmgr_pdev_obj.h>
29 #include <wlan_objmgr_vdev_obj.h>
30 #include <wlan_if_mgr_public_struct.h>
31 
32 #define ifmgr_alert(params...) \
33 	QDF_TRACE_FATAL(QDF_MODULE_ID_IFMGR, params)
34 #define ifmgr_err(params...) \
35 	QDF_TRACE_ERROR(QDF_MODULE_ID_IFMGR, params)
36 #define ifmgr_warn(params...) \
37 	QDF_TRACE_WARN(QDF_MODULE_ID_IFMGR, params)
38 #define ifmgr_notice(params...) \
39 	QDF_TRACE_INFO(QDF_MODULE_ID_IFMGR, params)
40 #define ifmgr_info(params...) \
41 	QDF_TRACE_INFO(QDF_MODULE_ID_IFMGR, params)
42 #define ifmgr_debug(params...) \
43 	QDF_TRACE_DEBUG(QDF_MODULE_ID_IFMGR, params)
44 
45 /* Rate Limited Logs */
46 #define ifmgr_alert_rl(params...) \
47 	QDF_TRACE_FATAL_RL(QDF_MODULE_ID_IFMGR, params)
48 #define ifmgr_err_rl(params...) \
49 	QDF_TRACE_ERROR_RL(QDF_MODULE_ID_IFMGR, params)
50 #define ifmgr_warn_rl(params...) \
51 	QDF_TRACE_WARN_RL(QDF_MODULE_ID_IFMGR, params)
52 #define ifmgr_info_rl(params...) \
53 	QDF_TRACE_INFO_RL(QDF_MODULE_ID_IFMGR, params)
54 #define ifmgr_debug_rl(params...) \
55 	QDF_TRACE_DEBUG_RL(QDF_MODULE_ID_IFMGR, params)
56 
57 #define ifmgr_nofl_alert(params...) \
58 	QDF_TRACE_FATAL_NO_FL(QDF_MODULE_ID_IFMGR, params)
59 #define ifmgr_nofl_err(params...) \
60 	QDF_TRACE_ERROR_NO_FL(QDF_MODULE_ID_IFMGR, params)
61 #define ifmgr_nofl_warn(params...) \
62 	QDF_TRACE_WARN_NO_FL(QDF_MODULE_ID_IFMGR, params)
63 #define ifmgr_nofl_info(params...) \
64 	QDF_TRACE_INFO_NO_FL(QDF_MODULE_ID_IFMGR, params)
65 #define ifmgr_nofl_debug(params...) \
66 	QDF_TRACE_DEBUG_NO_FL(QDF_MODULE_ID_IFMGR, params)
67 
68 #define ifmgr_hex_dump(level, data, buf_len) \
69 		qdf_trace_hex_dump(QDF_MODULE_ID_IFMGR, level, data, buf_len)
70 
71 /*
72  * wlan_if_mgr_init() - Interface manager module initialization API
73  *
74  * Return: QDF_STATUS
75  */
76 QDF_STATUS wlan_if_mgr_init(void);
77 
78 /**
79  * wlan_if_mgr_deinit() - interface manager module deinitialization API
80  *
81  * Return: QDF_STATUS
82  */
83 QDF_STATUS wlan_if_mgr_deinit(void);
84 
85 /**
86  * wlan_if_mgr_psoc_created_notification() - interface mgr psoc create handler
87  * @psoc: psoc object
88  * @arg_list: Argument list
89  *
90  * Return: QDF_STATUS
91  */
92 QDF_STATUS wlan_if_mgr_psoc_created_notification(struct wlan_objmgr_psoc *psoc,
93 						 void *arg_list);
94 /**
95  * wlan_scan_psoc_deleted_notification() - scan psoc delete handler
96  * @psoc: psoc object
97  * @arg_list: Argument list
98  *
99  * Return: QDF_STATUS
100  */
101 QDF_STATUS wlan_if_mgr_psoc_destroyed_notification(struct wlan_objmgr_psoc *psoc,
102 						   void *arg_list);
103 #else
104 inline QDF_STATUS wlan_if_mgr_init(void)
105 {
106 	return QDF_STATUS_SUCCESS;
107 }
108 
109 QDF_STATUS wlan_if_mgr_deinit(void)
110 {
111 	return QDF_STATUS_SUCCESS;
112 }
113 #endif
114 #endif
115