MT29F NAND driver: implement bad block handling and remapping.

[bertos.git] / bertos / drv / mt29f.h

diff --git a/bertos/drv/mt29f.h b/bertos/drv/mt29f.h
index c7669232f7065a4aa18502523b95d428a7f8d439..cf80ea7729964c4c8b2163c658d9799092d42b45 100644 (file)
--- a/bertos/drv/mt29f.h
+++ b/bertos/drv/mt29f.h
@@ -33,29 +33,11 @@
 *
 * This module allows read/write access to Micron MT29F serial
 * NANDs.
-* It is a block device, so it must be accessed using the KBlock
-* interface functions (see kblock.h).
-*
-* Once you have opened the flash for writing, you may want to use
-* kblock_trim() to avoid overwriting data on other flash banks.
-*
-* Example usage:
-* \code
-* Flash fls;
-* flash_init(&fls, 0);
-* // enable access only on desired blocks
-* // start block = 50, num blocks = 20
-* kblock_trim(&fls.blk, 50, 20);
-* // ...
-* // now write to the flash
-* // block number is automatically converted
-* kblock_write(&fls.blk, 0, buf, 0, 128);
-* \endcode
 *
 * \author Stefano Fedrigo <aleph@develer.com>
 *
 * $WIZ$ module_name = "mt29f"
-* $WIZ$ module_depends = "kfile", "kfile_block", "kblock"
+* $WIZ$ module_depends = "kfile", "kfile_block", "kblock", "heap"
 * $WIZ$ module_configuration = "bertos/cfg/cfg_mt29f.h"
 */
 
@@ -63,51 +45,41 @@
 #define DRV_MT29F_H
 
 #include "cfg/cfg_mt29f.h"
-
 #include <cfg/macros.h>
-#include <cfg/compiler.h>
-
-#include <io/kblock.h>
-#include <io/kfile.h>
-#include <io/kfile_block.h>
-
-#include <cpu/attr.h>
 
 
 /**
- * \name Error codes
+ * \name Error codes.
  * \{
  */
-#define MT29F_ERR_ERASE    BV(1)   ///< Error erasing a block
-#define MT29F_ERR_WRITE    BV(2)   ///< Error writing a page
+#define MT29F_ERR_ERASE     BV(1)   ///< Error erasing a block
+#define MT29F_ERR_WRITE     BV(2)   ///< Error writing a page
+#define MT29F_ERR_RD_TMOUT  BV(2)   ///< Read timeout
+#define MT29F_ERR_WR_TMOUT  BV(2)   ///< Write timeout
 /** \} */
 
-struct Mt29fHardware;
 
 /**
- * MT29F KBlock context structure.
+ * MT29F context.
  */
 typedef struct Mt29f
 {
-       KBlock blk;                  ///< KBlock context
-       struct Mt29fHardware *hw;
+       uint8_t   chip_select;
+       uint8_t   status;
+
+       uint16_t *block_map;    // For bad blocks remapping
+       uint16_t  remap_start;  // First unused remap block
 } Mt29f;
 
-/*
- * Kblock type ID.
- */
-#define KBT_MT29F MAKE_ID('M', 'T', '2', '9')
+struct Heap;
 
-/**
- * Convert + ASSERT from generic KBlock to Flash.
- */
-INLINE Mt29f *FLASH_CAST(KBlock *fls)
-{
-       ASSERT(fls->priv.type == KBT_MT29F);
-       return (Mt29f *)fls;
-}
+bool mt29f_init(Mt29f *chip, struct Heap *heap, uint8_t chip_select);
+bool mt29f_getDevId(Mt29f *chip, uint8_t dev_id[5]);
+int mt29f_blockErase(Mt29f *chip, uint16_t block);
+bool mt29f_read(Mt29f *chip, uint32_t page, void *buf, uint16_t size);
+bool mt29f_write(Mt29f *chip, uint32_t page, const void *buf, uint16_t size);
+int mt29f_error(Mt29f *chip);
+void mt29f_clearError(Mt29f *chip);
 
-void mt29f_hw_init(Mt29f *fls);
-void mt29f_hw_initUnbuffered(Mt29f *fls);
 
 #endif /* DRV_MT29F_H */