1 /* Copyright (c) 2011-2016 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