source: rtems/cpukit/include/rtems/score/schedulersimplesmp.h @ 878487b0

5
Last change on this file since 878487b0 was 7097962, checked in by Sebastian Huber <sebastian.huber@…>, on 08/29/18 at 07:43:44

score: Add thread pin/unpin support

Add support to temporarily pin a thread to its current processor. This
may be used to access per-processor data structures in critical sections
with enabled thread dispatching, e.g. a pinned thread is allowed to
block.

Update #3508.

  • Property mode set to 100644
File size: 4.4 KB
Line 
1/**
2 * @file
3 *
4 * @brief Simple SMP Scheduler API
5 *
6 * @ingroup ScoreSchedulerSMPSimple
7 */
8
9/*
10 *  Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
11 *
12 *  Copyright (c) 2013, 2018 embedded brains GmbH.
13 *
14 *  The license and distribution terms for this file may be
15 *  found in the file LICENSE in this distribution or at
16 *  http://www.rtems.org/license/LICENSE.
17 */
18
19#ifndef _RTEMS_SCORE_SCHEDULERSIMPLE_SMP_H
20#define _RTEMS_SCORE_SCHEDULERSIMPLE_SMP_H
21
22#ifdef __cplusplus
23extern "C" {
24#endif
25
26#include <rtems/score/scheduler.h>
27#include <rtems/score/schedulerpriority.h>
28#include <rtems/score/schedulersmp.h>
29
30/**
31 * @defgroup ScoreSchedulerSMPSimple Simple Priority SMP Scheduler
32 *
33 * @ingroup ScoreSchedulerSMP
34 *
35 * The Simple Priority SMP Scheduler allocates a processor for the processor
36 * count highest priority ready threads.  The thread priority and position in
37 * the ready chain are the only information to determine the scheduling
38 * decision.  Threads with an allocated processor are in the scheduled chain.
39 * After initialization the scheduled chain has exactly processor count nodes.
40 * Each processor has exactly one allocated thread after initialization.  All
41 * enqueue and extract operations may exchange threads with the scheduled
42 * chain.  One thread will be added and another will be removed.  The scheduled
43 * and ready chain is ordered according to the thread priority order.  The
44 * chain insert operations are O(count of ready threads), thus this scheduler
45 * is unsuitable for most real-time applications.
46 *
47 * The thread preempt mode will be ignored.
48 *
49 * @{
50 */
51
52typedef struct {
53  Scheduler_SMP_Context Base;
54  Chain_Control         Ready;
55} Scheduler_simple_SMP_Context;
56
57#define SCHEDULER_SIMPLE_SMP_MAXIMUM_PRIORITY 255
58
59/**
60 * @brief Entry points for the Simple SMP Scheduler.
61 */
62#define SCHEDULER_SIMPLE_SMP_ENTRY_POINTS \
63  { \
64    _Scheduler_simple_SMP_Initialize, \
65    _Scheduler_default_Schedule, \
66    _Scheduler_simple_SMP_Yield, \
67    _Scheduler_simple_SMP_Block, \
68    _Scheduler_simple_SMP_Unblock, \
69    _Scheduler_simple_SMP_Update_priority, \
70    _Scheduler_default_Map_priority, \
71    _Scheduler_default_Unmap_priority, \
72    _Scheduler_simple_SMP_Ask_for_help, \
73    _Scheduler_simple_SMP_Reconsider_help_request, \
74    _Scheduler_simple_SMP_Withdraw_node, \
75    _Scheduler_default_Pin_or_unpin, \
76    _Scheduler_default_Pin_or_unpin, \
77    _Scheduler_simple_SMP_Add_processor, \
78    _Scheduler_simple_SMP_Remove_processor, \
79    _Scheduler_simple_SMP_Node_initialize, \
80    _Scheduler_default_Node_destroy, \
81    _Scheduler_default_Release_job, \
82    _Scheduler_default_Cancel_job, \
83    _Scheduler_default_Tick, \
84    _Scheduler_SMP_Start_idle \
85    SCHEDULER_OPERATION_DEFAULT_GET_SET_AFFINITY \
86  }
87
88void _Scheduler_simple_SMP_Initialize( const Scheduler_Control *scheduler );
89
90void _Scheduler_simple_SMP_Node_initialize(
91  const Scheduler_Control *scheduler,
92  Scheduler_Node          *node,
93  Thread_Control          *the_thread,
94  Priority_Control         priority
95);
96
97void _Scheduler_simple_SMP_Block(
98  const Scheduler_Control *scheduler,
99  Thread_Control          *thread,
100  Scheduler_Node          *node
101);
102
103void _Scheduler_simple_SMP_Unblock(
104  const Scheduler_Control *scheduler,
105  Thread_Control          *thread,
106  Scheduler_Node          *node
107);
108
109void _Scheduler_simple_SMP_Update_priority(
110  const Scheduler_Control *scheduler,
111  Thread_Control          *the_thread,
112  Scheduler_Node          *node
113);
114
115bool _Scheduler_simple_SMP_Ask_for_help(
116  const Scheduler_Control *scheduler,
117  Thread_Control          *the_thread,
118  Scheduler_Node          *node
119);
120
121void _Scheduler_simple_SMP_Reconsider_help_request(
122  const Scheduler_Control *scheduler,
123  Thread_Control          *the_thread,
124  Scheduler_Node          *node
125);
126
127void _Scheduler_simple_SMP_Withdraw_node(
128  const Scheduler_Control *scheduler,
129  Thread_Control          *the_thread,
130  Scheduler_Node          *node,
131  Thread_Scheduler_state   next_state
132);
133
134void _Scheduler_simple_SMP_Add_processor(
135  const Scheduler_Control *scheduler,
136  Thread_Control          *idle
137);
138
139Thread_Control *_Scheduler_simple_SMP_Remove_processor(
140  const Scheduler_Control *scheduler,
141  struct Per_CPU_Control  *cpu
142);
143
144void _Scheduler_simple_SMP_Yield(
145  const Scheduler_Control *scheduler,
146  Thread_Control          *thread,
147  Scheduler_Node          *node
148);
149
150/** @} */
151
152#ifdef __cplusplus
153}
154#endif
155
156#endif
157/* end of include file */
Note: See TracBrowser for help on using the repository browser.