rt2x00reg.h revision 70e2fed4ec14df84ed72554d573794714b15a078 
1/*
2	Copyright (C) 2004 - 2008 rt2x00 SourceForge Project
3	<http://rt2x00.serialmonkey.com>
4
5	This program is free software; you can redistribute it and/or modify
6	it under the terms of the GNU General Public License as published by
7	the Free Software Foundation; either version 2 of the License, or
8	(at your option) any later version.
9
10	This program is distributed in the hope that it will be useful,
11	but WITHOUT ANY WARRANTY; without even the implied warranty of
12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13	GNU General Public License for more details.
14
15	You should have received a copy of the GNU General Public License
16	along with this program; if not, write to the
17	Free Software Foundation, Inc.,
18	59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 */
20
21/*
22	Module: rt2x00
23	Abstract: rt2x00 generic register information.
24 */
25
26#ifndef RT2X00REG_H
27#define RT2X00REG_H
28
29/*
30 * TX result flags.
31 */
32enum tx_status {
33	TX_SUCCESS = 0,
34	TX_SUCCESS_RETRY = 1,
35	TX_FAIL_RETRY = 2,
36	TX_FAIL_INVALID = 3,
37	TX_FAIL_OTHER = 4,
38};
39
40/*
41 * Antenna values
42 */
43enum antenna {
44	ANTENNA_SW_DIVERSITY = 0,
45	ANTENNA_A = 1,
46	ANTENNA_B = 2,
47	ANTENNA_HW_DIVERSITY = 3,
48};
49
50/*
51 * Led mode values.
52 */
53enum led_mode {
54	LED_MODE_DEFAULT = 0,
55	LED_MODE_TXRX_ACTIVITY = 1,
56	LED_MODE_SIGNAL_STRENGTH = 2,
57	LED_MODE_ASUS = 3,
58	LED_MODE_ALPHA = 4,
59};
60
61/*
62 * TSF sync values
63 */
64enum tsf_sync {
65	TSF_SYNC_NONE = 0,
66	TSF_SYNC_INFRA = 1,
67	TSF_SYNC_BEACON = 2,
68};
69
70/*
71 * Device states
72 */
73enum dev_state {
74	STATE_DEEP_SLEEP = 0,
75	STATE_SLEEP = 1,
76	STATE_STANDBY = 2,
77	STATE_AWAKE = 3,
78
79/*
80 * Additional device states, these values are
81 * not strict since they are not directly passed
82 * into the device.
83 */
84	STATE_RADIO_ON,
85	STATE_RADIO_OFF,
86	STATE_RADIO_RX_ON,
87	STATE_RADIO_RX_OFF,
88	STATE_RADIO_RX_ON_LINK,
89	STATE_RADIO_RX_OFF_LINK,
90	STATE_RADIO_IRQ_ON,
91	STATE_RADIO_IRQ_OFF,
92};
93
94/*
95 * IFS backoff values
96 */
97enum ifs {
98	IFS_BACKOFF = 0,
99	IFS_SIFS = 1,
100	IFS_NEW_BACKOFF = 2,
101	IFS_NONE = 3,
102};
103
104/*
105 * Cipher types for hardware encryption
106 */
107enum cipher {
108	CIPHER_NONE = 0,
109	CIPHER_WEP64 = 1,
110	CIPHER_WEP128 = 2,
111	CIPHER_TKIP = 3,
112	CIPHER_AES = 4,
113/*
114 * The following fields were added by rt61pci and rt73usb.
115 */
116	CIPHER_CKIP64 = 5,
117	CIPHER_CKIP128 = 6,
118	CIPHER_TKIP_NO_MIC = 7,
119};
120
121/*
122 * Register handlers.
123 * We store the position of a register field inside a field structure,
124 * This will simplify the process of setting and reading a certain field
125 * inside the register while making sure the process remains byte order safe.
126 */
127struct rt2x00_field8 {
128	u8 bit_offset;
129	u8 bit_mask;
130};
131
132struct rt2x00_field16 {
133	u16 bit_offset;
134	u16 bit_mask;
135};
136
137struct rt2x00_field32 {
138	u32 bit_offset;
139	u32 bit_mask;
140};
141
142/*
143 * Power of two check, this will check
144 * if the mask that has been given contains
145 * and contiguous set of bits.
146 */
147#define is_power_of_two(x)	( !((x) & ((x)-1)) )
148#define low_bit_mask(x)		( ((x)-1) & ~(x) )
149#define is_valid_mask(x)	is_power_of_two(1 + (x) + low_bit_mask(x))
150
151#define FIELD8(__mask)				\
152({						\
153	BUILD_BUG_ON(!(__mask) ||		\
154		     !is_valid_mask(__mask) ||	\
155		     (__mask) != (u8)(__mask));	\
156	(struct rt2x00_field8) {		\
157		__ffs(__mask), (__mask)		\
158	};					\
159})
160
161#define FIELD16(__mask)				\
162({						\
163	BUILD_BUG_ON(!(__mask) ||		\
164		     !is_valid_mask(__mask) ||	\
165		     (__mask) != (u16)(__mask));\
166	(struct rt2x00_field16) {		\
167		__ffs(__mask), (__mask)		\
168	};					\
169})
170
171#define FIELD32(__mask)				\
172({						\
173	BUILD_BUG_ON(!(__mask) ||		\
174		     !is_valid_mask(__mask) ||	\
175		     (__mask) != (u32)(__mask));\
176	(struct rt2x00_field32) {		\
177		__ffs(__mask), (__mask)		\
178	};					\
179})
180
181static inline void rt2x00_set_field32(u32 *reg,
182				      const struct rt2x00_field32 field,
183				      const u32 value)
184{
185	*reg &= ~(field.bit_mask);
186	*reg |= (value << field.bit_offset) & field.bit_mask;
187}
188
189static inline u32 rt2x00_get_field32(const u32 reg,
190				     const struct rt2x00_field32 field)
191{
192	return (reg & field.bit_mask) >> field.bit_offset;
193}
194
195static inline void rt2x00_set_field16(u16 *reg,
196				      const struct rt2x00_field16 field,
197				      const u16 value)
198{
199	*reg &= ~(field.bit_mask);
200	*reg |= (value << field.bit_offset) & field.bit_mask;
201}
202
203static inline u16 rt2x00_get_field16(const u16 reg,
204				     const struct rt2x00_field16 field)
205{
206	return (reg & field.bit_mask) >> field.bit_offset;
207}
208
209static inline void rt2x00_set_field8(u8 *reg,
210				     const struct rt2x00_field8 field,
211				     const u8 value)
212{
213	*reg &= ~(field.bit_mask);
214	*reg |= (value << field.bit_offset) & field.bit_mask;
215}
216
217static inline u8 rt2x00_get_field8(const u8 reg,
218				   const struct rt2x00_field8 field)
219{
220	return (reg & field.bit_mask) >> field.bit_offset;
221}
222
223#endif /* RT2X00REG_H */
224