1 /******************************************************************************
3 * Copyright(c) 2003 - 2008 Intel Corporation. All rights reserved.
5 * Portions of this file are derived from the ipw3945 project.
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of version 2 of the GNU General Public License as
9 * published by the Free Software Foundation.
11 * This program is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * You should have received a copy of the GNU General Public License along with
17 * this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
20 * The full GNU General Public License is included in this distribution in the
21 * file called LICENSE.
23 * Contact Information:
24 * James P. Ketrenos <ipw2100-admin@linux.intel.com>
25 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
27 *****************************************************************************/
29 #ifndef __iwl3945_io_h__
30 #define __iwl3945_io_h__
34 #include "iwl-3945-debug.h"
37 * IO, register, and NIC memory access functions
39 * NOTE on naming convention and macro usage for these
41 * A single _ prefix before a an access function means that no state
42 * check or debug information is printed when that function is called.
44 * A double __ prefix before an access function means that state is checked
45 * and the current line number is printed in addition to any other debug output.
47 * The non-prefixed name is the #define that maps the caller into a
48 * #define that provides the caller's __LINE__ to the double prefix version.
50 * If you wish to call the function without any debug or state checking,
51 * you should use the single _ prefix version (as is used by dependent IO
52 * routines, for example _iwl3945_read_direct32 calls the non-check version of
55 * These declarations are *extremely* useful in quickly isolating code deltas
56 * which result in misconfiguring of the hardware I/O. In combination with
57 * git-bisect and the IO debug level you can quickly determine the specific
58 * commit which breaks the IO sequence to the hardware.
62 #define _iwl3945_write32(priv, ofs, val) writel((val), (priv)->hw_base + (ofs))
63 #ifdef CONFIG_IWL3945_DEBUG
64 static inline void __iwl3945_write32(const char *f, u32 l, struct iwl3945_priv *priv,
67 IWL_DEBUG_IO("write32(0x%08X, 0x%08X) - %s %d\n", ofs, val, f, l);
68 _iwl3945_write32(priv, ofs, val);
70 #define iwl3945_write32(priv, ofs, val) \
71 __iwl3945_write32(__FILE__, __LINE__, priv, ofs, val)
73 #define iwl3945_write32(priv, ofs, val) _iwl3945_write32(priv, ofs, val)
76 #define _iwl3945_read32(priv, ofs) readl((priv)->hw_base + (ofs))
77 #ifdef CONFIG_IWL3945_DEBUG
78 static inline u32 __iwl3945_read32(char *f, u32 l, struct iwl3945_priv *priv, u32 ofs)
80 IWL_DEBUG_IO("read_direct32(0x%08X) - %s %d\n", ofs, f, l);
81 return _iwl3945_read32(priv, ofs);
83 #define iwl3945_read32(priv, ofs) __iwl3945_read32(__FILE__, __LINE__, priv, ofs)
85 #define iwl3945_read32(p, o) _iwl3945_read32(p, o)
88 static inline int _iwl3945_poll_bit(struct iwl3945_priv *priv, u32 addr,
89 u32 bits, u32 mask, int timeout)
94 if ((_iwl3945_read32(priv, addr) & mask) == (bits & mask))
98 } while (i < timeout);
102 #ifdef CONFIG_IWL3945_DEBUG
103 static inline int __iwl3945_poll_bit(const char *f, u32 l,
104 struct iwl3945_priv *priv, u32 addr,
105 u32 bits, u32 mask, int timeout)
107 int ret = _iwl3945_poll_bit(priv, addr, bits, mask, timeout);
108 IWL_DEBUG_IO("poll_bit(0x%08X, 0x%08X, 0x%08X) - %s- %s %d\n",
110 unlikely(ret == -ETIMEDOUT)?"timeout":"", f, l);
113 #define iwl3945_poll_bit(priv, addr, bits, mask, timeout) \
114 __iwl3945_poll_bit(__FILE__, __LINE__, priv, addr, bits, mask, timeout)
116 #define iwl3945_poll_bit(p, a, b, m, t) _iwl3945_poll_bit(p, a, b, m, t)
119 static inline void _iwl3945_set_bit(struct iwl3945_priv *priv, u32 reg, u32 mask)
121 _iwl3945_write32(priv, reg, _iwl3945_read32(priv, reg) | mask);
123 #ifdef CONFIG_IWL3945_DEBUG
124 static inline void __iwl3945_set_bit(const char *f, u32 l,
125 struct iwl3945_priv *priv, u32 reg, u32 mask)
127 u32 val = _iwl3945_read32(priv, reg) | mask;
128 IWL_DEBUG_IO("set_bit(0x%08X, 0x%08X) = 0x%08X\n", reg, mask, val);
129 _iwl3945_write32(priv, reg, val);
131 #define iwl3945_set_bit(p, r, m) __iwl3945_set_bit(__FILE__, __LINE__, p, r, m)
133 #define iwl3945_set_bit(p, r, m) _iwl3945_set_bit(p, r, m)
136 static inline void _iwl3945_clear_bit(struct iwl3945_priv *priv, u32 reg, u32 mask)
138 _iwl3945_write32(priv, reg, _iwl3945_read32(priv, reg) & ~mask);
140 #ifdef CONFIG_IWL3945_DEBUG
141 static inline void __iwl3945_clear_bit(const char *f, u32 l,
142 struct iwl3945_priv *priv, u32 reg, u32 mask)
144 u32 val = _iwl3945_read32(priv, reg) & ~mask;
145 IWL_DEBUG_IO("clear_bit(0x%08X, 0x%08X) = 0x%08X\n", reg, mask, val);
146 _iwl3945_write32(priv, reg, val);
148 #define iwl3945_clear_bit(p, r, m) __iwl3945_clear_bit(__FILE__, __LINE__, p, r, m)
150 #define iwl3945_clear_bit(p, r, m) _iwl3945_clear_bit(p, r, m)
153 static inline int _iwl3945_grab_nic_access(struct iwl3945_priv *priv)
158 #ifdef CONFIG_IWL3945_DEBUG
159 if (atomic_read(&priv->restrict_refcnt))
162 if (test_bit(STATUS_RF_KILL_HW, &priv->status) ||
163 test_bit(STATUS_RF_KILL_SW, &priv->status)) {
164 IWL_WARNING("WARNING: Requesting MAC access during RFKILL "
167 /* 10 msec allows time for NIC to complete its data save */
168 gp_ctl = _iwl3945_read32(priv, CSR_GP_CNTRL);
169 if (gp_ctl & CSR_GP_CNTRL_REG_FLAG_MAC_CLOCK_READY) {
170 IWL_DEBUG_RF_KILL("Wait for complete power-down, "
171 "gpctl = 0x%08x\n", gp_ctl);
174 IWL_DEBUG_RF_KILL("power-down complete, "
175 "gpctl = 0x%08x\n", gp_ctl);
178 /* this bit wakes up the NIC */
179 _iwl3945_set_bit(priv, CSR_GP_CNTRL, CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ);
180 ret = _iwl3945_poll_bit(priv, CSR_GP_CNTRL,
181 CSR_GP_CNTRL_REG_VAL_MAC_ACCESS_EN,
182 (CSR_GP_CNTRL_REG_FLAG_MAC_CLOCK_READY |
183 CSR_GP_CNTRL_REG_FLAG_GOING_TO_SLEEP), 50);
185 IWL_ERROR("MAC is in deep sleep!\n");
189 #ifdef CONFIG_IWL3945_DEBUG
190 atomic_inc(&priv->restrict_refcnt);
195 #ifdef CONFIG_IWL3945_DEBUG
196 static inline int __iwl3945_grab_nic_access(const char *f, u32 l,
197 struct iwl3945_priv *priv)
199 if (atomic_read(&priv->restrict_refcnt))
200 IWL_DEBUG_INFO("Grabbing access while already held at "
203 IWL_DEBUG_IO("grabbing nic access - %s %d\n", f, l);
204 return _iwl3945_grab_nic_access(priv);
206 #define iwl3945_grab_nic_access(priv) \
207 __iwl3945_grab_nic_access(__FILE__, __LINE__, priv)
209 #define iwl3945_grab_nic_access(priv) \
210 _iwl3945_grab_nic_access(priv)
213 static inline void _iwl3945_release_nic_access(struct iwl3945_priv *priv)
215 #ifdef CONFIG_IWL3945_DEBUG
216 if (atomic_dec_and_test(&priv->restrict_refcnt))
218 _iwl3945_clear_bit(priv, CSR_GP_CNTRL,
219 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ);
221 #ifdef CONFIG_IWL3945_DEBUG
222 static inline void __iwl3945_release_nic_access(const char *f, u32 l,
223 struct iwl3945_priv *priv)
225 if (atomic_read(&priv->restrict_refcnt) <= 0)
226 IWL_ERROR("Release unheld nic access at line %d.\n", l);
228 IWL_DEBUG_IO("releasing nic access - %s %d\n", f, l);
229 _iwl3945_release_nic_access(priv);
231 #define iwl3945_release_nic_access(priv) \
232 __iwl3945_release_nic_access(__FILE__, __LINE__, priv)
234 #define iwl3945_release_nic_access(priv) \
235 _iwl3945_release_nic_access(priv)
238 static inline u32 _iwl3945_read_direct32(struct iwl3945_priv *priv, u32 reg)
240 return _iwl3945_read32(priv, reg);
242 #ifdef CONFIG_IWL3945_DEBUG
243 static inline u32 __iwl3945_read_direct32(const char *f, u32 l,
244 struct iwl3945_priv *priv, u32 reg)
246 u32 value = _iwl3945_read_direct32(priv, reg);
247 if (!atomic_read(&priv->restrict_refcnt))
248 IWL_ERROR("Nic access not held from %s %d\n", f, l);
249 IWL_DEBUG_IO("read_direct32(0x%4X) = 0x%08x - %s %d \n", reg, value,
253 #define iwl3945_read_direct32(priv, reg) \
254 __iwl3945_read_direct32(__FILE__, __LINE__, priv, reg)
256 #define iwl3945_read_direct32 _iwl3945_read_direct32
259 static inline void _iwl3945_write_direct32(struct iwl3945_priv *priv,
262 _iwl3945_write32(priv, reg, value);
264 #ifdef CONFIG_IWL3945_DEBUG
265 static void __iwl3945_write_direct32(u32 line,
266 struct iwl3945_priv *priv, u32 reg, u32 value)
268 if (!atomic_read(&priv->restrict_refcnt))
269 IWL_ERROR("Nic access not held from line %d\n", line);
270 _iwl3945_write_direct32(priv, reg, value);
272 #define iwl3945_write_direct32(priv, reg, value) \
273 __iwl3945_write_direct32(__LINE__, priv, reg, value)
275 #define iwl3945_write_direct32 _iwl3945_write_direct32
278 static inline void iwl3945_write_reg_buf(struct iwl3945_priv *priv,
279 u32 reg, u32 len, u32 *values)
281 u32 count = sizeof(u32);
283 if ((priv != NULL) && (values != NULL)) {
284 for (; 0 < len; len -= count, reg += count, values++)
285 _iwl3945_write_direct32(priv, reg, *values);
289 static inline int _iwl3945_poll_direct_bit(struct iwl3945_priv *priv,
290 u32 addr, u32 mask, int timeout)
295 if ((_iwl3945_read_direct32(priv, addr) & mask) == mask)
299 } while (i < timeout);
304 #ifdef CONFIG_IWL3945_DEBUG
305 static inline int __iwl3945_poll_direct_bit(const char *f, u32 l,
306 struct iwl3945_priv *priv,
307 u32 addr, u32 mask, int timeout)
309 int ret = _iwl3945_poll_direct_bit(priv, addr, mask, timeout);
311 if (unlikely(ret == -ETIMEDOUT))
312 IWL_DEBUG_IO("poll_direct_bit(0x%08X, 0x%08X) - "
313 "timedout - %s %d\n", addr, mask, f, l);
315 IWL_DEBUG_IO("poll_direct_bit(0x%08X, 0x%08X) = 0x%08X "
316 "- %s %d\n", addr, mask, ret, f, l);
319 #define iwl3945_poll_direct_bit(priv, addr, mask, timeout) \
320 __iwl3945_poll_direct_bit(__FILE__, __LINE__, priv, addr, mask, timeout)
322 #define iwl3945_poll_direct_bit _iwl3945_poll_direct_bit
325 static inline u32 _iwl3945_read_prph(struct iwl3945_priv *priv, u32 reg)
327 _iwl3945_write_direct32(priv, HBUS_TARG_PRPH_RADDR, reg | (3 << 24));
328 return _iwl3945_read_direct32(priv, HBUS_TARG_PRPH_RDAT);
330 #ifdef CONFIG_IWL3945_DEBUG
331 static inline u32 __iwl3945_read_prph(u32 line, struct iwl3945_priv *priv, u32 reg)
333 if (!atomic_read(&priv->restrict_refcnt))
334 IWL_ERROR("Nic access not held from line %d\n", line);
335 return _iwl3945_read_prph(priv, reg);
338 #define iwl3945_read_prph(priv, reg) \
339 __iwl3945_read_prph(__LINE__, priv, reg)
341 #define iwl3945_read_prph _iwl3945_read_prph
344 static inline void _iwl3945_write_prph(struct iwl3945_priv *priv,
347 _iwl3945_write_direct32(priv, HBUS_TARG_PRPH_WADDR,
348 ((addr & 0x0000FFFF) | (3 << 24)));
349 _iwl3945_write_direct32(priv, HBUS_TARG_PRPH_WDAT, val);
351 #ifdef CONFIG_IWL3945_DEBUG
352 static inline void __iwl3945_write_prph(u32 line, struct iwl3945_priv *priv,
355 if (!atomic_read(&priv->restrict_refcnt))
356 IWL_ERROR("Nic access from line %d\n", line);
357 _iwl3945_write_prph(priv, addr, val);
360 #define iwl3945_write_prph(priv, addr, val) \
361 __iwl3945_write_prph(__LINE__, priv, addr, val);
363 #define iwl3945_write_prph _iwl3945_write_prph
366 #define _iwl3945_set_bits_prph(priv, reg, mask) \
367 _iwl3945_write_prph(priv, reg, (_iwl3945_read_prph(priv, reg) | mask))
368 #ifdef CONFIG_IWL3945_DEBUG
369 static inline void __iwl3945_set_bits_prph(u32 line, struct iwl3945_priv *priv,
372 if (!atomic_read(&priv->restrict_refcnt))
373 IWL_ERROR("Nic access not held from line %d\n", line);
375 _iwl3945_set_bits_prph(priv, reg, mask);
377 #define iwl3945_set_bits_prph(priv, reg, mask) \
378 __iwl3945_set_bits_prph(__LINE__, priv, reg, mask)
380 #define iwl3945_set_bits_prph _iwl3945_set_bits_prph
383 #define _iwl3945_set_bits_mask_prph(priv, reg, bits, mask) \
384 _iwl3945_write_prph(priv, reg, ((_iwl3945_read_prph(priv, reg) & mask) | bits))
386 #ifdef CONFIG_IWL3945_DEBUG
387 static inline void __iwl3945_set_bits_mask_prph(u32 line,
388 struct iwl3945_priv *priv, u32 reg, u32 bits, u32 mask)
390 if (!atomic_read(&priv->restrict_refcnt))
391 IWL_ERROR("Nic access not held from line %d\n", line);
392 _iwl3945_set_bits_mask_prph(priv, reg, bits, mask);
394 #define iwl3945_set_bits_mask_prph(priv, reg, bits, mask) \
395 __iwl3945_set_bits_mask_prph(__LINE__, priv, reg, bits, mask)
397 #define iwl3945_set_bits_mask_prph _iwl3945_set_bits_mask_prph
400 static inline void iwl3945_clear_bits_prph(struct iwl3945_priv
401 *priv, u32 reg, u32 mask)
403 u32 val = _iwl3945_read_prph(priv, reg);
404 _iwl3945_write_prph(priv, reg, (val & ~mask));
407 static inline u32 iwl3945_read_targ_mem(struct iwl3945_priv *priv, u32 addr)
409 iwl3945_write_direct32(priv, HBUS_TARG_MEM_RADDR, addr);
410 return iwl3945_read_direct32(priv, HBUS_TARG_MEM_RDAT);
413 static inline void iwl3945_write_targ_mem(struct iwl3945_priv *priv, u32 addr, u32 val)
415 iwl3945_write_direct32(priv, HBUS_TARG_MEM_WADDR, addr);
416 iwl3945_write_direct32(priv, HBUS_TARG_MEM_WDAT, val);
419 static inline void iwl3945_write_targ_mem_buf(struct iwl3945_priv *priv, u32 addr,
420 u32 len, u32 *values)
422 iwl3945_write_direct32(priv, HBUS_TARG_MEM_WADDR, addr);
423 for (; 0 < len; len -= sizeof(u32), values++)
424 iwl3945_write_direct32(priv, HBUS_TARG_MEM_WDAT, *values);