summaryrefslogtreecommitdiff
path: root/network/wlan/WDI/HAL/HalTxFeedback.h
blob: 2f66eead3255ea5608996e16ba6d7cf8ba221113 (plain)
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

#ifndef __INC_HAL_TX_FEEDBACK_H
#define __INC_HAL_TX_FEEDBACK_H


// The identifier/reason of the tx feedback
#define	RT_TX_FEEDBACK_ID_AP_WMM_PS_PKT				BIT0
#define	RT_TX_FEEDBACK_ID_AP_WMM_EOSP_ENDING		BIT1
#define	RT_TX_FEEDBACK_ID_TDLS_TEARDOWN_PKT			BIT2
#define	RT_TX_FEEDBACK_ID_TDLS_CHNLSWITCH			BIT3
#define	RT_TX_FEEDBACK_ID_TDLS_NULL_PKT				BIT4
#define	RT_TX_FEEDBACK_ID_TDLS_CS_DATA_PKT			BIT5
#define	RT_TX_FEEDBACK_ID_TDLS_CHNLSWITCH_REQ		BIT6
#define	RT_TX_FEEDBACK_ID_TDLS_PTR					BIT7
#define	RT_TX_FEEDBACK_ID_SCAN_TX_NULL				BIT8	// Send Null frame when starting scan process
#define RT_TX_FEEDBACK_ID_P2P_NEGO_TX				BIT9
#define RT_TX_FEEDBACK_ID_CCX_TSM					BIT10
#define RT_TX_FEEDBACK_ID_CCX_LINK_TEST				BIT11
#define RT_TX_FEEDBACK_ID_P2P_PD_RSP_TX				BIT12
#define RT_TX_FEEDBACK_ID_OFF_CHNL_TX				BIT13


#define 	RT_TX_FEEDBACK_ID_MULTICHANNEL_NULL_PKT	BIT31

typedef struct _RT_TX_FEEDBACK_INFO RT_TX_FEEDBACK_INFO, *PRT_TX_FEEDBACK_INFO;

typedef	VOID
(*RtTxFeedbackCallbackHandler)(
	PADAPTER pAdapter,
	const RT_TX_FEEDBACK_INFO * const pTxFeedbackInfo
);

typedef struct _RT_TX_FEEDBACK_INFO_TX_PROFILE
{
	RT_VALID_PAIR_BOOLEAN	bPktOk;
	RT_VALID_PAIR_BOOLEAN	bRetryOver;
	RT_VALID_PAIR_BOOLEAN	bLifeTimeOver;
	RT_VALID_PAIR_BOOLEAN	bUnicast;
	RT_VALID_PAIR_U4BYTE	uQueueID;
	RT_VALID_PAIR_U4BYTE	uMacID;
	RT_VALID_PAIR_U4BYTE	uDataRetryCount;
	RT_VALID_PAIR_U4BYTE	uQueueTimeUs;
	RT_VALID_PAIR_U4BYTE	uFinalDataRateIndex;

} RT_TX_FEEDBACK_INFO_TX_PROFILE, *PRT_TX_FEEDBACK_INFO_TX_PROFILE;

#define GET_TX_PROFILE_PKT_OK(_pTxProfile)						(((_pTxProfile)->bPktOk.bVaild) ? 				((_pTxProfile)->bPktOk.Data) 				: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_RETRY_OVER(_pTxProfile)					(((_pTxProfile)->bRetryOver.bVaild) ? 			((_pTxProfile)->bRetryOver.Data) 			: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_LEFE_TIME_OVER(_pTxProfile)				(((_pTxProfile)->bLifeTimeOver.bVaild) ? 			((_pTxProfile)->bLifeTimeOver.Data) 		: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_IS_UNICAST(_pTxProfile)					(((_pTxProfile)->bUnicast.bVaild) ? 				((_pTxProfile)->bUnicast.Data) 				: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_QUEUE_ID(_pTxProfile)					(((_pTxProfile)->uQueueID.bVaild) ? 			((_pTxProfile)->uQueueID.Data) 			: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_MAC_ID(_pTxProfile)						(((_pTxProfile)->uMacID.bVaild) ? 				((_pTxProfile)->uMacID.Data) 				: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_DATA_RETRY_COUNT(_pTxProfile)			(((_pTxProfile)->uDataRetryCount.bVaild) ? 		((_pTxProfile)->uDataRetryCount.Data) 		: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_QUEUE_TIME_US(_pTxProfile)				(((_pTxProfile)->uQueueTimeUs.bVaild) ? 		((_pTxProfile)->uQueueTimeUs.Data) 		: TxFeedbackAssertForInvalidData())
#define GET_TX_PROFILE_FINAL_DATA_RATE_INDEX(_pTxProfile)		(((_pTxProfile)->uFinalDataRateIndex.bVaild) ? 	((_pTxProfile)->uFinalDataRateIndex.Data) 	: TxFeedbackAssertForInvalidData())


typedef struct	_RT_TX_FEEDBACK_INFO
{
	// User Configuration Part ------------------------------------------------------
	RT_LIST_ENTRY				List;			// The linked list pointer.
	u4Byte						Identifier;		// The ID to identify this tx feedback.
	u4Byte						Reason;			// The reason for this packet.
	PADAPTER					pAdapter;		// The adapter address.
	RtTxFeedbackCallbackHandler	Callback;		// The callback function.
	PVOID						pContext;		// The context address.
	// --------------------------------------------------------------------------

	// Packet Tx Profile -----------------------------------------------------------
	RT_TX_FEEDBACK_INFO_TX_PROFILE	TxProfile;
	// --------------------------------------------------------------------------
	
}RT_TX_FEEDBACK_INFO, *PRT_TX_FEEDBACK_INFO;


#define	HAL_MAX_TX_FEEDBACK_INFO_NUM			16 		// The same number with TID.
#define	HAL_MAX_TX_FEEDBACK_QUEUE_NUM			7		// The number of the edca (TID) queue for the tx feedback information


typedef struct _TX_FEEDBACK_CONTEXT{

	BOOLEAN						bSupportTxFeedBack;
	RT_TX_FEEDBACK_INFO			TxFeedbackArray[HAL_MAX_TX_FEEDBACK_INFO_NUM];

	// Use RT_TX_SPINLOCK to protect the queue context ------------------------------------------------------------
	RT_LIST_ENTRY				TxFeedbackIdleQueue;
	RT_LIST_ENTRY				TxFeedbackEDCAQueue[HAL_MAX_TX_FEEDBACK_QUEUE_NUM];	// The number of TID.
	// --------------------------------------------------------------------------------------------------------

} TX_FEEDBACK_CONTEXT, *PTX_FEEDBACK_CONTEXT;

#define TX_FEEDBACK_SIZE_OF_CONTEXT 	sizeof(TX_FEEDBACK_CONTEXT)



typedef struct _TX_FEEDBACK_TCB_ZONE{

	PRT_TX_FEEDBACK_INFO 	pTxFeedbackInfo;
	
} TX_FEEDBACK_TCB_ZONE, *PTX_FEEDBACK_TCB_ZONE;

#define TX_FEEDBACK_SIZE_OF_TCB_ZONE 	sizeof(TX_FEEDBACK_TCB_ZONE)





VOID
TxFeedbackInitialize(
	PADAPTER pAdapter
);

BOOLEAN
TxFeedbackExistActiveTxFeedbackInfo(
	PADAPTER pAdapter
);

PRT_TX_FEEDBACK_INFO
TxFeedbackGetMatchedTxFeedbackInfoFromSpecificQueue(
	PADAPTER pAdapter,
	u1Byte QueueID,
	u4Byte TxFeedbackID
);

static VOID
TxFeedbackReturnTxFeedbackInfo(
	PADAPTER pAdapter,
	PRT_TX_FEEDBACK_INFO pTxFeedbackInfo
);

VOID
TxFeedbackSetActiveTxFeedbackInfo(
	PADAPTER pAdapter,
	u1Byte QueueID,
	PRT_TCB pTcb
);

VOID
TxFeedbackSetTxFeedbackInfoID(
	PADAPTER pAdapter,
	PRT_TCB pTcb
);

VOID
TxFeedbackExecuteCallbackAndReturnTxFeedbackInfo(
	PADAPTER pAdapter,
	PRT_TX_FEEDBACK_INFO pTxFeedbackInfo
);


BOOLEAN
TxFeedbackInstallTxFeedbackInfoForTcb(
	PADAPTER pAdapter,
	PRT_TCB pTcb
);

VOID
TxFeedbackDeInstallTxFeedbackInfoForTcb(
	PADAPTER pAdapter,
	PRT_TCB pTcb
);

VOID
TxFeedbackFillTxFeedbackInfoUserConfiguration(
	PRT_TCB 					pTcb,
	u4Byte						Reason,
	PADAPTER					pAdapter,
	RtTxFeedbackCallbackHandler	Callback,
	PVOID						pContext
);

BOOLEAN
TxFeedbackIsTxFeedbackInfoInstalled(
	PRT_TCB 					pTcb
);

BOOLEAN
TxFeedbackCheckCurrentFunctionality(
	PADAPTER pAdapter
);

BOOLEAN
TxFeedbackAssertForInvalidData(
);




#endif