• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * report.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:   report.h                                                    */
38 /*    PURPOSE:  Report module internal header API                           */
39 /*                                                                          */
40 /***************************************************************************/
41 #ifndef __REPORT_H__
42 #define __REPORT_H__
43 
44 /** \file  report.h
45  * \brief Report module API	\n
46  * APIs which are used for reporting messages to the User while running. \n\n
47  *
48  * The report mechanism: Messages are reported per file and severity Level	\n
49  * Therefore, each file has a report flag which indicate if reporting for that file is enabled, \n
50  * and each severity has a severity flag which indicate if reporting for that severity is enabled.	\n
51  * Only if both flags are enabled, the message is printed. \n
52  * The report flags of all file are indicated in a bit map Table which is contained in the report module handle	\n
53  * The report flags of all severities  are indicated in a bit map Table which is contained in the report module handle	\n
54  */
55 
56 /* in order to work without the driver logger use that definition here
57  * #define PRINTF_ROLLBACK
58  */
59 
60 #include "osApi.h"
61 #include "commonTypes.h"
62 
63 #define MAX_STRING_LEN         32
64 
65 
66 /*******************************/
67 /*      Report Files IDs       */
68 /*******************************/
69 
70 typedef enum
71 {
72 	FILE_ID_0	   ,    /*   timer                    */
73 	FILE_ID_1	   ,    /*   measurementMgr			  */
74 	FILE_ID_2	   ,    /*   measurementMgrSM         */
75 	FILE_ID_3	   ,    /*   regulatoryDomain         */
76 	FILE_ID_4	   ,    /*   requestHandler           */
77 	FILE_ID_5	   ,    /*   SoftGemini               */
78 	FILE_ID_6	   ,    /*   spectrumMngmntMgr        */
79 	FILE_ID_7	   ,    /*   SwitchChannel            */
80 	FILE_ID_8	   ,    /*   roamingMngr              */
81 	FILE_ID_9	   ,    /*   scanMngr                 */
82 	FILE_ID_10	   ,    /*   admCtrlXCC               */
83 	FILE_ID_11	   ,    /*   XCCMngr                  */
84 	FILE_ID_12	   ,    /*   XCCRMMngr                */
85 	FILE_ID_13	   ,    /*   XCCTSMngr                */
86 	FILE_ID_14	   ,    /*   rogueAp                  */
87 	FILE_ID_15	   ,    /*   TransmitPowerXCC         */
88 	FILE_ID_16	   ,    /*   admCtrl                  */
89 	FILE_ID_17	   ,    /*   admCtrlNone              */
90 	FILE_ID_18	   ,    /*   admCtrlWep               */
91 	FILE_ID_19	   ,    /*   admCtrlWpa               */
92 	FILE_ID_20	   ,    /*   admCtrlWpa2              */
93 	FILE_ID_21	   ,    /*   apConn                   */
94 	FILE_ID_22	   ,    /*   broadcastKey802_1x       */
95 	FILE_ID_23	   ,    /*   broadcastKeyNone         */
96 	FILE_ID_24	   ,    /*   broadcastKeySM           */
97 	FILE_ID_25	   ,    /*   conn                     */
98 	FILE_ID_26	   ,    /*   connIbss                 */
99 	FILE_ID_27	   ,    /*   connInfra                */
100 	FILE_ID_28	   ,    /*   keyDerive                */
101 	FILE_ID_29	   ,    /*   keyDeriveAes             */
102 	FILE_ID_30	   ,    /*   keyDeriveCkip            */
103 	FILE_ID_31	   ,    /*   keyDeriveTkip            */
104 	FILE_ID_32	   ,    /*   keyDeriveWep             */
105 	FILE_ID_33	   ,    /*   keyParser                */
106 	FILE_ID_34	   ,    /*   keyParserExternal        */
107 	FILE_ID_35	   ,    /*   keyParserWep             */
108 	FILE_ID_36	   ,    /*   mainKeysSm               */
109 	FILE_ID_37	   ,    /*   mainSecKeysOnly          */
110 	FILE_ID_38	   ,    /*   mainSecNull              */
111 	FILE_ID_39	   ,    /*   mainSecSm                */
112 	FILE_ID_40	   ,    /*   rsn                      */
113 	FILE_ID_41	   ,    /*   sme                      */
114 	FILE_ID_42	   ,    /*   smeSelect                */
115 	FILE_ID_43	   ,    /*   smeSm                    */
116 	FILE_ID_44	   ,    /*   unicastKey802_1x         */
117 	FILE_ID_45	   ,    /*   unicastKeyNone           */
118 	FILE_ID_46	   ,    /*   unicastKeySM             */
119 	FILE_ID_47	   ,    /*   CmdDispatcher            */
120 	FILE_ID_48	   ,    /*   CmdHndlr                 */
121 	FILE_ID_49	   ,    /*   DrvMain                  */
122 	FILE_ID_50	   ,    /*   EvHandler                */
123 	FILE_ID_51	   ,    /*   Ctrl                     */
124 	FILE_ID_52	   ,    /*   GeneralUtil              */
125 	FILE_ID_53	   ,    /*   RateAdaptation           */
126 	FILE_ID_54	   ,    /*   rx                       */
127 	FILE_ID_55	   ,    /*   TrafficMonitor           */
128 	FILE_ID_56	   ,    /*   txCtrl                   */
129 	FILE_ID_57	   ,    /*   txCtrlParams             */
130 	FILE_ID_58	   ,    /*   txCtrlServ               */
131 	FILE_ID_59	   ,    /*   TxDataClsfr              */
132 	FILE_ID_60	   ,    /*   txDataQueue              */
133 	FILE_ID_61	   ,    /*   txMgmtQueue              */
134 	FILE_ID_62	   ,    /*   txPort                   */
135 	FILE_ID_63	   ,    /*   assocSM                  */
136 	FILE_ID_64	   ,    /*   authSm                   */
137 	FILE_ID_65	   ,    /*   currBss                  */
138 	FILE_ID_66	   ,    /*   healthMonitor            */
139 	FILE_ID_67	   ,    /*   mlmeBuilder              */
140 	FILE_ID_68	   ,    /*   mlmeParser               */
141 	FILE_ID_69	   ,    /*   mlmeSm                   */
142 	FILE_ID_70	   ,    /*   openAuthSm               */
143 	FILE_ID_71	   ,    /*   PowerMgr                 */
144 	FILE_ID_72	   ,    /*   PowerMgrDbgPrint         */
145 	FILE_ID_73	   ,    /*   PowerMgrKeepAlive        */
146 	FILE_ID_74	   ,    /*   qosMngr                  */
147 	FILE_ID_75	   ,    /*   roamingInt               */
148 	FILE_ID_76	   ,    /*   ScanCncn                 */
149 	FILE_ID_77	   ,    /*   ScanCncnApp              */
150 	FILE_ID_78	   ,    /*   ScanCncnOsSm             */
151 	FILE_ID_79	   ,    /*   ScanCncnSm               */
152 	FILE_ID_80	   ,    /*   ScanCncnSmSpecific       */
153 	FILE_ID_81	   ,    /*   scanResultTable          */
154 	FILE_ID_82	   ,    /*   scr                      */
155 	FILE_ID_83	   ,    /*   sharedKeyAuthSm          */
156 	FILE_ID_84	   ,    /*   siteHash                 */
157 	FILE_ID_85	   ,    /*   siteMgr                  */
158 	FILE_ID_86	   ,    /*   StaCap                   */
159 	FILE_ID_87	   ,    /*   systemConfig             */
160 	FILE_ID_88	   ,    /*   templates                */
161 	FILE_ID_89	   ,    /*   trafficAdmControl        */
162 	FILE_ID_90	   ,    /*   CmdBld                   */
163 	FILE_ID_91	   ,    /*   CmdBldCfg                */
164 	FILE_ID_92	   ,    /*   CmdBldCfgIE              */
165 	FILE_ID_93	   ,    /*   CmdBldCmd                */
166 	FILE_ID_94	   ,    /*   CmdBldCmdIE              */
167 	FILE_ID_95	   ,    /*   CmdBldItr                */
168 	FILE_ID_96	   ,    /*   CmdBldItrIE              */
169 	FILE_ID_97	   ,    /*   CmdQueue                 */
170 	FILE_ID_98	   ,    /*   RxQueue                  */
171 	FILE_ID_99	   ,    /*   txCtrlBlk                */
172 	FILE_ID_100	   ,    /*   txHwQueue                */
173 	FILE_ID_101	   ,    /*   CmdMBox                  */
174 	FILE_ID_102	   ,    /*   eventMbox                */
175 	FILE_ID_103	   ,    /*   fwDebug                  */
176 	FILE_ID_104	   ,    /*   FwEvent                  */
177 	FILE_ID_105	   ,    /*   HwInit                   */
178 	FILE_ID_106	   ,    /*   RxXfer                   */
179 	FILE_ID_107	   ,    /*   txResult                 */
180 	FILE_ID_108	   ,    /*   txXfer                   */
181 	FILE_ID_109	   ,    /*   MacServices              */
182 	FILE_ID_110	   ,    /*   MeasurementSrv           */
183 	FILE_ID_111	   ,    /*   measurementSrvDbgPrint   */
184 	FILE_ID_112	   ,    /*   MeasurementSrvSM         */
185 	FILE_ID_113	   ,    /*   PowerSrv                 */
186 	FILE_ID_114	   ,    /*   PowerSrvSM               */
187 	FILE_ID_115	   ,    /*   ScanSrv                  */
188 	FILE_ID_116	   ,    /*   ScanSrvSM                */
189 	FILE_ID_117	   ,    /*   TWDriver                 */
190 	FILE_ID_118	   ,    /*   TWDriverCtrl             */
191 	FILE_ID_119	   ,    /*   TWDriverRadio            */
192 	FILE_ID_120	   ,    /*   TWDriverTx               */
193 	FILE_ID_121	   ,    /*   TwIf                     */
194 	FILE_ID_122	   ,    /*   SdioBusDrv               */
195 	FILE_ID_123	   ,    /*   TxnQueue                 */
196 	FILE_ID_124	   ,    /*   WspiBusDrv               */
197 	FILE_ID_125	   ,    /*   context                  */
198 	FILE_ID_126	   ,    /*   freq                     */
199 	FILE_ID_127	   ,    /*   fsm                      */
200 	FILE_ID_128	   ,    /*   GenSM                    */
201 	FILE_ID_129	   ,    /*   mem                      */
202 	FILE_ID_130	   ,    /*   queue                    */
203 	FILE_ID_131	   ,    /*   rate                     */
204 	FILE_ID_132	   ,    /*   report                   */
205 	FILE_ID_133	   ,    /*   stack                    */
206     FILE_ID_134	   ,    /*   externalSec              */
207     FILE_ID_135	   ,    /*   roamingMngr_autoSM       */
208     FILE_ID_136	   ,    /*   roamingMngr_manualSM     */
209 
210 	FILE_ID_137	   ,    /*   cmdinterpretoid          */
211 	REPORT_FILES_NUM	/*   Number of files with trace reports   */
212 
213 } EReportFiles;
214 
215 
216 /************************************/
217 /*      Report Severity values      */
218 /************************************/
219 
220 /** \enum EReportSeverity
221  * \brief Report Severity Types
222  *
223  * \par Description
224  * All available severity Levels of the events which are reported to user.\n
225  *
226  * \sa
227  */
228 typedef enum
229 {
230     REPORT_SEVERITY_INIT           =  1,	/**< Init Level (event happened during initialization)			*/
231     REPORT_SEVERITY_INFORMATION    =  2,	/**< Information Level											*/
232     REPORT_SEVERITY_WARNING        =  3,	/**< Warning Level												*/
233     REPORT_SEVERITY_ERROR          =  4,	/**< Error Level (error accored)  		 						*/
234     REPORT_SEVERITY_FATAL_ERROR    =  5,	/**< Fatal-Error Level (fatal-error accored)					*/
235     REPORT_SEVERITY_SM             =  6,	/**< State-Machine Level (event happened in State-Machine)		*/
236     REPORT_SEVERITY_CONSOLE        =  7,	/**< Consol Level (event happened in Consol) 					*/
237     REPORT_SEVERITY_MAX            = REPORT_SEVERITY_CONSOLE + 1	/**< Maximum number of report severity levels	*/
238 
239 } EReportSeverity;
240 
241 /** \struct TReport
242  * \brief Report Module Object
243  *
244  * \par Description
245  * All the Databases and other parameters which are needed for reporting messages to user
246  *
247  * \sa
248  */
249 typedef struct
250 {
251     TI_HANDLE       hOs;												/**< Handle to Operating System Object																									*/
252     TI_UINT8        aSeverityTable[REPORT_SEVERITY_MAX];				/**< Severities Table: Table which holds for each severity level a flag which indicates whether the severity is enabled for reporting	*/
253 	char            aSeverityDesc[REPORT_SEVERITY_MAX][MAX_STRING_LEN];	/**< Severities Descriptors Table: Table which holds for each severity a string of its name, which is used in severity's reported messages		*/
254     TI_UINT8        aFileEnable[REPORT_FILES_NUM];					    /**< Files table indicating per file if it is enabled for reporting	 */
255 
256 #ifdef PRINTF_ROLLBACK
257     char            aFileName[REPORT_FILES_NUM][MAX_STRING_LEN];	    /**< Files names table inserted in the file's reported messages		 */
258 #endif
259 
260 } TReport;
261 
262 /** \struct TReportParamInfo
263  * \brief Report Parameter Information
264  *
265  * \par Description
266  * Struct which defines all the Databases and other parameters which are needed
267  * for reporting messages to user.
268  * The actual Content of the Report Parameter Could be one of the followed (held in union):
269  * Severety Table | Module Table | Enable/Disable indication of debug module usage
270  *
271  * \sa	EExternalParam, ETwdParam
272  */
273 typedef struct
274 {
275     TI_UINT32       paramType;								/**< The reported parameter type - one of External Parameters (which includes Set,Get, Module, internal number etc.)
276 															* of Report Module. Used by user for Setting or Getting Report Module Paramters, for exaple Set/Get severety table
277 															* to/from Report Module
278 															*/
279     TI_UINT32       paramLength;							/**< Length of reported parameter	*/
280 
281     union
282     {
283         TI_UINT8    aSeverityTable[REPORT_SEVERITY_MAX];	/**< Table which holds severity flag for every available LOG severity level.
284 															* This flag indicates for each severity - whether it is enabled for Logging or not.
285 															* User can Set/Get this Tabel
286 															*/
287         TI_UINT8    aFileEnable[REPORT_FILES_NUM]; 		/**< Table which holds file flag for every available LOG file.
288 															* This flag indicates for each file - whether it is enabled for Logging or not.
289 															* User can Set/Get this Tabel
290 															*/
291         TI_UINT32   uReportPPMode;							/**< Used by user for Indicating if Debug Module should be enabled/disabled																	*/
292 
293     } content;
294 
295 } TReportParamInfo;
296 
297 /** \struct TReportInitParams
298  * \brief Report Init Parameters
299  *
300  * \par Description
301  * Struct which defines all the Databases needed for init and set the defualts of the Report Module.
302  *
303  */
304 typedef struct
305 {
306     /* Note: The arrays sizes are aligned to 4 byte to avoid padding added by the compiler! */
307 	TI_UINT8   aSeverityTable[(REPORT_SEVERITY_MAX + 3) & ~3];	/**< Table in the size of all available LOG severity levels which indicates for each severity - whether it is enabled for Logging or not.	*/
308 	TI_UINT8   aFileEnable   [(REPORT_FILES_NUM    + 3) & ~3];	/**< Table in the size of all available LOG files which indicates for each file - whether it is enabled for Logging or not				*/
309 
310 } TReportInitParams;
311 
312 
313 
314 /****************************/
315 /* report module Macros		*/
316 /****************************/
317 
318 /* The report mechanism is like that:
319     Each file has a report flag. Each severity has a severity flag.
320     Only if bits are enabled, the message is printed */
321 /* The modules which have their report flag enable are indicated by a bit map in the reportModule
322     variable contained in the report handle*/
323 /* The severities which have are enabled are indicated by a bit map in the reportSeverity
324     variable contained in the report handle*/
325 /* general trace messages */
326 #ifndef PRINTF_ROLLBACK
327 
328 #define TRACE0(hReport, level, str) \
329 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
330 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 0); } } while(0)
331 
332 #define TRACE1(hReport, level, str, p1) \
333 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
334 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 1, (TI_UINT32)p1); } } while(0)
335 
336 #define TRACE2(hReport, level, str, p1, p2) \
337 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
338 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 2, (TI_UINT32)p1, (TI_UINT32)p2); } } while(0)
339 
340 #define TRACE3(hReport, level, str, p1, p2, p3) \
341 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
342 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 3, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3); } } while(0)
343 
344 #define TRACE4(hReport, level, str, p1, p2, p3, p4) \
345 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
346 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 4, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4); } } while(0)
347 
348 #define TRACE5(hReport, level, str, p1, p2, p3, p4, p5) \
349 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
350 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 5, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5); } } while(0)
351 
352 #define TRACE6(hReport, level, str, p1, p2, p3, p4, p5, p6) \
353 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
354 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 6, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6); } } while(0)
355 
356 #define TRACE7(hReport, level, str, p1, p2, p3, p4, p5, p6, p7) \
357 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
358 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 7, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7); } } while(0)
359 
360 #define TRACE8(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8) \
361 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
362 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 8, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8); } } while(0)
363 
364 #define TRACE9(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9) \
365 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
366 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 9, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9); } } while(0)
367 
368 #define TRACE10(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10) \
369 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
370 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 10, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10); } } while(0)
371 
372 #define TRACE11(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11) \
373 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
374 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 11, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11); } } while(0)
375 
376 #define TRACE12(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12) \
377 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
378 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 12, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12); } } while(0)
379 
380 #define TRACE13(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13) \
381 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
382 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 13, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13); } } while(0)
383 
384 #define TRACE14(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14) \
385 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
386 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 14, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14); } } while(0)
387 
388 #define TRACE15(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15) \
389 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
390 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 15, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15); } } while(0)
391 
392 #define TRACE16(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16) \
393 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
394 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 16, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16); } } while(0)
395 
396 #define TRACE17(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17) \
397 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
398 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 17, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17); } } while(0)
399 
400 #define TRACE18(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18) \
401 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
402 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 18, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18); } } while(0)
403 
404 #define TRACE19(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19) \
405 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
406 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 19, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18, (TI_UINT32)p19); } } while(0)
407 
408 #define TRACE20(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20) \
409 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
410 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 20, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18, (TI_UINT32)p19, (TI_UINT32)p20); } } while(0)
411 
412 #define TRACE21(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21) \
413 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
414 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 21, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18, (TI_UINT32)p19, (TI_UINT32)p20, (TI_UINT32)p21); } } while(0)
415 
416 #define TRACE22(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22) \
417 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
418 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 22, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18, (TI_UINT32)p19, (TI_UINT32)p20, (TI_UINT32)p21, (TI_UINT32)p22); } } while(0)
419 
420 #define TRACE25(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22, p23, p24, p25) \
421 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
422 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 22, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18, (TI_UINT32)p19, (TI_UINT32)p20, (TI_UINT32)p21, (TI_UINT32)p22, (TI_UINT32)p23, (TI_UINT32)p24, (TI_UINT32)p25); } } while(0)
423 
424 #define TRACE31(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22, p23, p24, p25, p26, p27, p28, p29, p30, p31) \
425 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
426 { os_Trace((((TReport *)hReport)->hOs), level, __FILE_ID__, __LINE__, 22, (TI_UINT32)p1, (TI_UINT32)p2, (TI_UINT32)p3, (TI_UINT32)p4, (TI_UINT32)p5, (TI_UINT32)p6, (TI_UINT32)p7, (TI_UINT32)p8, (TI_UINT32)p9, (TI_UINT32)p10, (TI_UINT32)p11, (TI_UINT32)p12, (TI_UINT32)p13, (TI_UINT32)p14, (TI_UINT32)p15, (TI_UINT32)p16, (TI_UINT32)p17, (TI_UINT32)p18, (TI_UINT32)p19, (TI_UINT32)p20, (TI_UINT32)p21, (TI_UINT32)p22, (TI_UINT32)p23, (TI_UINT32)p24, (TI_UINT32)p25, (TI_UINT32)p26, (TI_UINT32)p27, (TI_UINT32)p28, (TI_UINT32)p29, (TI_UINT32)p30, (TI_UINT32)p31); } } while(0)
427 
428 
429 #else /* PRINTF_ROLLBACK */
430 
431 #define TRACE0(hReport, level, str) \
432 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
433 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str); } } while(0)
434 
435 #define TRACE1(hReport, level, str, p1) \
436 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
437 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1); } } while(0)
438 
439 #define TRACE2(hReport, level, str, p1, p2) \
440 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
441 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2); } } while(0)
442 
443 #define TRACE3(hReport, level, str, p1, p2, p3) \
444 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
445 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3); } } while(0)
446 
447 #define TRACE4(hReport, level, str, p1, p2, p3, p4) \
448 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
449 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4); } } while(0)
450 
451 #define TRACE5(hReport, level, str, p1, p2, p3, p4, p5) \
452 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
453 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5); } } while(0)
454 
455 #define TRACE6(hReport, level, str, p1, p2, p3, p4, p5, p6) \
456 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
457 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6); } } while(0)
458 
459 #define TRACE7(hReport, level, str, p1, p2, p3, p4, p5, p6, p7) \
460 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
461 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7); } } while(0)
462 
463 #define TRACE8(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8) \
464 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
465 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8); } } while(0)
466 
467 #define TRACE9(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9) \
468 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
469 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9); } } while(0)
470 
471 #define TRACE10(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10) \
472 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
473 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10); } } while(0)
474 
475 #define TRACE11(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11) \
476 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
477 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11); } } while(0)
478 
479 #define TRACE12(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12) \
480 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
481 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12); } } while(0)
482 
483 #define TRACE13(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13) \
484 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
485 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13); } } while(0)
486 
487 #define TRACE14(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14) \
488 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
489 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14); } } while(0)
490 
491 #define TRACE15(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15) \
492 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
493 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15); } } while(0)
494 
495 #define TRACE16(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16) \
496 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
497 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16); } } while(0)
498 
499 #define TRACE17(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17) \
500 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
501 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17); } } while(0)
502 
503 #define TRACE18(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18) \
504 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
505 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18); } } while(0)
506 
507 #define TRACE19(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19) \
508 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
509 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19); } } while(0)
510 
511 #define TRACE20(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20) \
512 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
513 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20); } } while(0)
514 
515 #define TRACE21(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21) \
516 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
517 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21); } } while(0)
518 
519 #define TRACE22(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22) \
520 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
521 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22); } } while(0)
522 
523 #define TRACE25(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22, p23, p24, p25) \
524 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
525 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22, p23, p24, p25); } } while(0)
526 
527 #define TRACE31(hReport, level, str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22, p23, p24, p25, p26, p27, p28, p29, p30, p31) \
528 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[level]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
529 { os_printf ("%s, %s:", ((TReport *)hReport)->aFileName[__FILE_ID__], ((TReport *)hReport)->aSeverityDesc[level]); os_printf (str, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15, p16, p17, p18, p19, p20, p21, p22, p23, p24, p25, p27, p27, p28, p29, p30, p31); } } while(0)
530 
531 #endif /* #ifdef PRINTF_ROLLBACK */
532 
533 
534 /****************************/
535 /* report module Macros		*/
536 /****************************/
537 
538 /* The report mechanism is like that:
539 Each file has a report flag. Each severity has a severity flag.
540 Only if bits are enabled, the message is printed */
541 /* The modules which have their report flag enable are indicated by a bit map in the reportModule
542 variable contained in the report handle*/
543 /* The severities which have are enabled are indicated by a bit map in the reportSeverity
544 variable contained in the report handle*/
545 
546 #ifdef REPORT_LOG
547 
548 /** \def WLAN_OS_REPORT
549 * \brief Macro which writes a message to user via specific Operating System printf.
550 * E.g. print is done using the relevant used OS printf method.
551 */
552 #define WLAN_OS_REPORT(msg)                                           \
553 	do { os_printf msg;} while(0)
554 
555 
556 #ifdef INIT_MESSAGES
557 /** \def WLAN_INIT_REPORT
558 * \brief Macro which writes a message to user via specific Operating System printf.
559 * E.g. print is done using the relevant used OS printf method.
560 */
561 #define WLAN_INIT_REPORT(msg)                                         \
562 	do { os_printf msg;} while(0)
563 #else
564 /** \def WLAN_INIT_REPORT
565 * \brief Macro which writes a message to user via specific Operating System printf.
566 * E.g. print is done using the relevant used OS printf method.
567 */
568 #define WLAN_INIT_REPORT(msg)
569 #endif
570 #define TRACE_INFO_HEX(hReport, data, datalen) \
571 	do { if (hReport && (((TReport *)hReport)->aSeverityTable[REPORT_SEVERITY_INFORMATION]) && (((TReport *)hReport)->aFileEnable[__FILE_ID__])) \
572 { report_PrintDump (data, datalen); } } while(0)
573 
574 
575 #else   /* REPORT_LOG */
576 
577 /* NOTE: Keep a dummy report function call to treat compilation warnings */
578 
579 /** \def WLAN_OS_REPORT
580 * \brief Dummy macro: Nothing is done
581 */
582 #define WLAN_OS_REPORT(msg)                                           \
583 	do { } while (0)
584 
585 /** \def WLAN_INIT_REPORT
586 * \brief Dummy macro: Nothing is done
587 */
588 #define WLAN_INIT_REPORT(msg)                                         \
589 	do { } while (0)
590 
591 
592 #define TRACE_INFO_HEX(hReport, data, datalen) \
593 	do { } while (0)
594 
595 #endif  /* REPORT_LOG */
596 
597 
598 /****************************/
599 /* report module prototypes */
600 /****************************/
601 
602 /** \brief  Create Report Module Object
603  * \param  hOs   			- OS module object handle
604  * \return Handle to the report module on success, NULL otherwise
605  *
606  * \par Description
607  * Report module creation function, called by the config mgr in creation phase	\n
608  * performs the following:	\n
609  *	-   Allocate the report handle
610  */
611 TI_HANDLE report_Create (TI_HANDLE hOs);
612 /** \brief  Set Report Module Defaults
613  * \param  hReport   	- Report module object handle
614  * \param  pInitParams	- Pointer to Input Init Parameters
615  * \return TI_OK on success or TI_NOK on failure
616  *
617  * \par Description
618  * Report module configuration function, called by the config mgr in configuration phase	\n
619  * performs the following:	\n
620  *	-   Reset & init local variables
621  *	-   Resets all report modules bits
622  *	-   Resets all severities bits
623  *	-   Init the description strings *
624  */
625 TI_STATUS report_SetDefaults            (TI_HANDLE hReport, TReportInitParams *pInitParams);
626 /** \brief  Unload Report Module
627  * \param  hReport   	- Report module object handle
628  * \return TI_OK on success or TI_NOK on failure
629  *
630  * \par Description
631  * Report Module unload function, called by the config mgr in the unload phase	\n
632  * performs the following:	\n
633  *	-   Free all memory allocated by the module
634  */
635 TI_STATUS report_Unload                 (TI_HANDLE hReport);
636 /** \brief  Set Report Module
637  * \param  hReport   	- Report module object handle
638  * \return TI_OK on success or TI_NOK on failure
639  *
640  * \par Description
641  * Enables the relevant module for reporting -  according to the received module index
642  */
643 TI_STATUS report_SetReportModule        (TI_HANDLE hReport, TI_UINT8 module_index);
644 /** \brief  Clear Report Module
645  * \param  hReport   	- Report module object handle
646  * \param  module_index	- Index of file to be disable for reporting
647  * \return TI_OK on success or TI_NOK on failure
648  *
649  * \par Description
650  * Disables the relevant module for reporting -  according to the received module index
651  */
652 TI_STATUS report_ClearReportModule      (TI_HANDLE hReport, TI_UINT8 module_index);
653 /** \brief  Get Report files Table
654  * \param  hReport   	- Report module object handle
655  * \param  pFiles		- Pointer to output files Table
656  * \return TI_OK on success or TI_NOK on failure
657  *
658  * \par Description
659  * Returns the Modules Table (the table which holds Modules reporting indication) held in Report Module Object
660  */
661 TI_STATUS report_GetReportFilesTable    (TI_HANDLE hReport, TI_UINT8 *pFiles);
662 /** \brief  Set Report Files Table
663  * \param  hReport   	- Report module object handle
664  * \param  pFiles		- Pointer to input files Table
665  * \return TI_OK on success or TI_NOK on failure
666  *
667  * \par Description
668  * Updates the Modules Table: copies the input Modules Table (the table which holds Modules reporting indication)
669  * to the Modules Table which is held in Report Module Object
670  */
671 TI_STATUS report_SetReportFilesTable    (TI_HANDLE hReport, TI_UINT8 *pFiles);
672 /** \brief  Get Report Severity Table
673  * \param  hReport   	- Report module object handle
674  * \param  pSeverities	- Pointer to input Severity Table
675  * \return TI_OK on success or TI_NOK on failure
676  *
677  * \par Description
678  * Returns the Severities Table (the table which holds Severities reporting indication) held in Report Module Object
679  */
680 TI_STATUS report_GetReportSeverityTable (TI_HANDLE hReport, TI_UINT8 *pSeverities);
681 /** \brief  Set Report Severity Table
682  * \param  hReport   	- Report module object handle
683  * \param  pSeverities	- Pointer to input Severity Table
684  * \return TI_OK on success or TI_NOK on failure
685  *
686  * \par Description
687  * Updates the Severities Table: copies the input Severities Table (the table which holds Severities reporting indication)
688  * to the Severities Table which is held in Report Module Object
689  */
690 TI_STATUS report_SetReportSeverityTable (TI_HANDLE hReport, TI_UINT8 *pSeverities);
691 /** \brief  Set Report Parameters
692  * \param  hReport   	- Report module object handle
693  * \param  pParam		- Pointer to input Report Parameters Information
694  * \return TI_OK on success or TI_NOK on failure
695  *
696  * \par Description
697  * Report set param function sets parameter/s to Report Module Object.
698  * Called by the following:
699  *	-   configuration Manager in order to set a parameter/s from the OS abstraction layer
700  *	-   Form inside the driver
701  */
702 TI_STATUS report_SetParam               (TI_HANDLE hReport, TReportParamInfo *pParam);
703 /** \brief  Get Report Parameters
704  * \param  hReport   	- Report module object handle
705  * \param  pParam		- Pointer to output Report Parameters Information
706  * \return TI_OK on success or TI_NOK on failure
707  *
708  * \par Description
709  * Report get param function gets parameter/s from Report Module Object.
710  * Called by the following:
711  *	-   configuration Manager in order to get a parameter/s from the OS abstraction layer
712  *	-   from inside the driver
713  */
714 TI_STATUS report_GetParam               (TI_HANDLE hReport, TReportParamInfo *pParam);
715 /** \brief Report Dump
716  * \param  pBuffer  - Pointer to input HEX buffer
717  * \param  pString	- Pointer to output string
718  * \param  size		- size of output string
719  * \return TI_OK on success or TI_NOK on failure
720  *
721  * \par Description
722  * Converts hex buffer to string buffer
723  * NOTE:	1. The caller has to make sure that the string size is at lease: ((Size * 2) + 1)
724  * 	      	2. A string terminator is inserted into lase char of the string
725  */
726 TI_STATUS report_Dump 					(TI_UINT8 *pBuffer, char *pString, TI_UINT32 size);
727 /** \brief Report Print Dump
728  * \param  pData  	- Pointer to input data buffer
729  * \param  datalen	- size of input data buffer
730  * \return TI_OK on success or TI_NOK on failure
731  *
732  * \par Description
733  * Performs HEX dump of input Data buffer. Used for debug only!
734  */
735 TI_STATUS report_PrintDump 				(TI_UINT8 *pData, TI_UINT32 datalen);
736 
737 /** \brief Sets bRedirectOutputToLogger
738 * \param  value  	    - True if to direct output to remote PC
739 * \param  hEvHandler	- Event handler
740 */
741 void os_setDebugOutputToLogger(TI_BOOL value);
742 
743 
744 #endif /* __REPORT_H__ */
745 
746 
747