Changes between Version 4 and Version 5 of tim_driver

Timestamp:

Oct 25, 2014, 9:40:27 PM (10 years ago)

Author:

alain

Comment:

--

tim_driver

@@ -1 @@
-= GIET-VM / BDV Driver = 
+= GIET-VM / TIM Driver = 
 
 [[PageOutline]]
@@ -20 +20 @@
 
 
- === int '''_timer_start'''( unsigned int cluster_xy,  unsigned int local_id,  unsigned int period ) === 
-This function activates a timer in the vci_timer component by writing in the proper register the period value.
-It can be used by both the kernel to initialise a "system" timer, or by a task (through a system call) to configure an "user" timer.
+ === int '''_timer_start'''( unsigned int channel,  unsigned int period ) === 
+This function activates a timer channel in the vci_timer component by writing in the proper register the period value.
+ * '''channel''' : Timer channel global index
+ * '''period''' : interrupt period (cycles)
+Return 0 in case of success.
+Return -1 if timer index too large.
+
+ === int '''_timer_stop'''(  unsigned int channel ) ===
+This function desactivates a timer channel in the vci_timer component by writing in the proper register.
 
 Return 0 in case of success.
 Return -1 if timer index too large.
 
- === int '''_timer_stop'''( unsigned int cluster_xy,  unsigned int local_id ) ===
-This function desactivates a timer in the vci_timer component by writing in the proper register.
-
-Return 0 in case of success.
-Return -1 if timer index too large.
-
- === int '''_timer_reset_irq'''( unsigned int cluster_xy,  unsigned int local_id ) ===
-This function acknowlegge a timer interrupt in the vci_timer  component by writing in the proper register.
-It can be used by both the isr_switch() for a "system" timer, or by the _isr_timer() for an "user" timer.
+ === int '''_timer_reset_irq'''(  unsigned int channel ) ===
+This function can be used by the the _isr_timer() to acknowlege a timer interrupt in the vci_timer  component by writing in the proper register.
 
 Return 0 in case of success.
@@ -41 +40 @@
 
  === int '''_timer_reset_cpt'''( unsigned int cluster_xy,   unsigned int local_id) ===
-This function resets the timer counter. To do so, we re-write the period in the proper register, what causes the count to restart.
-This function is called during a context switch (user or preemptive).
+This function resets the timer counter, by re-writing the period in the proper register, what causes the count to restart. This function is called during a context switch (user or preemptive).
 
 Return 0 in case of success.
@@ -49 +47 @@
  === void '''_timer_isr'''( unsigned int irq_type,  unsigned int irq_id,  unsigned int channel ) ===
 This Interrupt Service Routine handles the IRQs generated by the "user" timers.
-The IRQs generated by the "system" timers should be handled by _isr_switch().
-It can be a HWI or a PTI. The channel argument is the timer local index.
+It can be a HWI or a PTI. The channel argument is the timer global index.
 The ISR acknowledges the IRQ, registers the event in the proper entry
 of the _user_timer_event[] array, and a log message is displayed on TTY0.