aboutsummaryrefslogtreecommitdiff
path: root/kernel/task/include/task/task.h
blob: 99f16dcc385d327ccf4e6468da31b2e145bbaa7c (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
#ifndef TASK_H
#define TASK_H

#include "collection/list.h"

/**
 * Wakeup sources define the minimum power level
 * at which a task that is waiting in a queue
 * can be woken up
 */
enum wakeup_src {
   WAKEUP_SRC_OFF = 0, //processor off, external interrupts may trigger this source
   WAKEUP_SRC_CLOCK = 1, //main clock required
   WAKEUP_SRC_IDLE = 2, //processor can be put in idle state
   WAKEUP_SRC_ON = 3 //processor must stay on
};

/**
 * Task control block, contains runtime
 * information about tasks.
 */
struct tcb_t {
  /** Stack pointer of this task. (must be first in structure) */
  char* volatile sp;

  /** Lowest address of this task's memory (inclusive). */
  char* mem_low;

  /** Highest address of this task's memory (inclusive). */
  char* mem_high;

  /** Entry function of this task. */
  void (*entry)(char);

  /** Current wait queue that this task is in.*/
  struct list_head queue;

  /** ID of task. */
  char id;


  enum wakeup_src wakeup_src;

};

/**
 * Utility for declaring a task with statically allocated memory.
 * Note: for a task to be scheduled, it must first be spawned (see spawn()).
*/
#define DECLARE_TASK(name, stack_size, entry_function, pid) \
  static char _declared_stack_##name[stack_size]; \
  static struct tcb_t name = { \
    .sp = 0, \
    .mem_low = _declared_stack_##name, \
    .mem_high = _declared_stack_##name + stack_size - 1, \
    .entry = entry_function, \
    .queue = {}, \
    .id = pid, \
    .wakeup_src = WAKEUP_SRC_ON \
  };

#endif