annotate packages/kernel/current/include/kapi.h @ 177:4c750ce71ae3

Merge from eCos master repository on 2001-08-10-19:22:57-BST
author jlarmour
date Fri, 10 Aug 2001 19:27:55 +0000
parents d397fc472bcf
children 391299f9e541
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1 #ifndef CYGONCE_KERNEL_KAPI_H
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
2 #define CYGONCE_KERNEL_KAPI_H
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
3
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
4 /*==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
5 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
6 // kapi.h
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
7 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
8 // Native API for Kernel
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
9 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
10 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
11 //####COPYRIGHTBEGIN####
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
12 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
13 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
14 // The contents of this file are subject to the Red Hat eCos Public License
66
bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents: 64
diff changeset
15 // Version 1.1 (the "License"); you may not use this file except in
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
16 // compliance with the License. You may obtain a copy of the License at
66
bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents: 64
diff changeset
17 // http://www.redhat.com/
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
18 //
66
bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents: 64
diff changeset
19 // Software distributed under the License is distributed on an "AS IS"
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
20 // basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
21 // License for the specific language governing rights and limitations under
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
22 // the License.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
23 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
24 // The Original Code is eCos - Embedded Configurable Operating System,
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
25 // released September 30, 1998.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
26 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
27 // The Initial Developer of the Original Code is Red Hat.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
28 // Portions created by Red Hat are
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
29 // Copyright (C) 1998, 1999, 2000 Red Hat, Inc.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
30 // All Rights Reserved.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
31 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 10
diff changeset
32 //
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
33 //####COPYRIGHTEND####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
34 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
35 //#####DESCRIPTIONBEGIN####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
36 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
37 // Author(s): nickg, dsm
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
38 // Contributors: nickg
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
39 // Date: 1998-03-02
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
40 // Purpose: Native API for Kernel
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
41 // Description: This file describes the native API for using the kernel.
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
42 // It is essentially a set of C wrappers for the C++ class
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
43 // member functions.
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
44 // Usage: #include <cyg/kernel/kapi.h>
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
45 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
46 //####DESCRIPTIONEND####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
47 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
48 //========================================================================*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
49
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
50 #include <pkgconf/kernel.h>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
51
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
52 #ifdef CYGFUN_KERNEL_API_C
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
53 #include <cyg/infra/cyg_type.h>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
54
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
55 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
56
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
57 #ifdef __cplusplus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
58 extern "C" {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
59 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
60
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
61 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
62 /* The following are derived types, they may have different */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
63 /* definitions from these depending on configuration. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
64
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
65 typedef CYG_ADDRWORD cyg_addrword_t; /* May hold pointer or word */
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
66 typedef cyg_addrword_t cyg_handle_t; /* Object handle */
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
67 typedef cyg_uint32 cyg_priority_t; /* type for priorities */
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
68 typedef cyg_int32 cyg_code_t; /* type for various codes */
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
69 typedef cyg_uint32 cyg_vector_t; /* Interrupt vector id */
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
70 typedef cyg_uint32 cyg_cpu_t; /* CPU id type */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
71
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
72 typedef cyg_uint64 cyg_tick_count_t;
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
73
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
74 typedef int cyg_bool_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
75
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
76 /* Exception handler function definition */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
77 typedef void cyg_exception_handler_t(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
78 cyg_addrword_t data,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
79 cyg_code_t exception_number,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
80 cyg_addrword_t info
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
81 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
82
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
83 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
84 struct cyg_thread;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
85 typedef struct cyg_thread cyg_thread;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
86
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
87 struct cyg_interrupt;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
88 typedef struct cyg_interrupt cyg_interrupt;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
89
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
90 struct cyg_counter;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
91 typedef struct cyg_counter cyg_counter;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
92
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
93 struct cyg_clock;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
94 typedef struct cyg_clock cyg_clock;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
95
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
96 struct cyg_alarm;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
97 typedef struct cyg_alarm cyg_alarm;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
98
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
99 struct cyg_mbox;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
100 typedef struct cyg_mbox cyg_mbox;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
101
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
102 struct cyg_sem_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
103 typedef struct cyg_sem_t cyg_sem_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
104
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
105 struct cyg_flag_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
106 typedef struct cyg_flag_t cyg_flag_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
107
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
108 struct cyg_mutex_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
109 typedef struct cyg_mutex_t cyg_mutex_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
110
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
111 struct cyg_cond_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
112 typedef struct cyg_cond_t cyg_cond_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
113
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
114 struct cyg_spinlock_t;
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
115 typedef struct cyg_spinlock_t cyg_spinlock_t;
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
116
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
117 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
118 /* Scheduler operations */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
119
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
120 /* Starts scheduler with created threads. Never returns. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
121 void cyg_scheduler_start(void) __attribute__ ((noreturn));
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
122
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
123 /* Lock and unlock the scheduler. When the scheduler is */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
124 /* locked thread preemption is disabled. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
125 void cyg_scheduler_lock(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
126
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
127 void cyg_scheduler_unlock(void);
84
489eb5632bc3 Merge from eCos master repository on 2000-04-28-18:44:39-BST
jlarmour
parents: 66
diff changeset
128
489eb5632bc3 Merge from eCos master repository on 2000-04-28-18:44:39-BST
jlarmour
parents: 66
diff changeset
129 /* Just like 'cyg_scheduler_lock()', but never take the lock higher than 1 */
489eb5632bc3 Merge from eCos master repository on 2000-04-28-18:44:39-BST
jlarmour
parents: 66
diff changeset
130 /* Thus this call is safe even if the scheduler is already locked and a */
489eb5632bc3 Merge from eCos master repository on 2000-04-28-18:44:39-BST
jlarmour
parents: 66
diff changeset
131 /* subsequent call to 'cyg_scheduler_unlock()' will completely unlock. */
489eb5632bc3 Merge from eCos master repository on 2000-04-28-18:44:39-BST
jlarmour
parents: 66
diff changeset
132 void cyg_scheduler_safe_lock(void);
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
133
105
5a0cc6c243a9 Merge from eCos master repository on 2000-06-30-08:18:49-BST
jlarmour
parents: 84
diff changeset
134 /* Read the scheduler lock value. */
5a0cc6c243a9 Merge from eCos master repository on 2000-06-30-08:18:49-BST
jlarmour
parents: 84
diff changeset
135 cyg_ucount32 cyg_scheduler_read_lock(void);
5a0cc6c243a9 Merge from eCos master repository on 2000-06-30-08:18:49-BST
jlarmour
parents: 84
diff changeset
136
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
137 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
138 /* Thread operations */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
139
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
140 typedef void cyg_thread_entry_t(cyg_addrword_t);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
141
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
142 void cyg_thread_create(
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
143 cyg_addrword_t sched_info, /* scheduling info (eg pri) */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
144 cyg_thread_entry_t *entry, /* entry point function */
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
145 cyg_addrword_t entry_data, /* entry data */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
146 char *name, /* optional thread name */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
147 void *stack_base, /* stack base, NULL = alloc */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
148 cyg_ucount32 stack_size, /* stack size, 0 = default */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
149 cyg_handle_t *handle, /* returned thread handle */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
150 cyg_thread *thread /* put thread here */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
151 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
152
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
153 void cyg_thread_exit(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
154
8
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 2
diff changeset
155 /* It may be necessary to arrange for the victim to run for it to disappear */
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 2
diff changeset
156 cyg_bool_t cyg_thread_delete(cyg_handle_t thread); /* false if NOT deleted */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
157
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
158 void cyg_thread_suspend(cyg_handle_t thread);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
159
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
160 void cyg_thread_resume(cyg_handle_t thread);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
161
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
162 void cyg_thread_kill(cyg_handle_t thread);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
163
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
164 void cyg_thread_release(cyg_handle_t thread);
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
165
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
166 void cyg_thread_yield(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
167
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
168 cyg_handle_t cyg_thread_self(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
169
10
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
170 cyg_handle_t cyg_thread_idle_thread(void);
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
171
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
172 /* Priority manipulation */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
173
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
174 void cyg_thread_set_priority(cyg_handle_t thread, cyg_priority_t priority );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
175
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
176 cyg_priority_t cyg_thread_get_priority(cyg_handle_t thread);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
177
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
178 /* Deadline scheduling control (optional) */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
179
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
180 void cyg_thread_deadline_wait(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
181 cyg_tick_count_t start_time, /* abs earliest start time */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
182 cyg_tick_count_t run_time, /* worst case execution time */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
183 cyg_tick_count_t deadline /* absolute deadline */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
184 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
185
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
186 void cyg_thread_delay(cyg_tick_count_t delay);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
187
10
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
188 /* Stack information */
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
189 cyg_addrword_t cyg_thread_get_stack_base(cyg_handle_t thread);
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
190
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
191 cyg_uint32 cyg_thread_get_stack_size(cyg_handle_t thread);
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
192
147
d397fc472bcf Merge from eCos master repository on 2001-01-05-06:43:02-GMT
jlarmour
parents: 115
diff changeset
193 #ifdef CYGFUN_KERNEL_THREADS_STACK_MEASUREMENT
d397fc472bcf Merge from eCos master repository on 2001-01-05-06:43:02-GMT
jlarmour
parents: 115
diff changeset
194 cyg_uint32 cyg_thread_measure_stack_usage(cyg_handle_t thread);
d397fc472bcf Merge from eCos master repository on 2001-01-05-06:43:02-GMT
jlarmour
parents: 115
diff changeset
195 #endif
10
d3fbcdfa1b2f Merge from eCos master repository on 1999-05-29-00:13:11-BST
jlarmour
parents: 8
diff changeset
196
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
197 /*---------------------------------------------------------------------------*/
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
198 /* Per-thread Data */
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
199
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
200 #ifdef CYGVAR_KERNEL_THREADS_DATA
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
201
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
202 cyg_ucount32 cyg_thread_new_data_index(void);
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
203
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
204 void cyg_thread_free_data_index(cyg_ucount32 index);
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
205
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
206 CYG_ADDRWORD cyg_thread_get_data(cyg_ucount32 index);
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
207
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
208 CYG_ADDRWORD *cyg_thread_get_data_ptr(cyg_ucount32 index);
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
209
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
210 void cyg_thread_set_data(cyg_ucount32 index, CYG_ADDRWORD data);
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
211
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
212 #endif
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
213
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
214 /*---------------------------------------------------------------------------*/
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
215 /* Exception handling. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
216
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
217 /* Replace current exception handler, this may apply to either the */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
218 /* current thread, or to a global exception handler. The exception */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
219 /* number may be ignored, or used to specify a particular handler. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
220
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
221 void cyg_exception_set_handler(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
222 cyg_code_t exception_number,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
223 cyg_exception_handler_t *new_handler,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
224 cyg_addrword_t new_data,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
225 cyg_exception_handler_t **old_handler,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
226 cyg_addrword_t *old_data
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
227 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
228
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
229 /* Clear exception hander to default value */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
230 void cyg_exception_clear_handler(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
231 cyg_code_t exception_number
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
232 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
233
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
234 /* Invoke exception handler */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
235 void cyg_exception_call_handler(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
236 cyg_handle_t thread,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
237 cyg_code_t exception_number,
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
238 cyg_addrword_t exception_info
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
239 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
240
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
241
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
242 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
243 /* Interrupt handling */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
244 typedef void cyg_VSR_t(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
245 typedef cyg_uint32 cyg_ISR_t(cyg_vector_t vector, cyg_addrword_t data);
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
246 typedef void cyg_DSR_t( cyg_vector_t vector,
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
247 cyg_ucount32 count,
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
248 cyg_addrword_t data);
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
249
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
250
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
251 enum cyg_ISR_results
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
252 {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
253 CYG_ISR_HANDLED = 1, /* Interrupt was handled */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
254 CYG_ISR_CALL_DSR = 2 /* Schedule DSR */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
255 };
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
256
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
257 void cyg_interrupt_create(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
258 cyg_vector_t vector, /* Vector to attach to */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
259 cyg_priority_t priority, /* Queue priority */
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
260 cyg_addrword_t data, /* Data pointer */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
261 cyg_ISR_t *isr, /* Interrupt Service Routine */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
262 cyg_DSR_t *dsr, /* Deferred Service Routine */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
263 cyg_handle_t *handle, /* returned handle */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
264 cyg_interrupt *intr /* put interrupt here */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
265 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
266
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
267 void cyg_interrupt_delete( cyg_handle_t interrupt );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
268
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
269 void cyg_interrupt_attach( cyg_handle_t interrupt );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
270
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
271 void cyg_interrupt_detach( cyg_handle_t interrupt );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
272
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
273 /* VSR manipulation */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
274
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
275 void cyg_interrupt_get_vsr(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
276 cyg_vector_t vector, /* vector to get */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
277 cyg_VSR_t **vsr /* vsr got */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
278 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
279
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
280 void cyg_interrupt_set_vsr(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
281 cyg_vector_t vector, /* vector to set */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
282 cyg_VSR_t *vsr /* vsr to set */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
283 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
284
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
285 /* CPU level interrupt mask */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
286 void cyg_interrupt_disable(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
287
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
288 void cyg_interrupt_enable(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
289
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
290 /* Interrupt controller access */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
291 void cyg_interrupt_mask(cyg_vector_t vector);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
292
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
293 void cyg_interrupt_unmask(cyg_vector_t vector);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
294
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
295 void cyg_interrupt_acknowledge(cyg_vector_t vector);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
296
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
297 void cyg_interrupt_configure(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
298 cyg_vector_t vector, /* vector to configure */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
299 cyg_bool_t level, /* level or edge triggered */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
300 cyg_bool_t up /* rising/faling edge, high/low level*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
301 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
302
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
303 void cyg_interrupt_set_cpu(
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
304 cyg_vector_t vector, /* vector to control */
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
305 cyg_cpu_t cpu /* CPU to set */
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
306 );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
307
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
308 cyg_cpu_t cyg_interrupt_get_cpu(
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
309 cyg_vector_t vector /* vector to control */
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
310 );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
311
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
312 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
313 /* Counters, Clocks and Alarms */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
314
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
315 void cyg_counter_create(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
316 cyg_handle_t *handle, /* returned counter handle */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
317 cyg_counter *counter /* put counter here */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
318 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
319
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
320 void cyg_counter_delete(cyg_handle_t counter);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
321
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
322 /* Return current value of counter */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
323 cyg_tick_count_t cyg_counter_current_value(cyg_handle_t counter);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
324
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
325 /* Set new current value */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
326 void cyg_counter_set_value(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
327 cyg_handle_t counter,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
328 cyg_tick_count_t new_value
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
329 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
330
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
331 /* Advance counter by one tick */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
332 void cyg_counter_tick(cyg_handle_t counter);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
333
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
334
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
335 typedef struct
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
336 {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
337 cyg_uint32 dividend;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
338 cyg_uint32 divisor;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
339 } cyg_resolution_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
340
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
341 /* Create a clock object */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
342 void cyg_clock_create(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
343 cyg_resolution_t resolution, /* Initial resolution */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
344 cyg_handle_t *handle, /* Returned clock handle */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
345 cyg_clock *clock /* put clock here */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
346 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
347
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
348 void cyg_clock_delete(cyg_handle_t clock);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
349
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
350 /* convert a clock handle to a counter handle so we can use the */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
351 /* counter API on it. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
352 void cyg_clock_to_counter(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
353 cyg_handle_t clock,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
354 cyg_handle_t *counter
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
355 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
356
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
357 void cyg_clock_set_resolution(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
358 cyg_handle_t clock,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
359 cyg_resolution_t resolution /* New resolution */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
360 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
361
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
362 cyg_resolution_t cyg_clock_get_resolution(cyg_handle_t clock);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
363
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
364 /* handle of real time clock */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
365 cyg_handle_t cyg_real_time_clock(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
366
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
367 /* returns value of real time clock's counter.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
368 This is the same as:
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
369 (cyg_clock_to_counter(cyg_real_time_clock(), &h),
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
370 cyg_counter_current_value(h)) */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
371 cyg_tick_count_t cyg_current_time(void);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
372
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
373 /* Alarm handler function */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
374 typedef void cyg_alarm_t(cyg_handle_t alarm, cyg_addrword_t data);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
375
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
376 void cyg_alarm_create(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
377 cyg_handle_t counter, /* Attached to this counter */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
378 cyg_alarm_t *alarmfn, /* Call-back function */
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
379 cyg_addrword_t data, /* Call-back data */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
380 cyg_handle_t *handle, /* Returned alarm object */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
381 cyg_alarm *alarm /* put alarm here */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
382 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
383
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
384 /* Disable alarm, detach from counter and invalidate handles */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
385 void cyg_alarm_delete( cyg_handle_t alarm);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
386
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
387 void cyg_alarm_initialize(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
388 cyg_handle_t alarm,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
389 cyg_tick_count_t trigger, /* Absolute trigger time */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
390 cyg_tick_count_t interval /* Relative retrigger interval */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
391 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
392
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
393 void cyg_alarm_enable( cyg_handle_t alarm );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
394
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
395 void cyg_alarm_disable( cyg_handle_t alarm );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
396
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
397 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
398 /* Mail boxes */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
399 void cyg_mbox_create(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
400 cyg_handle_t *handle,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
401 cyg_mbox *mbox
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
402 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
403
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
404 void cyg_mbox_delete(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
405
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
406 void *cyg_mbox_get(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
407
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
408 #ifdef CYGFUN_KERNEL_THREADS_TIMER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
409 void *cyg_mbox_timed_get(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
410 cyg_handle_t mbox,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
411 cyg_tick_count_t abstime
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
412 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
413 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
414
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
415 void *cyg_mbox_tryget(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
416
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
417 void *cyg_mbox_peek_item(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
418
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
419 #ifdef CYGMFN_KERNEL_SYNCH_MBOXT_PUT_CAN_WAIT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
420 cyg_bool_t cyg_mbox_put(cyg_handle_t mbox, void *item);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
421 #ifdef CYGFUN_KERNEL_THREADS_TIMER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
422 cyg_bool_t cyg_mbox_timed_put(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
423 cyg_handle_t mbox,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
424 void *item,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
425 cyg_tick_count_t abstime
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
426 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
427 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
428 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
429
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
430 cyg_bool_t cyg_mbox_tryput(cyg_handle_t mbox, void *item);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
431
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
432 cyg_count32 cyg_mbox_peek(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
433
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
434 cyg_bool_t cyg_mbox_waiting_to_get(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
435
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
436 cyg_bool_t cyg_mbox_waiting_to_put(cyg_handle_t mbox);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
437
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
438
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
439 /*-----------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
440 /* Memory pools */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
441
115
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents: 105
diff changeset
442 /* These definitions are found in the "memalloc" package as this is */
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents: 105
diff changeset
443 /* where the implementation lives. */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
444
115
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents: 105
diff changeset
445 #include <cyg/memalloc/kapi.h>
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
446
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
447 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
448 /* Semaphores */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
449
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
450 void cyg_semaphore_init(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
451 cyg_sem_t *sem, /* Semaphore to init */
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
452 cyg_count32 val /* Initial semaphore value */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
453 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
454
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
455 void cyg_semaphore_destroy( cyg_sem_t *sem );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
456
115
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents: 105
diff changeset
457 cyg_bool_t cyg_semaphore_wait( cyg_sem_t *sem );
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
458
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
459 #ifdef CYGFUN_KERNEL_THREADS_TIMER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
460 cyg_bool_t cyg_semaphore_timed_wait(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
461 cyg_sem_t *sem,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
462 cyg_tick_count_t abstime
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
463 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
464 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
465
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
466 cyg_bool_t cyg_semaphore_trywait( cyg_sem_t *sem );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
467
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
468 void cyg_semaphore_post( cyg_sem_t *sem );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
469
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
470 void cyg_semaphore_peek( cyg_sem_t *sem, cyg_count32 *val );
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
471
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
472 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
473 /* Flags */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
474
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
475 typedef cyg_uint32 cyg_flag_value_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
476 typedef cyg_uint8 cyg_flag_mode_t;
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
477 #define CYG_FLAG_WAITMODE_AND ((cyg_flag_mode_t)0) /* all bits must be set */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
478 #define CYG_FLAG_WAITMODE_OR ((cyg_flag_mode_t)2) /* any bit must be set */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
479 #define CYG_FLAG_WAITMODE_CLR ((cyg_flag_mode_t)1) /* clear when satisfied */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
480
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
481 void cyg_flag_init(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
482 cyg_flag_t *flag /* Flag to init */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
483 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
484
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
485 void cyg_flag_destroy( cyg_flag_t *flag );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
486
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
487 /* bitwise-or in the bits in value; awaken any waiting tasks whose
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
488 condition is now satisfied */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
489 void cyg_flag_setbits( cyg_flag_t *flag, cyg_flag_value_t value);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
490
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
491 /* bitwise-and with the the bits in value; this clears the bits which
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
492 are not set in value. No waiting task can be awoken. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
493 void cyg_flag_maskbits( cyg_flag_t *flag, cyg_flag_value_t value);
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
494
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
495 /* wait for the flag value to match the pattern, according to the mode.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
496 If mode includes CLR, set the flag value to zero when
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
497 our pattern is matched. The return value is that which matched
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
498 the request, or zero for an error/timeout return.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
499 Value must not itself be zero. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
500 cyg_flag_value_t cyg_flag_wait( cyg_flag_t *flag,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
501 cyg_flag_value_t pattern,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
502 cyg_flag_mode_t mode );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
503
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
504 #ifdef CYGFUN_KERNEL_THREADS_TIMER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
505 cyg_flag_value_t cyg_flag_timed_wait( cyg_flag_t *flag,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
506 cyg_flag_value_t pattern,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
507 cyg_flag_mode_t mode,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
508 cyg_tick_count_t abstime );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
509
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
510 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
511
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
512 cyg_flag_value_t cyg_flag_poll( cyg_flag_t *flag,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
513 cyg_flag_value_t pattern,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
514 cyg_flag_mode_t mode );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
515
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
516 cyg_flag_value_t cyg_flag_peek( cyg_flag_t *flag );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
517
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
518 cyg_bool_t cyg_flag_waiting( cyg_flag_t *flag );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
519
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
520 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
521 /* Mutex */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
522
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
523 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL_DYNAMIC
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
524 enum cyg_protcol
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
525 {
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
526 NONE = 0, // no inversion protocol
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
527 INHERIT, // priority inheritance protocol
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
528 CEILING // priority ceiling protocol
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
529 };
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
530 #endif
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
531
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
532 void cyg_mutex_init(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
533 cyg_mutex_t *mutex /* Mutex to init */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
534 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
535
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
536 void cyg_mutex_destroy( cyg_mutex_t *mutex );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
537
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
538 cyg_bool_t cyg_mutex_lock( cyg_mutex_t *mutex );
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
539
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
540 cyg_bool_t cyg_mutex_trylock( cyg_mutex_t *mutex );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
541
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
542 void cyg_mutex_unlock( cyg_mutex_t *mutex );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
543
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
544 void cyg_mutex_release( cyg_mutex_t *mutex );
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
545
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
546 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL_CEILING
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
547 void cyg_mutex_set_ceiling( cyg_mutex_t *mutex, cyg_priority_t priority );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
548 #endif
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
549
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
550 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL_DYNAMIC
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
551 void cyg_mutex_set_protocol ( cyg_mutex_t *mutex, enum cyg_protcol protocol );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
552 #endif
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
553
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
554 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
555 /* Condition Variables */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
556
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
557 void cyg_cond_init(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
558 cyg_cond_t *cond, /* condition variable to init */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
559 cyg_mutex_t *mutex /* associated mutex */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
560 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
561
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
562 void cyg_cond_destroy( cyg_cond_t *cond );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
563
115
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents: 105
diff changeset
564 cyg_bool_t cyg_cond_wait( cyg_cond_t *cond );
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
565
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
566 void cyg_cond_signal( cyg_cond_t *cond );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
567
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
568 void cyg_cond_broadcast( cyg_cond_t *cond );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
569
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
570 #ifdef CYGMFN_KERNEL_SYNCH_CONDVAR_TIMED_WAIT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
571 cyg_bool_t cyg_cond_timed_wait(
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
572 cyg_cond_t *cond,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
573 cyg_tick_count_t abstime
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
574 );
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
575 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
576
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
577 /*---------------------------------------------------------------------------*/
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
578 /* Spinlocks */
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
579
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
580 void cyg_spinlock_init(
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
581 cyg_spinlock_t *lock, /* spinlock to initialize */
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
582 cyg_bool_t locked /* init locked or unlocked */
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
583 );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
584
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
585 void cyg_spinlock_destroy( cyg_spinlock_t *lock );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
586
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
587 void cyg_spinlock_spin( cyg_spinlock_t *lock );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
588
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
589 void cyg_spinlock_clear( cyg_spinlock_t *lock );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
590
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
591 cyg_bool_t cyg_spinlock_try( cyg_spinlock_t *lock );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
592
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
593 cyg_bool_t cyg_spinlock_test( cyg_spinlock_t *lock );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
594
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
595 void cyg_spinlock_spin_intsave( cyg_spinlock_t *lock,
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
596 cyg_addrword_t *istate );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
597
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
598 void cyg_spinlock_clear_intsave( cyg_spinlock_t *lock,
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
599 cyg_addrword_t istate );
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
600
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
601 /*---------------------------------------------------------------------------*/
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
602 #ifdef __cplusplus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
603 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
604 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
605
177
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
606 /*---------------------------------------------------------------------------*/
4c750ce71ae3 Merge from eCos master repository on 2001-08-10-19:22:57-BST
jlarmour
parents: 147
diff changeset
607
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
608 #include <cyg/kernel/kapidata.h>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
609
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
610 /*---------------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
611 /* EOF kapi.h */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
612 #endif /* CYGFUN_KERNEL_API_C */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
613 #endif /* CYGONCE_KERNEL_KAPI_H */