[linux-2.6-block.git] / drivers / net / wireless / iwlwifi / iwl-core.h

/******************************************************************************
 *
 * This file is provided under a dual BSD/GPLv2 license.  When using or
 * redistributing this file, you may do so under either license.
 *
 * GPL LICENSE SUMMARY
 *
 * Copyright(c) 2008 Intel Corporation. All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
 * USA
 *
 * The full GNU General Public License is included in this distribution
 * in the file called LICENSE.GPL.
 *
 * Contact Information:
 * Tomas Winkler <tomas.winkler@intel.com>
 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
 *
 * BSD LICENSE
 *
 * Copyright(c) 2005 - 2008 Intel Corporation. All rights reserved.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *  * Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *  * Neither the name Intel Corporation nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *****************************************************************************/

#ifndef __iwl_core_h__
#define __iwl_core_h__

/************************
 * forward declarations *
 ************************/
struct iwl_host_cmd;
struct iwl_cmd;


#define IWLWIFI_VERSION "1.2.26k"
#define DRV_COPYRIGHT	"Copyright(c) 2003-2008 Intel Corporation"

#define IWL_PCI_DEVICE(dev, subdev, cfg) \
	.vendor = PCI_VENDOR_ID_INTEL,  .device = (dev), \
	.subvendor = PCI_ANY_ID, .subdevice = (subdev), \
	.driver_data = (kernel_ulong_t)&(cfg)

#define IWL_SKU_G       0x1
#define IWL_SKU_A       0x2
#define IWL_SKU_N       0x8

struct iwl_hcmd_ops {
	int (*rxon_assoc)(struct iwl_priv *priv);
};
struct iwl_hcmd_utils_ops {
	int (*enqueue_hcmd)(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
#ifdef CONFIG_IWLWIFI_RUN_TIME_CALIB
	void (*gain_computation)(struct iwl_priv *priv,
			u32 *average_noise,
			u16 min_average_noise_antennat_i,
			u32 min_average_noise);
	void (*chain_noise_reset)(struct iwl_priv *priv);
#endif
};

struct iwl_lib_ops {
	/* set hw dependant perameters */
	int (*set_hw_params)(struct iwl_priv *priv);
	/* ucode shared memory */
	int (*alloc_shared_mem)(struct iwl_priv *priv);
	void (*free_shared_mem)(struct iwl_priv *priv);
	void (*txq_update_byte_cnt_tbl)(struct iwl_priv *priv,
					struct iwl4965_tx_queue *txq,
					u16 byte_cnt);
	/* nic init */
	int (*hw_nic_init)(struct iwl_priv *priv);
	/* alive notification */
	int (*alive_notify)(struct iwl_priv *priv);
	/* check validity of rtc data address */
	int (*is_valid_rtc_data_addr)(u32 addr);
	/* 1st ucode load */
	int (*load_ucode)(struct iwl_priv *priv);
	/* rfkill */
	void (*radio_kill_sw)(struct iwl_priv *priv, int disable_radio);
	 /* power management */
	struct {
		int (*init)(struct iwl_priv *priv);
		int (*set_pwr_src)(struct iwl_priv *priv, enum iwl_pwr_src src);
	} apm_ops;
	/* power */
	int (*set_power)(struct iwl_priv *priv, void *cmd);
	void (*update_chain_flags)(struct iwl_priv *priv);
	/* eeprom operations (as defined in iwl-eeprom.h) */
	struct iwl_eeprom_ops eeprom_ops;
};

struct iwl_ops {
	const struct iwl_lib_ops *lib;
	const struct iwl_hcmd_ops *hcmd;
	const struct iwl_hcmd_utils_ops *utils;
};

struct iwl_mod_params {
	int disable;		/* def: 0 = enable radio */
	int sw_crypto;		/* def: 0 = using hardware encryption */
	int debug;		/* def: 0 = minimal debug log messages */
	int disable_hw_scan;	/* def: 0 = use h/w scan */
	int num_of_queues;	/* def: HW dependent */
	int enable_qos;		/* def: 1 = use quality of service */
	int amsdu_size_8K;	/* def: 1 = enable 8K amsdu size */
	int antenna;  		/* def: 0 = both antennas (use diversity) */
};

struct iwl_cfg {
	const char *name;
	const char *fw_name;
	unsigned int sku;
	int eeprom_size;
	const struct iwl_ops *ops;
	const struct iwl_mod_params *mod_params;
};

/***************************
 *   L i b                 *
 ***************************/

struct ieee80211_hw *iwl_alloc_all(struct iwl_cfg *cfg,
		struct ieee80211_ops *hw_ops);
void iwl_hw_detect(struct iwl_priv *priv);

void iwlcore_clear_stations_table(struct iwl_priv *priv);
void iwl_reset_qos(struct iwl_priv *priv);
void iwl_set_rxon_chain(struct iwl_priv *priv);
int iwl_set_rxon_channel(struct iwl_priv *priv,
				enum ieee80211_band band,
				u16 channel);
void iwlcore_free_geos(struct iwl_priv *priv);
int iwl_setup(struct iwl_priv *priv);

/*****************************************************
 *   S e n d i n g     H o s t     C o m m a n d s   *
 *****************************************************/

const char *get_cmd_string(u8 cmd);
int __must_check iwl_send_cmd_sync(struct iwl_priv *priv,
				   struct iwl_host_cmd *cmd);
int iwl_send_cmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
int __must_check iwl_send_cmd_pdu(struct iwl_priv *priv, u8 id,
				  u16 len, const void *data);
int iwl_send_cmd_pdu_async(struct iwl_priv *priv, u8 id, u16 len,
			   const void *data,
			   int (*callback)(struct iwl_priv *priv,
					   struct iwl_cmd *cmd,
					   struct sk_buff *skb));
/*************** DRIVER STATUS FUNCTIONS   *****/

#define STATUS_HCMD_ACTIVE	0	/* host command in progress */
#define STATUS_HCMD_SYNC_ACTIVE	1	/* sync host command in progress */
#define STATUS_INT_ENABLED	2
#define STATUS_RF_KILL_HW	3
#define STATUS_RF_KILL_SW	4
#define STATUS_INIT		5
#define STATUS_ALIVE		6
#define STATUS_READY		7
#define STATUS_TEMPERATURE	8
#define STATUS_GEO_CONFIGURED	9
#define STATUS_EXIT_PENDING	10
#define STATUS_IN_SUSPEND	11
#define STATUS_STATISTICS	12
#define STATUS_SCANNING		13
#define STATUS_SCAN_ABORTING	14
#define STATUS_SCAN_HW		15
#define STATUS_POWER_PMI	16
#define STATUS_FW_ERROR		17
#define STATUS_CONF_PENDING	18


static inline int iwl_is_ready(struct iwl_priv *priv)
{
	/* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
	 * set but EXIT_PENDING is not */
	return test_bit(STATUS_READY, &priv->status) &&
	       test_bit(STATUS_GEO_CONFIGURED, &priv->status) &&
	       !test_bit(STATUS_EXIT_PENDING, &priv->status);
}

static inline int iwl_is_alive(struct iwl_priv *priv)
{
	return test_bit(STATUS_ALIVE, &priv->status);
}

static inline int iwl_is_init(struct iwl_priv *priv)
{
	return test_bit(STATUS_INIT, &priv->status);
}

static inline int iwl_is_rfkill(struct iwl_priv *priv)
{
	return test_bit(STATUS_RF_KILL_HW, &priv->status) ||
	       test_bit(STATUS_RF_KILL_SW, &priv->status);
}

static inline int iwl_is_ready_rf(struct iwl_priv *priv)
{

	if (iwl_is_rfkill(priv))
		return 0;

	return iwl_is_ready(priv);
}


enum iwlcore_card_notify {
	IWLCORE_INIT_EVT = 0,
	IWLCORE_START_EVT = 1,
	IWLCORE_STOP_EVT = 2,
	IWLCORE_REMOVE_EVT = 3,
};

int iwlcore_low_level_notify(struct iwl_priv *priv,
			     enum iwlcore_card_notify notify);
extern int iwl_send_statistics_request(struct iwl_priv *priv, u8 flags);
int iwl_send_lq_cmd(struct iwl_priv *priv,
		    struct iwl_link_quality_cmd *lq, u8 flags);

static inline int iwl_send_rxon_assoc(struct iwl_priv *priv)
{
	return priv->cfg->ops->hcmd->rxon_assoc(priv);
}

#endif /* __iwl_core_h__ */
Commit	Line	Data
82b9a121 TW	1	/******************************************************************************
	2	*
	3	* This file is provided under a dual BSD/GPLv2 license. When using or
	4	* redistributing this file, you may do so under either license.
	5	*
	6	* GPL LICENSE SUMMARY
	7	*
	8	* Copyright(c) 2008 Intel Corporation. All rights reserved.
	9	*
	10	* This program is free software; you can redistribute it and/or modify
	11	* it under the terms of version 2 of the GNU General Public License as
	12	* published by the Free Software Foundation.
	13	*
	14	* This program is distributed in the hope that it will be useful, but
	15	* WITHOUT ANY WARRANTY; without even the implied warranty of
	16	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	17	* General Public License for more details.
	18	*
	19	* You should have received a copy of the GNU General Public License
	20	* along with this program; if not, write to the Free Software
	21	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
	22	* USA
	23	*
	24	* The full GNU General Public License is included in this distribution
	25	* in the file called LICENSE.GPL.
	26	*
	27	* Contact Information:
	28	* Tomas Winkler <tomas.winkler@intel.com>
	29	* Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
	30	*
	31	* BSD LICENSE
	32	*
	33	* Copyright(c) 2005 - 2008 Intel Corporation. All rights reserved.
	34	* All rights reserved.
	35	*
	36	* Redistribution and use in source and binary forms, with or without
	37	* modification, are permitted provided that the following conditions
	38	* are met:
	39	*
	40	* * Redistributions of source code must retain the above copyright
	41	* notice, this list of conditions and the following disclaimer.
	42	* * Redistributions in binary form must reproduce the above copyright
	43	* notice, this list of conditions and the following disclaimer in
	44	* the documentation and/or other materials provided with the
	45	* distribution.
	46	* * Neither the name Intel Corporation nor the names of its
	47	* contributors may be used to endorse or promote products derived
	48	* from this software without specific prior written permission.
	49	*
	50	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	51	* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	52	* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
	53	* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	54	* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	55	* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
	56	* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	57	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	58	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	59	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
	60	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	61	*****************************************************************************/
	62
	63	#ifndef __iwl_core_h__
	64	#define __iwl_core_h__
65
857485c0 TW	66	/************************
	67	* forward declarations *
	68	************************/
	69	struct iwl_host_cmd;
	70	struct iwl_cmd;
	71
	72
df48c323 TW	73	#define IWLWIFI_VERSION "1.2.26k"
	74	#define DRV_COPYRIGHT "Copyright(c) 2003-2008 Intel Corporation"
	75
82b9a121 TW	76	#define IWL_PCI_DEVICE(dev, subdev, cfg) \
	77	.vendor = PCI_VENDOR_ID_INTEL, .device = (dev), \
	78	.subvendor = PCI_ANY_ID, .subdevice = (subdev), \
	79	.driver_data = (kernel_ulong_t)&(cfg)
	80
	81	#define IWL_SKU_G 0x1
	82	#define IWL_SKU_A 0x2
	83	#define IWL_SKU_N 0x8
	84
3c424c28	85	struct iwl_hcmd_ops {
7e8c519e	86	int (rxon_assoc)(struct iwl_priv priv);
3c424c28	87	};
857485c0 TW	88	struct iwl_hcmd_utils_ops {
857485c0 TW	89	int (enqueue_hcmd)(struct iwl_priv priv, struct iwl_host_cmd *cmd);
f0832f13 EG	90	#ifdef CONFIG_IWLWIFI_RUN_TIME_CALIB
	91	void (gain_computation)(struct iwl_priv priv,
	92	u32 *average_noise,
	93	u16 min_average_noise_antennat_i,
	94	u32 min_average_noise);
	95	void (chain_noise_reset)(struct iwl_priv priv);
	96	#endif
857485c0 TW	97	};
857485c0 TW	98
6bc913bd	99	struct iwl_lib_ops {
5425e490 TW	100	/* set hw dependant perameters */
5425e490 TW	101	int (set_hw_params)(struct iwl_priv priv);
399f4900 RR	102	/* ucode shared memory */
	103	int (alloc_shared_mem)(struct iwl_priv priv);
	104	void (free_shared_mem)(struct iwl_priv priv);
e2a722eb TW	105	void (txq_update_byte_cnt_tbl)(struct iwl_priv priv,
	106	struct iwl4965_tx_queue *txq,
	107	u16 byte_cnt);
57aab75a TW	108	/* nic init */
	109	int (hw_nic_init)(struct iwl_priv priv);
	110	/* alive notification */
	111	int (alive_notify)(struct iwl_priv priv);
	112	/* check validity of rtc data address */
	113	int (*is_valid_rtc_data_addr)(u32 addr);
	114	/* 1st ucode load */
	115	int (load_ucode)(struct iwl_priv priv);
	116	/* rfkill */
	117	void (radio_kill_sw)(struct iwl_priv priv, int disable_radio);
91238714	118	/* power management */
6f4083aa	119	struct {
91238714	120	int (init)(struct iwl_priv priv);
6f4083aa TW	121	int (set_pwr_src)(struct iwl_priv priv, enum iwl_pwr_src src);
6f4083aa TW	122	} apm_ops;
5da4b55f MA	123	/* power */
	124	int (set_power)(struct iwl_priv priv, void *cmd);
	125	void (update_chain_flags)(struct iwl_priv priv);
6bc913bd AK	126	/* eeprom operations (as defined in iwl-eeprom.h) */
	127	struct iwl_eeprom_ops eeprom_ops;
	128	};
	129
	130	struct iwl_ops {
	131	const struct iwl_lib_ops *lib;
3c424c28	132	const struct iwl_hcmd_ops *hcmd;
857485c0	133	const struct iwl_hcmd_utils_ops *utils;
6bc913bd AK	134	};
6bc913bd AK	135
00acbc91 AK	136	struct iwl_mod_params {
00acbc91 AK	137	int disable; /* def: 0 = enable radio */
fcc76c6b	138	int sw_crypto; /* def: 0 = using hardware encryption */
00acbc91 AK	139	int debug; /* def: 0 = minimal debug log messages */
	140	int disable_hw_scan; /* def: 0 = use h/w scan */
	141	int num_of_queues; /* def: HW dependent */
	142	int enable_qos; /* def: 1 = use quality of service */
	143	int amsdu_size_8K; /* def: 1 = enable 8K amsdu size */
	144	int antenna; /* def: 0 = both antennas (use diversity) */
	145	};
	146
82b9a121 TW	147	struct iwl_cfg {
	148	const char *name;
	149	const char *fw_name;
	150	unsigned int sku;
073d3f5f	151	int eeprom_size;
6bc913bd	152	const struct iwl_ops *ops;
00acbc91	153	const struct iwl_mod_params *mod_params;
82b9a121 TW	154	};
82b9a121 TW	155
1d0a082d AK	156	/***************************
	157	* L i b *
	158	***************************/
	159
	160	struct ieee80211_hw iwl_alloc_all(struct iwl_cfg cfg,
	161	struct ieee80211_ops *hw_ops);
b661c819	162	void iwl_hw_detect(struct iwl_priv *priv);
1d0a082d	163
bf85ea4f	164	void iwlcore_clear_stations_table(struct iwl_priv *priv);
c7de35cd RR	165	void iwl_reset_qos(struct iwl_priv *priv);
	166	void iwl_set_rxon_chain(struct iwl_priv *priv);
	167	int iwl_set_rxon_channel(struct iwl_priv *priv,
bf85ea4f AK	168	enum ieee80211_band band,
bf85ea4f AK	169	u16 channel);
c7de35cd	170	void iwlcore_free_geos(struct iwl_priv *priv);
bf85ea4f AK	171	int iwl_setup(struct iwl_priv *priv);
bf85ea4f AK	172
857485c0 TW	173	/*****************************************************
	174	* S e n d i n g H o s t C o m m a n d s *
	175	*****************************************************/
	176
	177	const char *get_cmd_string(u8 cmd);
e5472978 TW	178	int __must_check iwl_send_cmd_sync(struct iwl_priv *priv,
e5472978 TW	179	struct iwl_host_cmd *cmd);
857485c0	180	int iwl_send_cmd(struct iwl_priv priv, struct iwl_host_cmd cmd);
e5472978 TW	181	int __must_check iwl_send_cmd_pdu(struct iwl_priv *priv, u8 id,
e5472978 TW	182	u16 len, const void *data);
857485c0 TW	183	int iwl_send_cmd_pdu_async(struct iwl_priv *priv, u8 id, u16 len,
	184	const void *data,
	185	int (callback)(struct iwl_priv priv,
	186	struct iwl_cmd *cmd,
	187	struct sk_buff *skb));
fee1247a TW	188	/************* DRIVER STATUS FUNCTIONS ***/
	189
	190	#define STATUS_HCMD_ACTIVE 0 /* host command in progress */
	191	#define STATUS_HCMD_SYNC_ACTIVE 1 /* sync host command in progress */
	192	#define STATUS_INT_ENABLED 2
	193	#define STATUS_RF_KILL_HW 3
	194	#define STATUS_RF_KILL_SW 4
	195	#define STATUS_INIT 5
	196	#define STATUS_ALIVE 6
	197	#define STATUS_READY 7
	198	#define STATUS_TEMPERATURE 8
	199	#define STATUS_GEO_CONFIGURED 9
	200	#define STATUS_EXIT_PENDING 10
	201	#define STATUS_IN_SUSPEND 11
	202	#define STATUS_STATISTICS 12
	203	#define STATUS_SCANNING 13
	204	#define STATUS_SCAN_ABORTING 14
	205	#define STATUS_SCAN_HW 15
	206	#define STATUS_POWER_PMI 16
	207	#define STATUS_FW_ERROR 17
	208	#define STATUS_CONF_PENDING 18
	209
	210
	211	static inline int iwl_is_ready(struct iwl_priv *priv)
	212	{
	213	/* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
	214	* set but EXIT_PENDING is not */
	215	return test_bit(STATUS_READY, &priv->status) &&
	216	test_bit(STATUS_GEO_CONFIGURED, &priv->status) &&
	217	!test_bit(STATUS_EXIT_PENDING, &priv->status);
	218	}
	219
	220	static inline int iwl_is_alive(struct iwl_priv *priv)
	221	{
	222	return test_bit(STATUS_ALIVE, &priv->status);
	223	}
	224
	225	static inline int iwl_is_init(struct iwl_priv *priv)
	226	{
	227	return test_bit(STATUS_INIT, &priv->status);
	228	}
	229
	230	static inline int iwl_is_rfkill(struct iwl_priv *priv)
	231	{
	232	return test_bit(STATUS_RF_KILL_HW, &priv->status) \|\|
	233	test_bit(STATUS_RF_KILL_SW, &priv->status);
	234	}
	235
	236	static inline int iwl_is_ready_rf(struct iwl_priv *priv)
	237	{
	238
	239	if (iwl_is_rfkill(priv))
	240	return 0;
	241
	242	return iwl_is_ready(priv);
	243	}
	244
857485c0	245
c8381fdc MA	246	enum iwlcore_card_notify {
	247	IWLCORE_INIT_EVT = 0,
	248	IWLCORE_START_EVT = 1,
	249	IWLCORE_STOP_EVT = 2,
	250	IWLCORE_REMOVE_EVT = 3,
	251	};
	252
	253	int iwlcore_low_level_notify(struct iwl_priv *priv,
	254	enum iwlcore_card_notify notify);
49ea8596	255	extern int iwl_send_statistics_request(struct iwl_priv *priv, u8 flags);
66c73db7 TW	256	int iwl_send_lq_cmd(struct iwl_priv *priv,
66c73db7 TW	257	struct iwl_link_quality_cmd *lq, u8 flags);
7e8c519e TW	258
	259	static inline int iwl_send_rxon_assoc(struct iwl_priv *priv)
	260	{
	261	return priv->cfg->ops->hcmd->rxon_assoc(priv);
	262	}
	263
82b9a121	264	#endif /* __iwl_core_h__ */