1 /* ZD1211 USB-WLAN driver for Linux
3 * Copyright (C) 2005-2007 Ulrich Kunitz <kune@deine-taler.de>
4 * Copyright (C) 2006-2007 Daniel Drake <dsd@gentoo.org>
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.
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.
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
21 #include <linux/kernel.h>
22 #include <linux/slab.h>
28 /* This RF programming code is based upon the code found in v2.16.0.0 of the
29 * ZyDAS vendor driver. Unlike other RF's, Ubec publish full technical specs
30 * for this RF on their website, so we're able to understand more than
31 * usual as to what is going on. Thumbs up for Ubec for doing that. */
33 /* The 3-wire serial interface provides access to 8 write-only registers.
34 * The data format is a 4 bit register address followed by a 20 bit value. */
35 #define UW2453_REGWRITE(reg, val) ((((reg) & 0xf) << 20) | ((val) & 0xfffff))
37 /* For channel tuning, we have to configure registers 1 (synthesizer), 2 (synth
38 * fractional divide ratio) and 3 (VCO config).
40 * We configure the RF to produce an interrupt when the PLL is locked onto
41 * the configured frequency. During initialization, we run through a variety
42 * of different VCO configurations on channel 1 until we detect a PLL lock.
43 * When this happens, we remember which VCO configuration produced the lock
44 * and use it later. Actually, we use the configuration *after* the one that
45 * produced the lock, which seems odd, but it works.
47 * If we do not see a PLL lock on any standard VCO config, we fall back on an
48 * autocal configuration, which has a fixed (as opposed to per-channel) VCO
49 * config and different synth values from the standard set (divide ratio
50 * is still shared with the standard set). */
52 /* The per-channel synth values for all standard VCO configurations. These get
53 * written to register 1. */
54 static const u8 uw2453_std_synth
[] = {
55 RF_CHANNEL( 1) = 0x47,
56 RF_CHANNEL( 2) = 0x47,
57 RF_CHANNEL( 3) = 0x67,
58 RF_CHANNEL( 4) = 0x67,
59 RF_CHANNEL( 5) = 0x67,
60 RF_CHANNEL( 6) = 0x67,
61 RF_CHANNEL( 7) = 0x57,
62 RF_CHANNEL( 8) = 0x57,
63 RF_CHANNEL( 9) = 0x57,
64 RF_CHANNEL(10) = 0x57,
65 RF_CHANNEL(11) = 0x77,
66 RF_CHANNEL(12) = 0x77,
67 RF_CHANNEL(13) = 0x77,
68 RF_CHANNEL(14) = 0x4f,
71 /* This table stores the synthesizer fractional divide ratio for *all* VCO
72 * configurations (both standard and autocal). These get written to register 2.
74 static const u16 uw2453_synth_divide
[] = {
75 RF_CHANNEL( 1) = 0x999,
76 RF_CHANNEL( 2) = 0x99b,
77 RF_CHANNEL( 3) = 0x998,
78 RF_CHANNEL( 4) = 0x99a,
79 RF_CHANNEL( 5) = 0x999,
80 RF_CHANNEL( 6) = 0x99b,
81 RF_CHANNEL( 7) = 0x998,
82 RF_CHANNEL( 8) = 0x99a,
83 RF_CHANNEL( 9) = 0x999,
84 RF_CHANNEL(10) = 0x99b,
85 RF_CHANNEL(11) = 0x998,
86 RF_CHANNEL(12) = 0x99a,
87 RF_CHANNEL(13) = 0x999,
88 RF_CHANNEL(14) = 0xccc,
91 /* Here is the data for all the standard VCO configurations. We shrink our
92 * table a little by observing that both channels in a consecutive pair share
93 * the same value. We also observe that the high 4 bits ([0:3] in the specs)
94 * are all 'Reserved' and are always set to 0x4 - we chop them off in the data
96 #define CHAN_TO_PAIRIDX(a) ((a - 1) / 2)
97 #define RF_CHANPAIR(a,b) [CHAN_TO_PAIRIDX(a)]
98 static const u16 uw2453_std_vco_cfg
[][7] = {
100 RF_CHANPAIR( 1, 2) = 0x664d,
101 RF_CHANPAIR( 3, 4) = 0x604d,
102 RF_CHANPAIR( 5, 6) = 0x6675,
103 RF_CHANPAIR( 7, 8) = 0x6475,
104 RF_CHANPAIR( 9, 10) = 0x6655,
105 RF_CHANPAIR(11, 12) = 0x6455,
106 RF_CHANPAIR(13, 14) = 0x6665,
109 RF_CHANPAIR( 1, 2) = 0x666d,
110 RF_CHANPAIR( 3, 4) = 0x606d,
111 RF_CHANPAIR( 5, 6) = 0x664d,
112 RF_CHANPAIR( 7, 8) = 0x644d,
113 RF_CHANPAIR( 9, 10) = 0x6675,
114 RF_CHANPAIR(11, 12) = 0x6475,
115 RF_CHANPAIR(13, 14) = 0x6655,
118 RF_CHANPAIR( 1, 2) = 0x665d,
119 RF_CHANPAIR( 3, 4) = 0x605d,
120 RF_CHANPAIR( 5, 6) = 0x666d,
121 RF_CHANPAIR( 7, 8) = 0x646d,
122 RF_CHANPAIR( 9, 10) = 0x664d,
123 RF_CHANPAIR(11, 12) = 0x644d,
124 RF_CHANPAIR(13, 14) = 0x6675,
127 RF_CHANPAIR( 1, 2) = 0x667d,
128 RF_CHANPAIR( 3, 4) = 0x607d,
129 RF_CHANPAIR( 5, 6) = 0x665d,
130 RF_CHANPAIR( 7, 8) = 0x645d,
131 RF_CHANPAIR( 9, 10) = 0x666d,
132 RF_CHANPAIR(11, 12) = 0x646d,
133 RF_CHANPAIR(13, 14) = 0x664d,
136 RF_CHANPAIR( 1, 2) = 0x6643,
137 RF_CHANPAIR( 3, 4) = 0x6043,
138 RF_CHANPAIR( 5, 6) = 0x667d,
139 RF_CHANPAIR( 7, 8) = 0x647d,
140 RF_CHANPAIR( 9, 10) = 0x665d,
141 RF_CHANPAIR(11, 12) = 0x645d,
142 RF_CHANPAIR(13, 14) = 0x666d,
145 RF_CHANPAIR( 1, 2) = 0x6663,
146 RF_CHANPAIR( 3, 4) = 0x6063,
147 RF_CHANPAIR( 5, 6) = 0x6643,
148 RF_CHANPAIR( 7, 8) = 0x6443,
149 RF_CHANPAIR( 9, 10) = 0x667d,
150 RF_CHANPAIR(11, 12) = 0x647d,
151 RF_CHANPAIR(13, 14) = 0x665d,
154 RF_CHANPAIR( 1, 2) = 0x6653,
155 RF_CHANPAIR( 3, 4) = 0x6053,
156 RF_CHANPAIR( 5, 6) = 0x6663,
157 RF_CHANPAIR( 7, 8) = 0x6463,
158 RF_CHANPAIR( 9, 10) = 0x6643,
159 RF_CHANPAIR(11, 12) = 0x6443,
160 RF_CHANPAIR(13, 14) = 0x667d,
163 RF_CHANPAIR( 1, 2) = 0x6673,
164 RF_CHANPAIR( 3, 4) = 0x6073,
165 RF_CHANPAIR( 5, 6) = 0x6653,
166 RF_CHANPAIR( 7, 8) = 0x6453,
167 RF_CHANPAIR( 9, 10) = 0x6663,
168 RF_CHANPAIR(11, 12) = 0x6463,
169 RF_CHANPAIR(13, 14) = 0x6643,
172 RF_CHANPAIR( 1, 2) = 0x664b,
173 RF_CHANPAIR( 3, 4) = 0x604b,
174 RF_CHANPAIR( 5, 6) = 0x6673,
175 RF_CHANPAIR( 7, 8) = 0x6473,
176 RF_CHANPAIR( 9, 10) = 0x6653,
177 RF_CHANPAIR(11, 12) = 0x6453,
178 RF_CHANPAIR(13, 14) = 0x6663,
181 RF_CHANPAIR( 1, 2) = 0x666b,
182 RF_CHANPAIR( 3, 4) = 0x606b,
183 RF_CHANPAIR( 5, 6) = 0x664b,
184 RF_CHANPAIR( 7, 8) = 0x644b,
185 RF_CHANPAIR( 9, 10) = 0x6673,
186 RF_CHANPAIR(11, 12) = 0x6473,
187 RF_CHANPAIR(13, 14) = 0x6653,
190 RF_CHANPAIR( 1, 2) = 0x665b,
191 RF_CHANPAIR( 3, 4) = 0x605b,
192 RF_CHANPAIR( 5, 6) = 0x666b,
193 RF_CHANPAIR( 7, 8) = 0x646b,
194 RF_CHANPAIR( 9, 10) = 0x664b,
195 RF_CHANPAIR(11, 12) = 0x644b,
196 RF_CHANPAIR(13, 14) = 0x6673,
201 /* The per-channel synth values for autocal. These get written to register 1. */
202 static const u16 uw2453_autocal_synth
[] = {
203 RF_CHANNEL( 1) = 0x6847,
204 RF_CHANNEL( 2) = 0x6847,
205 RF_CHANNEL( 3) = 0x6867,
206 RF_CHANNEL( 4) = 0x6867,
207 RF_CHANNEL( 5) = 0x6867,
208 RF_CHANNEL( 6) = 0x6867,
209 RF_CHANNEL( 7) = 0x6857,
210 RF_CHANNEL( 8) = 0x6857,
211 RF_CHANNEL( 9) = 0x6857,
212 RF_CHANNEL(10) = 0x6857,
213 RF_CHANNEL(11) = 0x6877,
214 RF_CHANNEL(12) = 0x6877,
215 RF_CHANNEL(13) = 0x6877,
216 RF_CHANNEL(14) = 0x684f,
219 /* The VCO configuration for autocal (all channels) */
220 static const u16 UW2453_AUTOCAL_VCO_CFG
= 0x6662;
222 /* TX gain settings. The array index corresponds to the TX power integration
223 * values found in the EEPROM. The values get written to register 7. */
224 static u32 uw2453_txgain
[] = {
246 /* RF-specific structure */
248 /* index into synth/VCO config tables where PLL lock was found
249 * -1 means autocal */
253 #define UW2453_PRIV(rf) ((struct uw2453_priv *) (rf)->priv)
255 static int uw2453_synth_set_channel(struct zd_chip
*chip
, int channel
,
259 int idx
= channel
- 1;
263 val
= UW2453_REGWRITE(1, uw2453_autocal_synth
[idx
]);
265 val
= UW2453_REGWRITE(1, uw2453_std_synth
[idx
]);
267 r
= zd_rfwrite_locked(chip
, val
, RF_RV_BITS
);
271 return zd_rfwrite_locked(chip
,
272 UW2453_REGWRITE(2, uw2453_synth_divide
[idx
]), RF_RV_BITS
);
275 static int uw2453_write_vco_cfg(struct zd_chip
*chip
, u16 value
)
277 /* vendor driver always sets these upper bits even though the specs say
278 * they are reserved */
279 u32 val
= 0x40000 | value
;
280 return zd_rfwrite_locked(chip
, UW2453_REGWRITE(3, val
), RF_RV_BITS
);
283 static int uw2453_init_mode(struct zd_chip
*chip
)
285 static const u32 rv
[] = {
286 UW2453_REGWRITE(0, 0x25f98), /* enter IDLE mode */
287 UW2453_REGWRITE(0, 0x25f9a), /* enter CAL_VCO mode */
288 UW2453_REGWRITE(0, 0x25f94), /* enter RX/TX mode */
289 UW2453_REGWRITE(0, 0x27fd4), /* power down RSSI circuit */
292 return zd_rfwritev_locked(chip
, rv
, ARRAY_SIZE(rv
), RF_RV_BITS
);
295 static int uw2453_set_tx_gain_level(struct zd_chip
*chip
, int channel
)
297 u8 int_value
= chip
->pwr_int_values
[channel
- 1];
299 if (int_value
>= ARRAY_SIZE(uw2453_txgain
)) {
300 dev_dbg_f(zd_chip_dev(chip
), "can't configure TX gain for "
301 "int value %x on channel %d\n", int_value
, channel
);
305 return zd_rfwrite_locked(chip
,
306 UW2453_REGWRITE(7, uw2453_txgain
[int_value
]), RF_RV_BITS
);
309 static int uw2453_init_hw(struct zd_rf
*rf
)
312 int found_config
= -1;
314 struct zd_chip
*chip
= zd_rf_to_chip(rf
);
316 static const struct zd_ioreq16 ioreqs
[] = {
317 { CR10
, 0x89 }, { CR15
, 0x20 },
318 { CR17
, 0x28 }, /* 6112 no change */
319 { CR23
, 0x38 }, { CR24
, 0x20 }, { CR26
, 0x93 },
320 { CR27
, 0x15 }, { CR28
, 0x3e }, { CR29
, 0x00 },
321 { CR33
, 0x28 }, { CR34
, 0x30 },
322 { CR35
, 0x43 }, /* 6112 3e->43 */
323 { CR41
, 0x24 }, { CR44
, 0x32 },
324 { CR46
, 0x92 }, /* 6112 96->92 */
326 { CR48
, 0x04 }, /* 5602 Roger */
327 { CR49
, 0xfa }, { CR79
, 0x58 }, { CR80
, 0x30 },
328 { CR81
, 0x30 }, { CR87
, 0x0a }, { CR89
, 0x04 },
329 { CR91
, 0x00 }, { CR92
, 0x0a }, { CR98
, 0x8d },
330 { CR99
, 0x28 }, { CR100
, 0x02 },
331 { CR101
, 0x09 }, /* 6112 13->1f 6220 1f->13 6407 13->9 */
333 { CR106
, 0x1c }, /* 5d07 5112 1f->1c 6220 1c->1f 6221 1f->1c */
334 { CR107
, 0x1c }, /* 6220 1c->1a 5221 1a->1c */
336 { CR110
, 0x1f }, /* 6112 13->1f 6221 1f->13 6407 13->0x09 */
337 { CR111
, 0x13 }, { CR112
, 0x1f }, { CR113
, 0x27 },
338 { CR114
, 0x23 }, /* 6221 27->23 */
339 { CR115
, 0x24 }, /* 6112 24->1c 6220 1c->24 */
340 { CR116
, 0x24 }, /* 6220 1c->24 */
341 { CR117
, 0xfa }, /* 6112 fa->f8 6220 f8->f4 6220 f4->fa */
342 { CR118
, 0xf0 }, /* 5d07 6112 f0->f2 6220 f2->f0 */
343 { CR119
, 0x1a }, /* 6112 1a->10 6220 10->14 6220 14->1a */
345 { CR121
, 0x1f }, /* 6220 4f->1f */
346 { CR122
, 0xf0 }, { CR123
, 0x57 }, { CR125
, 0xad },
347 { CR126
, 0x6c }, { CR127
, 0x03 },
348 { CR128
, 0x14 }, /* 6302 12->11 */
349 { CR129
, 0x12 }, /* 6301 10->0f */
350 { CR130
, 0x10 }, { CR137
, 0x50 }, { CR138
, 0xa8 },
351 { CR144
, 0xac }, { CR146
, 0x20 }, { CR252
, 0xff },
355 static const u32 rv
[] = {
356 UW2453_REGWRITE(4, 0x2b), /* configure reciever gain */
357 UW2453_REGWRITE(5, 0x19e4f), /* configure transmitter gain */
358 UW2453_REGWRITE(6, 0xf81ad), /* enable RX/TX filter tuning */
359 UW2453_REGWRITE(7, 0x3fffe), /* disable TX gain in test mode */
361 /* enter CAL_FIL mode, TX gain set by registers, RX gain set by pins,
362 * RSSI circuit powered down, reduced RSSI range */
363 UW2453_REGWRITE(0, 0x25f9c), /* 5d01 cal_fil */
365 /* synthesizer configuration for channel 1 */
366 UW2453_REGWRITE(1, 0x47),
367 UW2453_REGWRITE(2, 0x999),
369 /* disable manual VCO band selection */
370 UW2453_REGWRITE(3, 0x7602),
372 /* enable manual VCO band selection, configure current level */
373 UW2453_REGWRITE(3, 0x46063),
376 r
= zd_iowrite16a_locked(chip
, ioreqs
, ARRAY_SIZE(ioreqs
));
380 r
= zd_rfwritev_locked(chip
, rv
, ARRAY_SIZE(rv
), RF_RV_BITS
);
384 r
= uw2453_init_mode(chip
);
388 /* Try all standard VCO configuration settings on channel 1 */
389 for (i
= 0; i
< ARRAY_SIZE(uw2453_std_vco_cfg
) - 1; i
++) {
390 /* Configure synthesizer for channel 1 */
391 r
= uw2453_synth_set_channel(chip
, 1, false);
395 /* Write VCO config */
396 r
= uw2453_write_vco_cfg(chip
, uw2453_std_vco_cfg
[i
][0]);
400 /* ack interrupt event */
401 r
= zd_iowrite16_locked(chip
, 0x0f, UW2453_INTR_REG
);
405 /* check interrupt status */
406 r
= zd_ioread16_locked(chip
, &intr_status
, UW2453_INTR_REG
);
410 if (!(intr_status
& 0xf)) {
411 dev_dbg_f(zd_chip_dev(chip
),
412 "PLL locked on configuration %d\n", i
);
418 if (found_config
== -1) {
420 dev_dbg_f(zd_chip_dev(chip
),
421 "PLL did not lock, using autocal\n");
423 r
= uw2453_synth_set_channel(chip
, 1, true);
427 r
= uw2453_write_vco_cfg(chip
, UW2453_AUTOCAL_VCO_CFG
);
432 /* To match the vendor driver behaviour, we use the configuration after
433 * the one that produced a lock. */
434 UW2453_PRIV(rf
)->config
= found_config
+ 1;
436 return zd_iowrite16_locked(chip
, 0x06, CR203
);
439 static int uw2453_set_channel(struct zd_rf
*rf
, u8 channel
)
443 int config
= UW2453_PRIV(rf
)->config
;
444 bool autocal
= (config
== -1);
445 struct zd_chip
*chip
= zd_rf_to_chip(rf
);
447 static const struct zd_ioreq16 ioreqs
[] = {
448 { CR80
, 0x30 }, { CR81
, 0x30 }, { CR79
, 0x58 },
449 { CR12
, 0xf0 }, { CR77
, 0x1b }, { CR78
, 0x58 },
452 r
= uw2453_synth_set_channel(chip
, channel
, autocal
);
457 vco_cfg
= UW2453_AUTOCAL_VCO_CFG
;
459 vco_cfg
= uw2453_std_vco_cfg
[config
][CHAN_TO_PAIRIDX(channel
)];
461 r
= uw2453_write_vco_cfg(chip
, vco_cfg
);
465 r
= uw2453_init_mode(chip
);
469 r
= zd_iowrite16a_locked(chip
, ioreqs
, ARRAY_SIZE(ioreqs
));
473 r
= uw2453_set_tx_gain_level(chip
, channel
);
477 return zd_iowrite16_locked(chip
, 0x06, CR203
);
480 static int uw2453_switch_radio_on(struct zd_rf
*rf
)
483 struct zd_chip
*chip
= zd_rf_to_chip(rf
);
484 struct zd_ioreq16 ioreqs
[] = {
485 { CR11
, 0x00 }, { CR251
, 0x3f },
488 /* enter RXTX mode */
489 r
= zd_rfwrite_locked(chip
, UW2453_REGWRITE(0, 0x25f94), RF_RV_BITS
);
493 if (zd_chip_is_zd1211b(chip
))
494 ioreqs
[1].value
= 0x7f;
496 return zd_iowrite16a_locked(chip
, ioreqs
, ARRAY_SIZE(ioreqs
));
499 static int uw2453_switch_radio_off(struct zd_rf
*rf
)
502 struct zd_chip
*chip
= zd_rf_to_chip(rf
);
503 static const struct zd_ioreq16 ioreqs
[] = {
504 { CR11
, 0x04 }, { CR251
, 0x2f },
507 /* enter IDLE mode */
508 /* FIXME: shouldn't we go to SLEEP? sent email to zydas */
509 r
= zd_rfwrite_locked(chip
, UW2453_REGWRITE(0, 0x25f90), RF_RV_BITS
);
513 return zd_iowrite16a_locked(chip
, ioreqs
, ARRAY_SIZE(ioreqs
));
516 static void uw2453_clear(struct zd_rf
*rf
)
521 int zd_rf_init_uw2453(struct zd_rf
*rf
)
523 rf
->init_hw
= uw2453_init_hw
;
524 rf
->set_channel
= uw2453_set_channel
;
525 rf
->switch_radio_on
= uw2453_switch_radio_on
;
526 rf
->switch_radio_off
= uw2453_switch_radio_off
;
527 rf
->patch_6m_band_edge
= zd_rf_generic_patch_6m
;
528 rf
->clear
= uw2453_clear
;
529 /* we have our own TX integration code */
530 rf
->update_channel_int
= 0;
532 rf
->priv
= kmalloc(sizeof(struct uw2453_priv
), GFP_KERNEL
);
533 if (rf
->priv
== NULL
)