xref: /linux/drivers/net/wireless/realtek/rtw89/chan.h (revision 3fd6c59042dbba50391e30862beac979491145fe)
1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
2  * Copyright(c) 2020-2022  Realtek Corporation
3  */
4 
5 #ifndef __RTW89_CHAN_H__
6 #define __RTW89_CHAN_H__
7 
8 #include "core.h"
9 
10 /* The dwell time in TU before doing rtw89_chanctx_work(). */
11 #define RTW89_CHANCTX_TIME_MCC_PREPARE 100
12 #define RTW89_CHANCTX_TIME_MCC 100
13 
14 /* various MCC setting time in TU */
15 #define RTW89_MCC_LONG_TRIGGER_TIME 300
16 #define RTW89_MCC_SHORT_TRIGGER_TIME 100
17 #define RTW89_MCC_EARLY_TX_BCN_TIME 10
18 #define RTW89_MCC_EARLY_RX_BCN_TIME 5
19 #define RTW89_MCC_MIN_RX_BCN_TIME 10
20 #define RTW89_MCC_DFLT_BCN_OFST_TIME 40
21 
22 #define RTW89_MCC_MIN_GO_DURATION \
23 	(RTW89_MCC_EARLY_TX_BCN_TIME + RTW89_MCC_MIN_RX_BCN_TIME)
24 
25 #define RTW89_MCC_MIN_STA_DURATION \
26 	(RTW89_MCC_EARLY_RX_BCN_TIME + RTW89_MCC_MIN_RX_BCN_TIME)
27 
28 #define RTW89_MCC_DFLT_GROUP 0
29 #define RTW89_MCC_NEXT_GROUP(cur) (((cur) + 1) % 4)
30 
31 #define RTW89_MCC_DFLT_TX_NULL_EARLY 3
32 #define RTW89_MCC_DFLT_COURTESY_SLOT 3
33 
34 #define NUM_OF_RTW89_MCC_ROLES 2
35 
36 enum rtw89_chanctx_pause_reasons {
37 	RTW89_CHANCTX_PAUSE_REASON_HW_SCAN,
38 	RTW89_CHANCTX_PAUSE_REASON_ROC,
39 };
40 
41 struct rtw89_entity_weight {
42 	unsigned int active_chanctxs;
43 	unsigned int active_roles;
44 };
45 
rtw89_get_entity_state(struct rtw89_dev * rtwdev,enum rtw89_phy_idx phy_idx)46 static inline bool rtw89_get_entity_state(struct rtw89_dev *rtwdev,
47 					  enum rtw89_phy_idx phy_idx)
48 {
49 	struct rtw89_hal *hal = &rtwdev->hal;
50 
51 	return READ_ONCE(hal->entity_active[phy_idx]);
52 }
53 
rtw89_set_entity_state(struct rtw89_dev * rtwdev,enum rtw89_phy_idx phy_idx,bool active)54 static inline void rtw89_set_entity_state(struct rtw89_dev *rtwdev,
55 					  enum rtw89_phy_idx phy_idx,
56 					  bool active)
57 {
58 	struct rtw89_hal *hal = &rtwdev->hal;
59 
60 	WRITE_ONCE(hal->entity_active[phy_idx], active);
61 }
62 
63 static inline
rtw89_get_entity_mode(struct rtw89_dev * rtwdev)64 enum rtw89_entity_mode rtw89_get_entity_mode(struct rtw89_dev *rtwdev)
65 {
66 	struct rtw89_hal *hal = &rtwdev->hal;
67 
68 	return READ_ONCE(hal->entity_mode);
69 }
70 
rtw89_set_entity_mode(struct rtw89_dev * rtwdev,enum rtw89_entity_mode mode)71 static inline void rtw89_set_entity_mode(struct rtw89_dev *rtwdev,
72 					 enum rtw89_entity_mode mode)
73 {
74 	struct rtw89_hal *hal = &rtwdev->hal;
75 
76 	WRITE_ONCE(hal->entity_mode, mode);
77 }
78 
79 void rtw89_chan_create(struct rtw89_chan *chan, u8 center_chan, u8 primary_chan,
80 		       enum rtw89_band band, enum rtw89_bandwidth bandwidth);
81 bool rtw89_assign_entity_chan(struct rtw89_dev *rtwdev,
82 			      enum rtw89_chanctx_idx idx,
83 			      const struct rtw89_chan *new);
84 int rtw89_iterate_entity_chan(struct rtw89_dev *rtwdev,
85 			      int (*iterator)(const struct rtw89_chan *chan,
86 					      void *data),
87 			      void *data);
88 void rtw89_config_entity_chandef(struct rtw89_dev *rtwdev,
89 				 enum rtw89_chanctx_idx idx,
90 				 const struct cfg80211_chan_def *chandef);
91 void rtw89_config_roc_chandef(struct rtw89_dev *rtwdev,
92 			      enum rtw89_chanctx_idx idx,
93 			      const struct cfg80211_chan_def *chandef);
94 void rtw89_entity_init(struct rtw89_dev *rtwdev);
95 enum rtw89_entity_mode rtw89_entity_recalc(struct rtw89_dev *rtwdev);
96 void rtw89_chanctx_work(struct work_struct *work);
97 void rtw89_queue_chanctx_work(struct rtw89_dev *rtwdev);
98 void rtw89_queue_chanctx_change(struct rtw89_dev *rtwdev,
99 				enum rtw89_chanctx_changes change);
100 void rtw89_chanctx_track(struct rtw89_dev *rtwdev);
101 void rtw89_chanctx_pause(struct rtw89_dev *rtwdev,
102 			 enum rtw89_chanctx_pause_reasons rsn);
103 void rtw89_chanctx_proceed(struct rtw89_dev *rtwdev);
104 
105 const struct rtw89_chan *__rtw89_mgnt_chan_get(struct rtw89_dev *rtwdev,
106 					       const char *caller_message,
107 					       u8 link_index);
108 
109 #define rtw89_mgnt_chan_get(rtwdev, link_index) \
110 	__rtw89_mgnt_chan_get(rtwdev, __func__, link_index)
111 
112 int rtw89_chanctx_ops_add(struct rtw89_dev *rtwdev,
113 			  struct ieee80211_chanctx_conf *ctx);
114 void rtw89_chanctx_ops_remove(struct rtw89_dev *rtwdev,
115 			      struct ieee80211_chanctx_conf *ctx);
116 void rtw89_chanctx_ops_change(struct rtw89_dev *rtwdev,
117 			      struct ieee80211_chanctx_conf *ctx,
118 			      u32 changed);
119 int rtw89_chanctx_ops_assign_vif(struct rtw89_dev *rtwdev,
120 				 struct rtw89_vif_link *rtwvif_link,
121 				 struct ieee80211_chanctx_conf *ctx);
122 void rtw89_chanctx_ops_unassign_vif(struct rtw89_dev *rtwdev,
123 				    struct rtw89_vif_link *rtwvif_link,
124 				    struct ieee80211_chanctx_conf *ctx);
125 
126 #endif
127