1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-or-later */
2*4882a593Smuzhiyun /* ZD1211 USB-WLAN driver for Linux
3*4882a593Smuzhiyun *
4*4882a593Smuzhiyun * Copyright (C) 2005-2007 Ulrich Kunitz <kune@deine-taler.de>
5*4882a593Smuzhiyun * Copyright (C) 2006-2007 Daniel Drake <dsd@gentoo.org>
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun #ifndef _ZD_RF_H
9*4882a593Smuzhiyun #define _ZD_RF_H
10*4882a593Smuzhiyun
11*4882a593Smuzhiyun #define UW2451_RF 0x2
12*4882a593Smuzhiyun #define UCHIP_RF 0x3
13*4882a593Smuzhiyun #define AL2230_RF 0x4
14*4882a593Smuzhiyun #define AL7230B_RF 0x5 /* a,b,g */
15*4882a593Smuzhiyun #define THETA_RF 0x6
16*4882a593Smuzhiyun #define AL2210_RF 0x7
17*4882a593Smuzhiyun #define MAXIM_NEW_RF 0x8
18*4882a593Smuzhiyun #define UW2453_RF 0x9
19*4882a593Smuzhiyun #define AL2230S_RF 0xa
20*4882a593Smuzhiyun #define RALINK_RF 0xb
21*4882a593Smuzhiyun #define INTERSIL_RF 0xc
22*4882a593Smuzhiyun #define RF2959_RF 0xd
23*4882a593Smuzhiyun #define MAXIM_NEW2_RF 0xe
24*4882a593Smuzhiyun #define PHILIPS_RF 0xf
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun #define RF_CHANNEL(ch) [(ch)-1]
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun /* Provides functions of the RF transceiver. */
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun enum {
31*4882a593Smuzhiyun RF_REG_BITS = 6,
32*4882a593Smuzhiyun RF_VALUE_BITS = 18,
33*4882a593Smuzhiyun RF_RV_BITS = RF_REG_BITS + RF_VALUE_BITS,
34*4882a593Smuzhiyun };
35*4882a593Smuzhiyun
36*4882a593Smuzhiyun struct zd_rf {
37*4882a593Smuzhiyun u8 type;
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun u8 channel;
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun /* whether channel integration and calibration should be updated
42*4882a593Smuzhiyun * defaults to 1 (yes) */
43*4882a593Smuzhiyun u8 update_channel_int:1;
44*4882a593Smuzhiyun
45*4882a593Smuzhiyun /* whether ZD_CR47 should be patched from the EEPROM, if the appropriate
46*4882a593Smuzhiyun * flag is set in the POD. The vendor driver suggests that this should
47*4882a593Smuzhiyun * be done for all RF's, but a bug in their code prevents but their
48*4882a593Smuzhiyun * HW_OverWritePhyRegFromE2P() routine from ever taking effect. */
49*4882a593Smuzhiyun u8 patch_cck_gain:1;
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun /* private RF driver data */
52*4882a593Smuzhiyun void *priv;
53*4882a593Smuzhiyun
54*4882a593Smuzhiyun /* RF-specific functions */
55*4882a593Smuzhiyun int (*init_hw)(struct zd_rf *rf);
56*4882a593Smuzhiyun int (*set_channel)(struct zd_rf *rf, u8 channel);
57*4882a593Smuzhiyun int (*switch_radio_on)(struct zd_rf *rf);
58*4882a593Smuzhiyun int (*switch_radio_off)(struct zd_rf *rf);
59*4882a593Smuzhiyun int (*patch_6m_band_edge)(struct zd_rf *rf, u8 channel);
60*4882a593Smuzhiyun void (*clear)(struct zd_rf *rf);
61*4882a593Smuzhiyun };
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun const char *zd_rf_name(u8 type);
64*4882a593Smuzhiyun void zd_rf_init(struct zd_rf *rf);
65*4882a593Smuzhiyun void zd_rf_clear(struct zd_rf *rf);
66*4882a593Smuzhiyun int zd_rf_init_hw(struct zd_rf *rf, u8 type);
67*4882a593Smuzhiyun
68*4882a593Smuzhiyun int zd_rf_scnprint_id(struct zd_rf *rf, char *buffer, size_t size);
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun int zd_rf_set_channel(struct zd_rf *rf, u8 channel);
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun int zd_switch_radio_on(struct zd_rf *rf);
73*4882a593Smuzhiyun int zd_switch_radio_off(struct zd_rf *rf);
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun int zd_rf_patch_6m_band_edge(struct zd_rf *rf, u8 channel);
76*4882a593Smuzhiyun int zd_rf_generic_patch_6m(struct zd_rf *rf, u8 channel);
77*4882a593Smuzhiyun
zd_rf_should_update_pwr_int(struct zd_rf * rf)78*4882a593Smuzhiyun static inline int zd_rf_should_update_pwr_int(struct zd_rf *rf)
79*4882a593Smuzhiyun {
80*4882a593Smuzhiyun return rf->update_channel_int;
81*4882a593Smuzhiyun }
82*4882a593Smuzhiyun
zd_rf_should_patch_cck_gain(struct zd_rf * rf)83*4882a593Smuzhiyun static inline int zd_rf_should_patch_cck_gain(struct zd_rf *rf)
84*4882a593Smuzhiyun {
85*4882a593Smuzhiyun return rf->patch_cck_gain;
86*4882a593Smuzhiyun }
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun int zd_rf_patch_6m_band_edge(struct zd_rf *rf, u8 channel);
89*4882a593Smuzhiyun int zd_rf_generic_patch_6m(struct zd_rf *rf, u8 channel);
90*4882a593Smuzhiyun
91*4882a593Smuzhiyun /* Functions for individual RF chips */
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun int zd_rf_init_rf2959(struct zd_rf *rf);
94*4882a593Smuzhiyun int zd_rf_init_al2230(struct zd_rf *rf);
95*4882a593Smuzhiyun int zd_rf_init_al7230b(struct zd_rf *rf);
96*4882a593Smuzhiyun int zd_rf_init_uw2453(struct zd_rf *rf);
97*4882a593Smuzhiyun
98*4882a593Smuzhiyun #endif /* _ZD_RF_H */
99