init.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015 Intel Corporation.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_INIT_H_
#define ZEPHYR_INCLUDE_INIT_H_
 
#include <stdint.h>
#include <stddef.h>
 
#include <zephyr/sys/util.h>
#include <zephyr/toolchain.h>
 
#ifdef __cplusplus
extern "C" {
#endif

 
struct device;

struct init_entry {
        int (*init_fn)(void);
        const struct device *dev;
};

 
/* Helper definitions to evaluate level equality */
#define Z_INIT_EARLY_EARLY               1
#define Z_INIT_PRE_KERNEL_1_PRE_KERNEL_1 1
#define Z_INIT_PRE_KERNEL_2_PRE_KERNEL_2 1
#define Z_INIT_POST_KERNEL_POST_KERNEL   1
#define Z_INIT_APPLICATION_APPLICATION   1
#define Z_INIT_SMP_SMP                   1
 
/* Init level ordinals */
#define Z_INIT_ORD_EARLY        0
#define Z_INIT_ORD_PRE_KERNEL_1 1
#define Z_INIT_ORD_PRE_KERNEL_2 2
#define Z_INIT_ORD_POST_KERNEL  3
#define Z_INIT_ORD_APPLICATION  4
#define Z_INIT_ORD_SMP          5

#define Z_INIT_ENTRY_NAME(init_id) _CONCAT(__init_, init_id)

#define Z_INIT_ENTRY_SECTION(level, prio, sub_prio)                                                \
        __attribute__((__section__(                                                                \
                ".z_init_" #level "_P_" STRINGIFY(prio) "_SUB_" STRINGIFY(sub_prio)"_")))


#define INIT_LEVEL_ORD(level)                                                  \
        COND_CASE_1(Z_INIT_EARLY_##level, (Z_INIT_ORD_EARLY),                  \
                    Z_INIT_PRE_KERNEL_1_##level, (Z_INIT_ORD_PRE_KERNEL_1),    \
                    Z_INIT_PRE_KERNEL_2_##level, (Z_INIT_ORD_PRE_KERNEL_2),    \
                    Z_INIT_POST_KERNEL_##level, (Z_INIT_ORD_POST_KERNEL),      \
                    Z_INIT_APPLICATION_##level, (Z_INIT_ORD_APPLICATION),      \
                    Z_INIT_SMP_##level, (Z_INIT_ORD_SMP),                      \
                    (ZERO_OR_COMPILE_ERROR(0)))

#define SYS_INIT(init_fn, level, prio)                                         \
        SYS_INIT_NAMED(init_fn, init_fn, level, prio)

#define SYS_INIT_NAMED(name, init_fn_, level, prio)                                       \
        static const Z_DECL_ALIGN(struct init_entry)                                      \
                Z_INIT_ENTRY_SECTION(level, prio, 0) __used __noasan                      \
                Z_INIT_ENTRY_NAME(name) = {.init_fn = (init_fn_), .dev = NULL}            \


 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_INIT_H_ */