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
******************************************************************************/
21
#ifndef __PHYDMRAINFO_H__
22
#define __PHYDMRAINFO_H__
24
/*#define RAINFO_VERSION "2.0" //2014.11.04*/
25
/*#define RAINFO_VERSION "3.0" //2015.01.13 Dino*/
26
/*#define RAINFO_VERSION "3.1" //2015.01.14 Dino*/
27
/*#define RAINFO_VERSION "3.3" 2015.07.29 YuChen*/
28
/*#define RAINFO_VERSION "3.4"*/ /*2015.12.15 Stanley*/
29
/*#define RAINFO_VERSION "4.0"*/ /*2016.03.24 Dino, Add more RA mask state and Phydm-lize partial ra mask function */
30
/*#define RAINFO_VERSION "4.1"*/ /*2016.04.20 Dino, Add new function to adjust PCR RA threshold */
31
/*#define RAINFO_VERSION "4.2"*/ /*2016.05.17 Dino, Add H2C debug cmd */
32
#define RAINFO_VERSION "4.3" /*2016.07.11 Dino, Fix RA hang in CCK 1M problem */
34
#define FORCED_UPDATE_RAMASK_PERIOD 5
36
#define H2C_0X42_LENGTH 5
37
#define H2C_MAX_LENGTH 7
39
#define RA_FLOOR_UP_GAP 3
40
#define RA_FLOOR_TABLE_SIZE 7
42
#define ACTIVE_TP_THRESHOLD 150
43
#define RA_RETRY_DESCEND_NUM 2
44
#define RA_RETRY_LIMIT_LOW 4
45
#define RA_RETRY_LIMIT_HIGH 32
47
#define RAINFO_BE_RX_STATE BIT(0) /* 1:RX */ /* ULDL */
48
#define RAINFO_STBC_STATE BIT(1)
49
/* #define RAINFO_LDPC_STATE BIT2 */
50
#define RAINFO_NOISY_STATE BIT(2) /* set by Noisy_Detection */
51
#define RAINFO_SHURTCUT_STATE BIT(3)
52
#define RAINFO_SHURTCUT_FLAG BIT(4)
53
#define RAINFO_INIT_RSSI_RATE_STATE BIT(5)
54
#define RAINFO_BF_STATE BIT(6)
55
#define RAINFO_BE_TX_STATE BIT(7) /* 1:TX */
57
#define RA_MASK_CCK 0xf
58
#define RA_MASK_OFDM 0xff0
59
#define RA_MASK_HT1SS 0xff000
60
#define RA_MASK_HT2SS 0xff00000
61
/*#define RA_MASK_MCS3SS */
62
#define RA_MASK_HT4SS 0xff0
63
#define RA_MASK_VHT1SS 0x3ff000
64
#define RA_MASK_VHT2SS 0xffc00000
66
#if (DM_ODM_SUPPORT_TYPE == ODM_AP)
67
#define RA_FIRST_MACID 1
68
#elif (DM_ODM_SUPPORT_TYPE == ODM_WIN)
69
#define RA_FIRST_MACID 0
70
#define WIN_DEFAULT_PORT_MACID 0
71
#define WIN_BT_PORT_MACID 2
72
#else /*if (DM_ODM_SUPPORT_TYPE == ODM_CE)*/
73
#define RA_FIRST_MACID 0
76
#if (DM_ODM_SUPPORT_TYPE & ODM_WIN)
77
#define AP_InitRateAdaptiveState odm_rate_adaptive_state_ap_init
79
#define ap_init_rate_adaptive_state odm_rate_adaptive_state_ap_init
82
#if (RA_MASK_PHYDMLIZE_CE || RA_MASK_PHYDMLIZE_AP || RA_MASK_PHYDMLIZE_WIN)
83
#define DM_RATR_STA_INIT 0
84
#define DM_RATR_STA_HIGH 1
85
#define DM_RATR_STA_MIDDLE 2
86
#define DM_RATR_STA_LOW 3
87
#define DM_RATR_STA_ULTRA_LOW 4
90
enum phydm_ra_arfr_num_e {
99
enum phydm_ra_dbg_para_e {
100
RADBG_PCR_TH_OFFSET = 0,
101
RADBG_RTY_PENALTY = 1,
104
RADBG_TRATE_UP_TABLE = 4,
105
RADBG_TRATE_DOWN_TABLE = 5,
106
RADBG_TRYING_NECESSARY = 6,
107
RADBG_TDROPING_NECESSARY = 7,
108
RADBG_RATE_UP_RTY_RATIO = 8,
109
RADBG_RATE_DOWN_RTY_RATIO = 9, /* u8 */
111
RADBG_DEBUG_MONITOR1 = 0xc,
112
RADBG_DEBUG_MONITOR2 = 0xd,
113
RADBG_DEBUG_MONITOR3 = 0xe,
114
RADBG_DEBUG_MONITOR4 = 0xf,
115
RADBG_DEBUG_MONITOR5 = 0x10,
119
enum phydm_wireless_mode_e {
121
PHYDM_WIRELESS_MODE_UNKNOWN = 0x00,
122
PHYDM_WIRELESS_MODE_A = 0x01,
123
PHYDM_WIRELESS_MODE_B = 0x02,
124
PHYDM_WIRELESS_MODE_G = 0x04,
125
PHYDM_WIRELESS_MODE_AUTO = 0x08,
126
PHYDM_WIRELESS_MODE_N_24G = 0x10,
127
PHYDM_WIRELESS_MODE_N_5G = 0x20,
128
PHYDM_WIRELESS_MODE_AC_5G = 0x40,
129
PHYDM_WIRELESS_MODE_AC_24G = 0x80,
130
PHYDM_WIRELESS_MODE_AC_ONLY = 0x100,
131
PHYDM_WIRELESS_MODE_MAX = 0x800,
132
PHYDM_WIRELESS_MODE_ALL = 0xFFFF
135
enum phydm_rateid_idx_e {
137
PHYDM_BGN_40M_2SS = 0,
138
PHYDM_BGN_40M_1SS = 1,
139
PHYDM_BGN_20M_2SS = 2,
140
PHYDM_BGN_20M_1SS = 3,
146
PHYDM_ARFR0_AC_2SS = 9,
147
PHYDM_ARFR1_AC_1SS = 10,
148
PHYDM_ARFR2_AC_2G_1SS = 11,
149
PHYDM_ARFR3_AC_2G_2SS = 12,
150
PHYDM_ARFR4_AC_3SS = 13,
151
PHYDM_ARFR5_N_3SS = 14
154
enum phydm_rf_type_def_e {
178
#if (RATE_ADAPTIVE_SUPPORT == 1)/* 88E RA */
179
struct _odm_ra_info_ {
198
u8 ra_waiting_counter;
199
u8 ra_pending_counter;
200
u8 ra_drop_after_down;
201
#if 1 /* POWER_TRAINING_ACTIVE == 1 */ /* For compile pass only~! */
202
u8 pt_active; /* on or off */
203
u8 pt_try_state; /* 0 trying state, 1 for decision state */
204
u8 pt_stage; /* 0~6 */
205
u8 pt_stop_count; /* Stop PT counter */
206
u8 pt_pre_rate; /* if rate change do PT */
207
u8 pt_pre_rssi; /* if RSSI change 5% do PT */
208
u8 pt_mode_ss; /* decide whitch rate should do PT */
209
u8 ra_stage; /* StageRA, decide how many times RA will be done between PT */
212
#if (DM_ODM_SUPPORT_TYPE == ODM_AP) && ((DEV_BUS_TYPE == RT_USB_INTERFACE) || (DEV_BUS_TYPE == RT_SDIO_INTERFACE))
213
u8 rate_down_counter;
218
u8 bounding_learning_time;
219
u8 rate_down_start_time;
225
struct _rate_adaptive_table_ {
227
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
228
boolean PT_collision_pre;
231
#if (defined(CONFIG_RA_DBG_CMD))
232
boolean is_ra_dbg_init;
234
u8 RTY_P[ODM_NUM_RATE_IDX];
235
u8 RTY_P_default[ODM_NUM_RATE_IDX];
236
boolean RTY_P_modify_note[ODM_NUM_RATE_IDX];
238
u8 RATE_UP_RTY_RATIO[ODM_NUM_RATE_IDX];
239
u8 RATE_UP_RTY_RATIO_default[ODM_NUM_RATE_IDX];
240
boolean RATE_UP_RTY_RATIO_modify_note[ODM_NUM_RATE_IDX];
242
u8 RATE_DOWN_RTY_RATIO[ODM_NUM_RATE_IDX];
243
u8 RATE_DOWN_RTY_RATIO_default[ODM_NUM_RATE_IDX];
244
boolean RATE_DOWN_RTY_RATIO_modify_note[ODM_NUM_RATE_IDX];
246
boolean ra_para_feedback_req;
254
u8 link_tx_rate[ODM_ASSOCIATE_ENTRY_NUM];
255
u8 highest_client_tx_order;
256
u16 highest_client_tx_rate_order;
257
u8 power_tracking_flag;
258
u8 RA_threshold_offset;
259
u8 RA_offset_direction;
260
u8 force_update_ra_mask_count;
262
#if (defined(CONFIG_RA_DYNAMIC_RTY_LIMIT))
263
u8 per_rate_retrylimit_20M[ODM_NUM_RATE_IDX];
264
u8 per_rate_retrylimit_40M[ODM_NUM_RATE_IDX];
265
u8 retry_descend_num;
273
struct _ODM_RATE_ADAPTIVE {
274
u8 type; /* dm_type_by_fw/dm_type_by_driver */
275
u8 high_rssi_thresh; /* if RSSI > high_rssi_thresh => ratr_state is DM_RATR_STA_HIGH */
276
u8 low_rssi_thresh; /* if RSSI <= low_rssi_thresh => ratr_state is DM_RATR_STA_LOW */
277
u8 ratr_state; /* Current RSSI level, DM_RATR_STA_HIGH/DM_RATR_STA_MIDDLE/DM_RATR_STA_LOW */
279
#if (DM_ODM_SUPPORT_TYPE & (ODM_WIN | ODM_CE))
280
u8 ldpc_thres; /* if RSSI > ldpc_thres => switch from LPDC to BCC */
281
boolean is_lower_rts_rate;
284
#if (DM_ODM_SUPPORT_TYPE & ODM_WIN)
286
#elif (DM_ODM_SUPPORT_TYPE & ODM_CE)
289
u8 ultra_low_rssi_thresh;
290
u32 last_ratr; /* RATR Register Content */
304
#if (defined(CONFIG_RA_DBG_CMD))
313
odm_ra_para_adjust_init(
331
odm_c2h_ra_para_report_handler(
343
phydm_ra_dynamic_retry_count(
348
phydm_ra_dynamic_retry_limit(
353
phydm_ra_dynamic_rate_id_on_assoc(
367
phydm_c2h_ra_report_handler(
374
phydm_rate_order_compute(
380
phydm_ra_info_watchdog(
390
odm_rssi_monitor_init(
395
phydm_modify_RA_PCR_threshold(
397
u8 RA_offset_direction,
398
u8 RA_threshold_offset
402
odm_rssi_monitor_check(
412
phydm_vht_en_mapping(
418
phydm_rate_id_mapping(
426
phydm_update_hal_ra_mask(
433
u32 *ratr_bitmap_msb_in,
439
odm_rate_adaptive_mask_init(
444
odm_refresh_rate_adaptive_mask(
449
odm_refresh_rate_adaptive_mask_mp(
454
odm_refresh_rate_adaptive_mask_ce(
459
odm_refresh_rate_adaptive_mask_apadsl(
464
phydm_RA_level_decision(
474
boolean is_force_update,
479
odm_refresh_basic_rate_mask(
483
odm_ra_post_action_on_assoc(
487
#if (DM_ODM_SUPPORT_TYPE & (ODM_WIN | ODM_CE))
493
boolean is_erp_protect
497
odm_update_noisy_state(
499
boolean is_noisy_state_from_c2h
503
phydm_update_pwr_track(
508
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
511
phydm_find_minimum_rssi(
512
struct PHY_DM_STRUCT *p_dm_odm,
513
struct _ADAPTER *p_adapter,
514
OUT boolean *p_is_link_temp
518
odm_update_init_rate_work_item_callback(
523
odm_rssi_dump_to_register(
528
odm_refresh_ldpc_rts_mp(
529
struct _ADAPTER *p_adapter,
530
struct PHY_DM_STRUCT *p_dm_odm,
533
s32 undecorated_smoothed_pwdb
538
odm_dynamic_arfb_select(
541
boolean collision_state
546
odm_rate_adaptive_state_ap_init(
548
struct sta_info *p_entry
550
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE)
554
struct _ADAPTER *p_adapter
558
phydm_get_rate_bitmap_ex(
574
void phydm_ra_rssi_rpt_wk(void *p_context);
575
#endif/*#elif (DM_ODM_SUPPORT_TYPE == ODM_CE)*/
577
#elif (DM_ODM_SUPPORT_TYPE & (ODM_AP))
580
phydm_gen_ramask_h2c_AP(
582
struct rtl8192cd_priv *priv,
583
struct sta_info *p_entry,
587
#endif/*#if (DM_ODM_SUPPORT_TYPE & (ODM_WIN| ODM_CE))*/
589
#endif /*#ifndef __ODMRAINFO_H__*/