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, see <http://www.gnu.org/licenses/>.
18 */
19
20#ifndef _ZD_RF_H
21#define _ZD_RF_H
22
23#define UW2451_RF			0x2
24#define UCHIP_RF			0x3
25#define AL2230_RF			0x4
26#define AL7230B_RF			0x5	/* a,b,g */
27#define THETA_RF			0x6
28#define AL2210_RF			0x7
29#define MAXIM_NEW_RF			0x8
30#define UW2453_RF			0x9
31#define AL2230S_RF			0xa
32#define RALINK_RF			0xb
33#define INTERSIL_RF			0xc
34#define RF2959_RF			0xd
35#define MAXIM_NEW2_RF			0xe
36#define PHILIPS_RF			0xf
37
38#define RF_CHANNEL(ch) [(ch)-1]
39
40/* Provides functions of the RF transceiver. */
41
42enum {
43	RF_REG_BITS = 6,
44	RF_VALUE_BITS = 18,
45	RF_RV_BITS = RF_REG_BITS + RF_VALUE_BITS,
46};
47
48struct zd_rf {
49	u8 type;
50
51	u8 channel;
52
53	/* whether channel integration and calibration should be updated
54	 * defaults to 1 (yes) */
55	u8 update_channel_int:1;
56
57	/* whether ZD_CR47 should be patched from the EEPROM, if the appropriate
58	 * flag is set in the POD. The vendor driver suggests that this should
59	 * be done for all RF's, but a bug in their code prevents but their
60	 * HW_OverWritePhyRegFromE2P() routine from ever taking effect. */
61	u8 patch_cck_gain:1;
62
63	/* private RF driver data */
64	void *priv;
65
66	/* RF-specific functions */
67	int (*init_hw)(struct zd_rf *rf);
68	int (*set_channel)(struct zd_rf *rf, u8 channel);
69	int (*switch_radio_on)(struct zd_rf *rf);
70	int (*switch_radio_off)(struct zd_rf *rf);
71	int (*patch_6m_band_edge)(struct zd_rf *rf, u8 channel);
72	void (*clear)(struct zd_rf *rf);
73};
74
75const char *zd_rf_name(u8 type);
76void zd_rf_init(struct zd_rf *rf);
77void zd_rf_clear(struct zd_rf *rf);
78int zd_rf_init_hw(struct zd_rf *rf, u8 type);
79
80int zd_rf_scnprint_id(struct zd_rf *rf, char *buffer, size_t size);
81
82int zd_rf_set_channel(struct zd_rf *rf, u8 channel);
83
84int zd_switch_radio_on(struct zd_rf *rf);
85int zd_switch_radio_off(struct zd_rf *rf);
86
87int zd_rf_patch_6m_band_edge(struct zd_rf *rf, u8 channel);
88int zd_rf_generic_patch_6m(struct zd_rf *rf, u8 channel);
89
90static inline int zd_rf_should_update_pwr_int(struct zd_rf *rf)
91{
92	return rf->update_channel_int;
93}
94
95static inline int zd_rf_should_patch_cck_gain(struct zd_rf *rf)
96{
97	return rf->patch_cck_gain;
98}
99
100int zd_rf_patch_6m_band_edge(struct zd_rf *rf, u8 channel);
101int zd_rf_generic_patch_6m(struct zd_rf *rf, u8 channel);
102
103/* Functions for individual RF chips */
104
105int zd_rf_init_rf2959(struct zd_rf *rf);
106int zd_rf_init_al2230(struct zd_rf *rf);
107int zd_rf_init_al7230b(struct zd_rf *rf);
108int zd_rf_init_uw2453(struct zd_rf *rf);
109
110#endif /* _ZD_RF_H */
111