| /***************************************************************************** |
| * Copyright Statement: |
| * -------------------- |
| * This software is protected by Copyright and the information contained |
| * herein is confidential. The software may not be copied and the information |
| * contained herein may not be used or disclosed except with the written |
| * permission of MediaTek Inc. (C) 2005 |
| * |
| * BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES |
| * THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE") |
| * RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON |
| * AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES, |
| * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF |
| * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. |
| * NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE |
| * SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR |
| * SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH |
| * THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO |
| * NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S |
| * SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM. |
| * |
| * BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE |
| * LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE, |
| * AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE, |
| * OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO |
| * MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. |
| * |
| * THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE |
| * WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF |
| * LAWS PRINCIPLES. ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND |
| * RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER |
| * THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC). |
| * |
| *****************************************************************************/ |
| |
| /**************************************************************************** |
| * Filename: |
| * --------- |
| * @file kal_trace.h |
| * |
| * Description: |
| * ------------ |
| * @brief Interface of KAL trace. TODO: should phase-out. |
| * |
| * ========================================================================== |
| * $Log$ |
| * |
| * 09 18 2019 victoria.wang |
| * [MOLY00416922] DHL Legacy Wrapper migration and phase-out |
| * [Remove][DHL] phase out legacy wrapper API |
| * |
| * 04 21 2019 yh.sung |
| * [MOLY00392990] [VMOLY][UTF] Phase 2 Landing |
| * [UTF][DHL] UTF Trace API - trace interface |
| * |
| * 01 25 2019 yu-hsiang.peng |
| * [MOLY00381457] [DHL 2.0] Common Feature Development |
| * [SEPT.DEV] support mipi custom read |
| * |
| ****************************************************************************/ |
| |
| #ifndef _KAL_TRACE_H |
| #define _KAL_TRACE_H |
| |
| #include "dhl_unified_trace.h" |
| #if defined(__DHL_MODULE__) |
| #else |
| |
| #include <stdarg.h> |
| #ifndef GEN_FOR_PC |
| #include <stdio.h> |
| #endif |
| #include "kal_general_types.h" |
| #include "kal_public_defs.h" |
| |
| #if defined(__MTK_TARGET__) && !defined(__GNUC__) |
| #pragma diag_suppress 870 |
| #endif //#ifdef __MTK_TARGET__ |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| #if defined(__TST_MODULE__) && defined(__EM_MODE__) /* for ilm_struct type definition */ |
| #ifndef GEN_FOR_PC |
| struct ilm_struct; |
| extern void tst_EM_logger(struct ilm_struct *ilm_ptr); |
| #if defined(__DHL_MODULE__) |
| extern void dhl_EM_logger(struct ilm_struct *ilm_ptr); |
| #endif |
| #endif |
| #endif //#if defined(__TST_MODULE__) && defined(__EM_MODE__) |
| |
| #if !defined(__DHL_MODULE__) |
| #define dhl_trace(...) |
| #define dhl_internal_trace(...) |
| #define dhl_brief_trace(...) |
| #define dhl_peer_trace(...) |
| #define dhl_raw_trace(...) |
| #define dhl_print(...) |
| #define dhl_print_string(...) |
| #define dhl_print_system_trace(...) |
| |
| #define dhl_print_struct(...) |
| #define dhl_debug_print(...) |
| |
| #define dhl_trace_impl(...) |
| #define dhl_internal_trace_impl(...) |
| #define dhl_print_impl(...) |
| #define dhl_EM_logger(...) |
| #endif //#if !defined(__DHL_MODULE__) |
| |
| #define MAX_MSG_NBR_IN_MODULE 20 |
| #define ADDITIONAL_BUFFER_FOR_MUX 45 |
| #define DEFAULT_RS232_FRAME_SIZE 5 /* STX, LenHi, LenLo, Type, Checksum*/ |
| #define SAP_LOCAL_PARA_FILTER 0x02 |
| #define SAP_PEER_BUFF_FILTER 0x04 |
| |
| #define STX_OCTET 0x55 |
| #define LOGGED_PRIMITIVE_TYPE 0x60 |
| #define PS_TRACE_INDEX_TRACE_TYPE 0x61 |
| #define PS_PROMPT_TRACE_TYPE 0x62 |
| #define CONTROL_COMMAND_TYPE 0x63 |
| #define INJECT_PRIMITIVE_TYPE 0x64 |
| #define SYS_TRACE_TYPE 0x65 |
| |
| //Define Trace Macro for PS trace |
| #if defined(GEN_FOR_PC) && !defined(GEN_FOR_CPARSER) |
| #define BEGIN_TRACE_MAP(MOD) START_MODULE_MSG MOD MAX_MSG_NBR_IN_MODULE |
| #define BEGIN_TRACE_MAP_WITH_RANGE(MOD, MIN_VAL, MAX_VAL) START_RANGE_MODULE_MSG MOD MAX_MSG_NBR_IN_MODULE MIN_VAL MAX_VAL |
| #define TRC_MSG(MSG,STR) MSG STR |
| #define TRC_MSG_NEWLINE(MSG,STR,NUM) MSG STR NUM |
| #define END_TRACE_MAP(MOD) END_MODULE_MSG |
| #define END_TRACE_MAP_WITH_RANGE(MOD, MIN_VAL, MAX_VAL) MOD MIN_VAL MAX_VAL END_RANGE_MODULE_MSG |
| #else //Define Trace Macro for PS trace |
| #define BEGIN_TRACE_MAP(MOD) enum MOD##_MSG_ENUM{\ |
| MOD##_empty_string=MOD<<MAX_MSG_NBR_IN_MODULE, |
| #define BEGIN_TRACE_MAP_WITH_RANGE(MOD, MIN_VAL, MAX_VAL) enum MOD##_##MIN_VAL##_MSG_ENUM{\ |
| MOD##_##MIN_VAL##_empty_string = (MOD<<MAX_MSG_NBR_IN_MODULE) + MIN_VAL - 1, |
| #define TRC_MSG(MSG,STR) MSG##__enum, |
| #define TRC_MSG_NEWLINE(MSG,STR,NUM) MSG##__enum, MSG##_NEWLINE_EXPAND__enum = MSG##__enum+NUM, |
| #define END_TRACE_MAP(MOD) MOD##__end}; |
| #define END_TRACE_MAP_WITH_RANGE(MOD, MIN_VAL, MAX_VAL) MOD##_##MIN_VAL##__end}; |
| #endif //Define Trace Macro for PS trace |
| |
| |
| //Decide which path should enter |
| #ifdef __TST_MODULE__ |
| #if !defined(__FUE__) && !defined(__UBL__) |
| #if !defined(MODULE_TRACE_OFF) |
| #define __TST_TRACE_ENABLED__ |
| #elif defined(__TST_CRITICAL_TRACE_LEVEL__) //__PRIORITY_TRACING_ENABLED__ should be disabled in MoDIS |
| #define __TST_CRITICAL_TRACE_ENABLED__ |
| #endif //!defined(MODULE_TRACE_OFF) && |
| #endif |
| #endif //#ifdef __TST_MODULE__ |
| |
| #ifndef __TST_TRACE_ENABLED__ |
| #if defined(KAL_ON_OSCAR) || defined(MCD_DLL_EXPORT) || defined(L1_SIM) |
| #define __TST_TRACE_EMPTY_FUNCTION__ |
| |
| #if defined(__TST_CRITICAL_TRACE_ENABLED__) |
| #undef __TST_CRITICAL_TRACE_ENABLED__ |
| #endif //__TST_CRITICAL_TRACE_ENABLED__ |
| #endif //#if defined(KAL_ON_OSCAR) || defined(MCD_DLL_EXPORT) || defined(L1_SIM) |
| #endif |
| |
| |
| #if !defined(__TST_CRITICAL_TRACE_ENABLED__) || defined(GEN_FOR_PC) |
| typedef enum |
| { |
| TRACE_FUNC, |
| TRACE_STATE, |
| TRACE_INFO, |
| TRACE_WARNING, |
| TRACE_ERROR, |
| TRACE_GROUP_1, |
| TRACE_GROUP_2, |
| TRACE_GROUP_3, |
| TRACE_GROUP_4, |
| TRACE_GROUP_5, |
| TRACE_GROUP_6, |
| TRACE_GROUP_7, |
| TRACE_GROUP_8, |
| TRACE_GROUP_9, |
| TRACE_GROUP_10, |
| TRACE_PEER |
| } trace_class_enum; |
| |
| |
| typedef enum |
| { |
| DHL_CUSTOM_MEM_PMIC, |
| DHL_CUSTOM_MEM_MIPI, |
| DHL_CUSTOM_MEM_MAX |
| } DHL_CUSTOM_MEM_TYPE; |
| |
| #else //__TST_CRITICAL_TRACE_ENABLED__ |
| typedef unsigned char trace_class_enum; |
| #endif //__TST_CRITICAL_TRACE_ENABLED__ |
| |
| |
| #if defined(__TST_TRACE_ENABLED__) |
| #define kal_print_string_trace kal_wap_trace //alias kal_print_string_trace as kal_wap_trace |
| //#define kal_critical_trace kal_trace |
| //#define kal_critical_brief_trace kal_brief_trace |
| //#define kal_critical_assert_trace kal_assert_trace |
| extern void kal_critical_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_critical_brief_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_critical_assert_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| |
| /******************************************************************************* |
| * <GROUP Functions> |
| * |
| * FUNCTION |
| * kal_trace |
| * DESCRIPTION |
| * This function is used to output the pre-defined trace to PC. |
| * The engineers SHOULD define their own traces before using this function. |
| * If a trace is defined as ��Today is %d-$d-%d��, kal_trace simply sends the trace ID and the content of %d to PC. |
| * That will reduce the communication traffic. In the chapter 2, we will introduce how to ass a new trace. |
| * |
| * |
| * Property: |
| *�� ��Message Compression�� type API |
| *�� Cannot be invoked in LISR/HISR context. |
| *�� Can send up to 128 bytes parameters |
| *�� Suggested to use this API for most of the scenario. |
| * |
| * PARAMETERS |
| * trc_class: [IN] The trace class of this trace. Each module has 15 classes to category. |
| * msg_index: [IN] Message index. This part will be handled by tool. |
| * arg_type: [IN] This part will be handled by tool. |
| * ...: [IN] Parameters to log |
| * RETURNS |
| * NONE |
| * NOTE |
| * |
| ******************************************************************************/ |
| extern void kal_trace_for_3rd_party(trace_class_enum, kal_uint32, const kal_char *, va_list); |
| extern void kal_lib_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_assert_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_wap_trace(module_type mod_id, trace_class_enum trc_class, const char *fmt, ...); |
| extern void kal_buffer_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *fmt, kal_uint32 buf_len, const kal_uint8 *pData); |
| extern void kal_dev_trace(trace_class_enum trc_class, kal_uint32 msg_index, const char *arg_type, ...); |
| extern void kal_bootup_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_brief_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| |
| #define __TST_OPTIMIZATION_FOR_SPEED__ //Default enable in MOLY |
| |
| #ifdef __TST_OPTIMIZATION_FOR_SPEED__ //Optimization, kal_brief_trace_macro definition |
| |
| #if !defined(_MSC_VER) |
| |
| //Target build |
| extern kal_bool tst_is_PsTrc_open_and_pstrace_flag; //For optimization, the AND flag of tst_is_PsTrc_open and tst_pstrace_flag |
| extern void kal_brief_trace_opt_helper(trace_class_enum trc_class, kal_uint32 msg_index, const char *arg_type, ...); |
| |
| #define kal_brief_trace_macro(trc_class, msg_index,...) do{\ |
| if(tst_is_PsTrc_open_and_pstrace_flag){\ |
| kal_brief_trace_opt_helper(trc_class, msg_index, ##__VA_ARGS__);\ |
| }\ |
| }while(0) |
| |
| #else |
| |
| //PC build (MoDIS or MCDDLL) |
| extern void kal_trace_macro(trace_class_enum, kal_uint32, const kal_char *, ...); |
| |
| #endif |
| |
| #else //__TST_OPTIMIZATION_FOR_SPEED__ |
| |
| #if !defined(_MSC_VER) |
| |
| //Target build |
| #define kal_brief_trace_macro(...) kal_brief_trace(__VA_ARGS__) |
| |
| #else |
| |
| //PC build (MoDIS or MCDDLL) |
| extern void kal_trace_macro(trace_class_enum, kal_uint32, const kal_char *, ...); |
| |
| #endif |
| |
| #endif //__TST_OPTIMIZATION_FOR_SPEED__ |
| |
| |
| #else //__TST_TRACE_ENABLED__ |
| #if defined(__TST_TRACE_EMPTY_FUNCTION__) |
| /* |
| * For non-target platform (PC simulator or MNT), |
| * we define trace-related functions as inline function to avoid compile error |
| * in VC++. |
| */ |
| |
| static __inline void kal_critical_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| |
| static __inline void kal_critical_brief_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| static __inline void kal_critical_assert_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| |
| static __inline void kal_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| |
| static __inline void kal_brief_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| |
| static __inline void kal_trace_for_3rd_party(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, va_list argument_info) |
| { |
| return ; |
| } |
| |
| static __inline void kal_lib_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| static __inline void kal_assert_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| static __inline void kal_wap_trace(module_type mod_id, trace_class_enum trc_class, const char *fmt, ...) |
| { |
| return ; |
| } |
| static __inline void kal_print_string_trace(module_type mod_id, trace_class_enum trc_class, const char *fmt, ...) |
| { |
| return ; |
| } |
| |
| static __inline void kal_buffer_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *fmt, kal_uint32 buf_len, const kal_uint8 *pData) |
| { |
| return; |
| } |
| |
| static __inline void kal_dev_trace(trace_class_enum trc_class, kal_uint32 msg_index, const char *arg_type, ...) |
| { |
| return; |
| } |
| |
| static __inline void kal_bootup_trace(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| |
| static __inline void kal_brief_trace_macro(trace_class_enum trc_class, kal_uint32 msg_index, const kal_char *arg_type, ...) |
| { |
| return ; |
| } |
| |
| #elif defined(__TST_CRITICAL_TRACE_ENABLED__) |
| //Support partial tracing API enable |
| extern void kal_critical_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_critical_brief_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| extern void kal_critical_assert_trace(trace_class_enum, kal_uint32, const kal_char *, ...); |
| |
| #define kal_trace(...) |
| #define kal_brief_trace(...) |
| #define kal_trace_for_3rd_party(...) |
| #define kal_lib_trace(...) |
| #define kal_assert_trace(...) |
| #define kal_wap_trace(...) |
| #define kal_print_string_trace(...) |
| #define kal_buffer_trace(...) |
| #define kal_dev_trace(...) |
| #define kal_bootup_trace(...) |
| #define kal_brief_trace_macro(...) |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 0 |
| |
| #define TRACE_FUNC 0 |
| #define TRACE_STATE 1 |
| #define TRACE_INFO 2 |
| #define TRACE_WARNING 3 |
| #define TRACE_ERROR 4 |
| #define TRACE_GROUP_1 5 |
| #define TRACE_GROUP_2 6 |
| #define TRACE_GROUP_3 7 |
| #define TRACE_GROUP_4 8 |
| #define TRACE_GROUP_5 9 |
| #define TRACE_GROUP_6 10 |
| #define TRACE_GROUP_7 11 |
| #define TRACE_GROUP_8 12 |
| #define TRACE_GROUP_9 13 |
| #define TRACE_GROUP_10 14 |
| #define TRACE_PEER 15 |
| |
| #undef kal_trace |
| #undef kal_brief_trace |
| |
| #define _kal_trace(trace_class_enum, ...) kal_critical_trace_##trace_class_enum(trace_class_enum, __VA_ARGS__) |
| #define _kal_brief_trace(trace_class_enum, ...) kal_critical_brief_trace_##trace_class_enum(trace_class_enum, __VA_ARGS__) |
| |
| #define kal_trace(trace_class_enum, ...) _kal_trace(trace_class_enum, __VA_ARGS__) |
| #define kal_brief_trace(trace_class_enum, ...) _kal_brief_trace(trace_class_enum, __VA_ARGS__) |
| #define kal_brief_trace_macro(trace_class_enum, ...) _kal_brief_trace(trace_class_enum, __VA_ARGS__) |
| |
| //#define kal_assert_trace_(trace_class_enum, ...) kal_critical_assert_trace_##trace_class_enum(__VA_ARGS__) |
| |
| //declare the empty defined |
| #define kal_critical_trace_0(...) |
| #define kal_critical_trace_1(...) |
| #define kal_critical_trace_2(...) |
| #define kal_critical_trace_3(...) |
| #define kal_critical_trace_5(...) |
| #define kal_critical_trace_6(...) |
| #define kal_critical_trace_7(...) |
| #define kal_critical_trace_8(...) |
| #define kal_critical_trace_9(...) |
| #define kal_critical_trace_10(...) |
| #define kal_critical_trace_11(...) |
| #define kal_critical_trace_12(...) |
| #define kal_critical_trace_13(...) |
| #define kal_critical_trace_14(...) |
| #define kal_critical_trace_15(...) |
| |
| #define kal_critical_brief_trace_0(...) |
| #define kal_critical_brief_trace_1(...) |
| #define kal_critical_brief_trace_2(...) |
| #define kal_critical_brief_trace_3(...) |
| #define kal_critical_brief_trace_5(...) |
| #define kal_critical_brief_trace_6(...) |
| #define kal_critical_brief_trace_7(...) |
| #define kal_critical_brief_trace_8(...) |
| #define kal_critical_brief_trace_9(...) |
| #define kal_critical_brief_trace_10(...) |
| #define kal_critical_brief_trace_11(...) |
| #define kal_critical_brief_trace_12(...) |
| #define kal_critical_brief_trace_13(...) |
| #define kal_critical_brief_trace_14(...) |
| #define kal_critical_brief_trace_15(...) |
| |
| //ignore the known issues, wrap logging APIs in other APIs |
| #define kal_critical_trace_trc_class(...) |
| #define kal_critical_brief_trace_trc_class(...) |
| |
| //define ERROR --> 4 |
| #define kal_critical_trace_4 kal_critical_trace |
| #define kal_critical_brief_trace_4 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 1 |
| //define WARNING 3 |
| #undef kal_critical_trace_3 |
| #undef kal_critical_brief_trace_3 |
| #define kal_critical_trace_3 kal_critical_trace |
| #define kal_critical_brief_trace_3 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 2 |
| //define TRACE_STATE 1 |
| #undef kal_critical_trace_1 |
| #undef kal_critical_brief_trace_1 |
| #define kal_critical_trace_1 kal_critical_trace |
| #define kal_critical_brief_trace_1 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 3 |
| //define TRACE_INFO 2 |
| #undef kal_critical_trace_2 |
| #undef kal_critical_brief_trace_2 |
| #define kal_critical_trace_2 kal_critical_trace |
| #define kal_critical_brief_trace_2 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 4 |
| //#define TRACE_PEER 15 |
| #undef kal_critical_trace_15 |
| #undef kal_critical_brief_trace_15 |
| #define kal_critical_trace_15 kal_critical_trace |
| #define kal_critical_brief_trace_15 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 5 |
| //#define TRACE_GROUP_1 5 |
| #undef kal_critical_trace_5 |
| #undef kal_critical_brief_trace_5 |
| #define kal_critical_trace_5 kal_critical_trace |
| #define kal_critical_brief_trace_5 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 6 |
| //#define TRACE_GROUP_2 6 |
| #undef kal_critical_trace_6 |
| #undef kal_critical_brief_trace_6 |
| #define kal_critical_trace_6 kal_critical_trace |
| #define kal_critical_brief_trace_6 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 7 |
| //#define TRACE_GROUP_3 7 |
| #undef kal_critical_trace_7 |
| #undef kal_critical_brief_trace_7 |
| #define kal_critical_trace_7 kal_critical_trace |
| #define kal_critical_brief_trace_7 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 8 |
| //#define TRACE_GROUP_4 8 |
| #undef kal_critical_trace_8 |
| #undef kal_critical_brief_trace_8 |
| #define kal_critical_trace_8 kal_critical_trace |
| #define kal_critical_brief_trace_8 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 9 |
| //#define TRACE_GROUP_5 9 |
| #undef kal_critical_trace_9 |
| #undef kal_critical_brief_trace_9 |
| #define kal_critical_trace_9 kal_critical_trace |
| #define kal_critical_brief_trace_9 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 10 |
| //#define TRACE_GROUP_6 10 |
| #undef kal_critical_trace_10 |
| #undef kal_critical_brief_trace_10 |
| #define kal_critical_trace_10 kal_critical_trace |
| #define kal_critical_brief_trace_10 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 11 |
| //#define TRACE_GROUP_7 11 |
| #undef kal_critical_trace_11 |
| #undef kal_critical_brief_trace_11 |
| #define kal_critical_trace_11 kal_critical_trace |
| #define kal_critical_brief_trace_11 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 12 |
| //#define TRACE_GROUP_8 12 |
| #undef kal_critical_trace_12 |
| #undef kal_critical_brief_trace_12 |
| #define kal_critical_trace_12 kal_critical_trace |
| #define kal_critical_brief_trace_12 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 13 |
| //#define TRACE_GROUP_9 13 |
| #undef kal_critical_trace_13 |
| #undef kal_critical_brief_trace_13 |
| #define kal_critical_trace_13 kal_critical_trace |
| #define kal_critical_brief_trace_13 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 14 |
| //#define TRACE_GROUP_10 14 |
| #undef kal_critical_trace_14 |
| #undef kal_critical_brief_trace_14 |
| #define kal_critical_trace_14 kal_critical_trace |
| #define kal_critical_brief_trace_14 kal_critical_brief_trace |
| #endif |
| |
| #if __TST_CRITICAL_TRACE_LEVEL__ > 15 |
| //#define TRACE_FUNC 0 |
| #undef kal_critical_trace_0 |
| #undef kal_critical_brief_trace_0 |
| #define kal_critical_trace_0 kal_critical_trace |
| #define kal_critical_brief_trace_0 kal_critical_brief_trace |
| #endif |
| |
| #else // #if defined(__TST_TRACE_EMPTY_FUNCTION__) |
| //Define empty functions for Target SW |
| #define kal_trace(...) |
| #define kal_brief_trace(...) |
| #define kal_trace_for_3rd_party(...) |
| #define kal_lib_trace(...) |
| #define kal_assert_trace(...) |
| #define kal_wap_trace(...) |
| #define kal_print_string_trace(...) |
| #define kal_buffer_trace(...) |
| #define kal_dev_trace(...) |
| #define kal_bootup_trace(...) |
| #define kal_critical_trace(...) |
| #define kal_critical_brief_trace(...) |
| #define kal_critical_assert_trace(...) |
| #define kal_brief_trace_macro(...) |
| #endif // #if defined(__TST_TRACE_EMPTY_FUNCTION__) |
| #endif //__TST_TRACE_ENABLED__ |
| |
| #define kal_sys_trace tst_sys_trace |
| #define kal_sys_init_trace tst_sys_init_trace |
| #define kal_sys_fatal_trace tst_sysfatal_trace |
| |
| #ifdef __TST_MODULE__ |
| /******************************************************************************* |
| * <GROUP Functions> |
| * |
| * FUNCTION |
| * kal_prompt_trace |
| * DESCRIPTION |
| * It's a printf-like function which outputs log to Catcher Tool. |
| * Property: |
| * The message is sent in plaintext |
| *�� Cannot be invoked in LISR context. |
| *�� Can send up to 128 bytes logs |
| *�� This API can only be used in customer side to reduce the impact of ROM size increase. |
| *�� Heavy resource consumption. |
| *�� a.Caller��s RO-DATA |
| *�� b. Logging Bandwidth |
| * |
| * PARAMETERS |
| * mod_id: [IN] Module id |
| * fmt: [IN] The format string. Please refer to print function of C standard library. |
| * RETURNS |
| * NONE |
| * NOTE |
| * |
| ******************************************************************************/ |
| extern void kal_prompt_trace(module_type mod_id, const kal_char *fmt, ...); |
| extern void tst_sys_init_trace(const kal_char *info); |
| extern void tst_sys_trace(kal_char *info); |
| extern void tst_sysfatal_trace(kal_char *info); |
| extern kal_int32 tst_trace_check_ps_filter_off(trace_class_enum trc_class, kal_uint32 *module_id, kal_uint32 supportOption); |
| |
| #define kal_bootup_print tst_sys_init_trace |
| #else |
| #ifdef __TST_TRACE_EMPTY_FUNCTION__ |
| static __inline void kal_prompt_trace(module_type mod_id, const kal_char *fmt, ...) |
| { |
| return ; |
| } |
| static __inline void tst_sys_init_trace(const kal_char *info) |
| { |
| return ; |
| } |
| static __inline void tst_sys_trace(kal_char *info) |
| { |
| return ; |
| } |
| static __inline void tst_sysfatal_trace(kal_char *info) |
| { |
| return ; |
| } |
| static __inline kal_int32 tst_trace_check_ps_filter_off(trace_class_enum trc_class, kal_uint32 *module_id, kal_uint32 supportOption) |
| { |
| return 0; |
| } |
| #else |
| #define kal_prompt_trace(...) |
| #define tst_sys_init_trace(...) |
| #define tst_sys_trace(...) |
| #define tst_sysfatal_trace(...) |
| #define tst_trace_check_ps_filter_off(...) |
| #endif |
| #endif //#ifdef __TST_MODULE__ |
| |
| typedef void (*TST_VC_CallBack)(const kal_uint8 *pData, kal_uint32 nLen); |
| typedef void (*TST_String_Inject_CB)(kal_uint32 index, kal_uint8 *pData); |
| |
| /* |
| * tst_virtual_channel_id: |
| * regiester new virtual channel here and remake tst |
| */ |
| typedef enum |
| { |
| TVCI_GPS_LOGGING, |
| TVCI_DNT_L2COPRO_LOGGING, |
| TVCI_CATCHER_POLLING, |
| TVCI_GDB_COMM, |
| TVCI_AST_LOGGING, |
| TVCI_MINI_LOG, |
| TVCI_VM_LOGGING, |
| TVCI_BTT, |
| TVCI_LAST_ID |
| } |
| tst_virtual_channel_id; |
| |
| #define MAX_VC_RESPONSE_LEN (1023) |
| |
| kal_bool tst_vc_register_channel(tst_virtual_channel_id channel_id, TST_VC_CallBack fnCmd); |
| kal_bool tst_vc_response(tst_virtual_channel_id channel_id, const kal_uint8 *pData, kal_uint16 len); |
| |
| #define TVCI_CREATE_FILE 0x24540001 |
| #define TVCI_CLOSE_FILE 0x24540002 |
| |
| kal_bool tst_save_assert_bypass_trace(kal_char *info); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* __LTE_RAT__ */ |
| |
| #endif /* _KAL_TRACE_H */ |
| |