• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * TrafficMonitorAPI.h
3  *
4  * Copyright(c) 1998 - 2009 Texas Instruments. All rights reserved.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  *  * Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  *  * Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in
15  *    the documentation and/or other materials provided with the
16  *    distribution.
17  *  * Neither the name Texas Instruments nor the names of its
18  *    contributors may be used to endorse or promote products derived
19  *    from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 
35 /***************************************************************************/
36 /*                                                                                                                                                 */
37 /*        MODULE:       TrafficMonitor.h                                                                           */
38 /*    PURPOSE:  TrafficMonitor module Header file                                              */
39 /*                                                                                                                                                 */
40 /***************************************************************************/
41 #ifndef _TRAFFIC_MONITOR_API_H
42 #define _TRAFFIC_MONITOR_API_H
43 
44 #include "DataCtrl_Api.h"
45 #include "DrvMainModules.h"
46 
47 /**/
48 /* call back functions prototype.*/
49 /**/
50 typedef void (*TraffEevntCall_t)(TI_HANDLE Context,TI_UINT32 Cookie);
51 
52 
53 /*
54  *      This enum list all the available traffic monitor event
55  *  that a client can register to.
56  */
57 typedef enum
58 {
59     TX_ALL_MSDU_FRAMES =1,
60     RX_ALL_MSDU_FRAMES,
61     TX_RX_DIRECTED_FRAMES,
62     TX_RX_ALL_MSDU_FRAMES,
63     TX_RX_ALL_MSDU_IN_BYTES,
64     TX_RX_DIRECTED_IN_BYTES,
65     TX_RX_ALL_802_11_DATA_IN_BYTES,
66     TX_RX_ALL_802_11_DATA_FRAMES
67 } TraffEvntOptNum_t;
68 
69 
70 
71 typedef enum
72 {
73     TRAFF_EDGE = 0,
74     TRAFF_LEVEL
75 }TraffTrigger_t;
76 
77 typedef enum
78 {
79     TRAFF_UP = 0,
80     TRAFF_DOWN
81 }TraffDirection_t;
82 
83 typedef struct
84 {
85     /*initial param*/
86         TraffEevntCall_t    CallBack;
87     TI_HANDLE           Context;
88     TI_UINT32              Cookie;
89     TraffDirection_t    Direction;
90     TraffTrigger_t      Trigger;
91     int                                 Threshold;
92     TI_UINT32              TimeIntervalMs;
93     TraffEvntOptNum_t   MonitorType;
94 }TrafficAlertRegParm_t;
95 
96 
97 /*********************************************************************/
98 
99 
100 TI_HANDLE TrafficMonitor_create(TI_HANDLE hOs);
101 void TrafficMonitor_Init (TStadHandlesList *pStadHandles, TI_UINT32 BWwindowMs);
102 TI_STATUS TrafficMonitor_Destroy(TI_HANDLE hTrafficMonitor);
103 TI_HANDLE TrafficMonitor_RegEvent(TI_HANDLE hTrafficMonitor, TrafficAlertRegParm_t *TrafficAlertRegParm, TI_BOOL AutoResetCreate);
104 TI_STATUS TrafficMonitor_SetRstCondition(TI_HANDLE hTrafficMonitor,TI_HANDLE EventHandle,TI_HANDLE ResetEventHandle,TI_BOOL MutualRst);
105 int TrafficMonitor_GetFrameBandwidth(TI_HANDLE hTrafficMonitor);
106 void TrafficMonitor_UnregEvent(TI_HANDLE hTrafficMonitor, TI_HANDLE EventHandle);
107 void TrafficMonitor_Event(TI_HANDLE hTrafficMonitor,int Count,TI_UINT16 Mask,TI_UINT32 MonitorModuleType);
108 void TrafficMonitor_StopEventNotif(TI_HANDLE hTrafficMonitor,TI_HANDLE EventHandle);
109 void TrafficMonitor_StartEventNotif(TI_HANDLE hTrafficMonitor,TI_HANDLE EventHandle);
110 void TrafficMonitor_ResetEvent(TI_HANDLE hTrafficMonitor, TI_HANDLE EventHandle);
111 TI_STATUS TrafficMonitor_Stop(TI_HANDLE hTrafficMonitor);
112 TI_STATUS TrafficMonitor_Start(TI_HANDLE hTrafficMonitor);
113 TI_BOOL TrafficMonitor_IsEventOn(TI_HANDLE EventHandle);
114 
115 
116 
117 
118 #endif
119 
120 
121