hc
2024-05-14 bedbef8ad3e75a304af6361af235302bcc61d06b
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
/******************************************************************************
 *
 * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
 *                                        
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
 *
 *
 ******************************************************************************/
 
#ifndef    __PHYDMANTDIV_H__
#define    __PHYDMANTDIV_H__
 
/*#define ANTDIV_VERSION    "2.0"  //2014.11.04*/
/*#define ANTDIV_VERSION    "2.1"  //2015.01.13  Dino*/
#define ANTDIV_VERSION    "2.2"  /*2015.01.16  Dino*/
 
//1 ============================================================
//1  Definition 
//1 ============================================================
 
#define    ANTDIV_INIT        0xff
#define    MAIN_ANT    1        //Ant A or Ant Main
#define    AUX_ANT        2        //AntB or Ant Aux
#define    MAX_ANT        3        // 3 for AP using
 
#define ANT1_2G 0 // = ANT2_5G
#define ANT2_2G 1 // = ANT1_5G
 
//Antenna Diversty Control Type
#define    ODM_AUTO_ANT    0
#define    ODM_FIX_MAIN_ANT    1
#define    ODM_FIX_AUX_ANT    2
 
#define ODM_ANTDIV_SUPPORT        (ODM_RTL8188E|ODM_RTL8192E|ODM_RTL8723B|ODM_RTL8821|ODM_RTL8881A|ODM_RTL8812)
#define ODM_N_ANTDIV_SUPPORT        (ODM_RTL8188E|ODM_RTL8192E|ODM_RTL8723B)
#define ODM_AC_ANTDIV_SUPPORT        (ODM_RTL8821|ODM_RTL8881A|ODM_RTL8812)
#define ODM_SMART_ANT_SUPPORT        (ODM_RTL8188E|ODM_RTL8192E)
 
#define ODM_OLD_IC_ANTDIV_SUPPORT        (ODM_RTL8723A|ODM_RTL8192C|ODM_RTL8192D)
 
#define ODM_ANTDIV_2G_SUPPORT_IC            (ODM_RTL8188E|ODM_RTL8192E|ODM_RTL8723B|ODM_RTL8881A)
#define ODM_ANTDIV_5G_SUPPORT_IC            (ODM_RTL8821|ODM_RTL8881A|ODM_RTL8812)
 
#define ODM_EVM_ENHANCE_ANTDIV_SUPPORT_IC    (ODM_RTL8192E)
 
#define ODM_ANTDIV_2G    BIT0
#define ODM_ANTDIV_5G    BIT1
 
#define ANTDIV_ON 1
#define ANTDIV_OFF 0
 
#define FAT_ON 1
#define FAT_OFF 0
 
#define TX_BY_DESC 1
#define REG 0
 
#define RSSI_METHOD 0
#define EVM_METHOD 1
#define CRC32_METHOD 2
 
#define INIT_ANTDIV_TIMMER 0
#define CANCEL_ANTDIV_TIMMER 1
#define RELEASE_ANTDIV_TIMMER 2
 
#define CRC32_FAIL 1
#define CRC32_OK 0
 
#define Evm_RSSI_TH_High 25
#define Evm_RSSI_TH_Low 20
 
#define NORMAL_STATE_MIAN 1
#define NORMAL_STATE_AUX 2
#define TRAINING_STATE 3
 
#define FORCE_RSSI_DIFF 10
 
#define CSI_ON 1
#define CSI_OFF 0
 
#define DIVON_CSIOFF 1
#define DIVOFF_CSION 2
 
#define BDC_DIV_TRAIN_STATE 0
#define BDC_BFer_TRAIN_STATE 1
#define BDC_DECISION_STATE 2
#define BDC_BF_HOLD_STATE 3
#define BDC_DIV_HOLD_STATE 4
 
#define BDC_MODE_1 1
#define BDC_MODE_2 2
#define BDC_MODE_3 3
#define BDC_MODE_4 4
#define BDC_MODE_NULL 0xff
 
#define SWAW_STEP_PEAK        0
#define SWAW_STEP_DETERMINE    1
 
//1 ============================================================
//1  structure
//1 ============================================================
 
 
typedef struct _SW_Antenna_Switch_
{
   u1Byte        Double_chk_flag;
   u1Byte        try_flag;
   s4Byte        PreRSSI;
   u1Byte        CurAntenna;
   u1Byte        PreAntenna;
   u1Byte        RSSI_Trying;
   u1Byte        TestMode;
   u1Byte        bTriggerAntennaSwitch;
   u1Byte        SelectAntennaMap;
   u1Byte        RSSI_target;    
   u1Byte         reset_idx;
   u2Byte        Single_Ant_Counter;
   u2Byte        Dual_Ant_Counter;
   u2Byte          Aux_FailDetec_Counter;
   u2Byte          Retry_Counter;
 
   // Before link Antenna Switch check
   u1Byte        SWAS_NoLink_State;
   u4Byte        SWAS_NoLink_BK_Reg860;
   u4Byte        SWAS_NoLink_BK_Reg92c;
   u4Byte        SWAS_NoLink_BK_Reg948;
   BOOLEAN        ANTA_ON;    //To indicate Ant A is or not
   BOOLEAN        ANTB_ON;    //To indicate Ant B is on or not
   BOOLEAN        Pre_Aux_FailDetec;
   BOOLEAN        RSSI_AntDect_bResult;    
   u1Byte        Ant5G;
   u1Byte        Ant2G;
 
   s4Byte        RSSI_sum_A;
   s4Byte        RSSI_sum_B;
   s4Byte        RSSI_cnt_A;
   s4Byte        RSSI_cnt_B;
 
   u8Byte        lastTxOkCnt;
   u8Byte        lastRxOkCnt;
   u8Byte         TXByteCnt_A;
   u8Byte         TXByteCnt_B;
   u8Byte         RXByteCnt_A;
   u8Byte         RXByteCnt_B;
   u1Byte         TrafficLoad;
   u1Byte        Train_time;
   u1Byte        Train_time_flag;
   RT_TIMER     SwAntennaSwitchTimer;
#if (RTL8723B_SUPPORT == 1)||(RTL8821A_SUPPORT == 1)    
   RT_TIMER     SwAntennaSwitchTimer_8723B;
   u4Byte        PktCnt_SWAntDivByCtrlFrame;
   BOOLEAN        bSWAntDivByCtrlFrame;
#endif
   
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)    
   #if USE_WORKITEM
   RT_WORK_ITEM            SwAntennaSwitchWorkitem;
#if (RTL8723B_SUPPORT == 1)||(RTL8821A_SUPPORT == 1)    
   RT_WORK_ITEM            SwAntennaSwitchWorkitem_8723B;    
   #endif
#endif
#endif
/* CE Platform use
#ifdef CONFIG_SW_ANTENNA_DIVERSITY
   _timer SwAntennaSwitchTimer; 
   u8Byte lastTxOkCnt;
   u8Byte lastRxOkCnt;
   u8Byte TXByteCnt_A;
   u8Byte TXByteCnt_B;
   u8Byte RXByteCnt_A;
   u8Byte RXByteCnt_B;
   u1Byte DoubleComfirm;
   u1Byte TrafficLoad;
   //SW Antenna Switch
 
 
#endif
*/
#ifdef CONFIG_HW_ANTENNA_DIVERSITY
   //Hybrid Antenna Diversity
   u4Byte        CCK_Ant1_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte        CCK_Ant2_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte        OFDM_Ant1_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte        OFDM_Ant2_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte        RSSI_Ant1_Sum[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte        RSSI_Ant2_Sum[ODM_ASSOCIATE_ENTRY_NUM];
   u1Byte        TxAnt[ODM_ASSOCIATE_ENTRY_NUM];
   u1Byte        TargetSTA;
   u1Byte        antsel;
   u1Byte        RxIdleAnt;
 
#endif
   
}SWAT_T, *pSWAT_T;
 
 
#if (DM_ODM_SUPPORT_TYPE & (ODM_AP))
#if (defined(CONFIG_HW_ANTENNA_DIVERSITY))
typedef struct _BF_DIV_COEX_
{
   BOOLEAN w_BFer_Client[ODM_ASSOCIATE_ENTRY_NUM];
   BOOLEAN w_BFee_Client[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    MA_rx_TP[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    MA_rx_TP_DIV[ODM_ASSOCIATE_ENTRY_NUM];
 
   u1Byte  BDCcoexType_wBfer;
   u1Byte num_Txbfee_Client;
   u1Byte num_Txbfer_Client;
   u1Byte BDC_Try_counter;
   u1Byte BDC_Hold_counter;
   u1Byte BDC_Mode;
   u1Byte BDC_active_Mode;
   u1Byte BDC_state;
   u1Byte BDC_RxIdleUpdate_counter;
   u1Byte num_Client;
   u1Byte pre_num_Client;
   u1Byte num_BfTar;
   u1Byte num_DivTar;
   
   BOOLEAN bAll_DivSta_Idle;
   BOOLEAN bAll_BFSta_Idle;
   BOOLEAN BDC_Try_flag;
   BOOLEAN BF_pass;
   BOOLEAN DIV_pass;    
}BDC_T,*pBDC_T;
#endif
#endif
 
 
typedef struct _FAST_ANTENNA_TRAINNING_
{
   u1Byte    Bssid[6];
   u1Byte    antsel_rx_keep_0;
   u1Byte    antsel_rx_keep_1;
   u1Byte    antsel_rx_keep_2;
   u1Byte    antsel_rx_keep_3;
   u4Byte    antSumRSSI[7];
   u4Byte    antRSSIcnt[7];
   u4Byte    antAveRSSI[7];
   u1Byte    FAT_State;
   u4Byte    TrainIdx;
   u1Byte    antsel_a[ODM_ASSOCIATE_ENTRY_NUM];
   u1Byte    antsel_b[ODM_ASSOCIATE_ENTRY_NUM];
   u1Byte    antsel_c[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    MainAnt_Sum[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    AuxAnt_Sum[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    MainAnt_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    AuxAnt_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u1Byte    RxIdleAnt;
   u1Byte    AntDiv_OnOff;
   BOOLEAN    bBecomeLinked;
   u4Byte    MinMaxRSSI;
   u1Byte    idx_AntDiv_counter_2G;
   u1Byte    idx_AntDiv_counter_5G;
   u1Byte    AntDiv_2G_5G;
   u4Byte    CCK_counter_main;
   u4Byte    CCK_counter_aux;    
   u4Byte    OFDM_counter_main;
   u4Byte    OFDM_counter_aux;
 
   #ifdef ODM_EVM_ENHANCE_ANTDIV
   u4Byte    MainAntEVM_Sum[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    AuxAntEVM_Sum[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    MainAntEVM_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   u4Byte    AuxAntEVM_Cnt[ODM_ASSOCIATE_ENTRY_NUM];
   BOOLEAN    EVM_method_enable;
   u1Byte    TargetAnt_EVM;
   u1Byte    TargetAnt_CRC32;
   u1Byte    TargetAnt_enhance;
   u1Byte    pre_TargetAnt_enhance;
   u2Byte    Main_MPDU_OK_cnt;
   u2Byte    Aux_MPDU_OK_cnt;    
 
   u4Byte    CRC32_Ok_Cnt;
   u4Byte    CRC32_Fail_Cnt;
   u4Byte    MainCRC32_Ok_Cnt;
   u4Byte    AuxCRC32_Ok_Cnt;
   u4Byte    MainCRC32_Fail_Cnt;
   u4Byte    AuxCRC32_Fail_Cnt;
   #endif    
   #if (DM_ODM_SUPPORT_TYPE & (ODM_WIN|ODM_CE))
   u4Byte    CCK_CtrlFrame_Cnt_main;
   u4Byte    CCK_CtrlFrame_Cnt_aux;
   u4Byte    OFDM_CtrlFrame_Cnt_main;
   u4Byte    OFDM_CtrlFrame_Cnt_aux;
   u4Byte    MainAnt_CtrlFrame_Sum;
   u4Byte    AuxAnt_CtrlFrame_Sum;
   u4Byte    MainAnt_CtrlFrame_Cnt;
   u4Byte    AuxAnt_CtrlFrame_Cnt;
   #endif
   BOOLEAN    fix_ant_bfee;
   BOOLEAN    enable_ctrl_frame_antdiv;
   BOOLEAN    use_ctrl_frame_antdiv;
}FAT_T,*pFAT_T;
 
 
//1 ============================================================
//1  enumeration
//1 ============================================================
 
 
 
typedef enum _FAT_STATE
{
   FAT_NORMAL_STATE            = 0,
   FAT_TRAINING_STATE         = 1,
}FAT_STATE_E, *PFAT_STATE_E;
 
 
typedef enum _ANT_DIV_TYPE
{
   NO_ANTDIV            = 0xFF,    
   CG_TRX_HW_ANTDIV        = 0x01,
   CGCS_RX_HW_ANTDIV     = 0x02,
   FIXED_HW_ANTDIV        = 0x03,
   CG_TRX_SMART_ANTDIV    = 0x04,
   CGCS_RX_SW_ANTDIV    = 0x05,
   S0S1_SW_ANTDIV          = 0x06 //8723B intrnal switch S0 S1
}ANT_DIV_TYPE_E, *PANT_DIV_TYPE_E;
 
 
//1 ============================================================
//1  function prototype
//1 ============================================================
 
 
VOID
ODM_StopAntennaSwitchDm(
   IN    PVOID    pDM_VOID
   );
VOID
ODM_SetAntConfig(
   IN    PVOID    pDM_VOID,
   IN    u1Byte        antSetting    // 0=A, 1=B, 2=C, ....
   );
 
 
#define SwAntDivRestAfterLink    ODM_SwAntDivRestAfterLink
VOID ODM_SwAntDivRestAfterLink(    
   IN    PVOID    pDM_VOID
   );
 
#if (defined(CONFIG_HW_ANTENNA_DIVERSITY))
 
VOID
ODM_UpdateRxIdleAnt(
   IN        PVOID        pDM_VOID, 
   IN         u1Byte        Ant
);
 
#if (RTL8723B_SUPPORT == 1)||(RTL8821A_SUPPORT == 1)
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
VOID
ODM_SW_AntDiv_Callback(
   IN     PRT_TIMER        pTimer
   );
 
VOID
ODM_SW_AntDiv_WorkitemCallback(
   IN         PVOID            pContext
   );
 
 
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE)
 
VOID
ODM_SW_AntDiv_WorkitemCallback(
   IN PVOID    pContext
);
 
VOID
ODM_SW_AntDiv_Callback(
   void         *FunctionContext
   );
 
#endif
 
#if (DM_ODM_SUPPORT_TYPE & (ODM_WIN|ODM_CE))
VOID
odm_S0S1_SwAntDivByCtrlFrame(
   IN        PVOID            pDM_VOID,
   IN        u1Byte            Step
);
 
VOID
odm_AntselStatisticsOfCtrlFrame(
   IN        PVOID            pDM_VOID,
   IN        u1Byte            antsel_tr_mux,
   IN        u4Byte            RxPWDBAll
);
 
VOID
odm_S0S1_SwAntDivByCtrlFrame_ProcessRSSI(
   IN        PVOID                pDM_VOID,
   IN        PVOID        p_phy_info_void,
   IN        PVOID        p_pkt_info_void
);
 
/*
VOID
odm_S0S1_SwAntDivByCtrlFrame_ProcessRSSI(
   IN        PVOID                pDM_VOID,
   IN        PVOID        p_phy_info_void,
   IN        PVOID        p_pkt_info_void
);
*/
 
#endif 
#endif
 
#ifdef ODM_EVM_ENHANCE_ANTDIV
VOID
odm_EVM_FastAntTrainingCallback(
   IN        PVOID        pDM_VOID
);
#endif
 
VOID
odm_HW_AntDiv(
   IN        PVOID        pDM_VOID
);
 
#if( defined(CONFIG_5G_CG_SMART_ANT_DIVERSITY) ) ||( defined(CONFIG_2G_CG_SMART_ANT_DIVERSITY) )
VOID
odm_FastAntTraining(
   IN        PVOID        pDM_VOID
);
 
VOID
odm_FastAntTrainingCallback(
   IN        PVOID        pDM_VOID
);
 
VOID
odm_FastAntTrainingWorkItemCallback(
   IN        PVOID        pDM_VOID
);
#endif
 
 
VOID
ODM_AntDivInit(
   IN        PVOID        pDM_VOID
);
 
VOID
ODM_AntDiv(
   IN        PVOID        pDM_VOID
);
 
VOID
odm_AntselStatistics(
   IN        PVOID            pDM_VOID,
   IN        u1Byte            antsel_tr_mux,
   IN        u4Byte            MacId,
   IN        u4Byte            utility,
   IN            u1Byte            method
);
/*
VOID
ODM_Process_RSSIForAntDiv(    
   IN OUT    PVOID        pDM_VOID,
   IN        PVOID        p_phy_info_void,
   IN        PVOID        p_pkt_info_void
);
*/
 
 
VOID
ODM_Process_RSSIForAntDiv(    
   IN OUT    PVOID        pDM_VOID,
   IN        PVOID        p_phy_info_void,
   IN        PVOID        p_pkt_info_void
);
 
 
 
#if (DM_ODM_SUPPORT_TYPE & (ODM_WIN|ODM_CE))
VOID
ODM_SetTxAntByTxInfo(
   IN        PVOID            pDM_VOID,
   IN        pu1Byte            pDesc,
   IN        u1Byte            macId    
);
 
#elif(DM_ODM_SUPPORT_TYPE == ODM_AP)
 
VOID
ODM_SetTxAntByTxInfo(
   struct    rtl8192cd_priv        *priv,
   struct     tx_desc            *pdesc,
   unsigned short            aid    
);
 
#endif
 
 
VOID
ODM_AntDiv_Config(
   IN        PVOID        pDM_VOID
);
 
 
VOID
ODM_UpdateRxIdleAnt_8723B(
   IN        PVOID            pDM_VOID,
   IN        u1Byte            Ant,
   IN        u4Byte            DefaultAnt, 
   IN        u4Byte            OptionalAnt
);
 
VOID
ODM_AntDivTimers(
   IN        PVOID        pDM_VOID,
   IN         u1Byte        state
);
 
#endif //#if (defined(CONFIG_HW_ANTENNA_DIVERSITY))
 
VOID
ODM_AntDivReset(
   IN        PVOID        pDM_VOID
);
 
VOID
odm_AntennaDiversityInit(
   IN        PVOID        pDM_VOID
);
 
VOID
odm_AntennaDiversity(
   IN        PVOID        pDM_VOID
);
 
 
#endif //#ifndef    __ODMANTDIV_H__