Changes between Version 2 and Version 3 of Component/Vci Block Device

Timestamp:

Dec 3, 2008, 3:42:39 PM (17 years ago)

Author:

Nicolas Pouillon

Comment:

--

Component/Vci Block Device

@@ -26 +26 @@
    This register goes back to BLOCK_DEVICE_NOOP when operation is finished.
 
- * `BLOCK_DEVICE_STATUS` State of the transfer, -1 on failure
+ * `BLOCK_DEVICE_STATUS` State of the transfer. Reading this register while not busy resets its value to IDLE. Value may be one of
+  * `BLOCK_DEVICE_IDLE`
+  * `BLOCK_DEVICE_BUSY`
+  * `BLOCK_DEVICE_SUCCESS`
+  * `BLOCK_DEVICE_ERROR`
 
  * `BLOCK_DEVICE_IRQ_ENABLE` Boolean enabling the IRQ line
 
  * `BLOCK_DEVICE_SIZE` Number of blocks addressable in the controller (read-only)
+
+ * `BLOCK_DEVICE_BLOCK_SIZE` Block size (in bytes) (read-only)
 
 The following operations codes are defined:
@@ -45 +51 @@
 
 Sample code:
-{{{
-#include "soclib/block_device.h"
-
-static const void* bd_base = 0xc0000000;
-
-
-int block_read( const size_t lba, void *buffer, const size_t len )
-{
-        soclib_io_set(bd_base, BLOCK_DEVICE_LBA, lba);
-        soclib_io_set(bd_base, BLOCK_DEVICE_BUFFER, (uint32_t)buffer);
-        soclib_io_set(bd_base, BLOCK_DEVICE_COUNT, len);
-        soclib_io_set(bd_base, BLOCK_DEVICE_OP, BLOCK_DEVICE_READ);
-        while (soclib_io_get(bd_base, BLOCK_DEVICE_OP))
-                ;
-        return soclib_io_get(bd_base, BLOCK_DEVICE_STATUS);
-}
-
-int block_write( const size_t lba, const void *buffer, const size_t len )
-{
-        soclib_io_set(bd_base, BLOCK_DEVICE_LBA, lba);
-        soclib_io_set(bd_base, BLOCK_DEVICE_BUFFER, (uint32_t)buffer);
-        soclib_io_set(bd_base, BLOCK_DEVICE_COUNT, len);
-        soclib_io_set(bd_base, BLOCK_DEVICE_OP, BLOCK_DEVICE_WRITE);
-        while (soclib_io_get(bd_base, BLOCK_DEVICE_OP))
-                ;
-        return soclib_io_get(bd_base, BLOCK_DEVICE_STATUS);
-}
-
-uint32_t block_size()
-{
-        return soclib_io_get(bd_base, BLOCK_DEVICE_SIZE);
-}
-
-}}}
+Please see reference implementation in source:trunk/soclib/soclib/platform/topcells/caba-vgmn-block_device-mips32el
 
 (add -I/path/to/soclib/include to your compilation command-line)