2 * Fundamental types and constants relating to FILS AUTHENTICATION
3 * Copyright (C) 1999-2019, Broadcom.
5 * Unless you and Broadcom execute a separate written software license
6 * agreement governing use of this software, this software is licensed to you
7 * under the terms of the GNU General Public License version 2 (the "GPL"),
8 * available at http://www.broadcom.com/licenses/GPLv2.php, with the
9 * following added to such license:
11 * As a special exception, the copyright holders of this software give you
12 * permission to link this software with independent modules, and to copy and
13 * distribute the resulting executable under terms of your choice, provided that
14 * you also meet, for each linked independent module, the terms and conditions of
15 * the license of that module. An independent module is a module which is not
16 * derived from this software. The special exception does not apply to any
17 * modifications of the software.
19 * Notwithstanding the above, under no circumstances may you combine this
20 * software in any way with any other Broadcom software provided under a license
21 * other than the GPL, without Broadcom's express prior written consent.
24 * <<Broadcom-WL-IPTag/Open:>>
32 /* This marks the start of a packed structure section. */
33 #include <packed_section_start.h>
35 /* 11ai D6.0 8.6.8.36 FILS Discovery frame format
38 fils_discovery_info_field_t
40 fils_indication_element_t
41 fils_vendor_specific_element_t
44 /* 11revmc D4.0 8.4.2.25 Vendor Specific element */
45 typedef BWL_PRE_PACKED_STRUCT
struct fils_vendor_specific_element
{
48 /* variable len info */
49 uint8 orgid_vendorspecific_content
[];
50 } BWL_POST_PACKED_STRUCT fils_vendor_specific_element_t
;
52 #define FILS_VS_ELEM_HDR_LEN (sizeof(fils_vendor_specific_element_t))
54 /* 11ai D6.0 8.4.2.178 FILS Indication element */
55 typedef BWL_PRE_PACKED_STRUCT
struct fils_indication_element
{
59 /* variable len info */
60 uint8 cache_domain_publickey_id
[];
61 } BWL_POST_PACKED_STRUCT fils_indication_element_t
;
63 #define FILS_INDICATION_ELEM_HDR_LEN (sizeof(fils_indication_element_t))
65 #define FILS_INDICATION_IE_TAG_FIXED_LEN 2
67 #define FI_INFO_CACHE_IND_SUBFIELD_SIZE 2
69 /* FILS Indication Information field */
70 #define FI_INFO_PUB_KEY_IDENTS_MASK (0x0007)
71 #define FI_INFO_REALM_IDENTS_MASK (0x0038)
72 #define FI_INFO_IP_ADDR_CFG_MASK (0x0040)
73 #define FI_INFO_CACHE_IDENT_MASK (0x0080)
74 #define FI_INFO_HESSID_MASK (0x0100)
75 #define FI_INFO_SHRKEY_AUTH_WOPFS_MASK (0x0200)
76 #define FI_INFO_SHRKEY_AUTH_WPFS_MASK (0x0400)
77 #define FI_INFO_PUBKEY_AUTH_MASK (0x0800)
79 #define FI_INFO_CACHE_IDENT(fc) ((fc & FI_INFO_CACHE_IDENT_MASK))
80 #define FI_INFO_HESSID(fc) ((fc & FI_INFO_HESSID_MASK))
81 #define FI_INFO_SHRKEY_AUTH_WOPFS(fc) ((fc & FI_INFO_SHRKEY_AUTH_WOPFS_MASK))
82 #define FI_INFO_SHRKEY_AUTH_WPFS(fc) ((fc & FI_INFO_SHRKEY_AUTH_WPFS_MASK))
84 /* 11ai D11.0 9.4.2.171.1 TBTT Information field */
85 typedef BWL_PRE_PACKED_STRUCT
struct tbtt_info_field
{
87 uint8 bssid
[ETHER_ADDR_LEN
];
89 } BWL_POST_PACKED_STRUCT tbtt_info_field_t
;
91 #define TBTT_INFO_FIELD_HDR_LEN (sizeof(tbtt_info_field_t))
93 /* 11ai D11.0 9.4.2.171.1 Neighbor AP Information field */
94 typedef BWL_PRE_PACKED_STRUCT
struct neighbor_ap_info_field
{
95 uint16 tbtt_info_header
;
98 /* variable len info */
99 uint8 tbtt_info_field
[];
100 } BWL_POST_PACKED_STRUCT neighbor_ap_info_field_t
;
102 #define NEIGHBOR_AP_INFO_FIELD_HDR_LEN (sizeof(neighbor_ap_info_field_t))
104 /* 11ai D11.0 9.4.2.171 Reduced Neighbor Report element */
105 typedef BWL_PRE_PACKED_STRUCT
struct fils_rnr_element
{
108 /* variable len info */
109 uint8 neighbor_ap_info
[];
110 } BWL_POST_PACKED_STRUCT fils_rnr_element_t
;
112 #define FILS_RNR_ELEM_HDR_LEN (sizeof(fils_rnr_element_t))
114 /* TBTT Info Header macros */
115 #define TBTT_INFO_HDR_FIELD_TYPE_MASK (0x001f)
116 #define TBTT_INFO_HDR_FN_AP_MASK (0x0004)
117 #define TBTT_INFO_HDR_COUNT_MASK (0x00f0)
118 #define TBTT_INFO_HDR_LENGTH_MASK (0xff00)
120 #define TBTT_INFO_HDR_FIELD_TYPE(hdr)\
121 ((hdr) & TBTT_INFO_HDR_FIELD_TYPE_MASK)
122 #define TBTT_INFO_HDR_FN_AP(hdr)\
123 (((hdr) & TBTT_INFO_HDR_FN_AP_MASK) >> 2)
124 #define TBTT_INFO_HDR_COUNT(hdr)\
125 (((hdr) & TBTT_INFO_HDR_COUNT_MASK) >> 4)
126 #define TBTT_INFO_HDR_LENGTH(hdr)\
127 (((hdr) & TBTT_INFO_HDR_LENGTH_MASK) >> 8)
129 /* FILS Nonce element */
130 #define FILS_NONCE_LENGTH 16u
132 typedef BWL_PRE_PACKED_STRUCT
struct fils_nonce_element
{
135 uint8 element_id_ext
;
136 uint8 fils_nonce
[FILS_NONCE_LENGTH
];
137 } BWL_POST_PACKED_STRUCT fils_nonce_element_t
;
139 /* 8.4.2.175 FILS Session element */
140 #define FILS_SESSION_LENGTH 8u
142 typedef BWL_PRE_PACKED_STRUCT
struct fils_session_element
{
145 uint8 element_id_ext
;
146 uint8 fils_session
[FILS_SESSION_LENGTH
];
147 } BWL_POST_PACKED_STRUCT fils_session_element_t
;
149 /* 9.4.2.179 FILS key confirmation element */
150 #define FILS_KEY_CONFIRMATION_HEADER_LEN 3u
152 typedef BWL_PRE_PACKED_STRUCT
struct fils_key_conf_element
{
155 uint8 element_id_ext
;
156 /* variable len info */
158 } BWL_POST_PACKED_STRUCT fils_key_conf_element_t
;
160 #define FILS_SESSION_ELEM_LEN (sizeof(fils_session_element_t))
162 /* 8.4.2.174 FILS Key Confirmation element */
163 typedef BWL_PRE_PACKED_STRUCT
struct fils_key_confirm_element
{
166 uint8 element_id_ext
;
167 /* variable len info */
169 } BWL_POST_PACKED_STRUCT fils_key_confirm_element_t
;
171 #define FILS_CONFIRM_ELEM_HDR_LEN (sizeof(fils_key_confirm_element_t))
173 /* 11ai D6.0 8.6.8.36 FILS Discovery frame format */
174 typedef BWL_PRE_PACKED_STRUCT
struct fils_discovery_info_field
{
178 /* variable len info */
180 } BWL_POST_PACKED_STRUCT fils_discovery_info_field_t
;
182 #define FD_INFO_FIELD_HDR_LEN (sizeof(fils_discovery_info_field_t))
184 #define FD_INFO_CAP_SUBFIELD_SIZE 2
185 #define FD_INFO_LENGTH_FIELD_SIZE 2
187 /* FILS Discovery Information field */
188 #define FD_INFO_SSID_LENGTH_MASK (0x001f)
189 #define FD_INFO_CAP_IND_MASK (0x0020)
190 #define FD_INFO_SHORT_SSID_IND_MASK (0x0040)
191 #define FD_INFO_APCSN_IND_MASK (0x0080)
192 #define FD_INFO_ANO_IND_MASK (0x0100)
193 #define FD_INFO_CH_CENTER_FR_IND_MASK (0x0200)
194 #define FD_INFO_PRIMARY_CH_IND_MASK (0x0400)
195 #define FD_INFO_RSN_IND_MASK (0x0800)
196 #define FD_INFO_LENGTH_IND_MASK (0x1000)
197 #define FD_INFO_MD_IND_MASK (0x2000)
199 #define FD_INFO_SET_SSID_LENGTH(fc, len) (fc |= ((uint16)(len) & FD_INFO_SSID_LENGTH_MASK))
200 #define FD_INFO_SET_CAP_PRESENT(fc) (fc |= FD_INFO_CAP_IND_MASK)
201 #define FD_INFO_SET_SHORT_SSID_PRESENT(fc) (fc |= FD_INFO_SHORT_SSID_IND_MASK)
202 #define FD_INFO_SET_APCSN_PRESENT(fc) ((fc |= FD_INFO_APCSN_IND_MASK)
203 #define FD_INFO_SET_ANO_PRESENT(fc) (fc |= FD_INFO_ANO_IND_MASK)
204 #define FD_INFO_SET_CH_CENTER_FR_PRESENT(fc) (fc |= FD_INFO_CH_CENTER_FR_IND_MASK)
205 #define FD_INFO_SET_PRIMARY_CH_PRESENT(fc) (fc |= FD_INFO_PRIMARY_CH_IND_MASK)
206 #define FD_INFO_SET_RSN_PRESENT(fc) (fc |= FD_INFO_RSN_IND_MASK)
207 #define FD_INFO_SET_LENGTH_PRESENT(fc) (fc |= FD_INFO_LENGTH_IND_MASK)
208 #define FD_INFO_SET_MD_PRESENT(fc) (fc |= FD_INFO_MD_IND_MASK)
210 #define FD_INFO_SSID_LENGTH(fc) ((fc & FD_INFO_SSID_LENGTH_MASK))
211 #define FD_INFO_IS_CAP_PRESENT(fc) ((fc & FD_INFO_CAP_IND_MASK) >> 5)
212 #define FD_INFO_IS_SHORT_SSID_PRESENT(fc) ((fc & FD_INFO_SHORT_SSID_IND_MASK) >> 6)
213 #define FD_INFO_IS_APCSN_PRESENT(fc) ((fc & FD_INFO_APCSN_IND_MASK) >> 7)
214 #define FD_INFO_IS_ANO_PRESENT(fc) ((fc & FD_INFO_ANO_IND_MASK) >> 8)
215 #define FD_INFO_IS_CH_CENTER_FR_PRESENT(fc) ((fc & FD_INFO_CH_CENTER_FR_IND_MASK) >> 9)
216 #define FD_INFO_IS_PRIMARY_CH_PRESENT(fc) ((fc & FD_INFO_PRIMARY_CH_IND_MASK) >> 10)
217 #define FD_INFO_IS_RSN_PRESENT(fc) ((fc & FD_INFO_RSN_IND_MASK) >> 11)
218 #define FD_INFO_IS_LENGTH_PRESENT(fc) ((fc & FD_INFO_LENGTH_IND_MASK) >> 12)
219 #define FD_INFO_IS_MD_PRESENT(fc) ((fc & FD_INFO_MD_IND_MASK) >> 13)
221 /* FILS Discovery Capability subfield */
222 #define FD_CAP_ESS_MASK (0x0001)
223 #define FD_CAP_PRIVACY_MASK (0x0002)
224 #define FD_CAP_BSS_CH_WIDTH_MASK (0x001c)
225 #define FD_CAP_MAX_NSS_MASK (0x00e0)
226 #define FD_CAP_MULTI_BSS_MASK (0x0200)
227 #define FD_CAP_PHY_INDEX_MASK (0x1c00)
228 #define FD_CAP_FILS_MIN_RATE_MASK (0xe000)
230 #define FD_CAP_ESS(cap) ((cap & FD_CAP_ESS_MASK))
231 #define FD_CAP_PRIVACY(cap) ((cap & FD_CAP_PRIVACY_MASK) >> 1)
232 #define FD_CAP_BSS_CH_WIDTH(cap) ((cap & FD_CAP_BSS_CH_WIDTH_MASK) >> 2)
233 #define FD_CAP_MAX_NSS(cap) ((cap & FD_CAP_MAX_NSS_MASK) >> 5)
234 #define FD_CAP_MULTI_BSS(cap) ((cap & FD_CAP_MULTI_BSS_MASK) >> 9)
235 #define FD_CAP_PHY_INDEX(cap) ((cap & FD_CAP_PHY_INDEX_MASK) >> 10)
236 #define FD_CAP_FILS_MIN_RATE(cap) ((cap & FD_CAP_FILS_MIN_RATE_MASK) >> 13)
238 #define FD_CAP_SET_ESS(cap) ((cap |= FD_CAP_ESS_MASK))
239 #define FD_CAP_SET_PRIVACY(cap) ((cap & FD_CAP_PRIVACY_MASK) >> 1)
240 #define FD_CAP_SET_BSS_CH_WIDTH(cap) ((cap & FD_CAP_BSS_CH_WIDTH_MASK) >> 2)
241 #define FD_CAP_SET_MAX_NSS(cap) ((cap & FD_CAP_MAX_NSS_MASK) >> 5)
242 #define FD_CAP_SET_MULTI_BSS(cap) ((cap & FD_CAP_MULTI_BSS_MASK) >> 9)
243 #define FD_CAP_SET_PHY_INDEX(cap) ((cap & FD_CAP_PHY_INDEX_MASK) >> 10)
244 #define FD_CAP_SET_FILS_MIN_RATE(cap) ((cap & FD_CAP_FILS_MIN_RATE_MASK) >> 13)
246 /* 11ai D6.0 8.4.2.173 FILS Request Parameters element */
247 typedef BWL_PRE_PACKED_STRUCT
struct fils_request_parameters_element
{
250 uint8 element_id_ext
;
252 /* variable len info */
253 uint8 params_fields
[];
254 } BWL_POST_PACKED_STRUCT fils_request_parameters_element_t
;
256 #define FILS_PARAM_MAX_CHANNEL_TIME (1 << 2)
258 /* 11ai 9.4.2.184 FILS HLP Container element */
259 typedef BWL_PRE_PACKED_STRUCT
struct fils_hlp_container_element
{
262 uint8 element_id_ext
;
263 uint8 dest_addr
[ETHER_ADDR_LEN
];
264 uint8 src_addr
[ETHER_ADDR_LEN
];
265 /* variable len hlp packet */
267 } BWL_POST_PACKED_STRUCT fils_hlp_container_element_t
;
269 /* 11ai 9.4.2.184 FILS Wrapped Data element */
270 typedef BWL_PRE_PACKED_STRUCT
struct fils_wrapped_data_element
{
273 uint8 element_id_ext
;
274 /* variable len wrapped data packet */
275 uint8 wrapped_data
[];
276 } BWL_POST_PACKED_STRUCT fils_wrapped_data_element_t
;
278 #define FILS_HLP_CONTAINER_ELEM_LEN (sizeof(fils_hlp_container_element_t))
280 /* This marks the end of a packed structure section. */
281 #include <packed_section_end.h>
283 #endif /* __FILSAUTH_H__ */