[deliverable/linux.git] / drivers / net / wireless / brcm80211 / brcmfmac / dhd.h

/*
 * Copyright (c) 2010 Broadcom Corporation
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
 * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

/****************
 * Common types *
 */

#ifndef _BRCMF_H_
#define _BRCMF_H_

#include "fweh.h"

#define TOE_TX_CSUM_OL		0x00000001
#define TOE_RX_CSUM_OL		0x00000002

/* For supporting multiple interfaces */
#define BRCMF_MAX_IFS	16

#define DOT11_MAX_DEFAULT_KEYS	4

/* Small, medium and maximum buffer size for dcmd
 */
#define BRCMF_DCMD_SMLEN	256
#define BRCMF_DCMD_MEDLEN	1536
#define BRCMF_DCMD_MAXLEN	8192

/* IOCTL from host to device are limited in lenght. A device can only handle
 * ethernet frame size. This limitation is to be applied by protocol layer.
 */
#define BRCMF_TX_IOCTL_MAX_MSG_SIZE	(ETH_FRAME_LEN+ETH_FCS_LEN)

#define BRCMF_AMPDU_RX_REORDER_MAXFLOWS		256

/* Length of firmware version string stored for
 * ethtool driver info which uses 32 bytes as well.
 */
#define BRCMF_DRIVER_FIRMWARE_VERSION_LEN	32

/* Bus independent dongle command */
struct brcmf_dcmd {
	uint cmd;		/* common dongle cmd definition */
	void *buf;		/* pointer to user buffer */
	uint len;		/* length of user buffer */
	u8 set;			/* get or set request (optional) */
	uint used;		/* bytes read or written (optional) */
	uint needed;		/* bytes needed (optional) */
};

/**
 * struct brcmf_ampdu_rx_reorder - AMPDU receive reorder info
 *
 * @pktslots: dynamic allocated array for ordering AMPDU packets.
 * @flow_id: AMPDU flow identifier.
 * @cur_idx: last AMPDU index from firmware.
 * @exp_idx: expected next AMPDU index.
 * @max_idx: maximum amount of packets per AMPDU.
 * @pend_pkts: number of packets currently in @pktslots.
 */
struct brcmf_ampdu_rx_reorder {
	struct sk_buff **pktslots;
	u8 flow_id;
	u8 cur_idx;
	u8 exp_idx;
	u8 max_idx;
	u8 pend_pkts;
};

/* Forward decls for struct brcmf_pub (see below) */
struct brcmf_proto;	/* device communication protocol info */
struct brcmf_cfg80211_dev; /* cfg80211 device info */
struct brcmf_fws_info; /* firmware signalling info */

/* Common structure for module and instance linkage */
struct brcmf_pub {
	/* Linkage ponters */
	struct brcmf_bus *bus_if;
	struct brcmf_proto *proto;
	struct brcmf_cfg80211_info *config;

	/* Internal brcmf items */
	uint hdrlen;		/* Total BRCMF header length (proto + bus) */
	uint rxsz;		/* Rx buffer size bus module should use */
	u8 wme_dp;		/* wme discard priority */

	/* Dongle media info */
	char fwver[BRCMF_DRIVER_FIRMWARE_VERSION_LEN];
	u8 mac[ETH_ALEN];		/* MAC address obtained from dongle */

	/* Multicast data packets sent to dongle */
	unsigned long tx_multicast;

	struct brcmf_if *iflist[BRCMF_MAX_IFS];

	struct mutex proto_block;
	unsigned char proto_buf[BRCMF_DCMD_MAXLEN];

	struct brcmf_fweh_info fweh;

	struct brcmf_fws_info *fws;

	struct brcmf_ampdu_rx_reorder
		*reorder_flows[BRCMF_AMPDU_RX_REORDER_MAXFLOWS];
#ifdef DEBUG
	struct dentry *dbgfs_dir;
#endif
};

/* forward declarations */
struct brcmf_cfg80211_vif;
struct brcmf_fws_mac_descriptor;

/**
 * enum brcmf_netif_stop_reason - reason for stopping netif queue.
 *
 * @BRCMF_NETIF_STOP_REASON_FWS_FC:
 *	netif stopped due to firmware signalling flow control.
 * @BRCMF_NETIF_STOP_REASON_BLOCK_BUS:
 *	netif stopped due to bus blocking.
 */
enum brcmf_netif_stop_reason {
	BRCMF_NETIF_STOP_REASON_FWS_FC = 1,
	BRCMF_NETIF_STOP_REASON_BLOCK_BUS = 2
};

/**
 * struct brcmf_if - interface control information.
 *
 * @drvr: points to device related information.
 * @vif: points to cfg80211 specific interface information.
 * @ndev: associated network device.
 * @stats: interface specific network statistics.
 * @setmacaddr_work: worker object for setting mac address.
 * @multicast_work: worker object for multicast provisioning.
 * @fws_desc: interface specific firmware-signalling descriptor.
 * @ifidx: interface index in device firmware.
 * @bssidx: index of bss associated with this interface.
 * @mac_addr: assigned mac address.
 * @netif_stop: bitmap indicates reason why netif queues are stopped.
 * @netif_stop_lock: spinlock for update netif_stop from multiple sources.
 * @pend_8021x_cnt: tracks outstanding number of 802.1x frames.
 * @pend_8021x_wait: used for signalling change in count.
 */
struct brcmf_if {
	struct brcmf_pub *drvr;
	struct brcmf_cfg80211_vif *vif;
	struct net_device *ndev;
	struct net_device_stats stats;
	struct work_struct setmacaddr_work;
	struct work_struct multicast_work;
	struct brcmf_fws_mac_descriptor *fws_desc;
	int ifidx;
	s32 bssidx;
	u8 mac_addr[ETH_ALEN];
	u8 netif_stop;
	spinlock_t netif_stop_lock;
	atomic_t pend_8021x_cnt;
	wait_queue_head_t pend_8021x_wait;
};

struct brcmf_skb_reorder_data {
	u8 *reorder;
};

int brcmf_netdev_wait_pend8021x(struct net_device *ndev);

/* Return pointer to interface name */
char *brcmf_ifname(struct brcmf_pub *drvr, int idx);

int brcmf_net_attach(struct brcmf_if *ifp, bool rtnl_locked);
struct brcmf_if *brcmf_add_if(struct brcmf_pub *drvr, s32 bssidx, s32 ifidx,
			      char *name, u8 *mac_addr);
void brcmf_del_if(struct brcmf_pub *drvr, s32 bssidx);
void brcmf_txflowblock_if(struct brcmf_if *ifp,
			  enum brcmf_netif_stop_reason reason, bool state);
u32 brcmf_get_chip_info(struct brcmf_if *ifp);
void brcmf_txfinalize(struct brcmf_pub *drvr, struct sk_buff *txp, u8 ifidx,
		      bool success);

/* Sets dongle media info (drv_version, mac address). */
int brcmf_c_preinit_dcmds(struct brcmf_if *ifp);

#endif				/* _BRCMF_H_ */
Commit	Line	Data
5b435de0 AS	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 _BRCMF_H_
	22	#define _BRCMF_H_
	23
5c36b99a AS	24	#include "fweh.h"
5c36b99a AS	25
5b435de0 AS	26	#define TOE_TX_CSUM_OL 0x00000001
	27	#define TOE_RX_CSUM_OL 0x00000002
	28
5b435de0 AS	29	/* For supporting multiple interfaces */
5b435de0 AS	30	#define BRCMF_MAX_IFS 16
5b435de0	31
5b435de0 AS	32	#define DOT11_MAX_DEFAULT_KEYS 4
5b435de0 AS	33
81f5dcb8 HM	34	/* Small, medium and maximum buffer size for dcmd
	35	*/
	36	#define BRCMF_DCMD_SMLEN 256
	37	#define BRCMF_DCMD_MEDLEN 1536
	38	#define BRCMF_DCMD_MAXLEN 8192
	39
d4533992 HM	40	/* IOCTL from host to device are limited in lenght. A device can only handle
	41	* ethernet frame size. This limitation is to be applied by protocol layer.
	42	*/
	43	#define BRCMF_TX_IOCTL_MAX_MSG_SIZE (ETH_FRAME_LEN+ETH_FCS_LEN)
	44
87edd891 AS	45	#define BRCMF_AMPDU_RX_REORDER_MAXFLOWS 256
87edd891 AS	46
55685b8f AS	47	/* Length of firmware version string stored for
	48	* ethtool driver info which uses 32 bytes as well.
	49	*/
	50	#define BRCMF_DRIVER_FIRMWARE_VERSION_LEN 32
	51
5b435de0 AS	52	/* Bus independent dongle command */
	53	struct brcmf_dcmd {
	54	uint cmd; /* common dongle cmd definition */
	55	void buf; / pointer to user buffer */
	56	uint len; /* length of user buffer */
	57	u8 set; /* get or set request (optional) */
	58	uint used; /* bytes read or written (optional) */
	59	uint needed; /* bytes needed (optional) */
	60	};
	61
87edd891 AS	62	/**
	63	* struct brcmf_ampdu_rx_reorder - AMPDU receive reorder info
	64	*
	65	* @pktslots: dynamic allocated array for ordering AMPDU packets.
	66	* @flow_id: AMPDU flow identifier.
	67	* @cur_idx: last AMPDU index from firmware.
	68	* @exp_idx: expected next AMPDU index.
	69	* @max_idx: maximum amount of packets per AMPDU.
	70	* @pend_pkts: number of packets currently in @pktslots.
	71	*/
	72	struct brcmf_ampdu_rx_reorder {
	73	struct sk_buff **pktslots;
	74	u8 flow_id;
	75	u8 cur_idx;
	76	u8 exp_idx;
	77	u8 max_idx;
	78	u8 pend_pkts;
	79	};
	80
5b435de0	81	/* Forward decls for struct brcmf_pub (see below) */
5b435de0	82	struct brcmf_proto; /* device communication protocol info */
5b435de0	83	struct brcmf_cfg80211_dev; /* cfg80211 device info */
349e7104	84	struct brcmf_fws_info; /* firmware signalling info */
5b435de0 AS	85
	86	/* Common structure for module and instance linkage */
	87	struct brcmf_pub {
	88	/* Linkage ponters */
8d169aa0	89	struct brcmf_bus *bus_if;
85b84133	90	struct brcmf_proto *proto;
27a68fe3	91	struct brcmf_cfg80211_info *config;
5b435de0 AS	92
5b435de0 AS	93	/* Internal brcmf items */
5b435de0	94	uint hdrlen; /* Total BRCMF header length (proto + bus) */
5b435de0 AS	95	uint rxsz; /* Rx buffer size bus module should use */
	96	u8 wme_dp; /* wme discard priority */
	97
	98	/* Dongle media info */
55685b8f	99	char fwver[BRCMF_DRIVER_FIRMWARE_VERSION_LEN];
5b435de0	100	u8 mac[ETH_ALEN]; /* MAC address obtained from dongle */
5b435de0	101
5b435de0 AS	102	/* Multicast data packets sent to dongle */
5b435de0 AS	103	unsigned long tx_multicast;
5b435de0	104
d08b6a37 FL	105	struct brcmf_if *iflist[BRCMF_MAX_IFS];
	106
	107	struct mutex proto_block;
81f5dcb8	108	unsigned char proto_buf[BRCMF_DCMD_MAXLEN];
d08b6a37	109
5c36b99a	110	struct brcmf_fweh_info fweh;
349e7104	111
349e7104	112	struct brcmf_fws_info *fws;
87edd891 AS	113
	114	struct brcmf_ampdu_rx_reorder
	115	*reorder_flows[BRCMF_AMPDU_RX_REORDER_MAXFLOWS];
d319a7cf AS	116	#ifdef DEBUG
	117	struct dentry *dbgfs_dir;
	118	#endif
5b435de0 AS	119	};
5b435de0 AS	120
bb8c8063	121	/* forward declarations */
3eacf866	122	struct brcmf_cfg80211_vif;
bb8c8063	123	struct brcmf_fws_mac_descriptor;
3eacf866	124
29e04ae3 AS	125	/**
	126	* enum brcmf_netif_stop_reason - reason for stopping netif queue.
	127	*
	128	* @BRCMF_NETIF_STOP_REASON_FWS_FC:
	129	* netif stopped due to firmware signalling flow control.
	130	* @BRCMF_NETIF_STOP_REASON_BLOCK_BUS:
	131	* netif stopped due to bus blocking.
	132	*/
	133	enum brcmf_netif_stop_reason {
	134	BRCMF_NETIF_STOP_REASON_FWS_FC = 1,
	135	BRCMF_NETIF_STOP_REASON_BLOCK_BUS = 2
	136	};
	137
1d4fd8d7 AS	138	/**
	139	* struct brcmf_if - interface control information.
	140	*
	141	* @drvr: points to device related information.
3eacf866	142	* @vif: points to cfg80211 specific interface information.
1d4fd8d7 AS	143	* @ndev: associated network device.
1d4fd8d7 AS	144	* @stats: interface specific network statistics.
bb8c8063 AS	145	* @setmacaddr_work: worker object for setting mac address.
	146	* @multicast_work: worker object for multicast provisioning.
	147	* @fws_desc: interface specific firmware-signalling descriptor.
2880b868	148	* @ifidx: interface index in device firmware.
1d4fd8d7 AS	149	* @bssidx: index of bss associated with this interface.
1d4fd8d7 AS	150	* @mac_addr: assigned mac address.
29e04ae3	151	* @netif_stop: bitmap indicates reason why netif queues are stopped.
df50f756	152	* @netif_stop_lock: spinlock for update netif_stop from multiple sources.
10ef7321 HM	153	* @pend_8021x_cnt: tracks outstanding number of 802.1x frames.
10ef7321 HM	154	* @pend_8021x_wait: used for signalling change in count.
1d4fd8d7 AS	155	*/
	156	struct brcmf_if {
	157	struct brcmf_pub *drvr;
3eacf866	158	struct brcmf_cfg80211_vif *vif;
1d4fd8d7 AS	159	struct net_device *ndev;
1d4fd8d7 AS	160	struct net_device_stats stats;
bdf5ff51 AS	161	struct work_struct setmacaddr_work;
bdf5ff51 AS	162	struct work_struct multicast_work;
bb8c8063	163	struct brcmf_fws_mac_descriptor *fws_desc;
2880b868	164	int ifidx;
1d4fd8d7 AS	165	s32 bssidx;
1d4fd8d7 AS	166	u8 mac_addr[ETH_ALEN];
29e04ae3	167	u8 netif_stop;
df50f756	168	spinlock_t netif_stop_lock;
10ef7321 HM	169	atomic_t pend_8021x_cnt;
10ef7321 HM	170	wait_queue_head_t pend_8021x_wait;
5b435de0 AS	171	};
5b435de0 AS	172
87edd891 AS	173	struct brcmf_skb_reorder_data {
	174	u8 *reorder;
	175	};
1d4fd8d7	176
9bd91f3c	177	int brcmf_netdev_wait_pend8021x(struct net_device *ndev);
5b435de0	178
5b435de0	179	/* Return pointer to interface name */
9bd91f3c	180	char brcmf_ifname(struct brcmf_pub drvr, int idx);
5b435de0	181
9bd91f3c JP	182	int brcmf_net_attach(struct brcmf_if *ifp, bool rtnl_locked);
	183	struct brcmf_if brcmf_add_if(struct brcmf_pub drvr, s32 bssidx, s32 ifidx,
	184	char name, u8 mac_addr);
	185	void brcmf_del_if(struct brcmf_pub *drvr, s32 bssidx);
29e04ae3 AS	186	void brcmf_txflowblock_if(struct brcmf_if *ifp,
29e04ae3 AS	187	enum brcmf_netif_stop_reason reason, bool state);
9bd91f3c	188	u32 brcmf_get_chip_info(struct brcmf_if *ifp);
53e30ea4	189	void brcmf_txfinalize(struct brcmf_pub drvr, struct sk_buff txp, u8 ifidx,
9bd91f3c	190	bool success);
5b435de0	191
f931868d HM	192	/* Sets dongle media info (drv_version, mac address). */
	193	int brcmf_c_preinit_dcmds(struct brcmf_if *ifp);
	194
5b435de0	195	#endif /* _BRCMF_H_ */