source: soft/giet_vm/giet_kernel/sys_handler.h @ 738

Last change on this file since 738 was 733, checked in by alain, 9 years ago

Modify the system functions associated to hardware coprocessors:
Introduce two explicit arguments "cluster_xy" and "cluster_type"
to allows any task to control a coprocessor located in any cluster.

  • Property svn:executable set to *
File size: 11.7 KB
Line 
1///////////////////////////////////////////////////////////////////////////////
2// File     : sys_handler.h
3// Date     : 01/04/2012
4// Author   : alain greiner
5// Copyright (c) UPMC-LIP6
6///////////////////////////////////////////////////////////////////////////////
7// The sys_handler.c and sys_handler.h files are part of the GIET-VM kernel.
8// It define the syscall_vector[] (at the end of this file), as well as the
9// associated syscall handlers.
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _SYS_HANDLER_H
13#define _SYS_HANDLER_H
14
15#include "giet_config.h"
16#include "kernel_locks.h"
17#include "stdio.h"
18
19///////////////////////////////////////////////////////////////////////////////
20// Define the possible command values for the giet_pthread_control() syscall
21// These define must be synchronized with values in the stdio.c file
22///////////////////////////////////////////////////////////////////////////////
23
24#define THREAD_CMD_PAUSE        0
25#define THREAD_CMD_RESUME       1
26#define THREAD_CMD_CONTEXT      2
27
28///////////////////////////////////////////////////////////////////////////////
29// Define the error codes for the syscall handlers
30// These define must be synchronized with values in the stdio.c file
31///////////////////////////////////////////////////////////////////////////////
32
33#define SYSCALL_OK                               ( 0 )
34#define SYSCALL_VSPACE_NOT_FOUND                 (-1 )
35#define SYSCALL_THREAD_NOT_FOUND                 (-2 )
36#define SYSCALL_NOT_IN_SAME_VSPACE               (-3 )
37#define SYSCALL_UNCOHERENT_THREAD_CONTEXT        (-4 )
38#define SYSCALL_ILLEGAL_THREAD_COMMAND_TYPE      (-5 )
39#define SYSCALL_CANNOT_LOAD_DATA_SEGMENT         (-6 )
40#define SYSCALL_THREAD_ALREADY_ACTIVE            (-7 )
41#define SYSCALL_MAIN_NOT_FOUND                   (-8 )
42#define SYSCALL_APPLI_CANNOT_BE_KILLED           (-9 )
43#define SYSCALL_PTHREAD_ARGUMENT_NOT_SUPPORTED   (-10)
44#define SYSCALL_ILLEGAL_CLUSTER_COORDINATES      (-11)
45#define SYSCALL_VSEG_NOT_FOUND                   (-12)
46#define SYSCALL_UNDEFINED_SYSTEM_CALL            (-13)
47#define SYSCALL_COPROCESSOR_NOT_FOUND            (-14)
48#define SYSCALL_COPROCESSOR_ILLEGAL_MODE         (-15)
49#define SYSCALL_COPROCESSOR_NON_ALLOCATED        (-16)
50#define SYSCALL_CHANNEL_ALREADY_ALLOCATED        (-17)
51#define SYSCALL_NO_CHANNEL_AVAILABLE             (-18)
52#define SYSCALL_CHANNEL_NON_ALLOCATED            (-19)
53#define SYSCALL_ILLEGAL_ARGUMENT                 (-20)
54#define SYSCALL_OUT_OF_KERNEL_HEAP_MEMORY        (-21)
55#define SYSCALL_ADDRESS_NON_ALIGNED              (-22)
56#define SYSCALL_ADDRESS_NON_USER_ACCESSIBLE      (-23)
57#define SYSCALL_MISSING_INITIALISATION           (-24)
58
59///////////////////////////////////////////////////////////////////////////////
60//     Syscall Vector Table (indexed by syscall index)
61///////////////////////////////////////////////////////////////////////////////
62
63extern const void * _syscall_vector[64];
64
65///////////////////////////////////////////////////////////////////////////////
66// This structure is used by the CMA component to move a stream of images
67// from a set of user buffers to the frame buffer in kernel space.
68// It contains two chbuf arrays:
69// - The SRC chbuf contains <nbufs> buffer descriptors, in user space,
70//   that can be distributed (one buffer per cluster) or not.
71// - The DST cbuf contains one single buffer, that is the frame buffer.
72// Each buffer is described with a 64 bits buffer descriptor:
73// - the 26 LSB bits contain bits[31:6] of the status physical address.
74// - the 26 following bits contain bits[31:6] of the buffer physical address.
75// - the 12 MSB bits contain the common address extension.
76// The actual number of user buffers cannot be larger than 256 (at most
77// one user buffer per cluster for a 16*16 mesh).
78// NB: The user buffers are mapped in user space, but the chbuf descriptor
79// contained in this structure is a protected kernel variable.
80// This structure must be 64 bytes aligned.
81///////////////////////////////////////////////////////////////////////////////
82
83typedef struct fbf_chbuf_s
84{
85    unsigned long long  fbf_desc;                    // frame buffer descriptor
86    unsigned long long  usr_desc[256];               // user chbuf descriptor
87    unsigned int        nbufs;                       // number of user buffers
88} fbf_chbuf_t;   
89
90///////////////////////////////////////////////////////////////////////////////
91// This structure is used by the CMA component to move a stream of containers
92// between the NIC chbuf containing 2 buffers, and a kernel chbuf
93// containing up to (X_SIZE * Y_SIZE) buffers (one buffer per cluster).
94// The same structure is used for both TX or RX transfers.
95// The number of distributed containers can be smaller than (X_SIZE * YSIZE).
96// The actual number of buffers used in the chbuf is defined by (xmax * ymax).
97// Each buffer is described with a 64 bits buffer descriptor:
98// - the 26 LSB bits contain bits[31:6] of the status physical address.
99// - the 26 following bits contain bits[31:6] of the buffer physical address.
100// - the 12 MSB bits contain the common address extension.
101// The <xmax> and <ymax> fields define the actual mesh size.
102// This structure must be 64 bytes aligned.
103///////////////////////////////////////////////////////////////////////////////
104
105typedef struct nic_chbuf_s
106{
107    unsigned long long   buf_desc[X_SIZE*Y_SIZE];     // kernel chbuf descriptor
108    unsigned int         xmax;                        // nb clusters in a row
109    unsigned int         ymax;                        // nb clusters in a column
110} nic_chbuf_t;
111
112
113//////////////////////////////////////////////////////////////////////////////
114//           Applications related syscall handlers
115//////////////////////////////////////////////////////////////////////////////
116
117extern int _sys_kill_application( char* name );
118
119extern int _sys_exec_application( char* name );
120
121extern int _sys_applications_status( char* name );
122
123/////////////////////////////////////////////////////////////////////////////
124//          Threads related syscall handlers
125/////////////////////////////////////////////////////////////////////////////
126
127extern int _sys_pthread_create( unsigned int*  buffer,
128                                void*          attr,
129                                void*          function,
130                                void*          arg );
131
132extern int _sys_pthread_join( unsigned int  trdid,
133                              void*         ptr );
134
135extern int _sys_pthread_kill( unsigned int  trdid,
136                              int           signal );
137
138extern int _sys_pthread_exit( void* string);
139
140extern int _sys_pthread_yield();
141
142extern int _sys_pthread_control( unsigned int  command,
143                                 char*         vspace_name,
144                                 char*         thread_name );
145
146///////////////////////////////////////////////////////////////////////////////
147//          Coprocessors related syscall handlers
148///////////////////////////////////////////////////////////////////////////////
149
150extern int _sys_coproc_alloc( unsigned int   cluster_xy,
151                              unsigned int   coproc_type,
152                              unsigned int*  return_info );
153
154extern int _sys_coproc_release( unsigned int cluster_xy,
155                                unsigned int coproc_type );
156
157extern int _sys_coproc_channel_init( unsigned int            cluster_xy,
158                                     unsigned int            coproc_type,
159                                     unsigned int            channel,
160                                     giet_coproc_channel_t*  desc );
161
162extern int _sys_coproc_run( unsigned int cluster_xy,
163                            unsigned int coproc_type );
164
165extern int _sys_coproc_completed( unsigned int cluster_xy,
166                                  unsigned int coproc_type );
167
168///////////////////////////////////////////////////////////////////////////////
169//    TTY related syscall handlers
170///////////////////////////////////////////////////////////////////////////////
171
172extern int _sys_tty_alloc( unsigned int shared );
173
174extern int _sys_tty_release();
175
176extern int _sys_tty_write( const char*  buffer,
177                    unsigned int length,
178                    unsigned int channel );
179
180extern int _sys_tty_read(  char*        buffer,
181                    unsigned int length,
182                    unsigned int channel );
183
184//////////////////////////////////////////////////////////////////////////////
185//    TIM related syscall handlers
186//////////////////////////////////////////////////////////////////////////////
187
188extern int _sys_tim_alloc();
189
190extern int _sys_tim_release();
191
192extern int _sys_tim_start( unsigned int period );
193
194extern int _sys_tim_stop();
195
196//////////////////////////////////////////////////////////////////////////////
197//    NIC related syscall handlers
198//////////////////////////////////////////////////////////////////////////////
199
200extern int _sys_nic_alloc( unsigned int is_rx,
201                           unsigned int xmax,
202                           unsigned int ymax );
203
204extern int _sys_nic_release( unsigned int is_rx );
205
206extern int _sys_nic_start( unsigned int is_rx );
207
208extern int _sys_nic_move( unsigned int is_rx,
209                          void*        buffer );
210
211extern int _sys_nic_stop( unsigned int is_rx );
212
213extern int _sys_nic_clear( unsigned int is_rx );
214
215extern int _sys_nic_stats( unsigned int is_rx );
216
217//////////////////////////////////////////////////////////////////////////////
218//    FBF related syscall handlers
219//////////////////////////////////////////////////////////////////////////////
220
221extern int _sys_fbf_size( unsigned int* width,
222                          unsigned int* height );
223
224extern int _sys_fbf_alloc();
225
226extern int _sys_fbf_release();
227
228extern int _sys_fbf_sync_write( unsigned int offset,
229                                void*        buffer,
230                                unsigned int length );
231
232extern int _sys_fbf_sync_read(  unsigned int offset,
233                                void*        buffer,
234                                unsigned int length );
235
236extern int _sys_fbf_cma_alloc( unsigned int nbufs );
237
238extern int _sys_fbf_cma_release();
239
240extern int _sys_fbf_cma_init_buf( unsigned int index, 
241                                  void*        buf_vaddr, 
242                                  void*        sts_vaddr );
243
244extern int _sys_fbf_cma_start();
245
246extern int _sys_fbf_cma_display( unsigned int index );
247
248extern int _sys_fbf_cma_check( unsigned int index );
249
250extern int _sys_fbf_cma_stop();
251
252//////////////////////////////////////////////////////////////////////////////
253//    Miscelaneous syscall handlers
254//////////////////////////////////////////////////////////////////////////////
255
256extern int _sys_ukn();
257
258extern int _sys_proc_xyp( unsigned int* x,
259                          unsigned int* y,
260                          unsigned int* p );
261
262extern int _sys_procs_number( unsigned int* x_size,
263                              unsigned int* y_size, 
264                              unsigned int* nprocs );
265
266extern int _sys_vseg_get_vbase( char*         vspace_name,
267                                char*         vseg_name,
268                                unsigned int* vbase );
269
270extern int _sys_vseg_get_length( char*         vspace_name, 
271                                 char*         vseg_name,
272                                 unsigned int* length );
273
274extern int _sys_xy_from_ptr( void*          ptr,
275                             unsigned int*  x,
276                             unsigned int*  y );
277
278extern int _sys_heap_info( unsigned int* vaddr, 
279                           unsigned int* length,
280                           unsigned int  x,
281                           unsigned int  y ); 
282
283#endif
284
285// Local Variables:
286// tab-width: 4
287// c-basic-offset: 4
288// c-file-offsets:((innamespace . 0)(inline-open . 0))
289// indent-tabs-mode: nil
290// End:
291// vim: filetype=c:expandtab:shiftwidth=4:tabstop=4:softtabstop=4
292
Note: See TracBrowser for help on using the repository browser.