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.
21 #ifndef BRCMFMAC_CORE_H
22 #define BRCMFMAC_CORE_H
24 #include <net/cfg80211.h>
27 #define TOE_TX_CSUM_OL 0x00000001
28 #define TOE_RX_CSUM_OL 0x00000002
30 /* For supporting multiple interfaces */
31 #define BRCMF_MAX_IFS 16
33 /* Small, medium and maximum buffer size for dcmd
35 #define BRCMF_DCMD_SMLEN 256
36 #define BRCMF_DCMD_MEDLEN 1536
37 #define BRCMF_DCMD_MAXLEN 8192
39 /* IOCTL from host to device are limited in lenght. A device can only handle
40 * ethernet frame size. This limitation is to be applied by protocol layer.
42 #define BRCMF_TX_IOCTL_MAX_MSG_SIZE (ETH_FRAME_LEN+ETH_FCS_LEN)
44 #define BRCMF_AMPDU_RX_REORDER_MAXFLOWS 256
46 /* Length of firmware version string stored for
47 * ethtool driver info which uses 32 bytes as well.
49 #define BRCMF_DRIVER_FIRMWARE_VERSION_LEN 32
52 * struct brcmf_ampdu_rx_reorder - AMPDU receive reorder info
54 * @pktslots: dynamic allocated array for ordering AMPDU packets.
55 * @flow_id: AMPDU flow identifier.
56 * @cur_idx: last AMPDU index from firmware.
57 * @exp_idx: expected next AMPDU index.
58 * @max_idx: maximum amount of packets per AMPDU.
59 * @pend_pkts: number of packets currently in @pktslots.
61 struct brcmf_ampdu_rx_reorder {
62 struct sk_buff **pktslots;
70 /* Forward decls for struct brcmf_pub (see below) */
71 struct brcmf_proto; /* device communication protocol info */
72 struct brcmf_cfg80211_dev; /* cfg80211 device info */
73 struct brcmf_fws_info; /* firmware signalling info */
76 * struct brcmf_rev_info
78 * The result field stores the error code of the
79 * revision info request from firmware. For the
80 * other fields see struct brcmf_rev_info_le in
83 struct brcmf_rev_info {
104 /* Common structure for module and instance linkage */
106 /* Linkage ponters */
107 struct brcmf_bus *bus_if;
108 struct brcmf_proto *proto;
109 struct brcmf_cfg80211_info *config;
111 /* Internal brcmf items */
112 uint hdrlen; /* Total BRCMF header length (proto + bus) */
113 uint rxsz; /* Rx buffer size bus module should use */
115 /* Dongle media info */
116 char fwver[BRCMF_DRIVER_FIRMWARE_VERSION_LEN];
117 u8 mac[ETH_ALEN]; /* MAC address obtained from dongle */
119 /* Multicast data packets sent to dongle */
120 unsigned long tx_multicast;
122 struct mac_address addresses[BRCMF_MAX_IFS];
124 struct brcmf_if *iflist[BRCMF_MAX_IFS];
125 s32 if2bss[BRCMF_MAX_IFS];
127 struct mutex proto_block;
128 unsigned char proto_buf[BRCMF_DCMD_MAXLEN];
130 struct brcmf_fweh_info fweh;
132 struct brcmf_fws_info *fws;
134 struct brcmf_ampdu_rx_reorder
135 *reorder_flows[BRCMF_AMPDU_RX_REORDER_MAXFLOWS];
140 struct brcmf_rev_info revinfo;
142 struct dentry *dbgfs_dir;
146 /* forward declarations */
147 struct brcmf_cfg80211_vif;
148 struct brcmf_fws_mac_descriptor;
151 * enum brcmf_netif_stop_reason - reason for stopping netif queue.
153 * @BRCMF_NETIF_STOP_REASON_FWS_FC:
154 * netif stopped due to firmware signalling flow control.
155 * @BRCMF_NETIF_STOP_REASON_FLOW:
156 * netif stopped due to flowring full.
158 enum brcmf_netif_stop_reason {
159 BRCMF_NETIF_STOP_REASON_FWS_FC = 1,
160 BRCMF_NETIF_STOP_REASON_FLOW = 2
164 * struct brcmf_if - interface control information.
166 * @drvr: points to device related information.
167 * @vif: points to cfg80211 specific interface information.
168 * @ndev: associated network device.
169 * @stats: interface specific network statistics.
170 * @setmacaddr_work: worker object for setting mac address.
171 * @multicast_work: worker object for multicast provisioning.
172 * @fws_desc: interface specific firmware-signalling descriptor.
173 * @ifidx: interface index in device firmware.
174 * @bssidx: index of bss associated with this interface.
175 * @mac_addr: assigned mac address.
176 * @netif_stop: bitmap indicates reason why netif queues are stopped.
177 * @netif_stop_lock: spinlock for update netif_stop from multiple sources.
178 * @pend_8021x_cnt: tracks outstanding number of 802.1x frames.
179 * @pend_8021x_wait: used for signalling change in count.
182 struct brcmf_pub *drvr;
183 struct brcmf_cfg80211_vif *vif;
184 struct net_device *ndev;
185 struct net_device_stats stats;
186 struct work_struct setmacaddr_work;
187 struct work_struct multicast_work;
188 struct brcmf_fws_mac_descriptor *fws_desc;
191 u8 mac_addr[ETH_ALEN];
193 spinlock_t netif_stop_lock;
194 atomic_t pend_8021x_cnt;
195 wait_queue_head_t pend_8021x_wait;
198 struct brcmf_skb_reorder_data {
202 int brcmf_netdev_wait_pend8021x(struct brcmf_if *ifp);
204 /* Return pointer to interface name */
205 char *brcmf_ifname(struct brcmf_pub *drvr, int idx);
206 struct brcmf_if *brcmf_get_ifp(struct brcmf_pub *drvr, int ifidx);
207 int brcmf_net_attach(struct brcmf_if *ifp, bool rtnl_locked);
208 struct brcmf_if *brcmf_add_if(struct brcmf_pub *drvr, s32 bssidx, s32 ifidx,
209 bool is_p2pdev, char *name, u8 *mac_addr);
210 void brcmf_remove_interface(struct brcmf_if *ifp);
211 int brcmf_get_next_free_bsscfgidx(struct brcmf_pub *drvr);
212 void brcmf_txflowblock_if(struct brcmf_if *ifp,
213 enum brcmf_netif_stop_reason reason, bool state);
214 void brcmf_txfinalize(struct brcmf_if *ifp, struct sk_buff *txp, bool success);
215 void brcmf_netif_rx(struct brcmf_if *ifp, struct sk_buff *skb);
217 /* Sets dongle media info (drv_version, mac address). */
218 int brcmf_c_preinit_dcmds(struct brcmf_if *ifp);
220 #endif /* BRCMFMAC_CORE_H */