michaelh/zephyr
1
0
Fork 0
Code Releases Activity

logging: Cleanup in log_instance

Browse source 
Cleanup in log_instance.h:
 - prefixing internal macros with Z_
 - adding doxygen documentation
 - using COND_CODE_1 instead of ifdefs

Additionally, added LOG_INSTANCE_PTR macro which allows to get
pointer to instance. It can be used to reuse single instance
for multiple module layers when doing instance logging.

Signed-off-by: Krzysztof Chruscinski <krzysztof.chruscinski@nordicsemi.no>
This commit is contained in:
Krzysztof Chruscinski 2021-12-13 13:08:01 +01:00 • committed by Carles Cufí
commit 62b57651e8
4 changed files with 127 additions and 75 deletions
Download patch file Download diff file Expand all files Collapse all files

8
include/logging/log.h
View file

@ -318,8 +318,8 @@ static inline char *log_strdup(const char *str)
#define _LOG_MODULE_CONST_DATA_CREATE(_name, _level) \ #define _LOG_MODULE_CONST_DATA_CREATE(_name, _level) \
IF_ENABLED(LOG_IN_CPLUSPLUS, (extern)) \ IF_ENABLED(LOG_IN_CPLUSPLUS, (extern)) \
const struct log_source_const_data LOG_ITEM_CONST_DATA(_name) \ const struct log_source_const_data Z_LOG_ITEM_CONST_DATA(_name) \
__attribute__ ((section("." STRINGIFY(LOG_ITEM_CONST_DATA(_name))))) \ __attribute__ ((section("." STRINGIFY(Z_LOG_ITEM_CONST_DATA(_name))))) \
__attribute__((used)) = { \ __attribute__((used)) = { \
.name = STRINGIFY(_name), \ .name = STRINGIFY(_name), \
.level = _level \ .level = _level \
@ -409,14 +409,14 @@ static inline char *log_strdup(const char *str)
*/ */
#define LOG_MODULE_DECLARE(...) \ #define LOG_MODULE_DECLARE(...) \
extern const struct log_source_const_data \ extern const struct log_source_const_data \
LOG_ITEM_CONST_DATA(GET_ARG_N(1, __VA_ARGS__)); \ Z_LOG_ITEM_CONST_DATA(GET_ARG_N(1, __VA_ARGS__)); \
extern struct log_source_dynamic_data \ extern struct log_source_dynamic_data \
LOG_ITEM_DYNAMIC_DATA(GET_ARG_N(1, __VA_ARGS__)); \ LOG_ITEM_DYNAMIC_DATA(GET_ARG_N(1, __VA_ARGS__)); \
\ \
static const struct log_source_const_data * \ static const struct log_source_const_data * \
__log_current_const_data __unused = \ __log_current_const_data __unused = \
_LOG_LEVEL_RESOLVE(__VA_ARGS__) ? \ _LOG_LEVEL_RESOLVE(__VA_ARGS__) ? \
&LOG_ITEM_CONST_DATA(GET_ARG_N(1, __VA_ARGS__)) : \ &Z_LOG_ITEM_CONST_DATA(GET_ARG_N(1, __VA_ARGS__)) : \
NULL; \ NULL; \
\ \
static struct log_source_dynamic_data * \ static struct log_source_dynamic_data * \

2
include/logging/log_core.h
View file

@ -563,7 +563,7 @@ extern struct log_source_dynamic_data __log_dynamic_end[];
#define LOG_ITEM_DYNAMIC_DATA(_name) UTIL_CAT(log_dynamic_, _name) #define LOG_ITEM_DYNAMIC_DATA(_name) UTIL_CAT(log_dynamic_, _name)
#define LOG_INSTANCE_DYNAMIC_DATA(_module_name, _inst) \ #define LOG_INSTANCE_DYNAMIC_DATA(_module_name, _inst) \
LOG_ITEM_DYNAMIC_DATA(LOG_INSTANCE_FULL_NAME(_module_name, _inst)) LOG_ITEM_DYNAMIC_DATA(Z_LOG_INSTANCE_FULL_NAME(_module_name, _inst))
/** @brief Get index of the log source based on the address of the dynamic data /** @brief Get index of the log source based on the address of the dynamic data
* associated with the source. * associated with the source.

156
include/logging/log_instance.h
View file

@ -41,82 +41,134 @@ struct log_source_dynamic_data {
#endif #endif
}; };
/** @brief Creates name of variable and section for constant log data. /** @internal
*
* Creates name of variable and section for constant log data.
* *
* @param _name Name. * @param _name Name.
*/ */
#define LOG_ITEM_CONST_DATA(_name) UTIL_CAT(log_const_, _name) #define Z_LOG_ITEM_CONST_DATA(_name) UTIL_CAT(log_const_, _name)
/** @internal
*
* Create static logging instance in read only memory.
*
* @param _name name of the module. With added prefix forms name of variable and
* memory section.
*
* @param _str_name Name of the module that will be used when message is formatted.
*
* @param _level Messages up to this level are compiled in.
*/
#define Z_LOG_CONST_ITEM_REGISTER(_name, _str_name, _level) \ #define Z_LOG_CONST_ITEM_REGISTER(_name, _str_name, _level) \
const struct log_source_const_data LOG_ITEM_CONST_DATA(_name) \ const struct log_source_const_data Z_LOG_ITEM_CONST_DATA(_name) \
__attribute__ ((section("." STRINGIFY(LOG_ITEM_CONST_DATA(_name))))) \ __attribute__ ((section("." STRINGIFY(Z_LOG_ITEM_CONST_DATA(_name))))) \
__attribute__((used)) = { \ __attribute__((used)) = { \
.name = _str_name, \ .name = _str_name, \
.level = (_level), \ .level = (_level), \
} }
/** @def LOG_INSTANCE_PTR_DECLARE /** @brief Initialize pointer to logger instance with explicitly provided object.
* @brief Macro for declaring a logger instance pointer in the module structure.
*/
/** @def LOG_INSTANCE_REGISTER
* @brief Macro for registering instance for logging with independent filtering.
* *
* Module instance provides filtering of logs on instance level instead of * Macro can be used to initialized a pointer with object that is not unique to
* module level. * the given instance, thus not created with @ref LOG_INSTANCE_REGISTER.
*
* @param _name Name of the structure element for holding logging object.
* @param _object Pointer to a logging instance object.
*/ */
#define LOG_OBJECT_PTR_INIT(_name, _object) \
IF_ENABLED(CONFIG_LOG, (._name = _object,))
/** @def LOG_INSTANCE_PTR_INIT /** @internal
* @brief Macro for initializing a pointer to the logger instance. *
* Create a name for which contains module and instance names.
*/ */
#define Z_LOG_INSTANCE_FULL_NAME(_module_name, _inst_name) \
#ifdef CONFIG_LOG
#define LOG_INSTANCE_FULL_NAME(_module_name, _inst_name) \
UTIL_CAT(_module_name, UTIL_CAT(_, _inst_name)) UTIL_CAT(_module_name, UTIL_CAT(_, _inst_name))
#if defined(CONFIG_LOG_RUNTIME_FILTERING) /** @internal
#define LOG_INSTANCE_PTR_DECLARE(_name) \ *
struct log_source_dynamic_data *_name * Returns a pointer associated with given logging instance. When runtime filtering
* is enabled then dynamic instance is returned.
*
* @param _name Name of the instance.
*
* @return Pointer to the instance object (static or dynamic).
*/
#define Z_LOG_OBJECT_PTR(_name) \
COND_CODE_1(CONFIG_LOG_RUNTIME_FILTERING, \
(&LOG_ITEM_DYNAMIC_DATA(_name)), \
(&Z_LOG_ITEM_CONST_DATA(_name))) \
#define LOG_INSTANCE_REGISTER(_module_name, _inst_name, _level) \ /** @brief Get pointer to a logging instance.
Z_LOG_CONST_ITEM_REGISTER( \ *
LOG_INSTANCE_FULL_NAME(_module_name, _inst_name), \ * Instance is identified by @p _module_name and @p _inst_name.
STRINGIFY(_module_name._inst_name), \ *
_level); \ * @param _module_name Module name.
struct log_source_dynamic_data LOG_INSTANCE_DYNAMIC_DATA( \ * @param _inst_name Instance name.
_module_name, _inst_name) \ *
* @return Pointer to a logging instance.
*/
#define LOG_INSTANCE_PTR(_module_name, _inst_name) \
Z_LOG_OBJECT_PTR(Z_LOG_INSTANCE_FULL_NAME(_module_name, _inst_name))
/** @brief Macro for initializing a pointer to the logger instance.
*
* @p _module_name and @p _inst_name are concatenated to form a name of the object.
*
* Macro is intended to be used in user structure initializer to initialize a field
* in the structure that holds pointer to the logging instance. Structure field
* should be declared using @p LOG_INSTANCE_PTR_DECLARE.
*
* @param _name Name of a structure element that have a pointer to logging instance object.
* @param _module_name Module name.
* @param _inst_name Instance name.
*/
#define LOG_INSTANCE_PTR_INIT(_name, _module_name, _inst_name) \
LOG_OBJECT_PTR_INIT(_name, LOG_INSTANCE_PTR(_module_name, _inst_name))
#define Z_LOG_INSTANCE_STRUCT \
COND_CODE_1(CONFIG_LOG_RUNTIME_FILTERING, \
(struct log_source_dynamic_data), \
(const struct log_source_const_data))
/**
* @brief Declare a logger instance pointer in the module structure.
*
* @param _name Name of a structure element that will have a pointer to logging
* instance object.
*/
#define LOG_INSTANCE_PTR_DECLARE(_name) \
IF_ENABLED(CONFIG_LOG, (Z_LOG_INSTANCE_STRUCT * _name))
#define Z_LOG_RUNTIME_INSTANCE_REGISTER(_module_name, _inst_name) \
struct log_source_dynamic_data LOG_INSTANCE_DYNAMIC_DATA(_module_name, _inst_name) \
__attribute__ ((section("." STRINGIFY( \ __attribute__ ((section("." STRINGIFY( \
LOG_INSTANCE_DYNAMIC_DATA(_module_name, \ LOG_INSTANCE_DYNAMIC_DATA(_module_name, _inst_name) \
_inst_name) \
) \ ) \
))) __attribute__((used)) ))) __attribute__((used))
#define LOG_INSTANCE_PTR_INIT(_name, _module_name, _inst_name) \ #define Z_LOG_INSTANCE_REGISTER(_module_name, _inst_name, _level) \
._name = &LOG_ITEM_DYNAMIC_DATA( \
LOG_INSTANCE_FULL_NAME(_module_name, _inst_name)),
#else /* CONFIG_LOG_RUNTIME_FILTERING */
#define LOG_INSTANCE_PTR_DECLARE(_name) \
const struct log_source_const_data *_name
#define LOG_INSTANCE_REGISTER(_module_name, _inst_name, _level) \
Z_LOG_CONST_ITEM_REGISTER( \ Z_LOG_CONST_ITEM_REGISTER( \
LOG_INSTANCE_FULL_NAME(_module_name, _inst_name), \ Z_LOG_INSTANCE_FULL_NAME(_module_name, _inst_name), \
STRINGIFY(_module_name._inst_name), \ STRINGIFY(_module_name._inst_name), \
_level) _level); \
IF_ENABLED(CONFIG_LOG_RUNTIME_FILTERING, \
(Z_LOG_RUNTIME_INSTANCE_REGISTER(_module_name, _inst_name)))
/**
#define LOG_INSTANCE_PTR_INIT(_name, _module_name, _inst_name) \ * @brief Macro for registering instance for logging with independent filtering.
._name = &LOG_ITEM_CONST_DATA( \ *
LOG_INSTANCE_FULL_NAME(_module_name, _inst_name)), * Module instance provides filtering of logs on instance level instead of
* module level. Instance create using this macro can later on be used with
#endif /* CONFIG_LOG_RUNTIME_FILTERING */ * @ref LOG_INSTANCE_PTR_INIT or referenced by @ref LOG_INSTANCE_PTR.
#else /* CONFIG_LOG */ *
#define LOG_INSTANCE_PTR_DECLARE(_name) /* empty */ * @param _module_name Module name.
#define LOG_INSTANCE_REGISTER(_module_name, _inst_name, _level) /* empty */ * @param _inst_name Instance name.
#define LOG_INSTANCE_PTR_INIT(_name, _module_name, _inst_name) /* empty */ * @param _level Initial static filtering.
#endif */
#define LOG_INSTANCE_REGISTER(_module_name, _inst_name, _level) \
IF_ENABLED(CONFIG_LOG, (Z_LOG_INSTANCE_REGISTER(_module_name, _inst_name, _level)))
#ifdef __cplusplus #ifdef __cplusplus
} }

2
tests/subsys/logging/log_output/src/log_output_test.c
View file

@ -108,7 +108,7 @@ void test_log_output_string(void)
struct log_msg_ids src_level = { struct log_msg_ids src_level = {
.level = LOG_LEVEL_DBG, .level = LOG_LEVEL_DBG,
.source_id = log_const_source_id( .source_id = log_const_source_id(
&LOG_ITEM_CONST_DATA(LOG_MODULE_NAME)), &Z_LOG_ITEM_CONST_DATA(LOG_MODULE_NAME)),
.domain_id = CONFIG_LOG_DOMAIN_ID, .domain_id = CONFIG_LOG_DOMAIN_ID,
}; };