Logo Search packages:      
Sourcecode: pcmcia-cs version File versions

iflash2_mtd.c

/*======================================================================

    A simple MTD for Intel Series 2 and Series 100 Flash devices

    iflash2_mtd.c 1.65 2002/06/29 06:27:37

    The contents of this file are subject to the Mozilla Public
    License Version 1.1 (the "License"); you may not use this file
    except in compliance with the License. You may obtain a copy of
    the License at http://www.mozilla.org/MPL/

    Software distributed under the License is distributed on an "AS
    IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
    implied. See the License for the specific language governing
    rights and limitations under the License.

    The initial developer of the original code is David A. Hinds
    <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
    are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.

    Alternatively, the contents of this file may be used under the
    terms of the GNU General Public License version 2 (the "GPL"), in
    which case the provisions of the GPL are applicable instead of the
    above.  If you wish to allow the use of your version of this file
    only under the terms of the GPL and not to allow others to use
    your version of this file under the MPL, indicate your decision
    by deleting the provisions above and replace them with the notice
    and other provisions required by the GPL.  If you do not delete
    the provisions above, a recipient may use your version of this
    file under either the MPL or the GPL.
    
    For efficiency and simplicity, this driver is very block oriented.
    Reads and writes must not span erase block boundaries.  Erases
    are limited to one erase block per request.  This makes it much
    easier to manage multiple asynchronous erases efficiently.
    
======================================================================*/

#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/sched.h>
#include <linux/ptrace.h>
#include <linux/slab.h>
#include <linux/string.h>
#include <linux/timer.h>
#include <linux/major.h>
#include <linux/fs.h>
#include <linux/delay.h>
#include <asm/io.h>
#include <asm/system.h>

#include <stdarg.h>

#include <pcmcia/version.h>
#include <pcmcia/cs_types.h>
#include <pcmcia/cs.h>
#include <pcmcia/bulkmem.h>
#include <pcmcia/cisreg.h>
#include <pcmcia/cistpl.h>
#include <pcmcia/ds.h>
#include <pcmcia/mem_op.h>
#include "iflash.h"

/*====================================================================*/

/* Module parameters */

MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
MODULE_DESCRIPTION("Intel Series 2 flash PCMCIA MTD driver");
MODULE_LICENSE("Dual MPL/GPL");

#define INT_MODULE_PARM(n, v) static int n = v; MODULE_PARM(n, "i")

INT_MODULE_PARM(word_width, 1);                 /* 1 = 16-bit */
INT_MODULE_PARM(mem_speed, 0);                  /* in ns */
INT_MODULE_PARM(vpp_timeout_period, 1000);      /* in ms */
INT_MODULE_PARM(vpp_settle, 100);         /* in ms */
INT_MODULE_PARM(erase_timeout, 100);            /* in ms */
INT_MODULE_PARM(erase_limit, 10000);            /* in ms */
INT_MODULE_PARM(retry_limit, 4);          /* write retries */
INT_MODULE_PARM(max_tries, 4096);         /* status polling */

#ifdef PCMCIA_DEBUG
INT_MODULE_PARM(pc_debug, PCMCIA_DEBUG);
#define DEBUG(n, args...) do { if (pc_debug>(n)) printk(KERN_INFO args); } while (0)
static char *version =
"iflash2_mtd.c 1.65 2002/06/29 06:27:37 (David Hinds)";
#else
#define DEBUG(n, args...) do { } while (0)
#endif

/*====================================================================*/

static void flash_config(dev_link_t *link);
static void flash_release(u_long arg);
static int flash_event(event_t event, int priority,
                   event_callback_args_t *args);

static dev_link_t *flash_attach(void);
static void flash_detach(dev_link_t *);

#define MAX_CELLS       32

/* A flash region is composed of one or more "cells", where we allow
   simultaneous erases if they are in different cells */
typedef struct flash_region_t {
    region_info_t region;
    u_int         cell_size;
    struct flash_cell_t {
      u_int       state;
      u_long      erase_time;
      u_int       erase_addr;
      u_int       erase_retries;
    } cell[MAX_CELLS];
} flash_region_t;

typedef struct flash_dev_t {
    dev_link_t          link;
    caddr_t       Base;
    u_int         Size;
    u_int         vpp;
    int                 vpp_usage;
    u_long        vpp_start;
    struct timer_list   vpp_timeout;
    flash_region_t      *flash[2*CISTPL_MAX_DEVICES];
} flash_dev_t;

#define FLASH_PENDING         0x01
#define FLASH_ERASING         0x02
#define FLASH_ERASE_SUSPEND   0x04

static dev_info_t dev_info = "iflash2_mtd";

static dev_link_t *dev_list = NULL;

/*====================================================================*/

static void cs_error(client_handle_t handle, int func, int ret)
{
    error_info_t err = { func, ret };
    CardServices(ReportError, handle, &err);
}

/*======================================================================

    Low level routines for programming the flash card.
    
======================================================================*/

static void abort_cmd(dev_link_t *link, volatile caddr_t base,
                  int cell, mtd_mod_win_t *old)
{
    u_char *addr = base + CISREG_SLEEP + ((cell>>3)<<1);
    /* Map the CIS register page into memory */
    mtd_mod_win_t mod = { WIN_MEMORY_TYPE_AM, 250, 0x4000 };
    DEBUG(1, "iflash2_mtd: abort\n");
    MTDHelperEntry(MTDModifyWindow, link->win, &mod);
    /* Put the cell to sleep, then wake it up again */
    writeb(readb(addr) | (1 << (cell & 7)), addr);
    udelay(10L);
    writeb(readb(addr) & ~(1 << (cell & 7)), addr);
    udelay(10L);
    /* Restore the original memory window mapping */
    MTDHelperEntry(MTDModifyWindow, link->win, old);
}

static inline int byte_write(volatile u_char *address, u_char data)
{
    register u_char CSR = 0;
    register u_short i;
    for (i = 0; i < max_tries; i++) {
      CSR = readb(address);
      if (CSR & LOW(CSR_WR_READY)) {
          writeb(LOW(IF_WRITE), address);
          writeb(data, address);
          return CS_SUCCESS;
      }
    }
    printk(KERN_NOTICE "iflash2_mtd: byte_write timed out at 0x%p, "
         "CSR = 0x%x\n", address, CSR);
    return CS_WRITE_FAILURE;
}

static inline int word_write(volatile u_short *address, u_short data)
{
    register u_short CSR = 0, i;

    for (i = 0; i < max_tries; i++) {
      CSR = readw(address);
      if ((CSR & CSR_WR_READY) == CSR_WR_READY) {
          writew(IF_WRITE, address);
          writew(data, address);
          return CS_SUCCESS;
      }
    }
    printk(KERN_NOTICE "iflash2_mtd: word_write timed out at 0x%p, "
         "CSR = 0x%x\n", address, CSR);
    return CS_WRITE_FAILURE;
}

static int check_write(volatile u_short *address)
{
    u_short CSR = 0, i;
    writew(IF_READ_CSR, address);
    for (i = 0; i < max_tries; i++) {
      CSR = readw(address);
      if ((CSR & CSR_WR_READY) == CSR_WR_READY) break;
    }
    if (i == max_tries) {
      printk(KERN_NOTICE "iflash2_mtd: check_write timed out!"
             "  CSR = 0x%x\n", CSR);
      return CS_GENERAL_FAILURE;
    }
    if (CSR & (CSR_WR_ERR | CSR_VPP_LOW)) {
      printk(KERN_NOTICE "iflash2_mtd: write error: CSR = 0x%x\n",
             CSR);
      return CS_WRITE_FAILURE;
    } else
      return CS_SUCCESS;
}

static void block_erase(volatile u_short *address)
{
    writew(IF_BLOCK_ERASE, address);
    writew(IF_CONFIRM, address);
}

static int check_erase(volatile u_short *address)
{
    u_short CSR;
    writew(IF_READ_CSR, address);
    CSR = readw(address);
    if ((CSR & CSR_WR_READY) != CSR_WR_READY)
      return CS_BUSY;
    else if (CSR & (CSR_ERA_ERR | CSR_VPP_LOW | CSR_WR_ERR)) {
      printk(KERN_NOTICE "iflash2_mtd: erase failed: CSR = 0x%x\n",
             CSR);
      return CS_WRITE_FAILURE;
    } else
      return CS_SUCCESS;
}

static int suspend_erase(volatile u_short *address)
{
    u_short CSR = 0;
    u_int i;

    writew(IF_ERASE_SUSPEND, address);
    writew(IF_READ_CSR, address);
    for (i = 0; i < max_tries; i++) {
      CSR = readw(address);
      if ((CSR & CSR_WR_READY) == CSR_WR_READY) break;
    }
    if (i == max_tries) {
      printk(KERN_NOTICE "iflash2_mtd: suspend_erase timed out: "
             "CSR = 0x%x\n", CSR);
      return CS_GENERAL_FAILURE;
    }
    writew(IF_READ_ARRAY, address);
    return CS_SUCCESS;
}

static void resume_erase(volatile u_short *address)
{
    u_short CSR;
    writew(IF_READ_CSR, address);
    CSR = readw(address);
    /* Only give resume signal if the erase is really suspended */
    if (CSR & CSR_ERA_SUSPEND)
      writew(IF_CONFIRM, address);
}

static void reset_block(volatile u_short *address)
{
    u_short CSR, i;
    writew(IF_CLEAR_CSR, address);
    for (i = 0; i < 100; i++) {
      writew(IF_READ_CSR, address);
      CSR = readw(address);
      if (CSR != 0xffff) break;
      mdelay(1);
    }
#ifdef PCMCIA_DEBUG
    if (i)
      printk(KERN_DEBUG "iflash2_mtd: reset after %d iterations\n", i);
#endif
    writew(IF_READ_ARRAY, address);
}

/*======================================================================

    Vpp management functions.  The vpp_setup() function checks to
    see if Vpp is available for the specified device.  If not, it
    turns on Vpp.  The vpp_shutdown() function is scheduled to turn
    Vpp off after an interval of inactivity.

    vpp_setup() assumes that it will be called at the top of a
    request handler, and that it can use the MTD_REQ_TIMEOUT flag
    to tell if it has already been called for this particular
    request, so that it can count Vpp users.

    A handler should call vpp_shutdown() once for each request that
    does a vpp_setup().
    
======================================================================*/

static int vpp_setup(dev_link_t *link, mtd_request_t *req)
{
    flash_dev_t *dev = (flash_dev_t *)link->priv;
    mtd_vpp_req_t vpp_req;

    /* First, do we need to do this? */
    if (!dev->vpp) return 0;
    
    /* First time for this request? */
    if (!(req->Function & MTD_REQ_TIMEOUT)) {
      /* If no other users, kill shutdown timer and apply power */
      if (++dev->vpp_usage == 1) {
          if (!del_timer(&dev->vpp_timeout)) {
            DEBUG(1, "iflash2_mtd: raising Vpp...\n");
            dev->vpp_start = jiffies;
            vpp_req.Vpp1 = vpp_req.Vpp2 = dev->vpp;
            MTDHelperEntry(MTDSetVpp, link->handle, &vpp_req);
          }
      }
    }
    /* Wait for Vpp to settle if it was just applied */
    if (jiffies < dev->vpp_start + vpp_settle) {
      req->Status = MTD_WAITTIMER;
      req->Timeout = vpp_settle * 1000 / HZ;
      return 1;
    }
    return 0;
}

static void vpp_off(u_long arg)
{
    dev_link_t *link = (dev_link_t *)arg;
    flash_dev_t *dev = (flash_dev_t *)link->priv;
    mtd_vpp_req_t req;

    if (!dev->vpp) return;
    DEBUG(1, "iflash2_mtd: lowering Vpp...\n");
    dev->vpp_timeout.expires = 0;
    req.Vpp1 = req.Vpp2 = 0;
    MTDHelperEntry(MTDSetVpp, link->handle, &req);
}

static void vpp_shutdown(dev_link_t *link)
{
    flash_dev_t *dev = (flash_dev_t *)link->priv;
    if (!dev->vpp) return;
    dev->vpp_usage--;
    if (dev->vpp_usage == 0) {
      dev->vpp_timeout.expires = jiffies + vpp_timeout_period;
      add_timer(&dev->vpp_timeout);
    }
}

/*======================================================================

    flash_attach() creates an "instance" of the driver, allocating
    local data structures for one device.  The device is registered
    with Card Services.

======================================================================*/

static dev_link_t *flash_attach(void)
{
    client_reg_t client_reg;
    dev_link_t *link;
    flash_dev_t *dev;
    int ret;
    
    DEBUG(0, "iflash2_mtd: flash_attach()\n");

    /* Create new memory card device */
    dev = kmalloc(sizeof(*dev), GFP_KERNEL);
    if (!dev) return NULL;
    memset(dev, 0, sizeof(*dev));
    link = &dev->link; link->priv = dev;

    link->release.function = &flash_release;
    link->release.data = (u_long)link;

    dev->vpp_timeout.function = vpp_off;
    dev->vpp_timeout.data = (u_long)link;

    /* Register with Card Services */
    link->next = dev_list;
    dev_list = link;
    client_reg.dev_info = &dev_info;
    client_reg.Attributes = INFO_MTD_CLIENT | INFO_CARD_SHARE;
    client_reg.EventMask =
      CS_EVENT_RESET_PHYSICAL | CS_EVENT_CARD_RESET |
      CS_EVENT_CARD_INSERTION | CS_EVENT_CARD_REMOVAL |
      CS_EVENT_PM_SUSPEND | CS_EVENT_PM_RESUME;
    client_reg.event_handler = &flash_event;
    client_reg.Version = 0x0210;
    client_reg.event_callback_args.client_data = link;
    ret = CardServices(RegisterClient, &link->handle, &client_reg);
    if (ret != 0) {
      cs_error(link->handle, RegisterClient, ret);
      flash_detach(link);
      return NULL;
    }
    
    return link;
} /* flash_attach */

/*======================================================================

    This deletes a driver "instance".  The device is de-registered
    with Card Services.  If it has been released, all local data
    structures are freed.  Otherwise, the structures will be freed
    when the device is released.

======================================================================*/

static void flash_detach(dev_link_t *link)
{
    dev_link_t **linkp;
    int ret;

    DEBUG(0, "iflash2_mtd: flash_detach(0x%p)\n", link);
    
    /* Locate device structure */
    for (linkp = &dev_list; *linkp; linkp = &(*linkp)->next)
      if (*linkp == link) break;
    if (*linkp == NULL)
      return;

    del_timer(&link->release);
    if (link->state & DEV_CONFIG)
      flash_release((u_long)link);

    if (link->handle) {
      ret = CardServices(DeregisterClient, link->handle);
      if (ret != CS_SUCCESS)
          cs_error(link->handle, DeregisterClient, ret);
    }
    
    /* Unlink device structure, free bits */
    *linkp = link->next;
    kfree(link->priv);
    
} /* flash_detach */

/*======================================================================

    flash_config() is scheduled to run after a CARD_INSERTION event
    is received, to bind the MTD to appropriate memory regions.
    
======================================================================*/

static void printk_size(u_int sz)
{
    if (sz & 0x3ff)
      printk("%u bytes", sz);
    else if (sz & 0x0fffff)
      printk("%u kb", sz >> 10);
    else
      printk("%u mb", sz >> 20);
}

static void flash_config(dev_link_t *link)
{
    client_handle_t handle = link->handle;
    flash_dev_t *dev = link->priv;
    win_req_t req;
    mtd_reg_t reg;
    region_info_t region;
    int i, attr, ret;

    DEBUG(0, "iflash2_mtd: flash_config(0x%p)\n", link);

    /* Allocate a small memory window */
    if (word_width)
      req.Attributes = WIN_DATA_WIDTH_16;
    else
      req.Attributes = WIN_DATA_WIDTH_8;
    req.Base = req.Size = 0;
    req.AccessSpeed = mem_speed;
    link->win = (window_handle_t)handle;
    ret = MTDHelperEntry(MTDRequestWindow, &link->win, &req);
    if (ret != 0) {
      cs_error(handle, RequestWindow, ret);
      link->state &= ~DEV_CONFIG_PENDING;
      flash_release((u_long)link);
      return;
    }
    dev->Base = ioremap(req.Base, req.Size);
    dev->Size = req.Size;

    link->state |= DEV_CONFIG;

    /* Grab info for all the memory regions we can access */
    i = 0;
    for (attr = 0; attr < 2; attr++) {
      region.Attributes = attr ? REGION_TYPE_AM : REGION_TYPE_CM;
      ret = CardServices(GetFirstRegion, handle, &region);
      while (ret == CS_SUCCESS) {
          reg.Attributes = region.Attributes;
          reg.Offset = region.CardOffset;
          dev->flash[i] = kmalloc(sizeof(struct flash_region_t),
                            GFP_KERNEL);
          if (!dev->flash[i]) break;
          reg.MediaID = (u_long)dev->flash[i];
          ret = CardServices(RegisterMTD, handle, &reg);
          if (ret != 0) {
            kfree(dev->flash[i]);
            break;
          }
          printk(KERN_INFO "iflash2_mtd: %s at 0x%x, ",
               attr ? "attr" : "common", region.CardOffset);
          printk_size(region.RegionSize);
          printk(", ");
          printk_size(region.BlockSize);
          printk(" blocks, %u ns\n", region.AccessSpeed);
          memset(dev->flash[i], 0, sizeof(struct flash_region_t));
          /* Assume 128K blocks, if no geometry info present */
          if (region.BlockSize == 1)
            region.BlockSize = 0x20000;
          dev->flash[i]->region = region;
          /* If not Series 100, then we'll use Vpp=12V */
          if (region.JedecInfo != 0xaa) dev->vpp = 120;
          /* All Series 2 cards have 2MB component pairs */
          dev->flash[i]->cell_size = 0x200000;
          i++;
          ret = CardServices(GetNextRegion, handle, &region);
      }
    }
    dev->flash[i] = NULL;
    
} /* flash_config */

/*======================================================================

    After a card is removed, flash_release() will release the memory
    window allocated for this socket.
    
======================================================================*/

static void flash_release(u_long arg)
{
    dev_link_t *link = (dev_link_t *)arg;
    flash_dev_t *dev = link->priv;
    int i;

    DEBUG(0, "iflash2_mtd: flash_release(0x%p)\n", link);

    link->state &= ~DEV_CONFIG;
    if (link->win) {
      iounmap(dev->Base);
      i = MTDHelperEntry(MTDReleaseWindow, link->win);
      if (i != CS_SUCCESS)
          cs_error(link->handle, ReleaseWindow, i);
    }
    if (dev->vpp_usage == 0)
      del_timer(&dev->vpp_timeout);
    vpp_off((u_long)link);
    for (i = 0; (i < 2*CISTPL_MAX_DEVICES) && dev->flash[i]; i++)
      kfree(dev->flash[i]);
    
    if (link->state & DEV_STALE_LINK)
      flash_detach(link);
    
} /* flash_release */

/*======================================================================

    The read request handler.  This handler supports suspending
    current erase requests.  Reading from a block that is currently
    erasing is undefined.
    
======================================================================*/

static int flash_read(dev_link_t *link, char *buf, mtd_request_t *req)
{
    flash_dev_t *dev = (flash_dev_t *)link->priv;
    flash_region_t *flash;
    region_info_t *region;
    mtd_mod_win_t mod;
    u_int from, length, nb, cell;
    u_long time;
    int ret;
    
    DEBUG(2, "iflash2_mtd: flash_read(0x%p, 0x%lx, 0x%p, 0x%x, "
        "0x%x)\n", link, req->MediaID, buf, req->SrcCardOffset,
        req->TransferLength);

    flash = (flash_region_t *)(req->MediaID);
    region = &flash->region;
    if ((req->SrcCardOffset / region->BlockSize) !=
      ((req->SrcCardOffset+req->TransferLength-1) / region->BlockSize))
      return CS_BAD_SIZE;
    if (region->Attributes & REGION_TYPE_AM)
      mod.Attributes = WIN_MEMORY_TYPE_AM;
    else
      mod.Attributes = WIN_MEMORY_TYPE_CM;
    mod.AccessSpeed = region->AccessSpeed;

    /* Suspend an in-progress block erase */
    cell = (req->SrcCardOffset - region->CardOffset) / flash->cell_size;
    if (flash->cell[cell].state & FLASH_ERASING) {
      if ((flash->cell[cell].erase_addr / region->BlockSize) ==
          (req->SrcCardOffset / region->BlockSize)) {
          req->Status = MTD_WAITREQ;
          return CS_BUSY;
      }
      link->state |= DEV_BUSY;
      mod.CardOffset = flash->cell[cell].erase_addr;
      ret = MTDHelperEntry(MTDModifyWindow, link->win, &mod);
      if (ret != CS_SUCCESS) goto done;
      ret = suspend_erase((u_short *)dev->Base);
      if (ret != CS_SUCCESS) goto done;
      flash->cell[cell].state |= FLASH_ERASE_SUSPEND;
    } else
      link->state |= DEV_BUSY;

    mod.CardOffset = req->SrcCardOffset & ~(dev->Size-1);
    from = req->SrcCardOffset & (dev->Size-1);
    
    ret = CS_SUCCESS;
    time = jiffies;
    for (length = req->TransferLength; length > 0; length -= nb) {
      
      ret = MTDHelperEntry(MTDModifyWindow, link->win, &mod);
      if (ret != CS_SUCCESS) goto done;
      nb = (from+length > dev->Size) ? dev->Size-from : length;

      if (req->Function & MTD_REQ_KERNEL)
          copy_from_pc(buf, &dev->Base[from], nb);
      else
          copy_pc_to_user(buf, &dev->Base[from], nb);
      
      buf += nb;
      from = 0;
      mod.CardOffset += dev->Size;
    }
    
#ifdef PCMCIA_DEBUG
    time = jiffies - time;
    if (time > 1)
      DEBUG(3, "iflash2_mtd: read complete, time = %ld, "
            "avg = %ld ns/word, rate = %ld kb/sec\n", time,
            time*20000000/req->TransferLength,
            req->TransferLength*100/(time*1024));
#endif
    
done:
    if (flash->cell[cell].state & FLASH_ERASE_SUSPEND) {
      mod.CardOffset = flash->cell[cell].erase_addr;
      ret = MTDHelperEntry(MTDModifyWindow, link->win, &mod);
      if (ret == CS_SUCCESS)
          resume_erase((u_short *)dev->Base);
      flash->cell[cell].state &= ~FLASH_ERASE_SUSPEND;
    }
    link->state &= ~DEV_BUSY;
    return ret;
} /* flash_read */

/*======================================================================

    basic_write() handles a write that fits completely within a
    memory window that has already been set up.
    
======================================================================*/

static int basic_write(char *dest, char *buf,
                   u_int nb, u_int is_krnl)
{
    char *start = dest;
    int ret;
    
    *(u_short *)dest = IF_READ_CSR;
    if (is_krnl) {
      if (nb & 1) {
          ret = byte_write(dest, *buf);
          if (ret != CS_SUCCESS) return ret;
            dest++; buf++; nb--;
      }
      for (; nb != 0; dest += 2, buf += 2, nb -= 2) {
          ret = word_write((u_short *)dest, *(u_short *)buf);
          if (ret != CS_SUCCESS) return ret;
      }
    } else {
      if (nb & 1) {
          char c;
          get_user(c, buf);
          ret = byte_write(dest, c);
          if (ret != CS_SUCCESS) return ret;
          dest++; buf++; nb--;
      }
      for (; nb != 0; dest += 2, buf += 2, nb -= 2) {
          u_short s;
          get_user(s, (u_short *)buf);
          ret = word_write((u_short *)dest, s);
          if (ret != CS_SUCCESS) return ret;
      }
    }
    return check_write((u_short *)start);
      
} /* basic_write */

/*======================================================================

    The write request handler.  The Series 2+ cards support automatic
    erase suspend for writes.
    
======================================================================*/

static int flash_write(dev_link_t *link, char *buf, mtd_request_t *req)
{
    flash_dev_t *dev = (flash_dev_t *)link->priv;
    mtd_mod_win_t mod;
    flash_region_t *flash;
    region_info_t *region;
    u_int from, length, nb, retry, cell;
    u_long time;
    cs_status_t status;
    int ret;

    DEBUG(2, "iflash2_mtd: flash_write(0x%p, 0x%lx, 0x%p, 0x%x, "
        "0x%x)\n", link, req->MediaID, buf, req->DestCardOffset,
        req->TransferLength);

    /* Check card write protect status */
    ret = CardServices(GetStatus, link->handle, &status);
    if (ret != CS_SUCCESS) {
      cs_error(link->handle, GetStatus, ret);
      return CS_GENERAL_FAILURE;
    }
    if (status.CardState & CS_EVENT_WRITE_PROTECT)
      return CS_WRITE_PROTECTED;

    flash = (flash_region_t *)(req->MediaID);
    region = &flash->region;
    if ((req->DestCardOffset / region->BlockSize) !=
      ((req->DestCardOffset+req->TransferLength-1) / region->BlockSize))
      return CS_BAD_SIZE;
    
    if (vpp_setup(link, req) != 0)
      return CS_BUSY;

    /* Is this cell being erased? */
    cell = (req->DestCardOffset - region->CardOffset) / flash->cell_size;
    if (flash->cell[cell].state & FLASH_ERASING) {
      req->Status = MTD_WAITREQ;
      return CS_BUSY;
    }
    link->state |= DEV_BUSY;
    
    if (region->Attributes & REGION_TYPE_AM)
      mod.Attributes = WIN_MEMORY_TYPE_AM;
    else
      mod.Attributes = WIN_MEMORY_TYPE_CM;
    mod.AccessSpeed = region->AccessSpeed;

    time = jiffies;
    mod.CardOffset = req->DestCardOffset & ~(dev->Size-1);
    from = req->DestCardOffset & (dev->Size-1);
    
    for (length = req->TransferLength ; length > 0; length -= nb) {

      nb = (from+length > dev->Size) ? dev->Size-from : length;
      ret = MTDHelperEntry(MTDModifyWindow, link->win, &mod);
      if (ret != CS_SUCCESS) goto done;

      for (retry = 0; retry < retry_limit; retry++) {
          ret = basic_write(dev->Base+from, buf, nb,
                        (req->Function & MTD_REQ_KERNEL));
          if (ret == CS_SUCCESS)
            break;
          abort_cmd(link, dev->Base, cell, &mod);
      }
      if (retry == retry_limit) {
          printk(KERN_NOTICE "iflash2_mtd: write failed: "
               "too many retries!\n");
          goto done;
      }
      
      buf += nb;
      from = 0;
      mod.CardOffset += dev->Size;
    }

#ifdef PCMCIA_DEBUG
    time = jiffies - time;
    if (time > 1)
      DEBUG(3, "iflash2_mtd: write complete, time = %ld, "
            "avg = %ld us/word, rate = %ld kb/sec\n", time,
            time*20000/req->TransferLength,
            req->TransferLength*100/(time*1024));
#endif
    
done:
    reset_block((u_short *)dev->Base);
    link->state &= ~DEV_BUSY;
    /* Fire up the Vpp timer */
    vpp_shutdown(link);
    return ret;
} /* flash_write */

/*======================================================================

    The erase request handler.  This handler supports simultaneous
    erases in different device components.
    
======================================================================*/

static int flash_erase(dev_link_t *link, mtd_request_t *req)
{
    flash_dev_t *dev = (flash_dev_t *)link->priv;
    cs_status_t status;
    flash_region_t *flash;
    region_info_t *region;
    mtd_mod_win_t mod;
    int i, ret;

    DEBUG(2, "iflash2_mtd: flash_erase(0x%p, 0x%lx, 0x%x, 0x%x)\n",
        link, req->MediaID, req->DestCardOffset,
        req->TransferLength);

    flash = (flash_region_t *)(req->MediaID);
    region = &flash->region;
    if (region->BlockSize != req->TransferLength)
      return CS_BAD_SIZE;
    
    i = (req->DestCardOffset-region->CardOffset)/flash->cell_size;
    
    if (!(req->Function & MTD_REQ_TIMEOUT)) {
      if (flash->cell[i].state & (FLASH_ERASING|FLASH_PENDING)) {
          req->Status = MTD_WAITREQ;
          return CS_BUSY;
      }
      /* Check card write protect status */
      ret = CardServices(GetStatus, link->handle, &status);
      if (ret != CS_SUCCESS) {
          cs_error(link->handle, GetStatus, ret);
          return CS_GENERAL_FAILURE;
      }
      if (status.CardState & CS_EVENT_WRITE_PROTECT)
          return CS_WRITE_PROTECTED;
      flash->cell[i].state |= FLASH_PENDING;
      /* Activate Vpp if necessary */
      if (vpp_setup(link, req) != 0)
          return CS_BUSY;
    }

    if (region->Attributes & REGION_TYPE_AM)
      mod.Attributes = WIN_MEMORY_TYPE_AM;
    else
      mod.Attributes = WIN_MEMORY_TYPE_CM;
    mod.AccessSpeed = region->AccessSpeed;
    mod.CardOffset = req->DestCardOffset;
    ret = MTDHelperEntry(MTDModifyWindow, link->win, &mod);
    if (ret != CS_SUCCESS)
      goto done;
    
    if (flash->cell[i].state & FLASH_PENDING) {
      /* Start a new block erase */
      flash->cell[i].state &= ~FLASH_PENDING;
      flash->cell[i].state |= FLASH_ERASING;
      flash->cell[i].erase_addr = mod.CardOffset;
      flash->cell[i].erase_time = jiffies;
      flash->cell[i].erase_retries = 0;
      block_erase((u_short *)dev->Base);
    } else {
      /* Check on an already started erase */
      ret = check_erase((u_short *)dev->Base);
      if (ret == CS_SUCCESS)
          goto done;
      else if (ret != CS_BUSY) {
          if (++flash->cell[i].erase_retries > retry_limit) {
            printk(KERN_NOTICE "iflash2_mtd: erase failed: "
                   "too many retries!\n");
            goto done;
          } else {
            flash->cell[i].erase_time = jiffies;
            abort_cmd(link, dev->Base, i, &mod);
            reset_block((u_short *)dev->Base);
            block_erase((u_short *)dev->Base);
          }
      }
    }

    /* If the request is not complete, has it taken too long? */
    if (jiffies > flash->cell[i].erase_time + erase_limit) {
      printk(KERN_NOTICE "iflash2_mtd: erase timed out!\n");
      reset_block((u_short *)dev->Base);
      ret = CS_GENERAL_FAILURE;
      goto done;
    }
    req->Status = MTD_WAITTIMER;
    req->Timeout = erase_timeout;
    return CS_BUSY;
    
done:
    DEBUG(2, "iflash2_mtd: erase complete, time = %ld\n",
        jiffies - flash->cell[i].erase_time);
    flash->cell[i].state &= ~(FLASH_ERASING|FLASH_PENDING);
    reset_block((u_short *)dev->Base);
    vpp_shutdown(link);
    return ret;
} /* flash_erase */
    
/*====================================================================*/

static int flash_request(dev_link_t *link, void *buf, mtd_request_t *req)
{
    int ret = 0;
    
    if (!(link->state & DEV_PRESENT))
      return CS_NO_CARD;
    
    if (link->state & DEV_BUSY) {
      /* We do this because the erase routine uses the TIMEOUT flag
         to decide if this is a new request or a status check, so
         we need to propagate it */
      if (req->Function & MTD_REQ_TIMEOUT) {
          req->Timeout = erase_timeout;
          req->Status = MTD_WAITTIMER;
      } else
          req->Status = MTD_WAITREQ;
      return CS_BUSY;
    }
    
    switch (req->Function & MTD_REQ_ACTION) {
    case MTD_REQ_READ:
      ret = flash_read(link, buf, req);
      break;
    case MTD_REQ_WRITE:
      ret = flash_write(link, buf, req);
      break;
    case MTD_REQ_ERASE:
      ret = flash_erase(link, req);
      break;
    case MTD_REQ_COPY:
      ret = CS_UNSUPPORTED_FUNCTION;
      break;
    }
    if (!(link->state & DEV_PRESENT))
      return CS_GENERAL_FAILURE;
    return ret;
} /* flash_request */

/*======================================================================

    The card status event handler.  Mostly, this schedules other
    stuff to run after an event is received.  A CARD_REMOVAL event
    also sets some flags to discourage the driver from trying to
    talk to the card any more.
    
======================================================================*/

static int flash_event(event_t event, int priority,
                  event_callback_args_t *args)
{
    dev_link_t *link = args->client_data;

    DEBUG(1, "iflash2_mtd: flash_event(0x%06x)\n", event);
    
    switch (event) {
      
    case CS_EVENT_CARD_REMOVAL:
      link->state &= ~DEV_PRESENT;
      if (link->state & DEV_CONFIG)
          mod_timer(&link->release, jiffies + HZ/20);
      break;
      
    case CS_EVENT_CARD_INSERTION:
      link->state |= DEV_PRESENT | DEV_CONFIG_PENDING;
      flash_config(link);
      break;

    case CS_EVENT_PM_SUSPEND:
      link->state |= DEV_SUSPEND;
      /* Fall through... */
    case CS_EVENT_RESET_PHYSICAL:
      break;
      
    case CS_EVENT_PM_RESUME:
      link->state &= ~DEV_SUSPEND;
      /* Fall through... */
    case CS_EVENT_CARD_RESET:
      break;
      
    case CS_EVENT_MTD_REQUEST:
      return flash_request(link, args->buffer, args->mtdrequest);
      break;
      
    }
    return CS_SUCCESS;
} /* flash_event */

/*====================================================================*/

static int __init init_iflash2_mtd(void)
{
    servinfo_t serv;
    
    DEBUG(0, "%s\n", version);

    /* Rescale parameters */
    vpp_timeout_period = (vpp_timeout_period * HZ) / 1000;
    vpp_settle = (vpp_settle * HZ) / 1000;
    erase_limit = (erase_limit * HZ) / 1000;
    
    CardServices(GetCardServicesInfo, &serv);
    if (serv.Revision != CS_RELEASE_CODE) {
      printk(KERN_NOTICE "iflash2_mtd: Card Services release "
             "does not match!\n");
      return -1;
    }
    
    register_pccard_driver(&dev_info, &flash_attach, &flash_detach);

    return 0;
}

static void __exit exit_iflash2_mtd(void)
{
    DEBUG(0, "iflash2_mtd: unloading\n");
    unregister_pccard_driver(&dev_info);
    while (dev_list != NULL)
      flash_detach(dev_list);
}

module_init(init_iflash2_mtd);
module_exit(exit_iflash2_mtd);

Generated by  Doxygen 1.6.0   Back to index