0124ed142206cd08a2b7a7d39ef78c31790b4d6b
[firefly-linux-kernel-4.4.55.git] / drivers / net / wireless / rockchip_wlan / rtl8188eu / include / rtw_recv.h
1 /******************************************************************************
2  *
3  * Copyright(c) 2007 - 2012 Realtek Corporation. All rights reserved.
4  *
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.
8  *
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
12  * more details.
13  *
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
17  *
18  *
19  ******************************************************************************/
20 #ifndef _RTW_RECV_H_
21 #define _RTW_RECV_H_
22
23 #ifdef PLATFORM_OS_XP
24         #ifdef CONFIG_SDIO_HCI
25                 #define NR_RECVBUFF 1024//512//128
26         #else
27                 #define NR_RECVBUFF (16)
28         #endif
29 #elif defined(PLATFORM_OS_CE)
30         #ifdef CONFIG_SDIO_HCI
31                 #define NR_RECVBUFF (128)
32         #else
33                 #define NR_RECVBUFF (4)
34         #endif
35 #else //PLATFORM_LINUX /PLATFORM_BSD
36
37         #ifdef CONFIG_SINGLE_RECV_BUF
38                 #define NR_RECVBUFF (1)
39         #else
40                 #if defined(CONFIG_GSPI_HCI)
41                         #define NR_RECVBUFF (32)
42                 #elif defined(CONFIG_SDIO_HCI)
43                         #define NR_RECVBUFF (8) 
44                 #else
45                         #define NR_RECVBUFF (8)
46                 #endif  
47         #endif //CONFIG_SINGLE_RECV_BUF
48
49         #define NR_PREALLOC_RECV_SKB (8)        
50 #endif
51
52 #define NR_RECVFRAME 256
53
54 #define RXFRAME_ALIGN   8
55 #define RXFRAME_ALIGN_SZ        (1<<RXFRAME_ALIGN)
56
57 #define DRVINFO_SZ      4 // unit is 8bytes
58
59 #define MAX_RXFRAME_CNT 512
60 #define MAX_RX_NUMBLKS          (32)
61 #define RECVFRAME_HDR_ALIGN 128
62
63
64 #define PHY_RSSI_SLID_WIN_MAX                           100
65 #define PHY_LINKQUALITY_SLID_WIN_MAX            20
66
67
68 #define SNAP_SIZE sizeof(struct ieee80211_snap_hdr)
69
70 #define RX_MPDU_QUEUE                           0
71 #define RX_CMD_QUEUE                            1
72 #define RX_MAX_QUEUE                            2
73
74 static u8 SNAP_ETH_TYPE_IPX[2] = {0x81, 0x37};
75
76 static u8 SNAP_ETH_TYPE_APPLETALK_AARP[2] = {0x80, 0xf3};
77 static u8 SNAP_ETH_TYPE_APPLETALK_DDP[2] = {0x80, 0x9b};
78 static u8 SNAP_ETH_TYPE_TDLS[2] = {0x89, 0x0d};
79 static u8 SNAP_HDR_APPLETALK_DDP[3] = {0x08, 0x00, 0x07}; // Datagram Delivery Protocol
80
81 static u8 oui_8021h[] = {0x00, 0x00, 0xf8};
82 static u8 oui_rfc1042[]= {0x00,0x00,0x00};
83
84 #define MAX_SUBFRAME_COUNT      64
85 static u8 rtw_rfc1042_header[] =
86 { 0xaa, 0xaa, 0x03, 0x00, 0x00, 0x00 };
87 /* Bridge-Tunnel header (for EtherTypes ETH_P_AARP and ETH_P_IPX) */
88 static u8 rtw_bridge_tunnel_header[] =
89 { 0xaa, 0xaa, 0x03, 0x00, 0x00, 0xf8 };
90
91 //for Rx reordering buffer control
92 struct recv_reorder_ctrl
93 {
94         _adapter        *padapter;
95         u8 enable;
96         u16 indicate_seq;//=wstart_b, init_value=0xffff
97         u16 wend_b;
98         u8 wsize_b;
99         _queue pending_recvframe_queue;
100         _timer reordering_ctrl_timer;
101 };
102
103 struct  stainfo_rxcache {
104         u16     tid_rxseq[16];
105 /*
106         unsigned short  tid0_rxseq;
107         unsigned short  tid1_rxseq;
108         unsigned short  tid2_rxseq;
109         unsigned short  tid3_rxseq;
110         unsigned short  tid4_rxseq;
111         unsigned short  tid5_rxseq;
112         unsigned short  tid6_rxseq;
113         unsigned short  tid7_rxseq;
114         unsigned short  tid8_rxseq;
115         unsigned short  tid9_rxseq;
116         unsigned short  tid10_rxseq;
117         unsigned short  tid11_rxseq;
118         unsigned short  tid12_rxseq;
119         unsigned short  tid13_rxseq;
120         unsigned short  tid14_rxseq;
121         unsigned short  tid15_rxseq;
122 */
123 };
124
125
126 struct smooth_rssi_data {
127         u32     elements[100];  //array to store values
128         u32     index;                  //index to current array to store
129         u32     total_num;              //num of valid elements
130         u32     total_val;              //sum of valid elements
131 };
132
133 struct signal_stat {
134         u8      update_req;             //used to indicate 
135         u8      avg_val;                //avg of valid elements
136         u32     total_num;              //num of valid elements
137         u32     total_val;              //sum of valid elements 
138 };
139 /*
140 typedef struct _ODM_Phy_Status_Info_
141 {
142         //
143         // Be care, if you want to add any element please insert between 
144         // RxPWDBAll & SignalStrength.
145         //
146 #if (DM_ODM_SUPPORT_TYPE &  (ODM_WIN))
147         u4Byte          RxPWDBAll;      
148 #else
149         u1Byte          RxPWDBAll;      
150 #endif
151
152         u1Byte          SignalQuality;                  // in 0-100 index. 
153         s1Byte          RxMIMOSignalQuality[4]; //per-path's EVM
154         u1Byte          RxMIMOEVMdbm[4];                //per-path's EVM dbm
155
156         u1Byte          RxMIMOSignalStrength[4];// in 0~100 index
157
158         u2Byte          Cfo_short[4];                   // per-path's Cfo_short
159         u2Byte          Cfo_tail[4];                    // per-path's Cfo_tail
160         
161 #if (DM_ODM_SUPPORT_TYPE &  (ODM_WIN|ODM_CE))
162         s1Byte          RxPower;                                // in dBm Translate from PWdB
163         s1Byte          RecvSignalPower;                // Real power in dBm for this packet, no beautification and aggregation. Keep this raw info to be used for the other procedures.
164         u1Byte          BTRxRSSIPercentage;     
165         u1Byte          SignalStrength;                 // in 0-100 index.
166  
167         u1Byte          RxPwr[4];                               //per-path's pwdb
168 #endif
169         u1Byte          RxSNR[4];                               //per-path's SNR        
170         u1Byte          BandWidth;
171         u1Byte          btCoexPwrAdjust;
172 }ODM_PHY_INFO_T,*PODM_PHY_INFO_T;
173 */
174
175 struct phy_info
176 {               
177         u8              RxPWDBAll;
178
179         u8              SignalQuality;   // in 0-100 index. 
180         s8              RxMIMOSignalQuality[4]; //per-path's EVM
181         u8              RxMIMOEVMdbm[4];                //per-path's EVM dbm
182
183         u8              RxMIMOSignalStrength[4];// in 0~100 index
184
185         u16             Cfo_short[4];                   // per-path's Cfo_short
186         u16             Cfo_tail[4];                    // per-path's Cfo_tail
187
188         s8              RxPower; // in dBm Translate from PWdB
189         s8              RecvSignalPower;// Real power in dBm for this packet, no beautification and aggregation. Keep this raw info to be used for the other procedures.
190         u8              BTRxRSSIPercentage;     
191         u8              SignalStrength; // in 0-100 index.
192
193         s8              RxPwr[4];                               //per-path's pwdb
194         u8              RxSNR[4];                               //per-path's SNR        
195         u8              BandWidth;
196         u8              btCoexPwrAdjust;
197 };
198
199 #ifdef DBG_RX_SIGNAL_DISPLAY_RAW_DATA
200 struct rx_raw_rssi
201 {
202         u8 data_rate;
203         u8 pwdball;
204         s8 pwr_all;
205         
206         u8 mimo_singal_strength[4];// in 0~100 index
207         u8 mimo_singal_quality[4];
208         
209         s8 ofdm_pwr[4];\r
210         u8 ofdm_snr[4];\r
211
212 };
213 #endif
214
215 struct rx_pkt_attrib    {
216         u16     pkt_len;
217         u8      physt;
218         u8      drvinfo_sz;
219         u8      shift_sz;
220         u8      hdrlen; //the WLAN Header Len
221         u8      to_fr_ds;
222         u8      amsdu;
223         u8      qos;
224         u8      priority;
225         u8      pw_save;
226         u8      mdata;
227         u16     seq_num;
228         u8      frag_num;
229         u8      mfrag;
230         u8      order;
231         u8      privacy; //in frame_ctrl field
232         u8      bdecrypted;
233         u8      encrypt; //when 0 indicate no encrypt. when non-zero, indicate the encrypt algorith
234         u8      iv_len;
235         u8      icv_len;
236         u8      crc_err;
237         u8      icv_err;
238
239         u16     eth_type;
240
241         u8      dst[ETH_ALEN];
242         u8      src[ETH_ALEN];
243         u8      ta[ETH_ALEN];
244         u8      ra[ETH_ALEN];
245         u8      bssid[ETH_ALEN];
246         
247         u8      ack_policy;
248         
249 //#ifdef CONFIG_TCP_CSUM_OFFLOAD_RX
250         u8      tcpchk_valid; // 0: invalid, 1: valid
251         u8      ip_chkrpt; //0: incorrect, 1: correct
252         u8      tcp_chkrpt; //0: incorrect, 1: correct
253 //#endif
254         u8      key_index;
255
256         u8      data_rate;
257         u8      sgi;
258         u8      pkt_rpt_type;
259         u32     MacIDValidEntry[2];     // 64 bits present 64 entry.
260
261 /*
262         u8      signal_qual;
263         s8      rx_mimo_signal_qual[2];
264         u8      signal_strength;
265         u32     RxPWDBAll;      
266         s32     RecvSignalPower;
267 */
268         struct phy_info phy_info;       
269 };
270
271
272 //These definition is used for Rx packet reordering.
273 #define SN_LESS(a, b)           (((a-b)&0x800)!=0)
274 #define SN_EQUAL(a, b)  (a == b)
275 //#define REORDER_WIN_SIZE      128
276 //#define REORDER_ENTRY_NUM     128
277 #define REORDER_WAIT_TIME       (50) // (ms)
278
279 #define RECVBUFF_ALIGN_SZ 8
280
281 #define RXDESC_SIZE     24
282 #define RXDESC_OFFSET RXDESC_SIZE
283
284 struct recv_stat
285 {
286         unsigned int rxdw0;
287
288         unsigned int rxdw1;
289
290         unsigned int rxdw2;
291
292         unsigned int rxdw3;
293
294         unsigned int rxdw4;
295
296         unsigned int rxdw5;
297
298 #ifdef CONFIG_PCI_HCI
299         unsigned int rxdw6;
300
301         unsigned int rxdw7;
302 #endif
303 };
304
305 #define EOR BIT(30)
306
307 #ifdef CONFIG_PCI_HCI
308 #define PCI_MAX_RX_QUEUE                1// MSDU packet queue, Rx Command Queue
309 #define PCI_MAX_RX_COUNT                128
310
311 struct rtw_rx_ring {
312         struct recv_stat        *desc;
313         dma_addr_t              dma;
314         unsigned int            idx;
315         struct sk_buff  *rx_buf[PCI_MAX_RX_COUNT];
316 };
317 #endif
318
319
320
321 /*
322 accesser of recv_priv: rtw_recv_entry(dispatch / passive level); recv_thread(passive) ; returnpkt(dispatch)
323 ; halt(passive) ;
324
325 using enter_critical section to protect
326 */
327 struct recv_priv
328 {
329         _lock   lock;
330
331 #ifdef CONFIG_RECV_THREAD_MODE
332         _sema   recv_sema;
333         _sema   terminate_recvthread_sema;
334 #endif
335
336         //_queue        blk_strms[MAX_RX_NUMBLKS];    // keeping the block ack frame until return ack
337         _queue  free_recv_queue;
338         _queue  recv_pending_queue;
339         _queue  uc_swdec_pending_queue;
340
341
342         u8 *pallocated_frame_buf;
343         u8 *precv_frame_buf;
344
345         uint free_recvframe_cnt;
346
347         _adapter        *adapter;
348
349 #ifdef PLATFORM_WINDOWS
350         _nic_hdl  RxPktPoolHdl;
351         _nic_hdl  RxBufPoolHdl;
352
353 #ifdef PLATFORM_OS_XP
354         PMDL    pbytecnt_mdl;
355 #endif
356         uint    counter; //record the number that up-layer will return to drv; only when counter==0 can we  release recv_priv
357         NDIS_EVENT      recv_resource_evt ;
358 #endif
359
360         u32     bIsAnyNonBEPkts;
361         u64     rx_bytes;
362         u64     rx_pkts;
363         u64     rx_drop;
364
365         uint  rx_icv_err;
366         uint  rx_largepacket_crcerr;
367         uint  rx_smallpacket_crcerr;
368         uint  rx_middlepacket_crcerr;
369
370 #ifdef CONFIG_USB_HCI
371         //u8 *pallocated_urb_buf;
372         _sema allrxreturnevt;
373         uint    ff_hwaddr;
374         u8      rx_pending_cnt;
375
376 #ifdef CONFIG_USB_INTERRUPT_IN_PIPE
377 #ifdef PLATFORM_LINUX
378         PURB    int_in_urb;
379 #endif
380
381         u8      *int_in_buf;
382 #endif //CONFIG_USB_INTERRUPT_IN_PIPE
383
384 #endif
385 #if defined(PLATFORM_LINUX) || defined(PLATFORM_FREEBSD)
386 #ifdef PLATFORM_FREEBSD
387         struct task irq_prepare_beacon_tasklet;
388         struct task recv_tasklet;
389 #else //PLATFORM_FREEBSD
390         struct tasklet_struct irq_prepare_beacon_tasklet;
391         struct tasklet_struct recv_tasklet;
392 #endif //PLATFORM_FREEBSD
393         struct sk_buff_head free_recv_skb_queue;
394         struct sk_buff_head rx_skb_queue;
395 #ifdef CONFIG_RX_INDICATE_QUEUE
396         struct task rx_indicate_tasklet;
397         struct ifqueue rx_indicate_queue;
398 #endif  // CONFIG_RX_INDICATE_QUEUE
399
400 #endif //defined(PLATFORM_LINUX) || defined(PLATFORM_FREEBSD)
401
402         u8 *pallocated_recv_buf;
403         u8 *precv_buf;    // 4 alignment
404         _queue  free_recv_buf_queue;
405         u32     free_recv_buf_queue_cnt;
406
407 #if defined(CONFIG_SDIO_HCI) || defined(CONFIG_GSPI_HCI) || defined(CONFIG_USB_HCI) 
408         _queue  recv_buf_pending_queue;
409 #endif
410
411 #ifdef CONFIG_PCI_HCI
412         // Rx
413         struct rtw_rx_ring      rx_ring[PCI_MAX_RX_QUEUE];
414         int     rxringcount;
415         u16     rxbuffersize;
416 #endif
417
418         //For display the phy informatiom
419         u8 is_signal_dbg;       // for debug
420         u8 signal_strength_dbg; // for debug
421         
422         u8 signal_strength;
423         u8 signal_qual;
424         s8 rssi;        //translate_percentage_to_dbm(ptarget_wlan->network.PhyInfo.SignalStrength);
425         #ifdef DBG_RX_SIGNAL_DISPLAY_RAW_DATA
426         struct rx_raw_rssi raw_rssi_info;
427         #endif
428         //s8 rxpwdb;    
429         u8 noise;       
430         //int RxSNRdB[2];
431         //s8 RxRssi[2];
432         //int FalseAlmCnt_all;
433         
434
435 #ifdef CONFIG_NEW_SIGNAL_STAT_PROCESS
436         _timer signal_stat_timer;
437         u32 signal_stat_sampling_interval;
438         //u32 signal_stat_converging_constant;
439         struct signal_stat signal_qual_data;
440         struct signal_stat signal_strength_data;
441 #else //CONFIG_NEW_SIGNAL_STAT_PROCESS
442         struct smooth_rssi_data signal_qual_data;
443         struct smooth_rssi_data signal_strength_data;
444 #endif //CONFIG_NEW_SIGNAL_STAT_PROCESS
445
446 };
447
448 #ifdef CONFIG_NEW_SIGNAL_STAT_PROCESS
449 #define rtw_set_signal_stat_timer(recvpriv) _set_timer(&(recvpriv)->signal_stat_timer, (recvpriv)->signal_stat_sampling_interval)
450 #endif //CONFIG_NEW_SIGNAL_STAT_PROCESS
451
452 struct sta_recv_priv {
453
454         _lock   lock;
455         sint    option;
456
457         //_queue        blk_strms[MAX_RX_NUMBLKS];
458         _queue defrag_q;         //keeping the fragment frame until defrag
459
460         struct  stainfo_rxcache rxcache;
461
462         //uint  sta_rx_bytes;
463         //uint  sta_rx_pkts;
464         //uint  sta_rx_fail;
465
466 };
467
468
469 struct recv_buf
470 {
471         _list list;
472
473         _lock recvbuf_lock;
474
475         u32     ref_cnt;
476
477         PADAPTER adapter;
478
479         u8      *pbuf;
480         u8      *pallocated_buf;
481
482         u32     len;
483         u8      *phead;
484         u8      *pdata;
485         u8      *ptail;
486         u8      *pend;
487
488 #ifdef CONFIG_USB_HCI
489
490         #if defined(PLATFORM_OS_XP)||defined(PLATFORM_LINUX)||defined(PLATFORM_FREEBSD)
491         PURB    purb;
492         dma_addr_t dma_transfer_addr;   /* (in) dma addr for transfer_buffer */
493         u32 alloc_sz;
494         #endif
495
496         #ifdef PLATFORM_OS_XP
497         PIRP            pirp;
498         #endif
499
500         #ifdef PLATFORM_OS_CE
501         USB_TRANSFER    usb_transfer_read_port;
502         #endif
503
504         u8  irp_pending;
505         int  transfer_len;
506
507 #endif
508
509 #ifdef PLATFORM_LINUX
510         _pkt    *pskb;
511         u8      reuse;
512 #endif
513 #ifdef PLATFORM_FREEBSD //skb solution
514         struct sk_buff *pskb;
515         u8      reuse;
516 #endif //PLATFORM_FREEBSD //skb solution
517 };
518
519
520 /*
521         head  ----->
522
523                 data  ----->
524
525                         payload
526
527                 tail  ----->
528
529
530         end   ----->
531
532         len = (unsigned int )(tail - data);
533
534 */
535 struct recv_frame_hdr
536 {
537         _list   list;
538 #ifndef CONFIG_BSD_RX_USE_MBUF
539         struct sk_buff   *pkt;
540         struct sk_buff   *pkt_newalloc;
541 #else // CONFIG_BSD_RX_USE_MBUF
542         _pkt    *pkt;
543         _pkt *pkt_newalloc;
544 #endif // CONFIG_BSD_RX_USE_MBUF
545
546         _adapter  *adapter;
547
548         u8 fragcnt;
549
550         int frame_tag;
551
552         struct rx_pkt_attrib attrib;
553
554         uint  len;
555         u8 *rx_head;
556         u8 *rx_data;
557         u8 *rx_tail;
558         u8 *rx_end;
559
560         void *precvbuf;
561
562
563         //
564         struct sta_info *psta;
565
566         //for A-MPDU Rx reordering buffer control
567         struct recv_reorder_ctrl *preorder_ctrl;
568
569 #ifdef CONFIG_WAPI_SUPPORT
570         u8 UserPriority;
571         u8 WapiTempPN[16];
572         u8 WapiSrcAddr[6];
573         u8 bWapiCheckPNInDecrypt;
574         u8 bIsWaiPacket;
575 #endif
576
577 };
578
579
580 union recv_frame{
581
582         union{
583                 _list list;
584                 struct recv_frame_hdr hdr;
585                 uint mem[RECVFRAME_HDR_ALIGN>>2];
586         }u;
587
588         //uint mem[MAX_RXSZ>>2];
589
590 };
591
592 typedef enum _RX_PACKET_TYPE{
593         NORMAL_RX,//Normal rx packet
594         TX_REPORT1,//CCX
595         TX_REPORT2,//TX RPT
596         HIS_REPORT,// USB HISR RPT
597         C2H_PACKET
598 }RX_PACKET_TYPE, *PRX_PACKET_TYPE;
599
600 extern union recv_frame *_rtw_alloc_recvframe (_queue *pfree_recv_queue);  //get a free recv_frame from pfree_recv_queue
601 extern union recv_frame *rtw_alloc_recvframe (_queue *pfree_recv_queue);  //get a free recv_frame from pfree_recv_queue
602 extern void rtw_init_recvframe(union recv_frame *precvframe ,struct recv_priv *precvpriv);
603 extern int       rtw_free_recvframe(union recv_frame *precvframe, _queue *pfree_recv_queue);
604
605 #define rtw_dequeue_recvframe(queue) rtw_alloc_recvframe(queue)
606 extern int _rtw_enqueue_recvframe(union recv_frame *precvframe, _queue *queue);
607 extern int rtw_enqueue_recvframe(union recv_frame *precvframe, _queue *queue);
608
609 extern void rtw_free_recvframe_queue(_queue *pframequeue,  _queue *pfree_recv_queue);
610 u32 rtw_free_uc_swdec_pending_queue(_adapter *adapter);
611
612 sint rtw_enqueue_recvbuf_to_head(struct recv_buf *precvbuf, _queue *queue);
613 sint rtw_enqueue_recvbuf(struct recv_buf *precvbuf, _queue *queue);
614 struct recv_buf *rtw_dequeue_recvbuf (_queue *queue);
615
616 void rtw_reordering_ctrl_timeout_handler(void *pcontext);
617
618 __inline static u8 *get_rxmem(union recv_frame *precvframe)
619 {
620         //always return rx_head...
621         if(precvframe==NULL)
622                 return NULL;
623
624         return precvframe->u.hdr.rx_head;
625 }
626
627 __inline static u8 *get_rx_status(union recv_frame *precvframe)
628 {
629
630         return get_rxmem(precvframe);
631
632 }
633
634 __inline static u8 *get_recvframe_data(union recv_frame *precvframe)
635 {
636
637         //alwasy return rx_data
638         if(precvframe==NULL)
639                 return NULL;
640
641         return precvframe->u.hdr.rx_data;
642
643 }
644
645 __inline static u8 *recvframe_push(union recv_frame *precvframe, sint sz)
646 {
647         // append data before rx_data
648
649         /* add data to the start of recv_frame
650  *
651  *      This function extends the used data area of the recv_frame at the buffer
652  *      start. rx_data must be still larger than rx_head, after pushing.
653  */
654
655         if(precvframe==NULL)
656                 return NULL;
657
658
659         precvframe->u.hdr.rx_data -= sz ;
660         if( precvframe->u.hdr.rx_data < precvframe->u.hdr.rx_head )
661         {
662                 precvframe->u.hdr.rx_data += sz ;
663                 return NULL;
664         }
665
666         precvframe->u.hdr.len +=sz;
667
668         return precvframe->u.hdr.rx_data;
669
670 }
671
672
673 __inline static u8 *recvframe_pull(union recv_frame *precvframe, sint sz)
674 {
675         // rx_data += sz; move rx_data sz bytes  hereafter
676
677         //used for extract sz bytes from rx_data, update rx_data and return the updated rx_data to the caller
678
679
680         if(precvframe==NULL)
681                 return NULL;
682
683
684         precvframe->u.hdr.rx_data += sz;
685
686         if(precvframe->u.hdr.rx_data > precvframe->u.hdr.rx_tail)
687         {
688                 precvframe->u.hdr.rx_data -= sz;
689                 return NULL;
690         }
691
692         precvframe->u.hdr.len -=sz;
693
694         return precvframe->u.hdr.rx_data;
695
696 }
697
698 __inline static u8 *recvframe_put(union recv_frame *precvframe, sint sz)
699 {
700         // rx_tai += sz; move rx_tail sz bytes  hereafter
701
702         //used for append sz bytes from ptr to rx_tail, update rx_tail and return the updated rx_tail to the caller
703         //after putting, rx_tail must be still larger than rx_end.
704         unsigned char * prev_rx_tail;
705
706         if(precvframe==NULL)
707                 return NULL;
708
709         prev_rx_tail = precvframe->u.hdr.rx_tail;
710
711         precvframe->u.hdr.rx_tail += sz;
712
713         if(precvframe->u.hdr.rx_tail > precvframe->u.hdr.rx_end)
714         {
715                 precvframe->u.hdr.rx_tail -= sz;
716                 return NULL;
717         }
718
719         precvframe->u.hdr.len +=sz;
720
721         return precvframe->u.hdr.rx_tail;
722
723 }
724
725
726
727 __inline static u8 *recvframe_pull_tail(union recv_frame *precvframe, sint sz)
728 {
729         // rmv data from rx_tail (by yitsen)
730
731         //used for extract sz bytes from rx_end, update rx_end and return the updated rx_end to the caller
732         //after pulling, rx_end must be still larger than rx_data.
733
734         if(precvframe==NULL)
735                 return NULL;
736
737         precvframe->u.hdr.rx_tail -= sz;
738
739         if(precvframe->u.hdr.rx_tail < precvframe->u.hdr.rx_data)
740         {
741                 precvframe->u.hdr.rx_tail += sz;
742                 return NULL;
743         }
744
745         precvframe->u.hdr.len -=sz;
746
747         return precvframe->u.hdr.rx_tail;
748
749 }
750
751
752
753 __inline static _buffer * get_rxbuf_desc(union recv_frame *precvframe)
754 {
755         _buffer * buf_desc;
756
757         if(precvframe==NULL)
758                 return NULL;
759 #ifdef PLATFORM_WINDOWS
760         NdisQueryPacket(precvframe->u.hdr.pkt, NULL, NULL, &buf_desc, NULL);
761 #endif
762
763         return buf_desc;
764 }
765
766
767 __inline static union recv_frame *rxmem_to_recvframe(u8 *rxmem)
768 {
769         //due to the design of 2048 bytes alignment of recv_frame, we can reference the union recv_frame
770         //from any given member of recv_frame.
771         // rxmem indicates the any member/address in recv_frame
772
773         return (union recv_frame*)(((SIZE_PTR)rxmem >> RXFRAME_ALIGN) << RXFRAME_ALIGN);
774
775 }
776
777 __inline static union recv_frame *pkt_to_recvframe(_pkt *pkt)
778 {
779
780         u8 * buf_star;
781         union recv_frame * precv_frame;
782 #ifdef PLATFORM_WINDOWS
783         _buffer * buf_desc;
784         uint len;
785
786         NdisQueryPacket(pkt, NULL, NULL, &buf_desc, &len);
787         NdisQueryBufferSafe(buf_desc, &buf_star, &len, HighPagePriority);
788 #endif
789         precv_frame = rxmem_to_recvframe((unsigned char*)buf_star);
790
791         return precv_frame;
792 }
793
794 __inline static u8 *pkt_to_recvmem(_pkt *pkt)
795 {
796         // return the rx_head
797
798         union recv_frame * precv_frame = pkt_to_recvframe(pkt);
799
800         return  precv_frame->u.hdr.rx_head;
801
802 }
803
804 __inline static u8 *pkt_to_recvdata(_pkt *pkt)
805 {
806         // return the rx_data
807
808         union recv_frame * precv_frame =pkt_to_recvframe(pkt);
809
810         return  precv_frame->u.hdr.rx_data;
811
812 }
813
814
815 __inline static sint get_recvframe_len(union recv_frame *precvframe)
816 {
817         return precvframe->u.hdr.len;
818 }
819
820
821 __inline static s32 translate_percentage_to_dbm(u32 SignalStrengthIndex)
822 {
823         s32     SignalPower; // in dBm.
824
825         // Translate to dBm (x=0.5y-95).
826         SignalPower = (s32)((SignalStrengthIndex + 1) >> 1); 
827         SignalPower -= 95; 
828
829         return SignalPower;
830 }
831
832
833 struct sta_info;
834
835 extern void _rtw_init_sta_recv_priv(struct sta_recv_priv *psta_recvpriv);
836
837 extern void  mgt_dispatcher(_adapter *padapter, union recv_frame *precv_frame);
838
839 #endif
840