1 /******************************************************************************
3 * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of version 2 of the GNU General Public License as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
19 ******************************************************************************/
20 #ifndef __OSDEP_SERVICE_H_
21 #define __OSDEP_SERVICE_H_
23 #include <basic_types.h>
27 #define RTW_RX_HANDLED 2
29 #include <linux/spinlock.h>
30 #include <linux/compiler.h>
31 #include <linux/kernel.h>
32 #include <linux/errno.h>
33 #include <linux/slab.h>
34 #include <linux/module.h>
35 #include <linux/kref.h>
36 #include <linux/netdevice.h>
37 #include <linux/skbuff.h>
38 #include <linux/circ_buf.h>
39 #include <linux/uaccess.h>
40 #include <asm/byteorder.h>
41 #include <linux/atomic.h>
43 #include <linux/semaphore.h>
44 #include <linux/sem.h>
45 #include <linux/sched.h>
46 #include <linux/etherdevice.h>
47 #include <linux/wireless.h>
48 #include <net/iw_handler.h>
49 #include <linux/if_arp.h>
50 #include <linux/rtnetlink.h>
51 #include <linux/delay.h>
52 #include <linux/proc_fs.h> /* Necessary because we use the proc fs */
53 #include <linux/interrupt.h> /* for struct tasklet_struct */
55 #include <linux/kthread.h>
57 #include <linux/usb.h>
58 #include <linux/usb/ch9.h>
61 struct list_head queue
;
65 #define thread_exit() complete_and_exit(NULL, 0)
67 static inline struct list_head
*get_next(struct list_head
*list
)
72 static inline struct list_head
*get_list_head(struct __queue
*queue
)
74 return (&(queue
->queue
));
78 #define LIST_CONTAINOR(ptr, type, member) \
79 ((type *)((char *)(ptr)-(size_t)(&((type *)0)->member)))
82 static inline void _enter_critical(spinlock_t
*plock
, unsigned long *pirqL
)
84 spin_lock_irqsave(plock
, *pirqL
);
87 static inline void _exit_critical(spinlock_t
*plock
, unsigned long *pirqL
)
89 spin_unlock_irqrestore(plock
, *pirqL
);
92 static inline void _enter_critical_ex(spinlock_t
*plock
, unsigned long *pirqL
)
94 spin_lock_irqsave(plock
, *pirqL
);
97 static inline void _exit_critical_ex(spinlock_t
*plock
, unsigned long *pirqL
)
99 spin_unlock_irqrestore(plock
, *pirqL
);
102 static inline void _enter_critical_bh(spinlock_t
*plock
, unsigned long *pirqL
)
107 static inline void _exit_critical_bh(spinlock_t
*plock
, unsigned long *pirqL
)
109 spin_unlock_bh(plock
);
112 static inline int _enter_critical_mutex(struct mutex
*pmutex
, unsigned long *pirqL
)
116 ret
= mutex_lock_interruptible(pmutex
);
121 static inline void _exit_critical_mutex(struct mutex
*pmutex
, unsigned long *pirqL
)
123 mutex_unlock(pmutex
);
126 static inline void rtw_list_delete(struct list_head
*plist
)
128 list_del_init(plist
);
131 static inline void _init_timer(struct timer_list
*ptimer
,struct net_device
*nic_hdl
,void *pfunc
,void* cntx
)
133 ptimer
->function
= pfunc
;
134 ptimer
->data
= (unsigned long)cntx
;
138 static inline void _set_timer(struct timer_list
*ptimer
,u32 delay_time
)
140 mod_timer(ptimer
, (jiffies
+(delay_time
*HZ
/1000)));
143 static inline void _cancel_timer(struct timer_list
*ptimer
,u8
*bcancelled
)
145 del_timer_sync(ptimer
);
146 *bcancelled
= true;/* true ==1; false==0 */
149 #define RTW_TIMER_HDL_ARGS void *FunctionContext
150 #define RTW_TIMER_HDL_NAME(name) rtw_##name##_timer_hdl
151 #define RTW_DECLARE_TIMER_HDL(name) void RTW_TIMER_HDL_NAME(name)(RTW_TIMER_HDL_ARGS)
153 static inline void _init_workitem(struct work_struct
*pwork
, void *pfunc
, void * cntx
)
155 INIT_WORK(pwork
, pfunc
);
158 static inline void _set_workitem(struct work_struct
*pwork
)
160 schedule_work(pwork
);
163 static inline void _cancel_workitem_sync(struct work_struct
*pwork
)
165 cancel_work_sync(pwork
);
168 /* Global Mutex: can only be used at PASSIVE level. */
171 #define ACQUIRE_GLOBAL_MUTEX(_MutexCounter) \
173 while (atomic_inc_return((atomic_t *)&(_MutexCounter)) != 1)\
175 atomic_dec((atomic_t *)&(_MutexCounter)); \
180 #define RELEASE_GLOBAL_MUTEX(_MutexCounter) \
182 atomic_dec((atomic_t *)&(_MutexCounter)); \
185 static inline int rtw_netif_queue_stopped(struct net_device
*pnetdev
)
187 return netif_tx_queue_stopped(netdev_get_tx_queue(pnetdev
, 0)) &&
188 netif_tx_queue_stopped(netdev_get_tx_queue(pnetdev
, 1)) &&
189 netif_tx_queue_stopped(netdev_get_tx_queue(pnetdev
, 2)) &&
190 netif_tx_queue_stopped(netdev_get_tx_queue(pnetdev
, 3));
193 static inline void rtw_netif_wake_queue(struct net_device
*pnetdev
)
195 netif_tx_wake_all_queues(pnetdev
);
198 static inline void rtw_netif_start_queue(struct net_device
*pnetdev
)
200 netif_tx_start_all_queues(pnetdev
);
203 static inline void rtw_netif_stop_queue(struct net_device
*pnetdev
)
205 netif_tx_stop_all_queues(pnetdev
);
209 #define BIT(x) ( 1 << (x))
212 #define BIT0 0x00000001
213 #define BIT1 0x00000002
214 #define BIT2 0x00000004
215 #define BIT3 0x00000008
216 #define BIT4 0x00000010
217 #define BIT5 0x00000020
218 #define BIT6 0x00000040
219 #define BIT7 0x00000080
220 #define BIT8 0x00000100
221 #define BIT9 0x00000200
222 #define BIT10 0x00000400
223 #define BIT11 0x00000800
224 #define BIT12 0x00001000
225 #define BIT13 0x00002000
226 #define BIT14 0x00004000
227 #define BIT15 0x00008000
228 #define BIT16 0x00010000
229 #define BIT17 0x00020000
230 #define BIT18 0x00040000
231 #define BIT19 0x00080000
232 #define BIT20 0x00100000
233 #define BIT21 0x00200000
234 #define BIT22 0x00400000
235 #define BIT23 0x00800000
236 #define BIT24 0x01000000
237 #define BIT25 0x02000000
238 #define BIT26 0x04000000
239 #define BIT27 0x08000000
240 #define BIT28 0x10000000
241 #define BIT29 0x20000000
242 #define BIT30 0x40000000
243 #define BIT31 0x80000000
244 #define BIT32 0x0100000000
245 #define BIT33 0x0200000000
246 #define BIT34 0x0400000000
247 #define BIT35 0x0800000000
248 #define BIT36 0x1000000000
250 extern int RTW_STATUS_CODE(int error_code
);
252 /* flags used for rtw_update_mem_stat() */
254 MEM_STAT_VIR_ALLOC_SUCCESS
,
255 MEM_STAT_VIR_ALLOC_FAIL
,
257 MEM_STAT_PHY_ALLOC_SUCCESS
,
258 MEM_STAT_PHY_ALLOC_FAIL
,
260 MEM_STAT_TX
, /* used to distinguish TX/RX, asigned from caller */
261 MEM_STAT_TX_ALLOC_SUCCESS
,
262 MEM_STAT_TX_ALLOC_FAIL
,
264 MEM_STAT_RX
, /* used to distinguish TX/RX, asigned from caller */
265 MEM_STAT_RX_ALLOC_SUCCESS
,
266 MEM_STAT_RX_ALLOC_FAIL
,
270 extern unsigned char MCS_rate_2R
[16];
271 extern unsigned char MCS_rate_1R
[16];
272 extern unsigned char RTW_WPA_OUI
[];
273 extern unsigned char WPA_TKIP_CIPHER
[4];
274 extern unsigned char RSN_TKIP_CIPHER
[4];
276 #define rtw_update_mem_stat(flag, sz) do {} while (0)
277 u8
*_rtw_vmalloc(u32 sz
);
278 u8
*_rtw_zvmalloc(u32 sz
);
279 void _rtw_vmfree(u8
*pbuf
, u32 sz
);
280 u8
*_rtw_zmalloc(u32 sz
);
281 u8
*_rtw_malloc(u32 sz
);
282 void _rtw_mfree(u8
*pbuf
, u32 sz
);
283 #define rtw_vmalloc(sz) _rtw_vmalloc((sz))
284 #define rtw_zvmalloc(sz) _rtw_zvmalloc((sz))
285 #define rtw_vmfree(pbuf, sz) _rtw_vmfree((pbuf), (sz))
286 #define rtw_malloc(sz) _rtw_malloc((sz))
287 #define rtw_zmalloc(sz) _rtw_zmalloc((sz))
288 #define rtw_mfree(pbuf, sz) _rtw_mfree((pbuf), (sz))
290 void *rtw_malloc2d(int h
, int w
, int size
);
291 void rtw_mfree2d(void *pbuf
, int h
, int w
, int size
);
293 void _rtw_memcpy(void *dec
, void *sour
, u32 sz
);
294 int _rtw_memcmp(void *dst
, void *src
, u32 sz
);
295 void _rtw_memset(void *pbuf
, int c
, u32 sz
);
297 void _rtw_init_listhead(struct list_head
*list
);
298 u32
rtw_is_list_empty(struct list_head
*phead
);
299 void rtw_list_insert_head(struct list_head
*plist
, struct list_head
*phead
);
300 void rtw_list_insert_tail(struct list_head
*plist
, struct list_head
*phead
);
301 void rtw_list_delete(struct list_head
*plist
);
303 void _rtw_init_sema(struct semaphore
*sema
, int init_val
);
304 void _rtw_free_sema(struct semaphore
*sema
);
305 void _rtw_up_sema(struct semaphore
*sema
);
306 u32
_rtw_down_sema(struct semaphore
*sema
);
307 void _rtw_mutex_init(struct mutex
*pmutex
);
308 void _rtw_mutex_free(struct mutex
*pmutex
);
309 void _rtw_spinlock_init(spinlock_t
*plock
);
310 void _rtw_spinlock_free(spinlock_t
*plock
);
312 void _rtw_init_queue(struct __queue
*pqueue
);
313 u32
_rtw_queue_empty(struct __queue
*pqueue
);
314 u32
rtw_end_of_queue_search(struct list_head
*queue
, struct list_head
*pelement
);
316 u32
rtw_get_current_time(void);
317 u32
rtw_systime_to_ms(u32 systime
);
318 u32
rtw_ms_to_systime(u32 ms
);
319 s32
rtw_get_passing_time_ms(u32 start
);
320 s32
rtw_get_time_interval_ms(u32 start
, u32 end
);
322 void rtw_sleep_schedulable(int ms
);
324 void rtw_msleep_os(int ms
);
325 void rtw_usleep_os(int us
);
329 void rtw_mdelay_os(int ms
);
330 void rtw_udelay_os(int us
);
332 void rtw_yield_os(void);
334 static inline unsigned char _cancel_timer_ex(struct timer_list
*ptimer
)
336 return del_timer_sync(ptimer
);
339 static __inline
void thread_enter(char *name
)
342 daemonize("%s", name
);
344 allow_signal(SIGTERM
);
347 static inline void flush_signals_thread(void)
349 if (signal_pending (current
))
350 flush_signals(current
);
353 static inline int res_to_status(int res
)
358 #define _RND(sz, r) ((((sz)+((r)-1))/(r))*(r))
359 #define RND4(x) (((x >> 2) + (((x & 3) == 0) ? 0: 1)) << 2)
361 static inline u32
_RND4(u32 sz
)
365 val
= ((sz
>> 2) + ((sz
& 3) ? 1: 0)) << 2;
369 static inline u32
_RND8(u32 sz
)
373 val
= ((sz
>> 3) + ((sz
& 7) ? 1: 0)) << 3;
377 static inline u32
_RND128(u32 sz
)
381 val
= ((sz
>> 7) + ((sz
& 127) ? 1: 0)) << 7;
385 static inline u32
_RND256(u32 sz
)
389 val
= ((sz
>> 8) + ((sz
& 255) ? 1: 0)) << 8;
393 static inline u32
_RND512(u32 sz
)
397 val
= ((sz
>> 9) + ((sz
& 511) ? 1: 0)) << 9;
401 static inline u32
bitshift(u32 bitmask
)
405 for (i
= 0; i
<= 31; i
++)
406 if (((bitmask
>>i
) & 0x1) == 1) break;
410 /* limitation of path length */
411 #define PATH_LENGTH_MAX PATH_MAX
413 void rtw_suspend_lock_init(void);
414 void rtw_suspend_lock_uninit(void);
415 void rtw_lock_suspend(void);
416 void rtw_unlock_suspend(void);
418 /* Atomic integer operations */
419 #define ATOMIC_T atomic_t
421 void ATOMIC_SET(ATOMIC_T
*v
, int i
);
422 int ATOMIC_READ(ATOMIC_T
*v
);
423 void ATOMIC_ADD(ATOMIC_T
*v
, int i
);
424 void ATOMIC_SUB(ATOMIC_T
*v
, int i
);
425 void ATOMIC_INC(ATOMIC_T
*v
);
426 void ATOMIC_DEC(ATOMIC_T
*v
);
427 int ATOMIC_ADD_RETURN(ATOMIC_T
*v
, int i
);
428 int ATOMIC_SUB_RETURN(ATOMIC_T
*v
, int i
);
429 int ATOMIC_INC_RETURN(ATOMIC_T
*v
);
430 int ATOMIC_DEC_RETURN(ATOMIC_T
*v
);
432 struct rtw_netdev_priv_indicator
{
436 struct net_device
*rtw_alloc_etherdev_with_old_priv(int sizeof_priv
,
438 struct net_device
*rtw_alloc_etherdev(int sizeof_priv
);
440 #define rtw_netdev_priv(netdev) \
441 (((struct rtw_netdev_priv_indicator *)netdev_priv(netdev))->priv)
442 void rtw_free_netdev(struct net_device
*netdev
);
444 #define NDEV_FMT "%s"
445 #define NDEV_ARG(ndev) ndev->name
446 #define ADPT_FMT "%s"
447 #define ADPT_ARG(adapter) adapter->pnetdev->name
448 #define FUNC_NDEV_FMT "%s(%s)"
449 #define FUNC_NDEV_ARG(ndev) __func__, ndev->name
450 #define FUNC_ADPT_FMT "%s(%s)"
451 #define FUNC_ADPT_ARG(adapter) __func__, adapter->pnetdev->name
453 #define rtw_signal_process(pid, sig) kill_pid(find_vpid((pid)),(sig), 1)
455 u64
rtw_modular64(u64 x
, u64 y
);
456 u64
rtw_division64(u64 x
, u64 y
);
458 /* Macros for handling unaligned memory accesses */
460 #define RTW_GET_BE16(a) ((u16) (((a)[0] << 8) | (a)[1]))
461 #define RTW_PUT_BE16(a, val) \
463 (a)[0] = ((u16) (val)) >> 8; \
464 (a)[1] = ((u16) (val)) & 0xff; \
467 #define RTW_GET_LE16(a) ((u16) (((a)[1] << 8) | (a)[0]))
468 #define RTW_PUT_LE16(a, val) \
470 (a)[1] = ((u16) (val)) >> 8; \
471 (a)[0] = ((u16) (val)) & 0xff; \
474 #define RTW_GET_BE24(a) ((((u32) (a)[0]) << 16) | (((u32) (a)[1]) << 8) | \
476 #define RTW_PUT_BE24(a, val) \
478 (a)[0] = (u8) ((((u32) (val)) >> 16) & 0xff); \
479 (a)[1] = (u8) ((((u32) (val)) >> 8) & 0xff); \
480 (a)[2] = (u8) (((u32) (val)) & 0xff); \
483 #define RTW_GET_BE32(a) ((((u32) (a)[0]) << 24) | (((u32) (a)[1]) << 16) | \
484 (((u32) (a)[2]) << 8) | ((u32) (a)[3]))
485 #define RTW_PUT_BE32(a, val) \
487 (a)[0] = (u8) ((((u32) (val)) >> 24) & 0xff); \
488 (a)[1] = (u8) ((((u32) (val)) >> 16) & 0xff); \
489 (a)[2] = (u8) ((((u32) (val)) >> 8) & 0xff); \
490 (a)[3] = (u8) (((u32) (val)) & 0xff); \
493 #define RTW_GET_LE32(a) ((((u32) (a)[3]) << 24) | (((u32) (a)[2]) << 16) | \
494 (((u32) (a)[1]) << 8) | ((u32) (a)[0]))
495 #define RTW_PUT_LE32(a, val) \
497 (a)[3] = (u8) ((((u32) (val)) >> 24) & 0xff); \
498 (a)[2] = (u8) ((((u32) (val)) >> 16) & 0xff); \
499 (a)[1] = (u8) ((((u32) (val)) >> 8) & 0xff); \
500 (a)[0] = (u8) (((u32) (val)) & 0xff); \
503 #define RTW_GET_BE64(a) ((((u64) (a)[0]) << 56) | (((u64) (a)[1]) << 48) | \
504 (((u64) (a)[2]) << 40) | (((u64) (a)[3]) << 32) | \
505 (((u64) (a)[4]) << 24) | (((u64) (a)[5]) << 16) | \
506 (((u64) (a)[6]) << 8) | ((u64) (a)[7]))
507 #define RTW_PUT_BE64(a, val) \
509 (a)[0] = (u8) (((u64) (val)) >> 56); \
510 (a)[1] = (u8) (((u64) (val)) >> 48); \
511 (a)[2] = (u8) (((u64) (val)) >> 40); \
512 (a)[3] = (u8) (((u64) (val)) >> 32); \
513 (a)[4] = (u8) (((u64) (val)) >> 24); \
514 (a)[5] = (u8) (((u64) (val)) >> 16); \
515 (a)[6] = (u8) (((u64) (val)) >> 8); \
516 (a)[7] = (u8) (((u64) (val)) & 0xff); \
519 #define RTW_GET_LE64(a) ((((u64) (a)[7]) << 56) | (((u64) (a)[6]) << 48) | \
520 (((u64) (a)[5]) << 40) | (((u64) (a)[4]) << 32) | \
521 (((u64) (a)[3]) << 24) | (((u64) (a)[2]) << 16) | \
522 (((u64) (a)[1]) << 8) | ((u64) (a)[0]))
524 void rtw_buf_free(u8
**buf
, u32
*buf_len
);
525 void rtw_buf_update(u8
**buf
, u32
*buf_len
, u8
*src
, u32 src_len
);
534 bool rtw_cbuf_full(struct rtw_cbuf
*cbuf
);
535 bool rtw_cbuf_empty(struct rtw_cbuf
*cbuf
);
536 bool rtw_cbuf_push(struct rtw_cbuf
*cbuf
, void *buf
);
537 void *rtw_cbuf_pop(struct rtw_cbuf
*cbuf
);
538 struct rtw_cbuf
*rtw_cbuf_alloc(u32 size
);
539 int wifirate2_ratetbl_inx(unsigned char rate
);