126 lines
4.4 KiB
C
126 lines
4.4 KiB
C
|
|
/*
|
|
* Copyright (c) 2015 Intel Corporation.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef _INIT_H_
|
|
#define _INIT_H_
|
|
|
|
#include <device.h>
|
|
#include <toolchain.h>
|
|
|
|
/*
|
|
* System initialization levels. The PRIMARY and SECONDARY 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
|
|
* (i.e. the nanokernel's background task or the microkernel's idle task).
|
|
*/
|
|
|
|
#define _SYS_INIT_LEVEL_PRIMARY 0
|
|
#define _SYS_INIT_LEVEL_SECONDARY 1
|
|
#define _SYS_INIT_LEVEL_NANOKERNEL 2
|
|
#define _SYS_INIT_LEVEL_MICROKERNEL 3
|
|
#define _SYS_INIT_LEVEL_APPLICATION 4
|
|
|
|
|
|
/** @def SYS_DEFINE_DEVICE
|
|
*
|
|
* @brief Define device object
|
|
*
|
|
* @details This macro defines a device object that is automatically
|
|
* configured by the kernel during system initialization.
|
|
*
|
|
* @param name Device name.
|
|
*
|
|
* @param data Pointer to the device's configuration data.
|
|
* @sa DECLARE_DEVICE_INIT_CONFIG()
|
|
*
|
|
* @param level The initialization level at which configuration occurs.
|
|
* Must be one of the following symbols, which are listed in the order
|
|
* they are performed by the kernel:
|
|
*
|
|
* PRIMARY: Used for devices that have no dependencies, such as those
|
|
* that rely solely on hardware present in the processor/SOC. These devices
|
|
* cannot use any kernel services during configuration, since they are not
|
|
* yet available.
|
|
*
|
|
* SECONDARY: Used for devices that rely on the initialization of devices
|
|
* initialized as part of the PRIMARY level. These devices cannot use any
|
|
* kernel services during configuration, since they are not yet available.
|
|
*
|
|
* NANOKERNEL: Used for devices that require nanokernel services during
|
|
* configuration.
|
|
*
|
|
* MICROKERNEL: Used for devices that require microkernel services during
|
|
* configuration.
|
|
*
|
|
* APPLICATION: Used for application components (i.e. non-kernel components)
|
|
* that need automatic configuration. These devices can use all services
|
|
* provided by the kernel during configuration.
|
|
*
|
|
* @param priority The initialization priority of the device, relative to
|
|
* other devices of the same initialization level. Specified as an integer
|
|
* value in the range 0 to 99; lower values indicate earlier initialization.
|
|
* Must be expressed as a hard-coded decimal integer literal without leading
|
|
* zeroes (e.g. 32); symbolic expressions are @not permitted.
|
|
*/
|
|
|
|
#define SYS_DEFINE_DEVICE(name, data, level, priority) \
|
|
static struct device (__initconfig_##name) __used \
|
|
__attribute__((__section__(".init_" #level #priority))) = { \
|
|
.config = &(config_##name),\
|
|
.driver_data = data}
|
|
|
|
/**
|
|
* @def SYS_GET_DEVICE
|
|
*
|
|
* @brief Obtain a pointer to a device object by name
|
|
*
|
|
* @details Return the address of a device object created by
|
|
* SYS_DEFINE_DEVICE(), using the @name provided to SYS_DEFINE_DEVICE().
|
|
*
|
|
* @param name The same name provided to SYS_DEFINE_DEVICE()
|
|
*
|
|
* @return A pointer to the device object created by SYS_DEFINE_DEVICE()
|
|
*/
|
|
|
|
#define _PASTE2(a, b) a##b
|
|
#define _PASTE(a, b) _PASTE2(a, b)
|
|
|
|
#define SYS_GET_DEVICE(name) (&(_PASTE(__initconfig_, name)))
|
|
|
|
/* The following legacy APIs are provided for backwards compatibility */
|
|
|
|
#define pre_kernel_core_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, PRIMARY, 0)
|
|
#define pre_kernel_early_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, SECONDARY, 0)
|
|
#define pre_kernel_late_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, SECONDARY, 50)
|
|
#define nano_early_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, NANOKERNEL, 0)
|
|
#define nano_late_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, NANOKERNEL, 50)
|
|
#define micro_early_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, MICROKERNEL, 0)
|
|
#define micro_late_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, MICROKERNEL, 50)
|
|
#define app_early_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, APPLICATION, 0)
|
|
#define app_late_init(cfg, data) \
|
|
SYS_DEFINE_DEVICE(cfg, data, APPLICATION, 50)
|
|
|
|
#endif /* _INIT_H_ */
|