1 /*-
2  * Copyright (c) 2002-2008 Sam Leffler, Errno Consulting
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer,
10  *    without modification.
11  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12  *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13  *    redistribution must be conditioned upon including a substantially
14  *    similar Disclaimer requirement for further binary redistribution.
15  *
16  * NO WARRANTY
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19  * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21  * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27  * THE POSSIBILITY OF SUCH DAMAGES.
28  *
29  * $Id: ah_osdep.h,v 1.2 2011/07/17 20:54:51 joerg Exp $
30  */
31 
32 #ifndef _ATH_AH_OSDEP_H_
33 #define _ATH_AH_OSDEP_H_
34 /*
35  * Atheros Hardware Access Layer (HAL) OS Dependent Definitions.
36  */
37 #include <sys/param.h>
38 #include <sys/systm.h>
39 #include <sys/endian.h>
40 #include <sys/bus.h>
41 
42 /*
43  * Delay n microseconds.
44  */
45 extern    void ath_hal_delay(int);
46 #define   OS_DELAY(_n)        ath_hal_delay(_n)
47 
48 #define   OS_INLINE __inline
49 #define   OS_MEMZERO(_a, _n)  ath_hal_memzero((_a), (_n))
50 extern void ath_hal_memzero(void *, size_t);
51 #define   OS_MEMCPY(_d, _s, _n)         ath_hal_memcpy(_d,_s,_n)
52 extern void *ath_hal_memcpy(void *, const void *, size_t);
53 
54 #define   abs(_a)             __builtin_abs(_a)
55 
56 struct ath_hal;
57 extern    u_int32_t ath_hal_getuptime(struct ath_hal *);
58 #define   OS_GETUPTIME(_ah)   ath_hal_getuptime(_ah)
59 
60 /*
61  * WiSoC boards overload the bus tag with information about the
62  * board layout.  We must extract the bus space tag from that
63  * indirect structure.  For everyone else the tag is passed in
64  * directly.
65  * XXX cache indirect ref privately
66  */
67 #ifdef AH_SUPPORT_AR5312
68 #define   BUSTAG(ah) \
69           ((bus_space_tag_t) ((struct ar531x_config *)((ah)->ah_st))->tag)
70 #define   BUSHANDLE(ah)       ((bus_space_handle_t)((ah)->ah_sh))
71 
72 #elif defined(AH_REGOPS_FUNC)
73 #define   BUSTAG(ah)          (*(bus_space_tag_t *) (ah)->ah_st)
74 #define   BUSHANDLE(ah)       (*(bus_space_handle_t *)((ah)->ah_sh))
75 #define   HALTAG(t) (HAL_BUS_TAG) &(t)
76 #define   HALHANDLE(h)        (HAL_BUS_HANDLE) &(h)
77 #else
78 #define   BUSTAG(ah)          ((bus_space_tag_t) (ah)->ah_st)
79 #define   BUSHANDLE(ah)       ((bus_space_handle_t) ((ah)->ah_sh))
80 #define   HALTAG(t) (HAL_BUS_TAG) (t)
81 #define   HALHANDLE(h)        (HAL_BUS_HANDLE) (h)
82 #endif
83 
84 /*
85  * Register read/write; we assume the registers will always
86  * be memory-mapped.  Note that register accesses are done
87  * using target-specific functions when debugging is enabled
88  * (ATHHAL_DEBUG) or we are explicitly configured this way.  The
89  * latter is used on some platforms where the full i/o space
90  * cannot be directly mapped.
91  */
92 #if defined(ATHHAL_DEBUG) || defined(AH_REGOPS_FUNC) || defined(ATHHAL_DEBUG_ALQ)
93 #define   OS_REG_WRITE(_ah, _reg, _val) ath_hal_reg_write(_ah, _reg, _val)
94 #define   OS_REG_READ(_ah, _reg)                  ath_hal_reg_read(_ah, _reg)
95 
96 extern    void ath_hal_reg_write(struct ath_hal *ah, u_int reg, u_int32_t val);
97 extern    u_int32_t ath_hal_reg_read(struct ath_hal *ah, u_int reg);
98 #else
99 /*
100  * The hardware registers are native little-endian byte order.
101  * Big-endian hosts are handled by enabling hardware byte-swap
102  * of register reads and writes at reset.  But the PCI clock
103  * domain registers are not byte swapped!  Thus, on big-endian
104  * platforms we have to byte-swap thoese registers specifically.
105  * Most of this code is collapsed at compile time because the
106  * register values are constants.
107  */
108 #define   AH_LITTLE_ENDIAN    1234
109 #define   AH_BIG_ENDIAN                 4321
110 
111 #if _BYTE_ORDER == _BIG_ENDIAN
112 #define OS_REG_WRITE(_ah, _reg, _val) do {                                      \
113           if ( (_reg) >= 0x4000 && (_reg) < 0x5000)                             \
114                     bus_space_write_4((_ah)->ah_st, (_ah)->ah_sh,               \
115                               (_reg), (_val));                                  \
116           else                                                                            \
117                     bus_space_write_stream_4((_ah)->ah_st, (_ah)->ah_sh,        \
118                               (_reg), (_val));                                  \
119 } while (0)
120 #define OS_REG_READ(_ah, _reg)                                                            \
121           (((_reg) >= 0x4000 && (_reg) < 0x5000) ?                              \
122                     bus_space_read_4((_ah)->ah_st, (_ah)->ah_sh, (_reg)) :      \
123                     bus_space_read_stream_4((_ah)->ah_st, (_ah)->ah_sh, (_reg)))
124 #else /* _BYTE_ORDER == _LITTLE_ENDIAN */
125 #define   OS_REG_WRITE(_ah, _reg, _val)                                         \
126           bus_space_write_4((_ah)->ah_st, (_ah)->ah_sh, (_reg), (_val))
127 #define   OS_REG_READ(_ah, _reg)                                                          \
128           ((u_int32_t) bus_space_read_4((_ah)->ah_st, (_ah)->ah_sh, (_reg)))
129 #endif /* _BYTE_ORDER */
130 #endif /* ATHHAL_DEBUG || AH_REGFUNC || ATHHAL_DEBUG_ALQ */
131 
132 #ifdef ATHHAL_DEBUG_ALQ
133 extern    void OS_MARK(struct ath_hal *, u_int id, u_int32_t value);
134 #else
135 #define   OS_MARK(_ah, _id, _v)
136 #endif
137 
138 typedef void *      HAL_SOFTC;                    /* pointer to driver/OS state */
139 typedef bus_space_tag_t                 HAL_BUS_TAG;        /* opaque bus i/o id tag */
140 typedef bus_space_handle_t    HAL_BUS_HANDLE;     /* opaque bus i/o handle */
141 
142 #define OS_SET_DECLARE(set, ptype)      __link_set_decl(set, ptype)
143 #define OS_DATA_SET(set, sym)           __link_set_add_rodata(set, sym)
144 #define OS_SET_FOREACH(pvar, set)       __link_set_foreach(pvar, set)
145 
146 #define __bswap16(x)                              bswap16(x)
147 #define __bswap32(x)                              bswap32(x)
148 
149 #endif /* _ATH_AH_OSDEP_H_ */
150