auto_init_utils.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: 2022 Otto-von-Guericke-Universität Magdebug
3  * SPDX-License-Identifier: LGPL-2.1-only
4  */
5 
6 #pragma once
7 
27 #include <stdint.h>
28 #include "xfa.h"
29 #include "macros/xtstr.h"
30 #include "modules.h"
31 #if IS_USED(MODULE_PREPROCESSOR_SUCCESSOR)
32 #include "preprocessor_successor.h"
33 #endif
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 #ifndef CONFIG_AUTO_INIT_ENABLE_DEBUG
43 #define CONFIG_AUTO_INIT_ENABLE_DEBUG 0
44 #endif
45 
49 typedef void (*auto_init_fn_t)(void);
50 
54 typedef uint16_t auto_init_prio_t;
55 
59 typedef struct {
60  auto_init_fn_t init;
61 #if IS_ACTIVE(CONFIG_AUTO_INIT_ENABLE_DEBUG) || defined(DOXYGEN)
62  auto_init_prio_t prio;
63  const char *name;
64 #endif
65 } auto_init_module_t;
66 
67 #if IS_ACTIVE(CONFIG_AUTO_INIT_ENABLE_DEBUG) || defined(DOXYGEN)
74 #define AUTO_INIT(function, priority) \
75  XFA_CONST(auto_init_module_t, auto_init_xfa, priority) \
76  auto_init_xfa_ ## function \
77  = { .init = (auto_init_fn_t)function, \
78  .prio = priority, \
79  .name = XTSTR(function) }
80 #else
81 #define AUTO_INIT(function, priority) \
82  XFA_CONST(auto_init_module_t, auto_init_xfa, priority) \
83  auto_init_xfa_ ## function \
84  = { .init = (auto_init_fn_t)function }
85 #endif
86 
91 #define AUTO_INIT_PRIORITY_AFTER(priority) RIOT_PP_SUCCESSOR(priority)
92 
93 #ifdef __cplusplus
94 }
95 #endif
96 
auto_init_fn_t
void(* auto_init_fn_t)(void)
Auto-init function type.
Definition: auto_init_utils.h:49
auto_init_prio_t
uint16_t auto_init_prio_t
Data type to store the priority of a module.
Definition: auto_init_utils.h:54
modules.h
Common macros and compiler attributes/pragmas configuration.
auto_init_module_t
Type to represent a module to be auto-initialized.
Definition: auto_init_utils.h:59
auto_init_module_t::prio
auto_init_prio_t prio
Module priority.
Definition: auto_init_utils.h:62
auto_init_module_t::name
const char * name
Module auto-init function name.
Definition: auto_init_utils.h:63
auto_init_module_t::init
auto_init_fn_t init
Function to initialize the module.
Definition: auto_init_utils.h:60
xfa.h
Cross File Arrays.
xtstr.h
Macro to return string representation of x.