diff options
author | 2025-03-08 22:04:20 +0800 | |
---|---|---|
committer | 2025-03-08 22:04:20 +0800 | |
commit | a07bb8fd1299070229f0e8f3dcb57ffd5ef9870a (patch) | |
tree | 84f21bd0bf7071bc5fc7dd989e77d7ceb5476682 /net/wireless/reg.h | |
download | ohosKernel-a07bb8fd1299070229f0e8f3dcb57ffd5ef9870a.tar.gz ohosKernel-a07bb8fd1299070229f0e8f3dcb57ffd5ef9870a.zip |
Initial commit: OpenHarmony-v4.0-ReleaseOpenHarmony-v4.0-Release
Diffstat (limited to 'net/wireless/reg.h')
-rw-r--r-- | net/wireless/reg.h | 190 |
1 files changed, 190 insertions, 0 deletions
diff --git a/net/wireless/reg.h b/net/wireless/reg.h new file mode 100644 index 000000000..f9e83031a --- /dev/null +++ b/net/wireless/reg.h | |||
@@ -0,0 +1,190 @@ | |||
1 | #ifndef __NET_WIRELESS_REG_H | ||
2 | #define __NET_WIRELESS_REG_H | ||
3 | |||
4 | #include <net/cfg80211.h> | ||
5 | |||
6 | /* | ||
7 | * Copyright 2008-2011 Luis R. Rodriguez <mcgrof@qca.qualcomm.com> | ||
8 | * Copyright (C) 2019 Intel Corporation | ||
9 | * | ||
10 | * Permission to use, copy, modify, and/or distribute this software for any | ||
11 | * purpose with or without fee is hereby granted, provided that the above | ||
12 | * copyright notice and this permission notice appear in all copies. | ||
13 | * | ||
14 | * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | ||
15 | * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | ||
16 | * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | ||
17 | * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | ||
18 | * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | ||
19 | * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | ||
20 | * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | ||
21 | */ | ||
22 | |||
23 | enum ieee80211_regd_source { | ||
24 | REGD_SOURCE_INTERNAL_DB, | ||
25 | REGD_SOURCE_CRDA, | ||
26 | REGD_SOURCE_CACHED, | ||
27 | }; | ||
28 | |||
29 | extern const struct ieee80211_regdomain __rcu *cfg80211_regdomain; | ||
30 | |||
31 | bool reg_is_valid_request(const char *alpha2); | ||
32 | bool is_world_regdom(const char *alpha2); | ||
33 | bool reg_supported_dfs_region(enum nl80211_dfs_regions dfs_region); | ||
34 | enum nl80211_dfs_regions reg_get_dfs_region(struct wiphy *wiphy); | ||
35 | |||
36 | int regulatory_hint_user(const char *alpha2, | ||
37 | enum nl80211_user_reg_hint_type user_reg_hint_type); | ||
38 | |||
39 | /** | ||
40 | * regulatory_hint_indoor - hint operation in indoor env. or not | ||
41 | * @is_indoor: if true indicates that user space thinks that the | ||
42 | * device is operating in an indoor environment. | ||
43 | * @portid: the netlink port ID on which the hint was given. | ||
44 | */ | ||
45 | int regulatory_hint_indoor(bool is_indoor, u32 portid); | ||
46 | |||
47 | /** | ||
48 | * regulatory_netlink_notify - notify on released netlink socket | ||
49 | * @portid: the netlink socket port ID | ||
50 | */ | ||
51 | void regulatory_netlink_notify(u32 portid); | ||
52 | |||
53 | void wiphy_regulatory_register(struct wiphy *wiphy); | ||
54 | void wiphy_regulatory_deregister(struct wiphy *wiphy); | ||
55 | |||
56 | int __init regulatory_init(void); | ||
57 | void regulatory_exit(void); | ||
58 | |||
59 | int set_regdom(const struct ieee80211_regdomain *rd, | ||
60 | enum ieee80211_regd_source regd_src); | ||
61 | |||
62 | unsigned int reg_get_max_bandwidth(const struct ieee80211_regdomain *rd, | ||
63 | const struct ieee80211_reg_rule *rule); | ||
64 | |||
65 | bool reg_last_request_cell_base(void); | ||
66 | const struct ieee80211_regdomain *get_wiphy_regdom(struct wiphy *wiphy); | ||
67 | |||
68 | /** | ||
69 | * regulatory_hint_found_beacon - hints a beacon was found on a channel | ||
70 | * @wiphy: the wireless device where the beacon was found on | ||
71 | * @beacon_chan: the channel on which the beacon was found on | ||
72 | * @gfp: context flags | ||
73 | * | ||
74 | * This informs the wireless core that a beacon from an AP was found on | ||
75 | * the channel provided. This allows the wireless core to make educated | ||
76 | * guesses on regulatory to help with world roaming. This is only used for | ||
77 | * world roaming -- when we do not know our current location. This is | ||
78 | * only useful on channels 12, 13 and 14 on the 2 GHz band as channels | ||
79 | * 1-11 are already enabled by the world regulatory domain; and on | ||
80 | * non-radar 5 GHz channels. | ||
81 | * | ||
82 | * Drivers do not need to call this, cfg80211 will do it for after a scan | ||
83 | * on a newly found BSS. If you cannot make use of this feature you can | ||
84 | * set the wiphy->disable_beacon_hints to true. | ||
85 | */ | ||
86 | int regulatory_hint_found_beacon(struct wiphy *wiphy, | ||
87 | struct ieee80211_channel *beacon_chan, | ||
88 | gfp_t gfp); | ||
89 | |||
90 | /** | ||
91 | * regulatory_hint_country_ie - hints a country IE as a regulatory domain | ||
92 | * @wiphy: the wireless device giving the hint (used only for reporting | ||
93 | * conflicts) | ||
94 | * @band: the band on which the country IE was received on. This determines | ||
95 | * the band we'll process the country IE channel triplets for. | ||
96 | * @country_ie: pointer to the country IE | ||
97 | * @country_ie_len: length of the country IE | ||
98 | * | ||
99 | * We will intersect the rd with the what CRDA tells us should apply | ||
100 | * for the alpha2 this country IE belongs to, this prevents APs from | ||
101 | * sending us incorrect or outdated information against a country. | ||
102 | * | ||
103 | * The AP is expected to provide Country IE channel triplets for the | ||
104 | * band it is on. It is technically possible for APs to send channel | ||
105 | * country IE triplets even for channels outside of the band they are | ||
106 | * in but for that they would have to use the regulatory extension | ||
107 | * in combination with a triplet but this behaviour is currently | ||
108 | * not observed. For this reason if a triplet is seen with channel | ||
109 | * information for a band the BSS is not present in it will be ignored. | ||
110 | */ | ||
111 | void regulatory_hint_country_ie(struct wiphy *wiphy, | ||
112 | enum nl80211_band band, | ||
113 | const u8 *country_ie, | ||
114 | u8 country_ie_len); | ||
115 | |||
116 | /** | ||
117 | * regulatory_hint_disconnect - informs all devices have been disconnected | ||
118 | * | ||
119 | * Regulotory rules can be enhanced further upon scanning and upon | ||
120 | * connection to an AP. These rules become stale if we disconnect | ||
121 | * and go to another country, whether or not we suspend and resume. | ||
122 | * If we suspend, go to another country and resume we'll automatically | ||
123 | * get disconnected shortly after resuming and things will be reset as well. | ||
124 | * This routine is a helper to restore regulatory settings to how they were | ||
125 | * prior to our first connect attempt. This includes ignoring country IE and | ||
126 | * beacon regulatory hints. The ieee80211_regdom module parameter will always | ||
127 | * be respected but if a user had set the regulatory domain that will take | ||
128 | * precedence. | ||
129 | * | ||
130 | * Must be called from process context. | ||
131 | */ | ||
132 | void regulatory_hint_disconnect(void); | ||
133 | |||
134 | /** | ||
135 | * cfg80211_get_unii - get the U-NII band for the frequency | ||
136 | * @freq: the frequency for which we want to get the UNII band. | ||
137 | |||
138 | * Get a value specifying the U-NII band frequency belongs to. | ||
139 | * U-NII bands are defined by the FCC in C.F.R 47 part 15. | ||
140 | * | ||
141 | * Returns -EINVAL if freq is invalid, 0 for UNII-1, 1 for UNII-2A, | ||
142 | * 2 for UNII-2B, 3 for UNII-2C and 4 for UNII-3. | ||
143 | */ | ||
144 | int cfg80211_get_unii(int freq); | ||
145 | |||
146 | /** | ||
147 | * regulatory_indoor_allowed - is indoor operation allowed | ||
148 | */ | ||
149 | bool regulatory_indoor_allowed(void); | ||
150 | |||
151 | /* | ||
152 | * Grace period to timeout pre-CAC results on the dfs channels. This timeout | ||
153 | * value is used for Non-ETSI domain. | ||
154 | * TODO: May be make this timeout available through regdb? | ||
155 | */ | ||
156 | #define REG_PRE_CAC_EXPIRY_GRACE_MS 2000 | ||
157 | |||
158 | /** | ||
159 | * regulatory_propagate_dfs_state - Propagate DFS channel state to other wiphys | ||
160 | * @wiphy - wiphy on which radar is detected and the event will be propagated | ||
161 | * to other available wiphys having the same DFS domain | ||
162 | * @chandef - Channel definition of radar detected channel | ||
163 | * @dfs_state - DFS channel state to be set | ||
164 | * @event - Type of radar event which triggered this DFS state change | ||
165 | * | ||
166 | * This function should be called with rtnl lock held. | ||
167 | */ | ||
168 | void regulatory_propagate_dfs_state(struct wiphy *wiphy, | ||
169 | struct cfg80211_chan_def *chandef, | ||
170 | enum nl80211_dfs_state dfs_state, | ||
171 | enum nl80211_radar_event event); | ||
172 | |||
173 | /** | ||
174 | * reg_dfs_domain_same - Checks if both wiphy have same DFS domain configured | ||
175 | * @wiphy1 - wiphy it's dfs_region to be checked against that of wiphy2 | ||
176 | * @wiphy2 - wiphy it's dfs_region to be checked against that of wiphy1 | ||
177 | */ | ||
178 | bool reg_dfs_domain_same(struct wiphy *wiphy1, struct wiphy *wiphy2); | ||
179 | |||
180 | /** | ||
181 | * reg_reload_regdb - reload the regulatory.db firmware file | ||
182 | */ | ||
183 | int reg_reload_regdb(void); | ||
184 | |||
185 | extern const u8 shipped_regdb_certs[]; | ||
186 | extern unsigned int shipped_regdb_certs_len; | ||
187 | extern const u8 extra_regdb_certs[]; | ||
188 | extern unsigned int extra_regdb_certs_len; | ||
189 | |||
190 | #endif /* __NET_WIRELESS_REG_H */ | ||