aboutsummaryrefslogtreecommitdiff
path: root/kernel/task/include/task/sched.h
blob: c14a85b77837d27db1b7e457677f120ff6a6f332 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
#ifndef SCHED_H
#define SCHED_H

#include "collection/list.h"
#include "task/task.h"
#include "mcu/task/task.h"

/**
 * Points to currently executing task. If no scheduling has been enabled,
 * this points to NULL
 */
extern struct tcb_t* volatile current;

/**
 * Queue that contains all tasks that are ready to be run, awaiting their
 * turn from the scheduler.
 */
extern struct list_head ready;

/**
 * Stack pointer for operations performed out of task context, including any
 * calls made after SAVE_CONTEXT().
 */
extern void* volatile kstack;

/** 
 * Makes the current task sleep on a specific queue.
 * This moves the current task to the given queue's tail.
 */
static inline void sleep_queue(struct list_head* queue) {
  list_move_tail(&current->queue, queue);
}

/** 
 * Wakes all tasks waiting in the given queue.
 * This moves all tasks contained in the queue to the ready queue.
 */
static inline void wake_all_queue(struct list_head* queue) {
  list_splice_init(queue, ready.prev);
}

/**
 * Initializes a given task and adds it to the ready queue.
 */
void spawn(struct tcb_t* const tcb);

/**
 * Voluntarily relinquishes control of the CPU from the current task to the scheduler.
 */
void yield() __attribute__ ( ( naked ) );


/**
 * Initializes the scheduler by setting up kstack, initializing the idle task
 * and selecting the first task to run.
 */
void sched_init();

/** 
 * Enters the scheduler, setting current to the next runnable task.
 */
void schedule();

#endif