1 /* Copyright (c) 2011-2014 The Linux Foundation. All rights reserved. 2 * 3 * Redistribution and use in source and binary forms, with or without 4 * modification, are permitted provided that the following conditions are 5 * met: 6 * * Redistributions of source code must retain the above copyright 7 * notice, this list of conditions and the following disclaimer. 8 * * Redistributions in binary form must reproduce the above 9 * copyright notice, this list of conditions and the following 10 * disclaimer in the documentation and/or other materials provided 11 * with the distribution. 12 * * Neither the name of The Linux Foundation nor the names of its 13 * contributors may be used to endorse or promote products derived 14 * from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT 19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS 20 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 23 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 24 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 25 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 26 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 * 28 */ 29 30 #ifndef __LOG_UTIL_H__ 31 #define __LOG_UTIL_H__ 32 33 #ifndef USE_GLIB 34 #include <utils/Log.h> 35 #endif /* USE_GLIB */ 36 37 #ifdef USE_GLIB 38 39 #include <stdio.h> 40 #include <sys/types.h> 41 #include <unistd.h> 42 43 #ifndef LOG_TAG 44 #define LOG_TAG "GPS_UTILS" 45 46 #endif // LOG_TAG 47 48 #endif /* USE_GLIB */ 49 50 #ifdef __cplusplus 51 extern "C" 52 { 53 #endif 54 /*============================================================================= 55 * 56 * LOC LOGGER TYPE DECLARATION 57 * 58 *============================================================================*/ 59 /* LOC LOGGER */ 60 typedef struct loc_logger_s 61 { 62 unsigned long DEBUG_LEVEL; 63 unsigned long TIMESTAMP; 64 } loc_logger_s_type; 65 66 /*============================================================================= 67 * 68 * EXTERNAL DATA 69 * 70 *============================================================================*/ 71 extern loc_logger_s_type loc_logger; 72 73 // Logging Improvements 74 extern const char *loc_logger_boolStr[]; 75 76 extern const char *boolStr[]; 77 extern const char VOID_RET[]; 78 extern const char FROM_AFW[]; 79 extern const char TO_MODEM[]; 80 extern const char FROM_MODEM[]; 81 extern const char TO_AFW[]; 82 extern const char EXIT_TAG[]; 83 extern const char ENTRY_TAG[]; 84 extern const char EXIT_ERROR_TAG[]; 85 86 /*============================================================================= 87 * 88 * MODULE EXPORTED FUNCTIONS 89 * 90 *============================================================================*/ 91 extern void loc_logger_init(unsigned long debug, unsigned long timestamp); 92 extern char* get_timestamp(char* str, unsigned long buf_size); 93 94 #ifndef DEBUG_DMN_LOC_API 95 96 /* LOGGING MACROS */ 97 /*loc_logger.DEBUG_LEVEL is initialized to 0xff in loc_cfg.cpp 98 if that value remains unchanged, it means gps.conf did not 99 provide a value and we default to the initial value to use 100 Android's logging levels*/ 101 #define IF_LOC_LOGE if((loc_logger.DEBUG_LEVEL >= 1) && (loc_logger.DEBUG_LEVEL <= 5)) 102 103 #define IF_LOC_LOGW if((loc_logger.DEBUG_LEVEL >= 2) && (loc_logger.DEBUG_LEVEL <= 5)) 104 105 #define IF_LOC_LOGI if((loc_logger.DEBUG_LEVEL >= 3) && (loc_logger.DEBUG_LEVEL <= 5)) 106 107 #define IF_LOC_LOGD if((loc_logger.DEBUG_LEVEL >= 4) && (loc_logger.DEBUG_LEVEL <= 5)) 108 109 #define IF_LOC_LOGV if((loc_logger.DEBUG_LEVEL >= 5) && (loc_logger.DEBUG_LEVEL <= 5)) 110 111 #define LOC_LOGE(...) \ 112 IF_LOC_LOGE { ALOGE("E/" __VA_ARGS__); } \ 113 else if (loc_logger.DEBUG_LEVEL == 0xff) { ALOGE("E/" __VA_ARGS__); } 114 115 #define LOC_LOGW(...) \ 116 IF_LOC_LOGW { ALOGE("W/" __VA_ARGS__); } \ 117 else if (loc_logger.DEBUG_LEVEL == 0xff) { ALOGW("W/" __VA_ARGS__); } 118 119 #define LOC_LOGI(...) \ 120 IF_LOC_LOGI { ALOGE("I/" __VA_ARGS__); } \ 121 else if (loc_logger.DEBUG_LEVEL == 0xff) { ALOGI("I/" __VA_ARGS__); } 122 123 #define LOC_LOGD(...) \ 124 IF_LOC_LOGD { ALOGE("D/" __VA_ARGS__); } \ 125 else if (loc_logger.DEBUG_LEVEL == 0xff) { ALOGD("D/" __VA_ARGS__); } 126 127 #define LOC_LOGV(...) \ 128 IF_LOC_LOGV { ALOGE("V/" __VA_ARGS__); } \ 129 else if (loc_logger.DEBUG_LEVEL == 0xff) { ALOGV("V/" __VA_ARGS__); } 130 131 #else /* DEBUG_DMN_LOC_API */ 132 133 #define LOC_LOGE(...) ALOGE("E/" __VA_ARGS__) 134 135 #define LOC_LOGW(...) ALOGW("W/" __VA_ARGS__) 136 137 #define LOC_LOGI(...) ALOGI("I/" __VA_ARGS__) 138 139 #define LOC_LOGD(...) ALOGD("D/" __VA_ARGS__) 140 141 #define LOC_LOGV(...) ALOGV("V/" __VA_ARGS__) 142 143 #endif /* DEBUG_DMN_LOC_API */ 144 145 /*============================================================================= 146 * 147 * LOGGING IMPROVEMENT MACROS 148 * 149 *============================================================================*/ 150 #define LOG_(LOC_LOG, ID, WHAT, SPEC, VAL) \ 151 do { \ 152 if (loc_logger.TIMESTAMP) { \ 153 char ts[32]; \ 154 LOC_LOG("[%s] %s %s line %d " #SPEC, \ 155 get_timestamp(ts, sizeof(ts)), ID, WHAT, __LINE__, VAL); \ 156 } else { \ 157 LOC_LOG("%s %s line %d " #SPEC, \ 158 ID, WHAT, __LINE__, VAL); \ 159 } \ 160 } while(0) 161 162 #define LOC_LOG_HEAD(tag,fmt) "%s:%d][" tag "] " fmt "\n" 163 #define LOC_LOGv(tag,fmt,...) LOC_LOGV(LOC_LOG_HEAD(tag,fmt), __func__, __LINE__, ##__VA_ARGS__) 164 #define LOC_LOGw(tag,fmt,...) LOC_LOGW(LOC_LOG_HEAD(tag,fmt), __func__, __LINE__, ##__VA_ARGS__) 165 #define LOC_LOGd(tag,fmt,...) LOC_LOGD(LOC_LOG_HEAD(tag,fmt), __func__, __LINE__, ##__VA_ARGS__) 166 #define LOC_LOGe(tag,fmt,...) LOC_LOGE(LOC_LOG_HEAD(tag,fmt), __func__, __LINE__, ##__VA_ARGS__) 167 168 #define LOG_I(ID, WHAT, SPEC, VAL) LOG_(LOC_LOGI, ID, WHAT, SPEC, VAL) 169 #define LOG_V(ID, WHAT, SPEC, VAL) LOG_(LOC_LOGV, ID, WHAT, SPEC, VAL) 170 #define LOG_E(ID, WHAT, SPEC, VAL) LOG_(LOC_LOGE, ID, WHAT, SPEC, VAL) 171 172 #define ENTRY_LOG() LOG_V(ENTRY_TAG, __func__, %s, "") 173 #define EXIT_LOG(SPEC, VAL) LOG_V(EXIT_TAG, __func__, SPEC, VAL) 174 #define EXIT_LOG_WITH_ERROR(SPEC, VAL) \ 175 if (VAL != 0) { \ 176 LOG_E(EXIT_ERROR_TAG, __func__, SPEC, VAL); \ 177 } else { \ 178 LOG_V(EXIT_TAG, __func__, SPEC, VAL); \ 179 } 180 181 182 // Used for logging callflow from Android Framework 183 #define ENTRY_LOG_CALLFLOW() LOG_I(FROM_AFW, __func__, %s, "") 184 // Used for logging callflow to Modem 185 #define EXIT_LOG_CALLFLOW(SPEC, VAL) LOG_I(TO_MODEM, __func__, SPEC, VAL) 186 // Used for logging callflow from Modem(TO_MODEM, __func__, %s, "") 187 #define MODEM_LOG_CALLFLOW(SPEC, VAL) LOG_I(FROM_MODEM, __func__, SPEC, VAL) 188 // Used for logging callflow to Android Framework 189 #define CALLBACK_LOG_CALLFLOW(CB, SPEC, VAL) LOG_I(TO_AFW, CB, SPEC, VAL) 190 191 #ifdef __cplusplus 192 } 193 #endif 194 195 #endif // __LOG_UTIL_H__ 196