xref: /openbmc/linux/drivers/net/wireless/ath/ath11k/hif.h (revision 586c7fb1)
1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */
2 /*
3  * Copyright (c) 2019-2020 The Linux Foundation. All rights reserved.
4  * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved.
5  */
6 
7 #ifndef _HIF_H_
8 #define _HIF_H_
9 
10 #include "core.h"
11 
12 struct ath11k_hif_ops {
13 	u32 (*read32)(struct ath11k_base *sc, u32 address);
14 	void (*write32)(struct ath11k_base *sc, u32 address, u32 data);
15 	int (*read)(struct ath11k_base *ab, void *buf, u32 start, u32 end);
16 	void (*irq_enable)(struct ath11k_base *sc);
17 	void (*irq_disable)(struct ath11k_base *sc);
18 	int (*start)(struct ath11k_base *sc);
19 	void (*stop)(struct ath11k_base *sc);
20 	int (*power_up)(struct ath11k_base *sc);
21 	void (*power_down)(struct ath11k_base *sc);
22 	int (*suspend)(struct ath11k_base *ab);
23 	int (*resume)(struct ath11k_base *ab);
24 	int (*map_service_to_pipe)(struct ath11k_base *sc, u16 service_id,
25 				   u8 *ul_pipe, u8 *dl_pipe);
26 	int (*get_user_msi_vector)(struct ath11k_base *ab, char *user_name,
27 				   int *num_vectors, u32 *user_base_data,
28 				   u32 *base_vector);
29 	void (*get_msi_address)(struct ath11k_base *ab, u32 *msi_addr_lo,
30 				u32 *msi_addr_hi);
31 	void (*ce_irq_enable)(struct ath11k_base *ab);
32 	void (*ce_irq_disable)(struct ath11k_base *ab);
33 	void (*get_ce_msi_idx)(struct ath11k_base *ab, u32 ce_id, u32 *msi_idx);
34 };
35 
ath11k_hif_ce_irq_enable(struct ath11k_base * ab)36 static inline void ath11k_hif_ce_irq_enable(struct ath11k_base *ab)
37 {
38 	if (ab->hif.ops->ce_irq_enable)
39 		ab->hif.ops->ce_irq_enable(ab);
40 }
41 
ath11k_hif_ce_irq_disable(struct ath11k_base * ab)42 static inline void ath11k_hif_ce_irq_disable(struct ath11k_base *ab)
43 {
44 	if (ab->hif.ops->ce_irq_disable)
45 		ab->hif.ops->ce_irq_disable(ab);
46 }
47 
ath11k_hif_start(struct ath11k_base * sc)48 static inline int ath11k_hif_start(struct ath11k_base *sc)
49 {
50 	return sc->hif.ops->start(sc);
51 }
52 
ath11k_hif_stop(struct ath11k_base * sc)53 static inline void ath11k_hif_stop(struct ath11k_base *sc)
54 {
55 	sc->hif.ops->stop(sc);
56 }
57 
ath11k_hif_irq_enable(struct ath11k_base * sc)58 static inline void ath11k_hif_irq_enable(struct ath11k_base *sc)
59 {
60 	sc->hif.ops->irq_enable(sc);
61 }
62 
ath11k_hif_irq_disable(struct ath11k_base * sc)63 static inline void ath11k_hif_irq_disable(struct ath11k_base *sc)
64 {
65 	sc->hif.ops->irq_disable(sc);
66 }
67 
ath11k_hif_power_up(struct ath11k_base * sc)68 static inline int ath11k_hif_power_up(struct ath11k_base *sc)
69 {
70 	return sc->hif.ops->power_up(sc);
71 }
72 
ath11k_hif_power_down(struct ath11k_base * sc)73 static inline void ath11k_hif_power_down(struct ath11k_base *sc)
74 {
75 	sc->hif.ops->power_down(sc);
76 }
77 
ath11k_hif_suspend(struct ath11k_base * ab)78 static inline int ath11k_hif_suspend(struct ath11k_base *ab)
79 {
80 	if (ab->hif.ops->suspend)
81 		return ab->hif.ops->suspend(ab);
82 
83 	return 0;
84 }
85 
ath11k_hif_resume(struct ath11k_base * ab)86 static inline int ath11k_hif_resume(struct ath11k_base *ab)
87 {
88 	if (ab->hif.ops->resume)
89 		return ab->hif.ops->resume(ab);
90 
91 	return 0;
92 }
93 
ath11k_hif_read32(struct ath11k_base * sc,u32 address)94 static inline u32 ath11k_hif_read32(struct ath11k_base *sc, u32 address)
95 {
96 	return sc->hif.ops->read32(sc, address);
97 }
98 
ath11k_hif_write32(struct ath11k_base * sc,u32 address,u32 data)99 static inline void ath11k_hif_write32(struct ath11k_base *sc, u32 address, u32 data)
100 {
101 	sc->hif.ops->write32(sc, address, data);
102 }
103 
ath11k_hif_read(struct ath11k_base * ab,void * buf,u32 start,u32 end)104 static inline int ath11k_hif_read(struct ath11k_base *ab, void *buf,
105 				  u32 start, u32 end)
106 {
107 	if (!ab->hif.ops->read)
108 		return -EOPNOTSUPP;
109 
110 	return ab->hif.ops->read(ab, buf, start, end);
111 }
112 
ath11k_hif_map_service_to_pipe(struct ath11k_base * sc,u16 service_id,u8 * ul_pipe,u8 * dl_pipe)113 static inline int ath11k_hif_map_service_to_pipe(struct ath11k_base *sc, u16 service_id,
114 						 u8 *ul_pipe, u8 *dl_pipe)
115 {
116 	return sc->hif.ops->map_service_to_pipe(sc, service_id, ul_pipe, dl_pipe);
117 }
118 
ath11k_get_user_msi_vector(struct ath11k_base * ab,char * user_name,int * num_vectors,u32 * user_base_data,u32 * base_vector)119 static inline int ath11k_get_user_msi_vector(struct ath11k_base *ab, char *user_name,
120 					     int *num_vectors, u32 *user_base_data,
121 					     u32 *base_vector)
122 {
123 	if (!ab->hif.ops->get_user_msi_vector)
124 		return -EOPNOTSUPP;
125 
126 	return ab->hif.ops->get_user_msi_vector(ab, user_name, num_vectors,
127 						user_base_data,
128 						base_vector);
129 }
130 
ath11k_get_msi_address(struct ath11k_base * ab,u32 * msi_addr_lo,u32 * msi_addr_hi)131 static inline void ath11k_get_msi_address(struct ath11k_base *ab, u32 *msi_addr_lo,
132 					  u32 *msi_addr_hi)
133 {
134 	if (!ab->hif.ops->get_msi_address)
135 		return;
136 
137 	ab->hif.ops->get_msi_address(ab, msi_addr_lo, msi_addr_hi);
138 }
139 
ath11k_get_ce_msi_idx(struct ath11k_base * ab,u32 ce_id,u32 * msi_data_idx)140 static inline void ath11k_get_ce_msi_idx(struct ath11k_base *ab, u32 ce_id,
141 					 u32 *msi_data_idx)
142 {
143 	if (ab->hif.ops->get_ce_msi_idx)
144 		ab->hif.ops->get_ce_msi_idx(ab, ce_id, msi_data_idx);
145 	else
146 		*msi_data_idx = ce_id;
147 }
148 
149 #endif /* _HIF_H_ */
150