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_chanctx_cb_parm {
42 int (*cb)(struct rtw89_dev *rtwdev, void *data);
43 void *data;
44 const char *caller;
45 };
46
47 struct rtw89_entity_weight {
48 unsigned int active_chanctxs;
49 unsigned int active_roles;
50 };
51
rtw89_get_entity_state(struct rtw89_dev * rtwdev,enum rtw89_phy_idx phy_idx)52 static inline bool rtw89_get_entity_state(struct rtw89_dev *rtwdev,
53 enum rtw89_phy_idx phy_idx)
54 {
55 struct rtw89_hal *hal = &rtwdev->hal;
56
57 return READ_ONCE(hal->entity_active[phy_idx]);
58 }
59
rtw89_set_entity_state(struct rtw89_dev * rtwdev,enum rtw89_phy_idx phy_idx,bool active)60 static inline void rtw89_set_entity_state(struct rtw89_dev *rtwdev,
61 enum rtw89_phy_idx phy_idx,
62 bool active)
63 {
64 struct rtw89_hal *hal = &rtwdev->hal;
65
66 WRITE_ONCE(hal->entity_active[phy_idx], active);
67 }
68
69 static inline
rtw89_get_entity_mode(struct rtw89_dev * rtwdev)70 enum rtw89_entity_mode rtw89_get_entity_mode(struct rtw89_dev *rtwdev)
71 {
72 struct rtw89_hal *hal = &rtwdev->hal;
73
74 return READ_ONCE(hal->entity_mode);
75 }
76
rtw89_set_entity_mode(struct rtw89_dev * rtwdev,enum rtw89_entity_mode mode)77 static inline void rtw89_set_entity_mode(struct rtw89_dev *rtwdev,
78 enum rtw89_entity_mode mode)
79 {
80 struct rtw89_hal *hal = &rtwdev->hal;
81
82 WRITE_ONCE(hal->entity_mode, mode);
83 }
84
85 void rtw89_chan_create(struct rtw89_chan *chan, u8 center_chan, u8 primary_chan,
86 enum rtw89_band band, enum rtw89_bandwidth bandwidth);
87 bool rtw89_assign_entity_chan(struct rtw89_dev *rtwdev,
88 enum rtw89_chanctx_idx idx,
89 const struct rtw89_chan *new);
90 int rtw89_iterate_entity_chan(struct rtw89_dev *rtwdev,
91 int (*iterator)(const struct rtw89_chan *chan,
92 void *data),
93 void *data);
94 void rtw89_config_entity_chandef(struct rtw89_dev *rtwdev,
95 enum rtw89_chanctx_idx idx,
96 const struct cfg80211_chan_def *chandef);
97 void rtw89_config_roc_chandef(struct rtw89_dev *rtwdev,
98 enum rtw89_chanctx_idx idx,
99 const struct cfg80211_chan_def *chandef);
100 void rtw89_entity_init(struct rtw89_dev *rtwdev);
101 enum rtw89_entity_mode rtw89_entity_recalc(struct rtw89_dev *rtwdev);
102 void rtw89_chanctx_work(struct work_struct *work);
103 void rtw89_queue_chanctx_work(struct rtw89_dev *rtwdev);
104 void rtw89_queue_chanctx_change(struct rtw89_dev *rtwdev,
105 enum rtw89_chanctx_changes change);
106 void rtw89_chanctx_track(struct rtw89_dev *rtwdev);
107 void rtw89_chanctx_pause(struct rtw89_dev *rtwdev,
108 enum rtw89_chanctx_pause_reasons rsn);
109 void rtw89_chanctx_proceed(struct rtw89_dev *rtwdev,
110 const struct rtw89_chanctx_cb_parm *cb_parm);
111
112 const struct rtw89_chan *__rtw89_mgnt_chan_get(struct rtw89_dev *rtwdev,
113 const char *caller_message,
114 u8 link_index);
115
116 #define rtw89_mgnt_chan_get(rtwdev, link_index) \
117 __rtw89_mgnt_chan_get(rtwdev, __func__, link_index)
118
119 int rtw89_chanctx_ops_add(struct rtw89_dev *rtwdev,
120 struct ieee80211_chanctx_conf *ctx);
121 void rtw89_chanctx_ops_remove(struct rtw89_dev *rtwdev,
122 struct ieee80211_chanctx_conf *ctx);
123 void rtw89_chanctx_ops_change(struct rtw89_dev *rtwdev,
124 struct ieee80211_chanctx_conf *ctx,
125 u32 changed);
126 int rtw89_chanctx_ops_assign_vif(struct rtw89_dev *rtwdev,
127 struct rtw89_vif_link *rtwvif_link,
128 struct ieee80211_chanctx_conf *ctx);
129 void rtw89_chanctx_ops_unassign_vif(struct rtw89_dev *rtwdev,
130 struct rtw89_vif_link *rtwvif_link,
131 struct ieee80211_chanctx_conf *ctx);
132
133 #endif
134