Changeset 437 for soft/giet_vm/giet_drivers/ioc_driver.h

Timestamp:

Nov 3, 2014, 10:53:00 AM (10 years ago)

Author:

alain

Message:

Introducing dynamic allocation of peripheral channel(TTY, NIC, TIM, CMA)
Removint the ICU driver : ICU component not supported anymore.
Removing the FBF driver.

File:

• soft/giet_vm/giet_drivers/ioc_driver.h (modified) (6 diffs)

soft/giet_vm/giet_drivers/ioc_driver.h

@@ -18 +18 @@
 // USE_IOC_BDV, USE_IOC_SDC, USE_IOC_HBA, USE_IOC_RDK.
 //
-// Any physical block device driver xxx must provide the following API:
-// - _xxx_init()
-// - _xxx_read()
-// - _xxx_write()
-// - _xxx_get_status()
-// - _xxx_get_block_size()
-// The "channel" parameter is no transmited to single channel devices.
+// Any physical block device driver must provide the 5 five functions defined
+// by this generic driver.
 //
 // The _ioc_read() and _ioc_write() functions are always blocking for
@@ -67 +62 @@
 // If the RAMDISK is used, an extra memory segment with virtual base address
 // SEG_RDK_BASE, used by RDK driver, must be defined in hard_config.h.
-///////////////////////////////////////////////////////////////////////////////////
-// Implementation note:
 //
-// 1) In order to share the code, the two _ioc_read() and _ioc_write() functions
-// call the same _ioc_access() function.
-//
-// 2) The IOMMU is not supported yet, but the method is the following:
+// The IOMMU is not supported yet, but the method is the following:
 // A fixed size 2 Mbytes vseg is allocated to the IOC peripheral, in the I/O 
 // virtual space, and the user buffer is dynamically remapped to one single
@@ -103 +93 @@
 
 ///////////////////////////////////////////////////////////////////////////////////
-// IOC access functions  (generic disk controller)
+//      External functions                            
 ///////////////////////////////////////////////////////////////////////////////////
 
 ///////////////////////////////////////////////////////////////////////////////
-// This function cheks block size, and desactivates the IOC interrupts.
+// This function cheks block size, and desactivates interrupts.
 // Return 0 for success, non zero if error.
 ///////////////////////////////////////////////////////////////////////////////
@@ -113 +103 @@
 
 ///////////////////////////////////////////////////////////////////////////////
-// Transfer data from a memory buffer to the block device. 
-// - mode     : BOOT_PA / BOOT_VA / KERNEL / USER 
+// Transfer data from a memory buffer to the disk. 
+// - mode     : BOOT / KERNEL / USER 
 // - lba      : first block index on the block device
 // - buffer   : base address of the memory buffer (must be word aligned)
@@ -127 +117 @@
 
 ///////////////////////////////////////////////////////////////////////////////
-// Transfer data from the block device to a memory buffer. 
-// - mode     : BOOT_PA / BOOT_VA / KERNEL / USER 
+// Transfer data from the disk to a memory buffer. 
+// - mode     : BOOT / KERNEL / USER 
 // - lba      : first block index on the block device
 // - buffer   : base address of the memory buffer (must be word aligned)
@@ -142 +132 @@
 ///////////////////////////////////////////////////////////////////////////////
 // This function returns in the status variable, the transfert status, and
-// acknowledge the IRQ if the IOC controler is not busy.
+// acknowledge the IRQ if required.
 // Returns 0 if success, > 0 if error
 ///////////////////////////////////////////////////////////////////////////////