d398a6ced2
- CitrineOS core extracted (CSMS OCPP 2.0.1) - OpenOCPP extracted (firmware OCPP 1.6J/2.0.1) - ShapeShifter library installed (pip install -e) - ShapeShifter specification extracted - EVerest extracted TODO updated with progress
74 lines
2.5 KiB
C++
74 lines
2.5 KiB
C++
// SPDX-License-Identifier: Apache-2.0
|
|
// Copyright (C) 2022-2023 chargebyte GmbH
|
|
// Copyright (C) 2022-2023 Contributors to EVerest
|
|
#ifndef LOG_H
|
|
#define LOG_H
|
|
|
|
/**
|
|
* @brief Describe the intended log level of a message, or the maximum level a message must have to be displayed.
|
|
*/
|
|
typedef enum dloglevel_t {
|
|
DLOG_LEVEL_ALWAYS = 0, ///< internal use only, for notification of log level change
|
|
DLOG_LEVEL_ERROR, ///< error
|
|
DLOG_LEVEL_WARNING, ///< warning, not leading to unexpected behavior such as termination
|
|
DLOG_LEVEL_INFO, ///< informational message
|
|
DLOG_LEVEL_DEBUG, ///< message to help debug daemon activity
|
|
DLOG_LEVEL_TRACE, ///< message to provide extra internal information
|
|
DLOG_LEVEL_NUMLEVELS, ///< don't use, only for internal detection of upper range
|
|
} dloglevel_t;
|
|
|
|
/**
|
|
* @brief Internal: Issue a log message. Please use the dlog() macro instead.
|
|
*
|
|
* @return void
|
|
*/
|
|
void dlog_func(const dloglevel_t loglevel, const char* filename, const int linenumber, const char* functionname,
|
|
const char* format, ...);
|
|
|
|
/**
|
|
* @brief Increase the log level to the next higher step (more messages). At the highest step, the level rolls over to
|
|
* the lowest.
|
|
*
|
|
* @return void
|
|
*/
|
|
void dlog_level_inc(void);
|
|
|
|
/**
|
|
* @brief Set the log level.
|
|
* @param[in] loglevel the log level the logger shall use, of type enum dloglevel
|
|
*
|
|
* @return void
|
|
*/
|
|
void dlog_level_set(const dloglevel_t loglevel);
|
|
|
|
/**
|
|
* @brief Get the log level.
|
|
*
|
|
* @return dloglevel_t the currently valid log level
|
|
*/
|
|
dloglevel_t dlog_level_get(void);
|
|
|
|
/**
|
|
* @brief Set the log level from an MQTT topic string.
|
|
* @param[in] loglevel the log level the logger shall use, as an MQTT string
|
|
*
|
|
* @return void
|
|
*/
|
|
// dloglevel_t dlog_level_set_from_mqtt_string(const char *level_string);
|
|
|
|
/**
|
|
* @brief Issue a log message.
|
|
*
|
|
* @param[in] level the log level this message belongs to (type enum dloglevel)
|
|
* @param[in] printf()-like format string and parameters, without tailing '\n'
|
|
*
|
|
* @return void
|
|
*/
|
|
// this is a macro, so that when dlog() is used, it gets expanded at the caller's location
|
|
#define dlog(level, ...) \
|
|
do { \
|
|
dlog_func((level), __FILE__, __LINE__, __func__, ##__VA_ARGS__); \
|
|
} while (0)
|
|
|
|
#endif /* LOG_H */
|