88 lines
3.1 KiB
C
88 lines
3.1 KiB
C
/*
|
|
* This file is part of the coreboot project.
|
|
*
|
|
* Copyright (C) 2013 Google, Inc.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
#ifndef THREAD_H_
|
|
#define THREAD_H_
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <bootstate.h>
|
|
#include <timer.h>
|
|
#include <arch/cpu.h>
|
|
|
|
#if CONFIG_COOP_MULTITASKING && !defined(__SMM__) && !defined(__PRE_RAM__)
|
|
|
|
struct thread {
|
|
int id;
|
|
uintptr_t stack_current;
|
|
uintptr_t stack_orig;
|
|
struct thread *next;
|
|
void (*entry)(void *);
|
|
void *entry_arg;
|
|
int can_yield;
|
|
};
|
|
|
|
void threads_initialize(void);
|
|
/* Get the base of the thread stacks.
|
|
* Returns pointer to CONFIG_NUM_THREADS*CONFIG_STACK_SIZE contiguous bytes
|
|
* aligned to CONFIG_STACK_SIZE, or NULL.
|
|
*/
|
|
void *arch_get_thread_stackbase(void);
|
|
/* Run func(arrg) on a new thread. Return 0 on successful start of thread, < 0
|
|
* when thread could not be started. Note that the thread will block the
|
|
* current state in the boot state machine until it is complete. */
|
|
int thread_run(void (*func)(void *), void *arg);
|
|
/* thread_run_until is the same as thread_run() except that it blocks state
|
|
* transitions from occurring in the (state, seq) pair of the boot state
|
|
* machine. */
|
|
int thread_run_until(void (*func)(void *), void *arg,
|
|
boot_state_t state, boot_state_sequence_t seq);
|
|
/* Return 0 on successful yield for the given amount of time, < 0 when thread
|
|
* did not yield. */
|
|
int thread_yield_microseconds(unsigned int microsecs);
|
|
|
|
/* Allow and prevent thread cooperation on current running thread. By default
|
|
* all threads are marked to be cooperative. That means a thread can yield
|
|
* to another thread at a pre-determined switch point. Current there is
|
|
* only a single place where switching may occur: a call to udelay(). */
|
|
void thread_cooperate(void);
|
|
void thread_prevent_coop(void);
|
|
|
|
static inline void thread_init_cpu_info_non_bsp(struct cpu_info *ci)
|
|
{
|
|
ci->thread = NULL;
|
|
}
|
|
|
|
/* Architecture specific thread functions. */
|
|
asmlinkage void switch_to_thread(uintptr_t new_stack, uintptr_t *saved_stack);
|
|
/* Set up the stack frame for a new thread so that a switch_to_thread() call
|
|
* will enter the thread_entry() function with arg as a parameter. The
|
|
* saved_stack field in the struct thread needs to be updated accordingly. */
|
|
void arch_prepare_thread(struct thread *t,
|
|
asmlinkage void (*thread_entry)(void *), void *arg);
|
|
#else
|
|
static inline void threads_initialize(void) {}
|
|
static inline int thread_run(void (*func)(void *), void *arg) { return -1; }
|
|
static inline int thread_yield_microseconds(unsigned int microsecs)
|
|
{
|
|
return -1;
|
|
}
|
|
static inline void thread_cooperate(void) {}
|
|
static inline void thread_prevent_coop(void) {}
|
|
struct cpu_info;
|
|
static inline void thread_init_cpu_info_non_bsp(struct cpu_info *ci) { }
|
|
#endif
|
|
|
|
#endif /* THREAD_H_ */
|