Changes between Version 3 and Version 4 of bdv_driver

Timestamp:

Oct 7, 2014, 6:23:37 PM (11 years ago)

Author:

alain

Comment:

--

bdv_driver

@@ -1 +1 @@
 = GIET-VM / BDV Driver = 
 
-The [source:soft/giet_vm/giet_drivers/bdv_driver.c bdv_driver.c] and [source:soft/giet_vm/giet_drivers/bdv_driver.h bdv_driver.h] files define the blockdevice driver. This component is a single channel, block oriented, external mass storage peripheral, available in the SoCLib components library. 
+The [source:soft/giet_vm/giet_drivers/bdv_driver.c bdv_driver.c] and [source:soft/giet_vm/giet_drivers/bdv_driver.h bdv_driver.h] files define the block_device driver. This component is a single channel, block oriented, external mass storage peripheral, available in the SoCLib components library. 
 
 [[PageOutline]]
@@ -20 +20 @@
 
 The SEG_IOC_BASE address must be defined in the hard_config.h file.
+
+ === unsigned int '''_bdv_init'''() ===
+This function cheks block size == 512, and desactivates the interrupts.
+Return 0 for success, > 0 if error
+
+ === unsigned int '''_bdv_read'''(  unsigned int mode,  unsigned int lba, unsigned long long buffer,  unsigned int count ) ===
+This function transfer data from the block device to a memory buffer. 
+ * mode     : BOOT / KERNEL / USER
+ * lba       : first block index on the block device
+ * buffer   : physical base address of the memory buffer (word aligned)
+ * count    : number of blocks to be transfered.
+Returns 0 if success, > 0 if error.
+
+ === unsigned int '''_bdv_write'''( unsigned int mode,  unsigned int lba,  unsigned long long buffer,  unsigned int count ) ===
+This function transfer data from a memory buffer to the block device. 
+ * mode     : BOOT / KERNEL / USER
+ * lba       : first block index on the block device
+ * buffer   : physical base address of the memory buffer (word aligned)
+ * count    : number of blocks to be transfered.
+Returns 0 if success, > 0 if error.
+
+ === unsigned int '''_bdv_get_status'''() ===
+This function returns device status. Status values are defined in  the [source:soft/giet_vm/giet_drivers/bdv_driver.h bdv_driver.h] file.
+
+ ===  unsigned int '''_bdv_get_block_size'''() ===
+This function returns the block size (bytes).
+
+ === void '''_bdv_isr'''( unsigned irq_type,  unsigned irq_id,  unsigned channel ) ===
+This Interrupt Service Routine save the status, acknowledge the IRQ, and activates the task waiting on IO transfer. It can be an HWI or a SWI.
+
+
+