130 lines
5.6 KiB
C
130 lines
5.6 KiB
C
|
|
/* Copyright (c) 2015 Intel Corporation.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1) Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2) Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3) Neither the name of Intel Corporation nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _INIT_H_
|
|
#define _INIT_H_
|
|
|
|
#include <device.h>
|
|
#include <toolchain.h>
|
|
|
|
#define PRE_KERNEL_CORE 0
|
|
#define PRE_KERNEL_EARLY 1
|
|
#define PRE_KERNEL_LATE 2
|
|
#define NANO_EARLY 3
|
|
#define NANO_LATE 4
|
|
#define MICRO_EARLY 5
|
|
#define MICRO_LATE 6
|
|
#define APP_EARLY 7
|
|
#define APP_LATE 8
|
|
|
|
/** @def __define_initconfig
|
|
*
|
|
* @brief Define an init object
|
|
*
|
|
* @details This macro declares an init object to be placed in a
|
|
* given init level section in the image. This macro should not be used
|
|
* directly.
|
|
*
|
|
* @param cfg_name Name of the config object created with
|
|
* DECLARE_DEVICE_INIT_CONFIG() macro that will be referenced by
|
|
* init object.
|
|
*
|
|
* @param id The init level id where the init object will be placed
|
|
* in the image.
|
|
*
|
|
* @param data The pointer to the driver data for the driver instance.
|
|
* @sa DECLARE_DEVICE_INIT_CONFIG()
|
|
*/
|
|
#define __define_initconfig(cfg_name, id, data) \
|
|
static struct device (__initconfig_##cfg_name##id) __used \
|
|
__attribute__((__section__(".initconfig" #id ".init"))) = { \
|
|
.config = &(config_##cfg_name),\
|
|
.driver_data = data}
|
|
/*
|
|
* There are four distinct init levels, pre_kernel, nano, micro
|
|
* and app. Each init level a unique set of restrictions placed on the
|
|
* component being initialized within the level.
|
|
* pre_kernel:
|
|
* At this level no kernel objects or services are available to
|
|
* the component. pre_kernel has three phases, core, early and
|
|
* late. The core phase is intended for components that rely
|
|
* solely on hardware present in the processor/SOC and do *not*
|
|
* rely on services from any other component in the system. The
|
|
* early phase can be used by components that do *not* need kernel
|
|
* services and may rely on components from the core phase. The
|
|
* late phase can be used by components that do *not* need kernel
|
|
* services and may rely on components from the core and early
|
|
* phases.
|
|
* nano:
|
|
* At this level nano kernel services are available to the
|
|
* component. All services provided by the components initialized
|
|
* in the pre_kernel are also available. The nano level has an
|
|
* early and late phase. Components in the early phase may rely
|
|
* on the nano kernel and pre_kernel services. Components in the
|
|
* late phase may rely on, nano kernel, pre_kernel services and
|
|
* nano_early services
|
|
* micro:
|
|
* At this level micro kernel, nano kernel and pre_kernel services
|
|
* are available to the component. The micor level has an
|
|
* early and late phase. Components in the early phase may rely
|
|
* on micro kernel, nano kernel and pre_kernel services.
|
|
* Components in the late phase may rely on, micro kernel, nano
|
|
* kernel, pre_kernel services and micro_early services
|
|
* app:
|
|
* The app level is not intended for core kernel components but for
|
|
* the application developer to add any components that they wish to
|
|
* have initialized automatically during kernel initialization. The
|
|
* app level is executed as the final init stage in both nanokernel
|
|
* and microkernel configurations. The application component may
|
|
* rely any component configured into the system.
|
|
*/
|
|
|
|
/* Run on pre_kernel stack; no {micro,nano} kernel objects available */
|
|
#define pre_kernel_core_init(cfg, data) __define_initconfig(cfg, 0, data)
|
|
#define pre_kernel_early_init(cfg, data) __define_initconfig(cfg, 1, data)
|
|
#define pre_kernel_late_init(cfg, data) __define_initconfig(cfg, 2, data)
|
|
|
|
/* Run from nano kernel idle task; no micro kernel objects available */
|
|
#define nano_early_init(cfg, data) __define_initconfig(cfg, 3, data)
|
|
#define nano_late_init(cfg, data) __define_initconfig(cfg, 4, data)
|
|
|
|
/* Run from micro kernel idle task. */
|
|
#define micro_early_init(cfg, data) __define_initconfig(cfg, 5, data)
|
|
#define micro_late_init(cfg, data) __define_initconfig(cfg, 6, data)
|
|
|
|
/* Run in the idle task; In a nano kernel only system run after
|
|
* nano_late_init(). In a micro kernel system after micro_late_init()
|
|
*/
|
|
#define app_early_init(cfg, data) __define_initconfig(cfg, 7, data)
|
|
#define app_late_init(cfg, data) __define_initconfig(cfg, 8, data)
|
|
|
|
|
|
#endif /* _INIT_H_ */
|