Changes between Version 5 and Version 6 of pic_driver

Timestamp:

Dec 9, 2016, 3:47:20 PM (8 years ago)

Author:

alain

Comment:

--

pic_driver

@@ -15 +15 @@
 The addressable registers map is defined [source:soft/giet_vm/giet_drivers/pic_driver.h here].
 
-
+== __Low level access functions__ ==
 
  === void '''_pic_set_register'''( unsigned int channel,   unsigned int index,   unsigned int value ) ===
-This low level function set a new value in register (channel / index).
+This function set a new value in register identified by (channel / index).
 
  === unsigned int '''_pic_get_register'''( unsigned int channel,   unsigned int index ) ===
-This low level function returns the value of register (channel / index).
+This function returns the value of register identified by (channel / index).
+
+== __access functions__ ==
 
  === void '''_pic_init'''( unsigned int channel,  unsigned int vaddr,  unsigned int extend ) ===
-This function initializes and activates a given channel (i.e. a given external IRQ) in the PIC component. It writes an XCU mailbox physical address in  the IOPIC_ADDRESS and IOPIC_EXTEND registers, and writes a non-zero value in IOPIC_MASK register.
+This function initializes and activates a given channel (i.e. a given external IRQ) in the PIC component. It writes an XCU mailbox physical address in  the IOPIC_ADDRESS and IOPIC_EXTEND registers, and enables the channel.
  * channel : source PIC HWI channel
  * vaddr :  address of the destination XCU register
  * extend :  cluster_xy for the destination XCU
 
+ === void '''_pic_enable'''( unsigned int channel) ===
+This function enables a given channel (i.e a given external IRQ). The associated WTI maibox address is not modified.
+ * channel : source PIC HWI channel
+
+ === void '''_pic_disable'''( unsigned int channel) ===
+This function disables a given channel (i.e a given external IRQ). The associated WTI maibox address is not modified.
+ * channel : source PIC HWI channel
+
  === unsigned int '''_pic_get_status'''( unsigned int channel ) === 
 This function returns the status of a given HWI channel.