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_GET_CHANNEL 29
43 #define BRCMF_C_SET_CHANNEL 30
44 #define BRCMF_C_GET_SRL 31
45 #define BRCMF_C_SET_SRL 32
46 #define BRCMF_C_GET_LRL 33
47 #define BRCMF_C_SET_LRL 34
48 #define BRCMF_C_GET_RADIO 37
49 #define BRCMF_C_SET_RADIO 38
50 #define BRCMF_C_GET_PHYTYPE 39
51 #define BRCMF_C_SET_KEY 45
52 #define BRCMF_C_SET_PASSIVE_SCAN 49
53 #define BRCMF_C_SCAN 50
54 #define BRCMF_C_SCAN_RESULTS 51
55 #define BRCMF_C_DISASSOC 52
56 #define BRCMF_C_REASSOC 53
57 #define BRCMF_C_SET_ROAM_TRIGGER 55
58 #define BRCMF_C_SET_ROAM_DELTA 57
59 #define BRCMF_C_GET_BCNPRD 75
60 #define BRCMF_C_SET_BCNPRD 76
61 #define BRCMF_C_GET_DTIMPRD 77
62 #define BRCMF_C_SET_DTIMPRD 78
63 #define BRCMF_C_SET_COUNTRY 84
64 #define BRCMF_C_GET_PM 85
65 #define BRCMF_C_SET_PM 86
66 #define BRCMF_C_GET_CURR_RATESET 114
67 #define BRCMF_C_GET_AP 117
68 #define BRCMF_C_SET_AP 118
69 #define BRCMF_C_GET_RSSI 127
70 #define BRCMF_C_GET_WSEC 133
71 #define BRCMF_C_SET_WSEC 134
72 #define BRCMF_C_GET_PHY_NOISE 135
73 #define BRCMF_C_GET_BSS_INFO 136
74 #define BRCMF_C_GET_PHYLIST 180
75 #define BRCMF_C_SET_SCAN_CHANNEL_TIME 185
76 #define BRCMF_C_SET_SCAN_UNASSOC_TIME 187
77 #define BRCMF_C_SCB_DEAUTHENTICATE_FOR_REASON 201
78 #define BRCMF_C_GET_VALID_CHANNELS 217
79 #define BRCMF_C_GET_KEY_PRIMARY 235
80 #define BRCMF_C_SET_KEY_PRIMARY 236
81 #define BRCMF_C_SET_SCAN_PASSIVE_TIME 258
82 #define BRCMF_C_GET_VAR 262
83 #define BRCMF_C_SET_VAR 263
85 /* phy types (returned by WLC_GET_PHYTPE) */
86 #define WLC_PHY_TYPE_A 0
87 #define WLC_PHY_TYPE_B 1
88 #define WLC_PHY_TYPE_G 2
89 #define WLC_PHY_TYPE_N 4
90 #define WLC_PHY_TYPE_LP 5
91 #define WLC_PHY_TYPE_SSN 6
92 #define WLC_PHY_TYPE_HT 7
93 #define WLC_PHY_TYPE_LCN 8
94 #define WLC_PHY_TYPE_NULL 0xf
96 #define BRCMF_EVENTING_MASK_LEN 16
98 #define TOE_TX_CSUM_OL 0x00000001
99 #define TOE_RX_CSUM_OL 0x00000002
101 #define BRCMF_BSS_INFO_VERSION 109 /* curr ver of brcmf_bss_info_le struct */
103 /* size of brcmf_scan_params not including variable length array */
104 #define BRCMF_SCAN_PARAMS_FIXED_SIZE 64
106 /* masks for channel and ssid count */
107 #define BRCMF_SCAN_PARAMS_COUNT_MASK 0x0000ffff
108 #define BRCMF_SCAN_PARAMS_NSSID_SHIFT 16
110 /* primary (ie tx) key */
111 #define BRCMF_PRIMARY_KEY (1 << 1)
113 /* For supporting multiple interfaces */
114 #define BRCMF_MAX_IFS 16
116 #define DOT11_BSSTYPE_ANY 2
117 #define DOT11_MAX_DEFAULT_KEYS 4
119 #define BRCMF_ESCAN_REQ_VERSION 1
121 #define WLC_BSS_RSSI_ON_CHANNEL 0x0002
123 #define BRCMF_MAXRATES_IN_SET 16 /* max # of rates in rateset */
124 #define BRCMF_STA_ASSOC 0x10 /* Associated */
126 #define BRCMF_E_STATUS_SUCCESS 0
127 #define BRCMF_E_STATUS_FAIL 1
128 #define BRCMF_E_STATUS_TIMEOUT 2
129 #define BRCMF_E_STATUS_NO_NETWORKS 3
130 #define BRCMF_E_STATUS_ABORT 4
131 #define BRCMF_E_STATUS_NO_ACK 5
132 #define BRCMF_E_STATUS_UNSOLICITED 6
133 #define BRCMF_E_STATUS_ATTEMPT 7
134 #define BRCMF_E_STATUS_PARTIAL 8
135 #define BRCMF_E_STATUS_NEWSCAN 9
136 #define BRCMF_E_STATUS_NEWASSOC 10
137 #define BRCMF_E_STATUS_11HQUIET 11
138 #define BRCMF_E_STATUS_SUPPRESS 12
139 #define BRCMF_E_STATUS_NOCHANS 13
140 #define BRCMF_E_STATUS_CS_ABORT 15
141 #define BRCMF_E_STATUS_ERROR 16
143 #define BRCMF_E_REASON_INITIAL_ASSOC 0
144 #define BRCMF_E_REASON_LOW_RSSI 1
145 #define BRCMF_E_REASON_DEAUTH 2
146 #define BRCMF_E_REASON_DISASSOC 3
147 #define BRCMF_E_REASON_BCNS_LOST 4
148 #define BRCMF_E_REASON_MINTXRATE 9
149 #define BRCMF_E_REASON_TXFAIL 10
151 #define BRCMF_E_REASON_FAST_ROAM_FAILED 5
152 #define BRCMF_E_REASON_DIRECTED_ROAM 6
153 #define BRCMF_E_REASON_TSPEC_REJECTED 7
154 #define BRCMF_E_REASON_BETTER_AP 8
156 #define BRCMF_E_PRUNE_ENCR_MISMATCH 1
157 #define BRCMF_E_PRUNE_BCAST_BSSID 2
158 #define BRCMF_E_PRUNE_MAC_DENY 3
159 #define BRCMF_E_PRUNE_MAC_NA 4
160 #define BRCMF_E_PRUNE_REG_PASSV 5
161 #define BRCMF_E_PRUNE_SPCT_MGMT 6
162 #define BRCMF_E_PRUNE_RADAR 7
163 #define BRCMF_E_RSN_MISMATCH 8
164 #define BRCMF_E_PRUNE_NO_COMMON_RATES 9
165 #define BRCMF_E_PRUNE_BASIC_RATES 10
166 #define BRCMF_E_PRUNE_CIPHER_NA 12
167 #define BRCMF_E_PRUNE_KNOWN_STA 13
168 #define BRCMF_E_PRUNE_WDS_PEER 15
169 #define BRCMF_E_PRUNE_QBSS_LOAD 16
170 #define BRCMF_E_PRUNE_HOME_AP 17
172 #define BRCMF_E_SUP_OTHER 0
173 #define BRCMF_E_SUP_DECRYPT_KEY_DATA 1
174 #define BRCMF_E_SUP_BAD_UCAST_WEP128 2
175 #define BRCMF_E_SUP_BAD_UCAST_WEP40 3
176 #define BRCMF_E_SUP_UNSUP_KEY_LEN 4
177 #define BRCMF_E_SUP_PW_KEY_CIPHER 5
178 #define BRCMF_E_SUP_MSG3_TOO_MANY_IE 6
179 #define BRCMF_E_SUP_MSG3_IE_MISMATCH 7
180 #define BRCMF_E_SUP_NO_INSTALL_FLAG 8
181 #define BRCMF_E_SUP_MSG3_NO_GTK 9
182 #define BRCMF_E_SUP_GRP_KEY_CIPHER 10
183 #define BRCMF_E_SUP_GRP_MSG1_NO_GTK 11
184 #define BRCMF_E_SUP_GTK_DECRYPT_FAIL 12
185 #define BRCMF_E_SUP_SEND_FAIL 13
186 #define BRCMF_E_SUP_DEAUTH 14
188 #define BRCMF_E_IF_ADD 1
189 #define BRCMF_E_IF_DEL 2
190 #define BRCMF_E_IF_CHANGE 3
192 #define BRCMF_E_IF_ROLE_STA 0
193 #define BRCMF_E_IF_ROLE_AP 1
194 #define BRCMF_E_IF_ROLE_WDS 2
196 #define BRCMF_E_LINK_BCN_LOSS 1
197 #define BRCMF_E_LINK_DISASSOC 2
198 #define BRCMF_E_LINK_ASSOC_REC 3
199 #define BRCMF_E_LINK_BSSCFG_DIS 4
201 /* Small, medium and maximum buffer size for dcmd
203 #define BRCMF_DCMD_SMLEN 256
204 #define BRCMF_DCMD_MEDLEN 1536
205 #define BRCMF_DCMD_MAXLEN 8192
207 /* Pattern matching filter. Specifies an offset within received packets to
208 * start matching, the pattern to match, the size of the pattern, and a bitmask
209 * that indicates which bits within the pattern should be matched.
211 struct brcmf_pkt_filter_pattern_le {
213 * Offset within received packet to start pattern matching.
214 * Offset '0' is the first byte of the ethernet header.
217 /* Size of the pattern. Bitmask must be the same size.*/
220 * Variable length mask and pattern data. mask starts at offset 0.
221 * Pattern immediately follows mask.
223 u8 mask_and_pattern[1];
226 /* IOVAR "pkt_filter_add" parameter. Used to install packet filters. */
227 struct brcmf_pkt_filter_le {
228 __le32 id; /* Unique filter id, specified by app. */
229 __le32 type; /* Filter type (WL_PKT_FILTER_TYPE_xxx). */
230 __le32 negate_match; /* Negate the result of filter matches */
231 union { /* Filter definitions */
232 struct brcmf_pkt_filter_pattern_le pattern; /* Filter pattern */
236 /* IOVAR "pkt_filter_enable" parameter. */
237 struct brcmf_pkt_filter_enable_le {
238 __le32 id; /* Unique filter id */
239 __le32 enable; /* Enable/disable bool */
242 /* BSS info structure
243 * Applications MUST CHECK ie_offset field and length field to access IEs and
244 * next bss_info structure in a vector (in struct brcmf_scan_results)
246 struct brcmf_bss_info_le {
247 __le32 version; /* version field */
248 __le32 length; /* byte length of data in this record,
249 * starting at version and including IEs
252 __le16 beacon_period; /* units are Kusec */
253 __le16 capability; /* Capability information */
257 __le32 count; /* # rates in this set */
258 u8 rates[16]; /* rates in 500kbps units w/hi bit set if basic */
259 } rateset; /* supported rates */
260 __le16 chanspec; /* chanspec for bss */
261 __le16 atim_window; /* units are Kusec */
262 u8 dtim_period; /* DTIM period */
263 __le16 RSSI; /* receive signal strength (in dBm) */
264 s8 phy_noise; /* noise (in dBm) */
266 u8 n_cap; /* BSS is 802.11N Capable */
267 /* 802.11N BSS Capabilities (based on HT_CAP_*): */
269 u8 ctl_ch; /* 802.11N BSS control channel number */
270 __le32 reserved32[1]; /* Reserved for expansion of BSS properties */
271 u8 flags; /* flags */
272 u8 reserved[3]; /* Reserved for expansion of BSS properties */
273 u8 basic_mcs[MCSSET_LEN]; /* 802.11N BSS required MCS set */
275 __le16 ie_offset; /* offset at which IEs start, from beginning */
276 __le32 ie_length; /* byte length of Information Elements */
277 __le16 SNR; /* average SNR of during frame reception */
278 /* Add new fields here */
279 /* variable length Information Elements */
282 struct brcm_rateset_le {
283 /* # rates in this set */
285 /* rates in 500kbps units w/hi bit set if basic */
286 u8 rates[BRCMF_MAXRATES_IN_SET];
291 unsigned char SSID[32];
294 struct brcmf_ssid_le {
296 unsigned char SSID[32];
299 struct brcmf_scan_params_le {
300 struct brcmf_ssid_le ssid_le; /* default: {0, ""} */
301 u8 bssid[ETH_ALEN]; /* default: bcast */
302 s8 bss_type; /* default: any,
303 * DOT11_BSSTYPE_ANY/INFRASTRUCTURE/INDEPENDENT
305 u8 scan_type; /* flags, 0 use default */
306 __le32 nprobes; /* -1 use default, number of probes per channel */
307 __le32 active_time; /* -1 use default, dwell time per channel for
310 __le32 passive_time; /* -1 use default, dwell time per channel
311 * for passive scanning
313 __le32 home_time; /* -1 use default, dwell time for the
314 * home channel between channel scans
316 __le32 channel_num; /* count of channels and ssids that follow
318 * low half is count of channels in
319 * channel_list, 0 means default (use all
320 * available channels)
322 * high half is entries in struct brcmf_ssid
323 * array that follows channel_list, aligned for
324 * s32 (4 bytes) meaning an odd channel count
325 * implies a 2-byte pad between end of
326 * channel_list and first ssid
328 * if ssid count is zero, single ssid in the
329 * fixed parameter portion is assumed, otherwise
330 * ssid in the fixed portion is ignored
332 __le16 channel_list[1]; /* list of chanspecs */
335 struct brcmf_scan_results {
339 struct brcmf_bss_info_le bss_info_le[];
342 struct brcmf_escan_params_le {
346 struct brcmf_scan_params_le params_le;
349 struct brcmf_escan_result_le {
354 struct brcmf_bss_info_le bss_info_le;
357 #define WL_ESCAN_RESULTS_FIXED_SIZE (sizeof(struct brcmf_escan_result_le) - \
358 sizeof(struct brcmf_bss_info_le))
360 /* used for association with a specific BSSID and chanspec list */
361 struct brcmf_assoc_params_le {
362 /* 00:00:00:00:00:00: broadcast scan */
364 /* 0: all available channels, otherwise count of chanspecs in
367 /* list of chanspecs */
368 __le16 chanspec_list[1];
371 /* used for join with or without a specific bssid and channel list */
372 struct brcmf_join_params {
373 struct brcmf_ssid_le ssid_le;
374 struct brcmf_assoc_params_le params_le;
377 struct brcmf_wsec_key {
378 u32 index; /* key index */
379 u32 len; /* key length */
380 u8 data[WLAN_MAX_KEY_LEN]; /* key data */
382 u32 algo; /* CRYPTO_ALGO_AES_CCM, CRYPTO_ALGO_WEP128, etc */
383 u32 flags; /* misc flags */
385 u32 iv_initialized; /* has IV been initialized already? */
389 u32 hi; /* upper 32 bits of IV */
390 u16 lo; /* lower 16 bits of IV */
393 u8 ea[ETH_ALEN]; /* per station */
397 * dongle requires same struct as above but with fields in little endian order
399 struct brcmf_wsec_key_le {
400 __le32 index; /* key index */
401 __le32 len; /* key length */
402 u8 data[WLAN_MAX_KEY_LEN]; /* key data */
404 __le32 algo; /* CRYPTO_ALGO_AES_CCM, CRYPTO_ALGO_WEP128, etc */
405 __le32 flags; /* misc flags */
407 __le32 iv_initialized; /* has IV been initialized already? */
411 __le32 hi; /* upper 32 bits of IV */
412 __le16 lo; /* lower 16 bits of IV */
415 u8 ea[ETH_ALEN]; /* per station */
418 /* Used to get specific STA parameters */
419 struct brcmf_scb_val_le {
424 /* channel encoding */
425 struct brcmf_channel_info_le {
427 __le32 target_channel;
431 struct brcmf_sta_info_le {
432 __le16 ver; /* version of this struct */
433 __le16 len; /* length in bytes of this structure */
434 __le16 cap; /* sta's advertised capabilities */
435 __le32 flags; /* flags defined below */
436 __le32 idle; /* time since data pkt rx'd from sta */
437 u8 ea[ETH_ALEN]; /* Station address */
438 __le32 count; /* # rates in this set */
439 u8 rates[BRCMF_MAXRATES_IN_SET]; /* rates in 500kbps units */
440 /* w/hi bit set if basic */
441 __le32 in; /* seconds elapsed since associated */
442 __le32 listen_interval_inms; /* Min Listen interval in ms for STA */
443 __le32 tx_pkts; /* # of packets transmitted */
444 __le32 tx_failures; /* # of packets failed */
445 __le32 rx_ucast_pkts; /* # of unicast packets received */
446 __le32 rx_mcast_pkts; /* # of multicast packets received */
447 __le32 tx_rate; /* Rate of last successful tx frame */
448 __le32 rx_rate; /* Rate of last successful rx frame */
449 __le32 rx_decrypt_succeeds; /* # of packet decrypted successfully */
450 __le32 rx_decrypt_failures; /* # of packet decrypted failed */
453 /* Bus independent dongle command */
455 uint cmd; /* common dongle cmd definition */
456 void *buf; /* pointer to user buffer */
457 uint len; /* length of user buffer */
458 u8 set; /* get or set request (optional) */
459 uint used; /* bytes read or written (optional) */
460 uint needed; /* bytes needed (optional) */
463 /* Forward decls for struct brcmf_pub (see below) */
464 struct brcmf_proto; /* device communication protocol info */
465 struct brcmf_cfg80211_dev; /* cfg80211 device info */
467 /* Common structure for module and instance linkage */
469 /* Linkage ponters */
470 struct brcmf_bus *bus_if;
471 struct brcmf_proto *prot;
472 struct brcmf_cfg80211_info *config;
474 /* Internal brcmf items */
475 uint hdrlen; /* Total BRCMF header length (proto + bus) */
476 uint rxsz; /* Rx buffer size bus module should use */
477 u8 wme_dp; /* wme discard priority */
479 /* Dongle media info */
480 unsigned long drv_version; /* Version of dongle-resident driver */
481 u8 mac[ETH_ALEN]; /* MAC address obtained from dongle */
483 /* Additional stats for the bus level */
485 /* Multicast data packets sent to dongle */
486 unsigned long tx_multicast;
487 /* Packets flushed due to unscheduled sendup thread */
488 unsigned long rx_flushed;
489 /* Number of times dpc scheduled by watchdog timer */
490 unsigned long wd_dpc_sched;
492 /* Number of flow control pkts recvd */
493 unsigned long fc_packets;
495 /* Last error return */
498 /* Last error from dongle */
501 /* Suspend disable flag flag */
502 int suspend_disable_flag; /* "1" to disable all extra powersaving
504 int in_suspend; /* flag set to 1 when early suspend called */
505 int dtim_skip; /* dtim skip , default 0 means wake each dtim */
507 struct brcmf_if *iflist[BRCMF_MAX_IFS];
509 struct mutex proto_block;
510 unsigned char proto_buf[BRCMF_DCMD_MAXLEN];
512 u8 macvalue[ETH_ALEN];
513 atomic_t pend_8021x_cnt;
514 wait_queue_head_t pend_8021x_wait;
516 struct brcmf_fweh_info fweh;
518 struct dentry *dbgfs_dir;
522 struct bcmevent_name {
527 struct brcmf_if_event {
534 /* forward declaration */
535 struct brcmf_cfg80211_vif;
538 * struct brcmf_if - interface control information.
540 * @drvr: points to device related information.
541 * @vif: points to cfg80211 specific interface information.
542 * @ndev: associated network device.
543 * @stats: interface specific network statistics.
544 * @idx: interface index in device firmware.
545 * @bssidx: index of bss associated with this interface.
546 * @mac_addr: assigned mac address.
549 struct brcmf_pub *drvr;
550 struct brcmf_cfg80211_vif *vif;
551 struct net_device *ndev;
552 struct net_device_stats stats;
553 struct work_struct setmacaddr_work;
554 struct work_struct multicast_work;
557 u8 mac_addr[ETH_ALEN];
560 static inline s32 brcmf_ndev_bssidx(struct net_device *ndev)
562 struct brcmf_if *ifp = netdev_priv(ndev);
566 extern const struct bcmevent_name bcmevent_names[];
568 extern int brcmf_netdev_wait_pend8021x(struct net_device *ndev);
570 /* Return pointer to interface name */
571 extern char *brcmf_ifname(struct brcmf_pub *drvr, int idx);
574 extern int brcmf_proto_cdc_query_dcmd(struct brcmf_pub *drvr, int ifidx,
575 uint cmd, void *buf, uint len);
576 extern int brcmf_proto_cdc_set_dcmd(struct brcmf_pub *drvr, int ifidx, uint cmd,
577 void *buf, uint len);
579 extern int brcmf_net_attach(struct brcmf_if *ifp);
580 extern struct brcmf_if *brcmf_add_if(struct brcmf_pub *drvr, int ifidx,
581 s32 bssidx, char *name, u8 *mac_addr);
582 extern void brcmf_del_if(struct brcmf_pub *drvr, int ifidx);
584 #endif /* _BRCMF_H_ */