graphengine/third_party/fwkacllib/inc/toolchain/slog.h

/**
 * Copyright 2019-2020 Huawei Technologies Co., Ltd
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef D_SYSLOG_H_
#define D_SYSLOG_H_

#ifdef __cplusplus
extern "C" {
#endif // __cplusplus

/**
 * @ingroup slog
 *
 * debug level id
 */
#define DLOG_DEBUG 0

/**
 * @ingroup slog
 *
 * info level id
 */
#define DLOG_INFO 1

/**
 * @ingroup slog
 *
 * warning level id
 */
#define DLOG_WARN 2

/**
 * @ingroup slog
 *
 * error level id
 */
#define DLOG_ERROR 3

/**
 * @ingroup slog
 *
 * don't print log
 */
#define DLOG_NULL 4

/**
 * @ingroup slog
 *
 * trace log print level id
 */
#define DLOG_TRACE 5

/**
 * @ingroup slog
 *
 * oplog log print level id
 */
#define DLOG_OPLOG 6

/**
 * @ingroup slog
 *
 * event log print level id
 */
#define DLOG_EVENT 0x10

/**
 * @ingroup slog
 *
 * max log length
 */
#define MSG_LENGTH 1024

typedef struct tagDCODE {
  const char *cName;
  int cVal;
} DCODE;

typedef struct tagKV {
  char *kname;
  char *value;
} KeyValue;

/**
 * @ingroup slog
 *
 * module id
 */
enum {
  SLOG,          /**< Slog */
  IDEDD,         /**< IDE daemon device */
  IDEDH,         /**< IDE daemon host */
  HCCL,          /**< HCCL */
  FMK,           /**< Framework */
  HIAIENGINE,    /**< Matrix */
  DVPP,          /**< DVPP */
  RUNTIME,       /**< Runtime */
  CCE,           /**< CCE */
  HDC,           /**< HDC */
  DRV,           /**< Driver */
  MDCFUSION,     /**< Mdc fusion */
  MDCLOCATION,   /**< Mdc location */
  MDCPERCEPTION, /**< Mdc perception */
  MDCFSM,
  MDCCOMMON,
  MDCMONITOR,
  MDCBSWP,    /**< MDC base software platform */
  MDCDEFAULT, /**< MDC undefine */
  MDCSC,      /**< MDC spatial cognition */
  MDCPNC,
  MLL,
  DEVMM,    /**< Dlog memory managent */
  KERNEL,   /**< Kernel */
  LIBMEDIA, /**< Libmedia */
  CCECPU,   /**< ai cpu */
  ASCENDDK, /**< AscendDK */
  ROS,      /**< ROS */
  HCCP,
  ROCE,
  TEFUSION,
  PROFILING, /**< Profiling */
  DP,        /**< Data Preprocess */
  APP,       /**< User Application */
  TS,        /**< TS module */
  TSDUMP,    /**< TSDUMP module */
  AICPU,     /**< AICPU module */
  LP,        /**< LP module */
  TDT,
  FE,
  MD,
  MB,
  ME,
  IMU,
  IMP,
  GE, /**< Fmk */
  MDCFUSA,
  CAMERA,
  ASCENDCL,
  TEEOS,
  SIS,
  HSM,
  INVLID_MOUDLE_ID
};

#ifdef MODULE_ID_NAME

/**
 * @ingroup slog
 *
 * set module id to map
 */
#define SET_MOUDLE_ID_MAP_NAME(x) \
  { #x, x }

static DCODE g_moduleIdName[] = {SET_MOUDLE_ID_MAP_NAME(SLOG),
                                 SET_MOUDLE_ID_MAP_NAME(IDEDD),
                                 SET_MOUDLE_ID_MAP_NAME(IDEDH),
                                 SET_MOUDLE_ID_MAP_NAME(HCCL),
                                 SET_MOUDLE_ID_MAP_NAME(FMK),
                                 SET_MOUDLE_ID_MAP_NAME(HIAIENGINE),
                                 SET_MOUDLE_ID_MAP_NAME(DVPP),
                                 SET_MOUDLE_ID_MAP_NAME(RUNTIME),
                                 SET_MOUDLE_ID_MAP_NAME(CCE),
                                 SET_MOUDLE_ID_MAP_NAME(HDC),
                                 SET_MOUDLE_ID_MAP_NAME(DRV),
                                 SET_MOUDLE_ID_MAP_NAME(MDCFUSION),
                                 SET_MOUDLE_ID_MAP_NAME(MDCLOCATION),
                                 SET_MOUDLE_ID_MAP_NAME(MDCPERCEPTION),
                                 SET_MOUDLE_ID_MAP_NAME(MDCFSM),
                                 SET_MOUDLE_ID_MAP_NAME(MDCCOMMON),
                                 SET_MOUDLE_ID_MAP_NAME(MDCMONITOR),
                                 SET_MOUDLE_ID_MAP_NAME(MDCBSWP),
                                 SET_MOUDLE_ID_MAP_NAME(MDCDEFAULT),
                                 SET_MOUDLE_ID_MAP_NAME(MDCSC),
                                 SET_MOUDLE_ID_MAP_NAME(MDCPNC),
                                 SET_MOUDLE_ID_MAP_NAME(MLL),
                                 SET_MOUDLE_ID_MAP_NAME(DEVMM),
                                 SET_MOUDLE_ID_MAP_NAME(KERNEL),
                                 SET_MOUDLE_ID_MAP_NAME(LIBMEDIA),
                                 SET_MOUDLE_ID_MAP_NAME(CCECPU),
                                 SET_MOUDLE_ID_MAP_NAME(ASCENDDK),
                                 SET_MOUDLE_ID_MAP_NAME(ROS),
                                 SET_MOUDLE_ID_MAP_NAME(HCCP),
                                 SET_MOUDLE_ID_MAP_NAME(ROCE),
                                 SET_MOUDLE_ID_MAP_NAME(TEFUSION),
                                 SET_MOUDLE_ID_MAP_NAME(PROFILING),
                                 SET_MOUDLE_ID_MAP_NAME(DP),
                                 SET_MOUDLE_ID_MAP_NAME(APP),
                                 SET_MOUDLE_ID_MAP_NAME(TS),
                                 SET_MOUDLE_ID_MAP_NAME(TSDUMP),
                                 SET_MOUDLE_ID_MAP_NAME(AICPU),
                                 SET_MOUDLE_ID_MAP_NAME(LP),
                                 SET_MOUDLE_ID_MAP_NAME(TDT),
                                 SET_MOUDLE_ID_MAP_NAME(FE),
                                 SET_MOUDLE_ID_MAP_NAME(MD),
                                 SET_MOUDLE_ID_MAP_NAME(MB),
                                 SET_MOUDLE_ID_MAP_NAME(ME),
                                 SET_MOUDLE_ID_MAP_NAME(IMU),
                                 SET_MOUDLE_ID_MAP_NAME(IMP),
                                 SET_MOUDLE_ID_MAP_NAME(GE),
                                 SET_MOUDLE_ID_MAP_NAME(MDCFUSA),
                                 SET_MOUDLE_ID_MAP_NAME(CAMERA),
                                 SET_MOUDLE_ID_MAP_NAME(ASCENDCL),
                                 SET_MOUDLE_ID_MAP_NAME(TEEOS),
                                 SET_MOUDLE_ID_MAP_NAME(SIS),
                                 SET_MOUDLE_ID_MAP_NAME(HSM),
                                 {NULL, -1}};
#endif // SET_MOUDLE_ID_MAP_NAME

/**
 * @ingroup slog
 * @brief External log interface, which called by modules
 */
extern void dlog_init(void);

/**
 * @ingroup slog
 * @brief dlog_getlevel: get module level
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [out]enableEvent: 1: enable; 0: disable
 * @return: module level(0: debug, 1: info, 2: warning, 3: error, 4: null output)
 */
extern int dlog_getlevel(int moduleId, int *enableEvent);

/**
 * @ingroup slog
 * @brief dlog_error: print error log
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]fmt: log content
 */
#define dlog_error(moduleId, fmt, ...)                                          \
  do {                                                                          \
    DlogErrorInner(moduleId, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief dlog_warn: print warning log
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]fmt: log content
 */
#define dlog_warn(moduleId, fmt, ...)                                          \
  do {                                                                         \
    DlogWarnInner(moduleId, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief dlog_info: print info log
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]fmt: log content
 */
#define dlog_info(moduleId, fmt, ...)                                          \
  do {                                                                         \
    DlogInfoInner(moduleId, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief dlog_debug: print debug log
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]fmt: log content
 */
#define dlog_debug(moduleId, fmt, ...)                                          \
  do {                                                                          \
    DlogDebugInner(moduleId, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief dlog_event: print event log
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]fmt: log content
 */
#define dlog_event(moduleId, fmt, ...)                                          \
  do {                                                                          \
    DlogEventInner(moduleId, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief Dlog: print log, need caller to specify level
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]level(0: debug, 1: info, 2: warning, 3: error, 5: trace, 6: oplog, 16: event)
 * @param [in]fmt: log content
 */
#define Dlog(moduleId, level, fmt, ...)                                           \
  do {                                                                            \
    DlogInner(moduleId, level, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief DlogSub: print log, need caller to specify level and submodule
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]submodule: eg: engine
 * @param [in]level(0: debug, 1: info, 2: warning, 3: error, 5: trace, 6: oplog, 16: event)
 * @param [in]fmt: log content
 */
#define DlogSub(moduleId, submodule, level, fmt, ...)                                            \
  do {                                                                                           \
    DlogInner(moduleId, level, "[%s:%d][%s]" fmt, __FILE__, __LINE__, submodule, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief DlogWithKV: print log, need caller to specify level and other paramters
 *
 * @param [in]moduleId: module id, eg: CCE
 * @param [in]level(0: debug, 1: info, 2: warning, 3: error, 5: trace, 6: oplog, 16: event)
 * @param [in]pstKVArray: key-value array
 * @param [in]kvNum: key-value element num in array
 * @param [in]fmt: log content
 */
#define DlogWithKV(moduleId, level, pstKVArray, kvNum, fmt, ...)                                           \
  do {                                                                                                     \
    DlogWithKVInner(moduleId, level, pstKVArray, kvNum, "[%s:%d]" fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
  } while (0)

/**
 * @ingroup slog
 * @brief Internal log interface, other modules are not allowed to call this interface
 */
void DlogErrorInner(int moduleId, const char *fmt, ...);
void DlogWarnInner(int moduleId, const char *fmt, ...);
void DlogInfoInner(int moduleId, const char *fmt, ...);
void DlogDebugInner(int moduleId, const char *fmt, ...);
void DlogEventInner(int moduleId, const char *fmt, ...);
void DlogInner(int moduleId, int level, const char *fmt, ...);
void DlogWithKVInner(int moduleId, int level, KeyValue *pstKVArray, int kvNum, const char *fmt, ...);

#ifdef __cplusplus
}
#endif // __cplusplus
#endif // D_SYSLOG_H_