OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/soc/native/inf_clock/posix_native_task.h

65 lines
1.8 KiB
C
Raw Normal View History

soc_inf: Refactor native tasks into own header The native_tasks definition was directly in the soc_inf soc.h header. But soc.h pulls a lot of other headers. Some of those could cause conflicts, say with application headers, for users who only wanted the be able to register native tasks in a module. Let's refactor the native tasks definitions into their own header and include that header from soc_inf's soc.h. In this way users who need only need to register a native tasks can just include posix_native_tasks.h, and all previous users see no change. Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-04-13 16:39:57 +08:00
/*
* Copyright (c) 2017 Oticon A/S
*
* SPDX-License-Identifier: Apache-2.0
*/
#ifndef _POSIX_SOC_INF_CLOCK_POSIX_NATIVE_TASK_H
#define _POSIX_SOC_INF_CLOCK_POSIX_NATIVE_TASK_H
arch posix: native tasks header: Add missing include The native_tasks header requires the toolchain header. Let's include it directly instead of requiring users of this header to include it before. Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-06-08 17:04:21 +08:00
#include <zephyr/toolchain.h>
soc_inf: Refactor native tasks into own header The native_tasks definition was directly in the soc_inf soc.h header. But soc.h pulls a lot of other headers. Some of those could cause conflicts, say with application headers, for users who only wanted the be able to register native tasks in a module. Let's refactor the native tasks definitions into their own header and include that header from soc_inf's soc.h. In this way users who need only need to register a native tasks can just include posix_native_tasks.h, and all previous users see no change. Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-04-13 16:39:57 +08:00
#ifdef __cplusplus
extern "C" {
#endif
/**
* NATIVE_TASK
*
soc/posix posix_native_task: Replace native_posix in description Replace native_posix in the NATIVE_TASK description. Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-12-06 00:09:20 +08:00
* For native targets (POSIX arch based), register a function to be called at particular moments
* during the native target execution.
soc_inf: Refactor native tasks into own header The native_tasks definition was directly in the soc_inf soc.h header. But soc.h pulls a lot of other headers. Some of those could cause conflicts, say with application headers, for users who only wanted the be able to register native tasks in a module. Let's refactor the native tasks definitions into their own header and include that header from soc_inf's soc.h. In this way users who need only need to register a native tasks can just include posix_native_tasks.h, and all previous users see no change. Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-04-13 16:39:57 +08:00
*
* There is 5 choices for when the function will be called (level):
* * PRE_BOOT_1: Will be called before the command line parameters are parsed,
* or the HW models are initialized
*
* * PRE_BOOT_2: Will be called after the command line parameters are parsed,
* but before the HW models are initialized
*
* * PRE_BOOT_3: Will be called after the HW models initialization, right before
* the "CPU is booted" and Zephyr is started.
*
* * FIRST_SLEEP: Will be called the 1st time the CPU is sent to sleep
*
* * ON_EXIT: Will be called during termination of the native application
* execution.
*
* The function must take no parameters and return nothing.
* Note that for the PRE and ON_EXIT levels neither the Zephyr kernel or
* any Zephyr thread are running.
*/
#define NATIVE_TASK(fn, level, prio) \
static void (* const _CONCAT(__native_task_, fn))() __used __noasan \
__attribute__((__section__(".native_" #level STRINGIFY(prio) "_task")))\
= fn
#define _NATIVE_PRE_BOOT_1_LEVEL 0
#define _NATIVE_PRE_BOOT_2_LEVEL 1
#define _NATIVE_PRE_BOOT_3_LEVEL 2
#define _NATIVE_FIRST_SLEEP_LEVEL 3
#define _NATIVE_ON_EXIT_LEVEL 4
/**
* @brief Run the set of special native tasks corresponding to the given level
*
* @param level One of _NATIVE_*_LEVEL as defined in soc.h
*/
void run_native_tasks(int level);
#ifdef __cplusplus
}
#endif
#endif /* _POSIX_SOC_INF_CLOCK_POSIX_NATIVE_TASK_H */