Changes between Version 43 and Version 44 of kernel_syscalls

Timestamp:

Sep 17, 2015, 9:08:15 AM (10 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -60 +60 @@
 
 === 1) int '''_sys_tty_alloc'''( unsigned int shared ) ===
-This function allocates a private TTY terminal to the calling thread, and registers the TTY terminal index (called channel) in the thread context. If the <shared> argument is non-zero, the same TTY channel is registered in the context of all others threads in the same vspace, resulting in one single TTY terminal shared by all threads in the vspace. The number of users is registered in the _tty_channel[channel] array. 
+This function allocates a private TTY terminal to the calling thread, and registers the TTY terminal index (called channel) in the thread context. If the <shared> argument is non-zero, the same TTY channel is registered in the context of all others threads in the same vspace, resulting in one single TTY terminal shared by all threads in the vspace. The number of users is registered in the _tty_users[channel] array. An external IRQ (WTI) is dynamically allocated to the processor running the calling thread.
+The processor coordinates[x,y,p] and the WTI index are registered in the _tty_wti[channel] array.
 
 Returns 0 if success. 
@@ -66 +67 @@
 
 === 2) int '''_sys_tty_release'''( ) ===
-This function release the TTY channel allocated to the calling thread. The corresponding thread context slot is reset (0xFFFFFFFF value), and the _tty_channel[channel] entry is decremented. The corresponding channel keep busy until
-the value stored in _tty_channel[channel] is non-zero. 
+This function release the TTY channel allocated to the calling thread. The corresponding thread context slot is reset (0xFFFFFFFF value), and the _tty_users[channel] entry is decremented. The corresponding channel keep busy until
+the value stored in _tty_users[channel] is non-zero. 
 
 Returns 0 if success. 
@@ -84 +85 @@
 
 
-== TIM retated syscall handlers ==
+== TIMER retated syscall handlers ==
 
 === 1) int '''_sys_tim_alloc'''() ===
-This function allocates a private timer to the calling task, and register the timer index in the task context.
-Return -1 if no timer available.
-
+This function allocates a private timer to the calling thread, and register the timer index (called channel) in the thread context.
+The timer is not shared: a 1 value is registered in the _tim_users[channel] array. An external IRQ (WTI) is dynamically allocated to the processor running the calling thread. The processor coordinates[x,y,p] and the WTI index are registered in the _tty_wti[channel] array.
+
+Returns 0 if success.
+Return -1 if no timer available, or timer already allocated.
+
+=== 2) int '''_sys_tim_release'''() ===
+This function release the TIMER channel allocated to the calling thread. The corresponding thread context slot is reset (0xFFFFFFFF value), and the _tty_users[channel] entry is reset to 0.
 === 2) int '''_sys_tim_start'''( unsigned int period ) ===
 This function starts the user timer channel allocated to the calling task.
-Returns 0 if success. Returns -1 if no allocated timer.
-
-=== 3) int '''_sys_tim_stop'''() ===
+
+Returns 0 if success. 
+Returns -1 if  timer already released.
+
+===3) int '''_sys_tim_start'''( unsigned int period ) ===
+This function activates the timer allocated to the calling thread. The <period> argument defines the IRQ period.
+
+Returns 0 if success. 
+Returns -1 if no allocated timer.
+ 
+=== 4) int '''_sys_tim_stop'''() ===
 This function stops the user timer channel allocated to the calling task.
-Returns 0 if success. Returns -1 if no allocated timer.
+
+Returns 0 if success. 
+Returns -1 if no allocated timer.