92 lines
3.0 KiB
C
92 lines
3.0 KiB
C
/* start_task.c - arch-agnostic nanokernel APIs to start a task */
|
|
|
|
/*
|
|
* Copyright (c) 2010-2014 Wind River Systems, Inc.
|
|
*
|
|
* 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 Wind River Systems 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.
|
|
*/
|
|
|
|
/*
|
|
DESCRIPTION
|
|
This module contains the single primitive 'start_task' which is utilized
|
|
by the microkernel to "start a task".
|
|
*/
|
|
|
|
#ifdef CONFIG_MICROKERNEL
|
|
|
|
#include <start_task_arch.h>
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* start_task - initialize and start a task
|
|
*
|
|
* RETURNS: N/A
|
|
*/
|
|
|
|
void start_task(struct k_proc *X, /* ptr to task control block */
|
|
void (*func)(void) /* entry point for task */
|
|
)
|
|
{
|
|
unsigned int contextOptions;
|
|
void *pNewContext;
|
|
|
|
/* Note: the field X->worksize now represents the task size in bytes */
|
|
|
|
#ifdef CONFIG_INIT_STACKS
|
|
k_memset(X->workspace, 0xaa, X->worksize);
|
|
#endif
|
|
|
|
contextOptions = 0;
|
|
_START_TASK_ARCH(X, &contextOptions);
|
|
|
|
/*
|
|
* The 'func' argument to _NewContext() represents the entry point of
|
|
* the
|
|
* kernel task. The 'parameter1', 'parameter2', & 'parameter3'
|
|
* arguments
|
|
* are not applicable to such tasks. A 'priority' of -1 indicates that
|
|
* the context is a task, rather than a fiber.
|
|
*/
|
|
|
|
pNewContext = (tCCS *)_NewContext((char *)X->workspace, /* pStackMem */
|
|
X->worksize, /* stackSize */
|
|
(_ContextEntry)func, /* pEntry */
|
|
(void *)0, /* parameter1 */
|
|
(void *)0, /* parameter2 */
|
|
(void *)0, /* parameter3 */
|
|
-1, /* priority */
|
|
contextOptions /* options */
|
|
);
|
|
|
|
X->workspace = (char *)pNewContext;
|
|
X->fabort = NULL;
|
|
|
|
reset_state_bit(X, TF_STOP | TF_TERM);
|
|
}
|
|
|
|
#endif /* CONFIG_MICROKERNEL */
|