direct/yaffs_nandif.c

   1 /*
   2  * YAFFS: Yet Another Flash File System. A NAND-flash specific file system.
   3  *
   4  * Copyright (C) 2002-2007 Aleph One Ltd.
   5  *   for Toby Churchill Ltd and Brightstar Engineering
   6  *
   7  * Created by Charles Manning <charles@aleph1.co.uk>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License version 2 as
  11  * published by the Free Software Foundation.
  12  */
  13
  14 #include "yportenv.h"
  15 #include "yaffs_guts.h"
  16 #include "devextras.h"
  17
  18
  19 #include "yaffs_nandif.h"
  20 #include "yaffs_packedtags2.h"
  21
  22 #include "yramsim.h"
  23
  24 #include "yaffs_trace.h"
  25 #include "yaffsfs.h"
  26
  27
  28 /* NB For use with inband tags....
  29  * We assume that the data buffer is of size totalBytersPerChunk so that we can also
  30  * use it to load the tags.
  31  */
  32 int ynandif_WriteChunkWithTagsToNAND(yaffs_Device * dev, int chunkInNAND,
  33                                       const __u8 * data,
  34                                       const yaffs_ExtendedTags * tags)
  35 {
  36
  37         int retval = 0;
  38         yaffs_PackedTags2 pt;
  39         void *spare;
  40         unsigned spareSize = 0;
  41         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
  42
  43         T(YAFFS_TRACE_MTD,
  44           (TSTR
  45            ("nandmtd2_WriteChunkWithTagsToNAND chunk %d data %p tags %p"
  46             TENDSTR), chunkInNAND, data, tags));
  47
  48
  49         /* For yaffs2 writing there must be both data and tags.
  50          * If we're using inband tags, then the tags are stuffed into
  51          * the end of the data buffer.
  52          */
  53
  54         if(dev->param.inbandTags){
  55                 yaffs_PackedTags2TagsPart *pt2tp;
  56                 pt2tp = (yaffs_PackedTags2TagsPart *)(data + dev->nDataBytesPerChunk);
  57                 yaffs_PackTags2TagsPart(pt2tp,tags);
  58                 spare = NULL;
  59                 spareSize = 0;
  60         }
  61         else{
  62                 yaffs_PackTags2(&pt, tags,!dev->param.noTagsECC);
  63                 spare = &pt;
  64                 spareSize = sizeof(yaffs_PackedTags2);
  65         }
  66
  67         retval = geometry->writeChunk(dev,chunkInNAND,
  68                                           data, dev->param.totalBytesPerChunk, spare, spareSize);
  69
  70         return retval;
  71 }
  72
  73 int ynandif_ReadChunkWithTagsFromNAND(yaffs_Device * dev, int chunkInNAND,
  74                                        __u8 * data, yaffs_ExtendedTags * tags)
  75 {
  76         yaffs_PackedTags2 pt;
  77         int localData = 0;
  78         void *spare = NULL;
  79         unsigned spareSize;
  80         int retval = 0;
  81         int eccStatus; //0 = ok, 1 = fixed, -1 = unfixed
  82         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
  83
  84         T(YAFFS_TRACE_MTD,
  85           (TSTR
  86            ("nandmtd2_ReadChunkWithTagsFromNAND chunk %d data %p tags %p"
  87             TENDSTR), chunkInNAND, data, tags));
  88
  89         if(!tags){
  90                 spare = NULL;
  91                 spareSize = 0;
  92         }else if(dev->param.inbandTags){
  93
  94                 if(!data) {
  95                         localData = 1;
  96                         data = yaffs_GetTempBuffer(dev,__LINE__);
  97                 }
  98                 spare = NULL;
  99                 spareSize = 0;
 100         }
 101         else {
 102                 spare = &pt;
 103                 spareSize = sizeof(yaffs_PackedTags2);
 104         }
 105
 106         retval = geometry->readChunk(dev,chunkInNAND,
 107                                          data,
 108                                          data ? dev->param.totalBytesPerChunk : 0,
 109                                          spare,spareSize,
 110                                          &eccStatus);
 111
 112         if(dev->param.inbandTags){
 113                 if(tags){
 114                         yaffs_PackedTags2TagsPart * pt2tp;
 115                         pt2tp = (yaffs_PackedTags2TagsPart *)&data[dev->nDataBytesPerChunk];
 116                         yaffs_UnpackTags2TagsPart(tags,pt2tp);
 117                 }
 118         }
 119         else {
 120                 if (tags){
 121                         yaffs_UnpackTags2(tags, &pt,!dev->param.noTagsECC);
 122                 }
 123         }
 124
 125         if(tags && tags->chunkUsed){
 126                 if(eccStatus < 0 ||
 127                    tags->eccResult == YAFFS_ECC_RESULT_UNFIXED)
 128                         tags->eccResult = YAFFS_ECC_RESULT_UNFIXED;
 129                 else if(eccStatus > 0 ||
 130                              tags->eccResult == YAFFS_ECC_RESULT_FIXED)
 131                         tags->eccResult = YAFFS_ECC_RESULT_FIXED;
 132                 else
 133                         tags->eccResult = YAFFS_ECC_RESULT_NO_ERROR;
 134         }
 135
 136         if(localData)
 137                 yaffs_ReleaseTempBuffer(dev,data,__LINE__);
 138
 139         return retval;
 140 }
 141
 142 int ynandif_MarkNANDBlockBad(struct yaffs_DeviceStruct *dev, int blockId)
 143 {
 144         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
 145
 146         return geometry->markBlockBad(dev,blockId);
 147 }
 148
 149 int ynandif_EraseBlockInNAND(struct yaffs_DeviceStruct *dev, int blockId)
 150 {
 151         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
 152
 153         return geometry->eraseBlock(dev,blockId);
 154
 155 }
 156
 157
 158 static int ynandif_IsBlockOk(struct yaffs_DeviceStruct *dev, int blockId)
 159 {
 160         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
 161
 162         return geometry->checkBlockOk(dev,blockId);
 163 }
 164
 165 int ynandif_QueryNANDBlock(struct yaffs_DeviceStruct *dev, int blockId, yaffs_BlockState *state, __u32 *sequenceNumber)
 166 {
 167         unsigned chunkNo;
 168         yaffs_ExtendedTags tags;
 169
 170         *sequenceNumber = 0;
 171
 172         chunkNo = blockId * dev->param.nChunksPerBlock;
 173
 174         if(!ynandif_IsBlockOk(dev,blockId)){
 175                 *state = YAFFS_BLOCK_STATE_DEAD;
 176         }
 177         else
 178         {
 179                 ynandif_ReadChunkWithTagsFromNAND(dev,chunkNo,NULL,&tags);
 180
 181                 if(!tags.chunkUsed)
 182                 {
 183                         *state = YAFFS_BLOCK_STATE_EMPTY;
 184                 }
 185                 else
 186                 {
 187                         *state = YAFFS_BLOCK_STATE_NEEDS_SCANNING;
 188                         *sequenceNumber = tags.sequenceNumber;
 189                 }
 190         }
 191
 192         return YAFFS_OK;
 193 }
 194
 195
 196 int ynandif_InitialiseNAND(yaffs_Device *dev)
 197 {
 198         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
 199
 200         geometry->initialise(dev);
 201
 202         return YAFFS_OK;
 203 }
 204
 205 int ynandif_DeinitialiseNAND(yaffs_Device *dev)
 206 {
 207         ynandif_Geometry *geometry = (ynandif_Geometry *)(dev->driverContext);
 208
 209         geometry->deinitialise(dev);
 210
 211         return YAFFS_OK;
 212 }
 213
 214
 215 struct yaffs_DeviceStruct *
 216         yaffs_AddDeviceFromGeometry(const YCHAR *name,
 217                                         const ynandif_Geometry *geometry)
 218 {
 219         YCHAR *clonedName = YMALLOC(sizeof(YCHAR) * (yaffs_strnlen(name,YAFFS_MAX_NAME_LENGTH)+1));
 220         struct yaffs_DeviceStruct *dev = YMALLOC(sizeof(struct yaffs_DeviceStruct));
 221
 222         if(dev && clonedName){
 223                 memset(dev,0,sizeof(struct yaffs_DeviceStruct));
 224                 yaffs_strcpy(clonedName,name);
 225
 226                 dev->param.name = clonedName;
 227                 dev->param.writeChunkWithTagsToNAND  = ynandif_WriteChunkWithTagsToNAND;
 228                 dev->param.readChunkWithTagsFromNAND = ynandif_ReadChunkWithTagsFromNAND;
 229                 dev->param.eraseBlockInNAND          = ynandif_EraseBlockInNAND;
 230                 dev->param.initialiseNAND            = ynandif_InitialiseNAND;
 231                 dev->param.queryNANDBlock            = ynandif_QueryNANDBlock;
 232                 dev->param.markNANDBlockBad          = ynandif_MarkNANDBlockBad;
 233                 dev->param.nShortOpCaches                          = 20;
 234                 dev->param.startBlock                = geometry->startBlock;
 235                 dev->param.endBlock                  = geometry->endBlock;
 236                 dev->param.totalBytesPerChunk              = geometry->dataSize;
 237                 dev->param.spareBytesPerChunk              = geometry->spareSize;
 238                 dev->param.inbandTags                              = geometry->inbandTags;
 239                 dev->param.nChunksPerBlock                 = geometry->pagesPerBlock;
 240                 dev->param.useNANDECC                              = geometry->hasECC;
 241                 dev->param.isYaffs2                                = geometry->useYaffs2;
 242                 dev->param.nReservedBlocks                 = 5;
 243                 dev->driverContext                         = (void *)geometry;
 244
 245                 yaffs_AddDevice(dev);
 246
 247                 return dev;
 248         }
 249
 250         if(dev)
 251                 YFREE(dev);
 252         if(clonedName)
 253                 YFREE(clonedName);
 254
 255         return NULL;
 256 }