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 <toolchain.h>
#include <kernel.h>
#include <zephyr/types.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*
 * System initialization levels. The PRE_KERNEL_1 and PRE_KERNEL_2 levels are
 * executed in the kernel's initialization context, which uses the interrupt
 * stack. The remaining levels are executed in the kernel's main task.
 */
 
#define _SYS_INIT_LEVEL_PRE_KERNEL_1    0
#define _SYS_INIT_LEVEL_PRE_KERNEL_2    1
#define _SYS_INIT_LEVEL_POST_KERNEL     2
#define _SYS_INIT_LEVEL_APPLICATION     3
 
#ifdef CONFIG_SMP
#define _SYS_INIT_LEVEL_SMP             4
#endif
 
struct device;
 
struct init_entry {
        int (*init)(const struct device *dev);
        const struct device *dev;
};
 
void z_sys_init_run_level(int32_t level);
 
/* A counter is used to avoid issues when two or more system devices
 * are declared in the same C file with the same init function.
 */
#define Z_SYS_NAME(_init_fn) _CONCAT(_CONCAT(sys_init_, _init_fn), __COUNTER__)
 
#define Z_INIT_ENTRY_DEFINE(_entry_name, _init_fn, _device, _level, _prio)      \
        static const Z_DECL_ALIGN(struct init_entry)                    \
                _CONCAT(__init_, _entry_name) __used                    \
        __attribute__((__section__(".z_init_" #_level STRINGIFY(_prio)"_"))) = { \
                .init = (_init_fn),                                     \
                .dev = (_device),                                       \
        }
 
#define SYS_INIT(_init_fn, _level, _prio)                                       \
        Z_INIT_ENTRY_DEFINE(Z_SYS_NAME(_init_fn), _init_fn, NULL, _level, _prio)
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_INIT_H_ */