drivers/net/wireless/broadcom/brcm80211/brcmfmac/core.h

   1 /*
   2  * Copyright (c) 2010 Broadcom Corporation
   3  *
   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.
   7  *
   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.
  15  */
  16
  17 /****************
  18  * Common types *
  19  */
  20
  21 #ifndef BRCMFMAC_CORE_H
  22 #define BRCMFMAC_CORE_H
  23
  24 #include <net/cfg80211.h>
  25 #include "fweh.h"
  26
  27 #define TOE_TX_CSUM_OL          0x00000001
  28 #define TOE_RX_CSUM_OL          0x00000002
  29
  30 /* For supporting multiple interfaces */
  31 #define BRCMF_MAX_IFS   16
  32
  33 /* Small, medium and maximum buffer size for dcmd
  34  */
  35 #define BRCMF_DCMD_SMLEN        256
  36 #define BRCMF_DCMD_MEDLEN       1536
  37 #define BRCMF_DCMD_MAXLEN       8192
  38
  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.
  41  */
  42 #define BRCMF_TX_IOCTL_MAX_MSG_SIZE     (ETH_FRAME_LEN+ETH_FCS_LEN)
  43
  44 #define BRCMF_AMPDU_RX_REORDER_MAXFLOWS         256
  45
  46 /* Length of firmware version string stored for
  47  * ethtool driver info which uses 32 bytes as well.
  48  */
  49 #define BRCMF_DRIVER_FIRMWARE_VERSION_LEN       32
  50
  51 #define NDOL_MAX_ENTRIES        8
  52
  53 /**
  54  * struct brcmf_ampdu_rx_reorder - AMPDU receive reorder info
  55  *
  56  * @pktslots: dynamic allocated array for ordering AMPDU packets.
  57  * @flow_id: AMPDU flow identifier.
  58  * @cur_idx: last AMPDU index from firmware.
  59  * @exp_idx: expected next AMPDU index.
  60  * @max_idx: maximum amount of packets per AMPDU.
  61  * @pend_pkts: number of packets currently in @pktslots.
  62  */
  63 struct brcmf_ampdu_rx_reorder {
  64         struct sk_buff **pktslots;
  65         u8 flow_id;
  66         u8 cur_idx;
  67         u8 exp_idx;
  68         u8 max_idx;
  69         u8 pend_pkts;
  70 };
  71
  72 /* Forward decls for struct brcmf_pub (see below) */
  73 struct brcmf_proto;     /* device communication protocol info */
  74 struct brcmf_fws_info;  /* firmware signalling info */
  75 struct brcmf_mp_device; /* module paramateres, device specific */
  76
  77 /*
  78  * struct brcmf_rev_info
  79  *
  80  * The result field stores the error code of the
  81  * revision info request from firmware. For the
  82  * other fields see struct brcmf_rev_info_le in
  83  * fwil_types.h
  84  */
  85 struct brcmf_rev_info {
  86         int result;
  87         u32 vendorid;
  88         u32 deviceid;
  89         u32 radiorev;
  90         u32 chiprev;
  91         u32 corerev;
  92         u32 boardid;
  93         u32 boardvendor;
  94         u32 boardrev;
  95         u32 driverrev;
  96         u32 ucoderev;
  97         u32 bus;
  98         u32 chipnum;
  99         u32 phytype;
 100         u32 phyrev;
 101         u32 anarev;
 102         u32 chippkg;
 103         u32 nvramrev;
 104 };
 105
 106 /* Common structure for module and instance linkage */
 107 struct brcmf_pub {
 108         /* Linkage ponters */
 109         struct brcmf_bus *bus_if;
 110         struct brcmf_proto *proto;
 111         struct brcmf_cfg80211_info *config;
 112
 113         /* Internal brcmf items */
 114         uint hdrlen;            /* Total BRCMF header length (proto + bus) */
 115         uint rxsz;              /* Rx buffer size bus module should use */
 116
 117         /* Dongle media info */
 118         char fwver[BRCMF_DRIVER_FIRMWARE_VERSION_LEN];
 119         u8 mac[ETH_ALEN];               /* MAC address obtained from dongle */
 120
 121         /* Multicast data packets sent to dongle */
 122         unsigned long tx_multicast;
 123
 124         struct mac_address addresses[BRCMF_MAX_IFS];
 125
 126         struct brcmf_if *iflist[BRCMF_MAX_IFS];
 127         s32 if2bss[BRCMF_MAX_IFS];
 128
 129         struct mutex proto_block;
 130         unsigned char proto_buf[BRCMF_DCMD_MAXLEN];
 131
 132         struct brcmf_fweh_info fweh;
 133
 134         struct brcmf_fws_info *fws;
 135
 136         struct brcmf_ampdu_rx_reorder
 137                 *reorder_flows[BRCMF_AMPDU_RX_REORDER_MAXFLOWS];
 138
 139         u32 feat_flags;
 140         u32 chip_quirks;
 141
 142         struct brcmf_rev_info revinfo;
 143 #ifdef DEBUG
 144         struct dentry *dbgfs_dir;
 145 #endif
 146
 147         struct notifier_block inetaddr_notifier;
 148         struct notifier_block inet6addr_notifier;
 149         struct brcmf_mp_device *settings;
 150 };
 151
 152 /* forward declarations */
 153 struct brcmf_cfg80211_vif;
 154 struct brcmf_fws_mac_descriptor;
 155
 156 /**
 157  * enum brcmf_netif_stop_reason - reason for stopping netif queue.
 158  *
 159  * @BRCMF_NETIF_STOP_REASON_FWS_FC:
 160  *      netif stopped due to firmware signalling flow control.
 161  * @BRCMF_NETIF_STOP_REASON_FLOW:
 162  *      netif stopped due to flowring full.
 163  * @BRCMF_NETIF_STOP_REASON_DISCONNECTED:
 164  *      netif stopped due to not being connected (STA mode).
 165  */
 166 enum brcmf_netif_stop_reason {
 167         BRCMF_NETIF_STOP_REASON_FWS_FC = BIT(0),
 168         BRCMF_NETIF_STOP_REASON_FLOW = BIT(1),
 169         BRCMF_NETIF_STOP_REASON_DISCONNECTED = BIT(2)
 170 };
 171
 172 /**
 173  * struct brcmf_if - interface control information.
 174  *
 175  * @drvr: points to device related information.
 176  * @vif: points to cfg80211 specific interface information.
 177  * @ndev: associated network device.
 178  * @stats: interface specific network statistics.
 179  * @setmacaddr_work: worker object for setting mac address.
 180  * @multicast_work: worker object for multicast provisioning.
 181  * @ndoffload_work: worker object for neighbor discovery offload configuration.
 182  * @fws_desc: interface specific firmware-signalling descriptor.
 183  * @ifidx: interface index in device firmware.
 184  * @bsscfgidx: index of bss associated with this interface.
 185  * @mac_addr: assigned mac address.
 186  * @netif_stop: bitmap indicates reason why netif queues are stopped.
 187  * @netif_stop_lock: spinlock for update netif_stop from multiple sources.
 188  * @pend_8021x_cnt: tracks outstanding number of 802.1x frames.
 189  * @pend_8021x_wait: used for signalling change in count.
 190  */
 191 struct brcmf_if {
 192         struct brcmf_pub *drvr;
 193         struct brcmf_cfg80211_vif *vif;
 194         struct net_device *ndev;
 195         struct net_device_stats stats;
 196         struct work_struct setmacaddr_work;
 197         struct work_struct multicast_work;
 198         struct work_struct ndoffload_work;
 199         struct brcmf_fws_mac_descriptor *fws_desc;
 200         int ifidx;
 201         s32 bsscfgidx;
 202         u8 mac_addr[ETH_ALEN];
 203         u8 netif_stop;
 204         spinlock_t netif_stop_lock;
 205         atomic_t pend_8021x_cnt;
 206         wait_queue_head_t pend_8021x_wait;
 207         struct in6_addr ipv6_addr_tbl[NDOL_MAX_ENTRIES];
 208         u8 ipv6addr_idx;
 209 };
 210
 211 struct brcmf_skb_reorder_data {
 212         u8 *reorder;
 213 };
 214
 215 int brcmf_netdev_wait_pend8021x(struct brcmf_if *ifp);
 216
 217 /* Return pointer to interface name */
 218 char *brcmf_ifname(struct brcmf_if *ifp);
 219 struct brcmf_if *brcmf_get_ifp(struct brcmf_pub *drvr, int ifidx);
 220 int brcmf_net_attach(struct brcmf_if *ifp, bool rtnl_locked);
 221 struct brcmf_if *brcmf_add_if(struct brcmf_pub *drvr, s32 bsscfgidx, s32 ifidx,
 222                               bool is_p2pdev, char *name, u8 *mac_addr);
 223 void brcmf_remove_interface(struct brcmf_if *ifp);
 224 int brcmf_get_next_free_bsscfgidx(struct brcmf_pub *drvr);
 225 void brcmf_txflowblock_if(struct brcmf_if *ifp,
 226                           enum brcmf_netif_stop_reason reason, bool state);
 227 void brcmf_txfinalize(struct brcmf_if *ifp, struct sk_buff *txp, bool success);
 228 void brcmf_netif_rx(struct brcmf_if *ifp, struct sk_buff *skb);
 229 void brcmf_net_setcarrier(struct brcmf_if *ifp, bool on);
 230 int __init brcmf_core_init(void);
 231 void __exit brcmf_core_exit(void);
 232
 233 #endif /* BRCMFMAC_CORE_H */