xref: /wlan-driver/qca-wifi-host-cmn/hal/wifi3.0/li/hal_li_reo.h (revision 5113495b16420b49004c444715d2daae2066e7dc)
1 /*
2  * Copyright (c) 2017-2019, 2021 The Linux Foundation. All rights reserved.
3  * Copyright (c) 2021, 2023 Qualcomm Innovation Center, Inc. All rights reserved.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for
6  * any purpose with or without fee is hereby granted, provided that the
7  * above copyright notice and this permission notice appear in all
8  * copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17  * PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 #ifndef _HAL_LI_REO_H_
21 #define _HAL_LI_REO_H_
22 
23 #include "hal_rx.h"
24 #include "hal_reo.h"
25 
26 #define HAL_REO_QUEUE_EXT_DESC 9
27 
28 /**
29  * hal_get_ba_aging_timeout_li() - Get BA Aging timeout
30  * @hal_soc_hdl: Opaque HAL SOC handle
31  * @ac: Access category
32  * @value: window size to get
33  */
34 void hal_get_ba_aging_timeout_li(hal_soc_handle_t hal_soc_hdl, uint8_t ac,
35 				 uint32_t *value);
36 
37 /**
38  * hal_set_ba_aging_timeout_li() - Set BA Aging timeout
39  * @hal_soc_hdl: Opaque HAL SOC handle
40  * @ac: Access category
41  * ac: 0 - Background, 1 - Best Effort, 2 - Video, 3 - Voice
42  * @value: Input value to set
43  */
44 void hal_set_ba_aging_timeout_li(hal_soc_handle_t hal_soc_hdl, uint8_t ac,
45 				 uint32_t value);
46 
47 uint32_t hal_get_reo_reg_base_offset_li(void);
48 
49 int hal_reo_send_cmd_li(hal_soc_handle_t hal_soc_hdl,
50 			hal_ring_handle_t  hal_ring_hdl,
51 			enum hal_reo_cmd_type cmd,
52 			void *params);
53 
54 /* REO status ring routines */
55 void
56 hal_reo_queue_stats_status_li(hal_ring_desc_t ring_desc,
57 			      void *st_handle,
58 			      hal_soc_handle_t hal_soc_hdl);
59 void
60 hal_reo_flush_queue_status_li(hal_ring_desc_t ring_desc,
61 			      void *st_handle,
62 			      hal_soc_handle_t hal_soc_hdl);
63 void
64 hal_reo_flush_cache_status_li(hal_ring_desc_t ring_desc,
65 			      void *st_handle,
66 			      hal_soc_handle_t hal_soc_hdl);
67 void
68 hal_reo_unblock_cache_status_li(hal_ring_desc_t ring_desc,
69 				hal_soc_handle_t hal_soc_hdl,
70 				void *st_handle);
71 void hal_reo_flush_timeout_list_status_li(hal_ring_desc_t ring_desc,
72 					  void *st_handle,
73 					  hal_soc_handle_t hal_soc_hdl);
74 void hal_reo_desc_thres_reached_status_li(hal_ring_desc_t ring_desc,
75 					  void *st_handle,
76 					  hal_soc_handle_t hal_soc_hdl);
77 void
78 hal_reo_rx_update_queue_status_li(hal_ring_desc_t ring_desc,
79 				  void *st_handle,
80 				  hal_soc_handle_t hal_soc_hdl);
81 
82 /**
83  * hal_reo_init_cmd_ring_li() - Initialize descriptors of REO command SRNG
84  * with command number
85  * @hal_soc_hdl: Handle to HAL SoC structure
86  * @hal_ring_hdl: Handle to HAL SRNG structure
87  *
88  * Return: none
89  */
90 void hal_reo_init_cmd_ring_li(hal_soc_handle_t hal_soc_hdl,
91 			      hal_ring_handle_t hal_ring_hdl);
92 
93 uint8_t hal_get_tlv_hdr_size_li(void);
94 
95 uint64_t hal_rx_get_qdesc_addr_li(uint8_t *dst_ring_desc, uint8_t *buf);
96 #endif /* _HAL_LI_REO_H_ */
97