1/* ZD1211 USB-WLAN driver for Linux
  2 *
  3 * Copyright (C) 2005-2007 Ulrich Kunitz <kune@deine-taler.de>
  4 * Copyright (C) 2006-2007 Daniel Drake <dsd@gentoo.org>
  5 *
  6 * This program is free software; you can redistribute it and/or modify
  7 * it under the terms of the GNU General Public License as published by
  8 * the Free Software Foundation; either version 2 of the License, or
  9 * (at your option) any later version.
 10 *
 11 * This program is distributed in the hope that it will be useful,
 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 14 * GNU General Public License for more details.
 15 *
 16 * You should have received a copy of the GNU General Public License
 17 * along with this program; if not, write to the Free Software
 18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 19 */
 20
 21#ifndef _ZD_RF_H
 22#define _ZD_RF_H
 23
 24#define UW2451_RF			0x2
 25#define UCHIP_RF			0x3
 26#define AL2230_RF			0x4
 27#define AL7230B_RF			0x5	/* a,b,g */
 28#define THETA_RF			0x6
 29#define AL2210_RF			0x7
 30#define MAXIM_NEW_RF			0x8
 31#define UW2453_RF			0x9
 32#define AL2230S_RF			0xa
 33#define RALINK_RF			0xb
 34#define INTERSIL_RF			0xc
 35#define RF2959_RF			0xd
 36#define MAXIM_NEW2_RF			0xe
 37#define PHILIPS_RF			0xf
 38
 39#define RF_CHANNEL(ch) [(ch)-1]
 40
 41/* Provides functions of the RF transceiver. */
 42
 43enum {
 44	RF_REG_BITS = 6,
 45	RF_VALUE_BITS = 18,
 46	RF_RV_BITS = RF_REG_BITS + RF_VALUE_BITS,
 47};
 48
 49struct zd_rf {
 50	u8 type;
 51
 52	u8 channel;
 53
 54	/* whether channel integration and calibration should be updated
 55	 * defaults to 1 (yes) */
 56	u8 update_channel_int:1;
 57
 58	/* whether ZD_CR47 should be patched from the EEPROM, if the appropriate
 59	 * flag is set in the POD. The vendor driver suggests that this should
 60	 * be done for all RF's, but a bug in their code prevents but their
 61	 * HW_OverWritePhyRegFromE2P() routine from ever taking effect. */
 62	u8 patch_cck_gain:1;
 63
 64	/* private RF driver data */
 65	void *priv;
 66
 67	/* RF-specific functions */
 68	int (*init_hw)(struct zd_rf *rf);
 69	int (*set_channel)(struct zd_rf *rf, u8 channel);
 70	int (*switch_radio_on)(struct zd_rf *rf);
 71	int (*switch_radio_off)(struct zd_rf *rf);
 72	int (*patch_6m_band_edge)(struct zd_rf *rf, u8 channel);
 73	void (*clear)(struct zd_rf *rf);
 74};
 75
 76const char *zd_rf_name(u8 type);
 77void zd_rf_init(struct zd_rf *rf);
 78void zd_rf_clear(struct zd_rf *rf);
 79int zd_rf_init_hw(struct zd_rf *rf, u8 type);
 80
 81int zd_rf_scnprint_id(struct zd_rf *rf, char *buffer, size_t size);
 82
 83int zd_rf_set_channel(struct zd_rf *rf, u8 channel);
 84
 85int zd_switch_radio_on(struct zd_rf *rf);
 86int zd_switch_radio_off(struct zd_rf *rf);
 87
 88int zd_rf_patch_6m_band_edge(struct zd_rf *rf, u8 channel);
 89int zd_rf_generic_patch_6m(struct zd_rf *rf, u8 channel);
 90
 91static inline int zd_rf_should_update_pwr_int(struct zd_rf *rf)
 92{
 93	return rf->update_channel_int;
 94}
 95
 96static inline int zd_rf_should_patch_cck_gain(struct zd_rf *rf)
 97{
 98	return rf->patch_cck_gain;
 99}
100
101int zd_rf_patch_6m_band_edge(struct zd_rf *rf, u8 channel);
102int zd_rf_generic_patch_6m(struct zd_rf *rf, u8 channel);
103
104/* Functions for individual RF chips */
105
106int zd_rf_init_rf2959(struct zd_rf *rf);
107int zd_rf_init_al2230(struct zd_rf *rf);
108int zd_rf_init_al7230b(struct zd_rf *rf);
109int zd_rf_init_uw2453(struct zd_rf *rf);
110
111#endif /* _ZD_RF_H */