2 * Copyright (c) 2010 Broadcom Corporation
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
11 * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
13 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
14 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
24 #define BRCMF_VERSION_STR "4.218.248.5"
28 /*******************************************************************************
29 * IO codes that are interpreted by dongle firmware
30 ******************************************************************************/
32 #define BRCMF_C_DOWN 3
33 #define BRCMF_C_SET_PROMISC 10
34 #define BRCMF_C_GET_RATE 12
35 #define BRCMF_C_GET_INFRA 19
36 #define BRCMF_C_SET_INFRA 20
37 #define BRCMF_C_GET_AUTH 21
38 #define BRCMF_C_SET_AUTH 22
39 #define BRCMF_C_GET_BSSID 23
40 #define BRCMF_C_GET_SSID 25
41 #define BRCMF_C_SET_SSID 26
42 #define BRCMF_C_TERMINATED 28
43 #define BRCMF_C_GET_CHANNEL 29
44 #define BRCMF_C_SET_CHANNEL 30
45 #define BRCMF_C_GET_SRL 31
46 #define BRCMF_C_SET_SRL 32
47 #define BRCMF_C_GET_LRL 33
48 #define BRCMF_C_SET_LRL 34
49 #define BRCMF_C_GET_RADIO 37
50 #define BRCMF_C_SET_RADIO 38
51 #define BRCMF_C_GET_PHYTYPE 39
52 #define BRCMF_C_SET_KEY 45
53 #define BRCMF_C_SET_PASSIVE_SCAN 49
54 #define BRCMF_C_SCAN 50
55 #define BRCMF_C_SCAN_RESULTS 51
56 #define BRCMF_C_DISASSOC 52
57 #define BRCMF_C_REASSOC 53
58 #define BRCMF_C_SET_ROAM_TRIGGER 55
59 #define BRCMF_C_SET_ROAM_DELTA 57
60 #define BRCMF_C_GET_BCNPRD 75
61 #define BRCMF_C_SET_BCNPRD 76
62 #define BRCMF_C_GET_DTIMPRD 77
63 #define BRCMF_C_SET_DTIMPRD 78
64 #define BRCMF_C_SET_COUNTRY 84
65 #define BRCMF_C_GET_PM 85
66 #define BRCMF_C_SET_PM 86
67 #define BRCMF_C_GET_CURR_RATESET 114
68 #define BRCMF_C_GET_AP 117
69 #define BRCMF_C_SET_AP 118
70 #define BRCMF_C_GET_RSSI 127
71 #define BRCMF_C_GET_WSEC 133
72 #define BRCMF_C_SET_WSEC 134
73 #define BRCMF_C_GET_PHY_NOISE 135
74 #define BRCMF_C_GET_BSS_INFO 136
75 #define BRCMF_C_SET_SCB_TIMEOUT 158
76 #define BRCMF_C_GET_PHYLIST 180
77 #define BRCMF_C_SET_SCAN_CHANNEL_TIME 185
78 #define BRCMF_C_SET_SCAN_UNASSOC_TIME 187
79 #define BRCMF_C_SCB_DEAUTHENTICATE_FOR_REASON 201
80 #define BRCMF_C_GET_VALID_CHANNELS 217
81 #define BRCMF_C_GET_KEY_PRIMARY 235
82 #define BRCMF_C_SET_KEY_PRIMARY 236
83 #define BRCMF_C_SET_SCAN_PASSIVE_TIME 258
84 #define BRCMF_C_GET_VAR 262
85 #define BRCMF_C_SET_VAR 263
87 /* phy types (returned by WLC_GET_PHYTPE) */
88 #define WLC_PHY_TYPE_A 0
89 #define WLC_PHY_TYPE_B 1
90 #define WLC_PHY_TYPE_G 2
91 #define WLC_PHY_TYPE_N 4
92 #define WLC_PHY_TYPE_LP 5
93 #define WLC_PHY_TYPE_SSN 6
94 #define WLC_PHY_TYPE_HT 7
95 #define WLC_PHY_TYPE_LCN 8
96 #define WLC_PHY_TYPE_NULL 0xf
98 #define BRCMF_EVENTING_MASK_LEN 16
100 #define TOE_TX_CSUM_OL 0x00000001
101 #define TOE_RX_CSUM_OL 0x00000002
103 #define BRCMF_BSS_INFO_VERSION 109 /* curr ver of brcmf_bss_info_le struct */
105 /* size of brcmf_scan_params not including variable length array */
106 #define BRCMF_SCAN_PARAMS_FIXED_SIZE 64
108 /* masks for channel and ssid count */
109 #define BRCMF_SCAN_PARAMS_COUNT_MASK 0x0000ffff
110 #define BRCMF_SCAN_PARAMS_NSSID_SHIFT 16
112 /* primary (ie tx) key */
113 #define BRCMF_PRIMARY_KEY (1 << 1)
115 /* For supporting multiple interfaces */
116 #define BRCMF_MAX_IFS 16
118 #define DOT11_BSSTYPE_ANY 2
119 #define DOT11_MAX_DEFAULT_KEYS 4
121 #define BRCMF_ESCAN_REQ_VERSION 1
123 #define WLC_BSS_RSSI_ON_CHANNEL 0x0002
125 #define BRCMF_MAXRATES_IN_SET 16 /* max # of rates in rateset */
126 #define BRCMF_STA_ASSOC 0x10 /* Associated */
128 #define BRCMF_E_STATUS_SUCCESS 0
129 #define BRCMF_E_STATUS_FAIL 1
130 #define BRCMF_E_STATUS_TIMEOUT 2
131 #define BRCMF_E_STATUS_NO_NETWORKS 3
132 #define BRCMF_E_STATUS_ABORT 4
133 #define BRCMF_E_STATUS_NO_ACK 5
134 #define BRCMF_E_STATUS_UNSOLICITED 6
135 #define BRCMF_E_STATUS_ATTEMPT 7
136 #define BRCMF_E_STATUS_PARTIAL 8
137 #define BRCMF_E_STATUS_NEWSCAN 9
138 #define BRCMF_E_STATUS_NEWASSOC 10
139 #define BRCMF_E_STATUS_11HQUIET 11
140 #define BRCMF_E_STATUS_SUPPRESS 12
141 #define BRCMF_E_STATUS_NOCHANS 13
142 #define BRCMF_E_STATUS_CS_ABORT 15
143 #define BRCMF_E_STATUS_ERROR 16
145 #define BRCMF_E_REASON_INITIAL_ASSOC 0
146 #define BRCMF_E_REASON_LOW_RSSI 1
147 #define BRCMF_E_REASON_DEAUTH 2
148 #define BRCMF_E_REASON_DISASSOC 3
149 #define BRCMF_E_REASON_BCNS_LOST 4
150 #define BRCMF_E_REASON_MINTXRATE 9
151 #define BRCMF_E_REASON_TXFAIL 10
153 #define BRCMF_E_REASON_LINK_BSSCFG_DIS 4
154 #define BRCMF_E_REASON_FAST_ROAM_FAILED 5
155 #define BRCMF_E_REASON_DIRECTED_ROAM 6
156 #define BRCMF_E_REASON_TSPEC_REJECTED 7
157 #define BRCMF_E_REASON_BETTER_AP 8
159 #define BRCMF_E_PRUNE_ENCR_MISMATCH 1
160 #define BRCMF_E_PRUNE_BCAST_BSSID 2
161 #define BRCMF_E_PRUNE_MAC_DENY 3
162 #define BRCMF_E_PRUNE_MAC_NA 4
163 #define BRCMF_E_PRUNE_REG_PASSV 5
164 #define BRCMF_E_PRUNE_SPCT_MGMT 6
165 #define BRCMF_E_PRUNE_RADAR 7
166 #define BRCMF_E_RSN_MISMATCH 8
167 #define BRCMF_E_PRUNE_NO_COMMON_RATES 9
168 #define BRCMF_E_PRUNE_BASIC_RATES 10
169 #define BRCMF_E_PRUNE_CIPHER_NA 12
170 #define BRCMF_E_PRUNE_KNOWN_STA 13
171 #define BRCMF_E_PRUNE_WDS_PEER 15
172 #define BRCMF_E_PRUNE_QBSS_LOAD 16
173 #define BRCMF_E_PRUNE_HOME_AP 17
175 #define BRCMF_E_SUP_OTHER 0
176 #define BRCMF_E_SUP_DECRYPT_KEY_DATA 1
177 #define BRCMF_E_SUP_BAD_UCAST_WEP128 2
178 #define BRCMF_E_SUP_BAD_UCAST_WEP40 3
179 #define BRCMF_E_SUP_UNSUP_KEY_LEN 4
180 #define BRCMF_E_SUP_PW_KEY_CIPHER 5
181 #define BRCMF_E_SUP_MSG3_TOO_MANY_IE 6
182 #define BRCMF_E_SUP_MSG3_IE_MISMATCH 7
183 #define BRCMF_E_SUP_NO_INSTALL_FLAG 8
184 #define BRCMF_E_SUP_MSG3_NO_GTK 9
185 #define BRCMF_E_SUP_GRP_KEY_CIPHER 10
186 #define BRCMF_E_SUP_GRP_MSG1_NO_GTK 11
187 #define BRCMF_E_SUP_GTK_DECRYPT_FAIL 12
188 #define BRCMF_E_SUP_SEND_FAIL 13
189 #define BRCMF_E_SUP_DEAUTH 14
191 #define BRCMF_E_IF_ADD 1
192 #define BRCMF_E_IF_DEL 2
193 #define BRCMF_E_IF_CHANGE 3
195 #define BRCMF_E_IF_ROLE_STA 0
196 #define BRCMF_E_IF_ROLE_AP 1
197 #define BRCMF_E_IF_ROLE_WDS 2
199 #define BRCMF_E_LINK_BCN_LOSS 1
200 #define BRCMF_E_LINK_DISASSOC 2
201 #define BRCMF_E_LINK_ASSOC_REC 3
202 #define BRCMF_E_LINK_BSSCFG_DIS 4
204 /* Small, medium and maximum buffer size for dcmd
206 #define BRCMF_DCMD_SMLEN 256
207 #define BRCMF_DCMD_MEDLEN 1536
208 #define BRCMF_DCMD_MAXLEN 8192
210 /* Pattern matching filter. Specifies an offset within received packets to
211 * start matching, the pattern to match, the size of the pattern, and a bitmask
212 * that indicates which bits within the pattern should be matched.
214 struct brcmf_pkt_filter_pattern_le {
216 * Offset within received packet to start pattern matching.
217 * Offset '0' is the first byte of the ethernet header.
220 /* Size of the pattern. Bitmask must be the same size.*/
223 * Variable length mask and pattern data. mask starts at offset 0.
224 * Pattern immediately follows mask.
226 u8 mask_and_pattern[1];
229 /* IOVAR "pkt_filter_add" parameter. Used to install packet filters. */
230 struct brcmf_pkt_filter_le {
231 __le32 id; /* Unique filter id, specified by app. */
232 __le32 type; /* Filter type (WL_PKT_FILTER_TYPE_xxx). */
233 __le32 negate_match; /* Negate the result of filter matches */
234 union { /* Filter definitions */
235 struct brcmf_pkt_filter_pattern_le pattern; /* Filter pattern */
239 /* IOVAR "pkt_filter_enable" parameter. */
240 struct brcmf_pkt_filter_enable_le {
241 __le32 id; /* Unique filter id */
242 __le32 enable; /* Enable/disable bool */
245 /* BSS info structure
246 * Applications MUST CHECK ie_offset field and length field to access IEs and
247 * next bss_info structure in a vector (in struct brcmf_scan_results)
249 struct brcmf_bss_info_le {
250 __le32 version; /* version field */
251 __le32 length; /* byte length of data in this record,
252 * starting at version and including IEs
255 __le16 beacon_period; /* units are Kusec */
256 __le16 capability; /* Capability information */
260 __le32 count; /* # rates in this set */
261 u8 rates[16]; /* rates in 500kbps units w/hi bit set if basic */
262 } rateset; /* supported rates */
263 __le16 chanspec; /* chanspec for bss */
264 __le16 atim_window; /* units are Kusec */
265 u8 dtim_period; /* DTIM period */
266 __le16 RSSI; /* receive signal strength (in dBm) */
267 s8 phy_noise; /* noise (in dBm) */
269 u8 n_cap; /* BSS is 802.11N Capable */
270 /* 802.11N BSS Capabilities (based on HT_CAP_*): */
272 u8 ctl_ch; /* 802.11N BSS control channel number */
273 __le32 reserved32[1]; /* Reserved for expansion of BSS properties */
274 u8 flags; /* flags */
275 u8 reserved[3]; /* Reserved for expansion of BSS properties */
276 u8 basic_mcs[MCSSET_LEN]; /* 802.11N BSS required MCS set */
278 __le16 ie_offset; /* offset at which IEs start, from beginning */
279 __le32 ie_length; /* byte length of Information Elements */
280 __le16 SNR; /* average SNR of during frame reception */
281 /* Add new fields here */
282 /* variable length Information Elements */
285 struct brcm_rateset_le {
286 /* # rates in this set */
288 /* rates in 500kbps units w/hi bit set if basic */
289 u8 rates[BRCMF_MAXRATES_IN_SET];
294 unsigned char SSID[32];
297 struct brcmf_ssid_le {
299 unsigned char SSID[32];
302 struct brcmf_scan_params_le {
303 struct brcmf_ssid_le ssid_le; /* default: {0, ""} */
304 u8 bssid[ETH_ALEN]; /* default: bcast */
305 s8 bss_type; /* default: any,
306 * DOT11_BSSTYPE_ANY/INFRASTRUCTURE/INDEPENDENT
308 u8 scan_type; /* flags, 0 use default */
309 __le32 nprobes; /* -1 use default, number of probes per channel */
310 __le32 active_time; /* -1 use default, dwell time per channel for
313 __le32 passive_time; /* -1 use default, dwell time per channel
314 * for passive scanning
316 __le32 home_time; /* -1 use default, dwell time for the
317 * home channel between channel scans
319 __le32 channel_num; /* count of channels and ssids that follow
321 * low half is count of channels in
322 * channel_list, 0 means default (use all
323 * available channels)
325 * high half is entries in struct brcmf_ssid
326 * array that follows channel_list, aligned for
327 * s32 (4 bytes) meaning an odd channel count
328 * implies a 2-byte pad between end of
329 * channel_list and first ssid
331 * if ssid count is zero, single ssid in the
332 * fixed parameter portion is assumed, otherwise
333 * ssid in the fixed portion is ignored
335 __le16 channel_list[1]; /* list of chanspecs */
338 struct brcmf_scan_results {
342 struct brcmf_bss_info_le bss_info_le[];
345 struct brcmf_escan_params_le {
349 struct brcmf_scan_params_le params_le;
352 struct brcmf_escan_result_le {
357 struct brcmf_bss_info_le bss_info_le;
360 #define WL_ESCAN_RESULTS_FIXED_SIZE (sizeof(struct brcmf_escan_result_le) - \
361 sizeof(struct brcmf_bss_info_le))
363 /* used for association with a specific BSSID and chanspec list */
364 struct brcmf_assoc_params_le {
365 /* 00:00:00:00:00:00: broadcast scan */
367 /* 0: all available channels, otherwise count of chanspecs in
370 /* list of chanspecs */
371 __le16 chanspec_list[1];
374 /* used for join with or without a specific bssid and channel list */
375 struct brcmf_join_params {
376 struct brcmf_ssid_le ssid_le;
377 struct brcmf_assoc_params_le params_le;
380 /* scan params for extended join */
381 struct brcmf_join_scan_params_le {
382 u8 scan_type; /* 0 use default, active or passive scan */
383 __le32 nprobes; /* -1 use default, nr of probes per channel */
384 __le32 active_time; /* -1 use default, dwell time per channel for
387 __le32 passive_time; /* -1 use default, dwell time per channel
388 * for passive scanning
390 __le32 home_time; /* -1 use default, dwell time for the home
391 * channel between channel scans
395 /* extended join params */
396 struct brcmf_ext_join_params_le {
397 struct brcmf_ssid_le ssid_le; /* {0, ""}: wildcard scan */
398 struct brcmf_join_scan_params_le scan_le;
399 struct brcmf_assoc_params_le assoc_le;
402 struct brcmf_wsec_key {
403 u32 index; /* key index */
404 u32 len; /* key length */
405 u8 data[WLAN_MAX_KEY_LEN]; /* key data */
407 u32 algo; /* CRYPTO_ALGO_AES_CCM, CRYPTO_ALGO_WEP128, etc */
408 u32 flags; /* misc flags */
410 u32 iv_initialized; /* has IV been initialized already? */
414 u32 hi; /* upper 32 bits of IV */
415 u16 lo; /* lower 16 bits of IV */
418 u8 ea[ETH_ALEN]; /* per station */
422 * dongle requires same struct as above but with fields in little endian order
424 struct brcmf_wsec_key_le {
425 __le32 index; /* key index */
426 __le32 len; /* key length */
427 u8 data[WLAN_MAX_KEY_LEN]; /* key data */
429 __le32 algo; /* CRYPTO_ALGO_AES_CCM, CRYPTO_ALGO_WEP128, etc */
430 __le32 flags; /* misc flags */
432 __le32 iv_initialized; /* has IV been initialized already? */
436 __le32 hi; /* upper 32 bits of IV */
437 __le16 lo; /* lower 16 bits of IV */
440 u8 ea[ETH_ALEN]; /* per station */
443 /* Used to get specific STA parameters */
444 struct brcmf_scb_val_le {
449 /* channel encoding */
450 struct brcmf_channel_info_le {
452 __le32 target_channel;
456 struct brcmf_sta_info_le {
457 __le16 ver; /* version of this struct */
458 __le16 len; /* length in bytes of this structure */
459 __le16 cap; /* sta's advertised capabilities */
460 __le32 flags; /* flags defined below */
461 __le32 idle; /* time since data pkt rx'd from sta */
462 u8 ea[ETH_ALEN]; /* Station address */
463 __le32 count; /* # rates in this set */
464 u8 rates[BRCMF_MAXRATES_IN_SET]; /* rates in 500kbps units */
465 /* w/hi bit set if basic */
466 __le32 in; /* seconds elapsed since associated */
467 __le32 listen_interval_inms; /* Min Listen interval in ms for STA */
468 __le32 tx_pkts; /* # of packets transmitted */
469 __le32 tx_failures; /* # of packets failed */
470 __le32 rx_ucast_pkts; /* # of unicast packets received */
471 __le32 rx_mcast_pkts; /* # of multicast packets received */
472 __le32 tx_rate; /* Rate of last successful tx frame */
473 __le32 rx_rate; /* Rate of last successful rx frame */
474 __le32 rx_decrypt_succeeds; /* # of packet decrypted successfully */
475 __le32 rx_decrypt_failures; /* # of packet decrypted failed */
480 * WLC_E_P2P_PROBREQ_MSG
481 * WLC_E_ACTION_FRAME_RX
483 struct brcmf_rx_mgmt_data {
491 /* Bus independent dongle command */
493 uint cmd; /* common dongle cmd definition */
494 void *buf; /* pointer to user buffer */
495 uint len; /* length of user buffer */
496 u8 set; /* get or set request (optional) */
497 uint used; /* bytes read or written (optional) */
498 uint needed; /* bytes needed (optional) */
501 /* Forward decls for struct brcmf_pub (see below) */
502 struct brcmf_proto; /* device communication protocol info */
503 struct brcmf_cfg80211_dev; /* cfg80211 device info */
505 /* Common structure for module and instance linkage */
507 /* Linkage ponters */
508 struct brcmf_bus *bus_if;
509 struct brcmf_proto *prot;
510 struct brcmf_cfg80211_info *config;
512 /* Internal brcmf items */
513 uint hdrlen; /* Total BRCMF header length (proto + bus) */
514 uint rxsz; /* Rx buffer size bus module should use */
515 u8 wme_dp; /* wme discard priority */
517 /* Dongle media info */
518 unsigned long drv_version; /* Version of dongle-resident driver */
519 u8 mac[ETH_ALEN]; /* MAC address obtained from dongle */
521 /* Multicast data packets sent to dongle */
522 unsigned long tx_multicast;
524 struct brcmf_if *iflist[BRCMF_MAX_IFS];
526 struct mutex proto_block;
527 unsigned char proto_buf[BRCMF_DCMD_MAXLEN];
529 struct brcmf_fweh_info fweh;
531 struct dentry *dbgfs_dir;
535 struct brcmf_if_event {
542 /* forward declaration */
543 struct brcmf_cfg80211_vif;
546 * struct brcmf_if - interface control information.
548 * @drvr: points to device related information.
549 * @vif: points to cfg80211 specific interface information.
550 * @ndev: associated network device.
551 * @stats: interface specific network statistics.
552 * @ifidx: interface index in device firmware.
553 * @bssidx: index of bss associated with this interface.
554 * @mac_addr: assigned mac address.
555 * @pend_8021x_cnt: tracks outstanding number of 802.1x frames.
556 * @pend_8021x_wait: used for signalling change in count.
559 struct brcmf_pub *drvr;
560 struct brcmf_cfg80211_vif *vif;
561 struct net_device *ndev;
562 struct net_device_stats stats;
563 struct work_struct setmacaddr_work;
564 struct work_struct multicast_work;
567 u8 mac_addr[ETH_ALEN];
568 atomic_t pend_8021x_cnt;
569 wait_queue_head_t pend_8021x_wait;
573 extern int brcmf_netdev_wait_pend8021x(struct net_device *ndev);
575 /* Return pointer to interface name */
576 extern char *brcmf_ifname(struct brcmf_pub *drvr, int idx);
579 extern int brcmf_proto_cdc_query_dcmd(struct brcmf_pub *drvr, int ifidx,
580 uint cmd, void *buf, uint len);
581 extern int brcmf_proto_cdc_set_dcmd(struct brcmf_pub *drvr, int ifidx, uint cmd,
582 void *buf, uint len);
584 /* Remove any protocol-specific data header. */
585 extern int brcmf_proto_hdrpull(struct brcmf_pub *drvr, u8 *ifidx,
586 struct sk_buff *rxp);
588 extern int brcmf_net_attach(struct brcmf_if *ifp, bool rtnl_locked);
589 extern struct brcmf_if *brcmf_add_if(struct brcmf_pub *drvr, s32 bssidx,
590 s32 ifidx, char *name, u8 *mac_addr);
591 extern void brcmf_del_if(struct brcmf_pub *drvr, s32 bssidx);
592 extern u32 brcmf_get_chip_info(struct brcmf_if *ifp);
594 #endif /* _BRCMF_H_ */