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

iflash2+_mtd.c

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

    A simple MTD for Intel Series 2+ Flash devices

    iflash2+_mtd.c 1.75 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/timex.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/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(write_timeout, 100);            /* in ms */
INT_MODULE_PARM(erase_timeout, 100);            /* in ms */
INT_MODULE_PARM(erase_limit, 10000);            /* in ms */
INT_MODULE_PARM(retry_limit, 8);          /* write retries */
INT_MODULE_PARM(max_tries, 4096);         /* status polling */
INT_MODULE_PARM(do_sleep, 1);             /* spin vs sleep? */

#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.75 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;
    window_handle_t     ESRwin;
    caddr_t       ESRbase;
    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);
}

#ifdef BENCHMARK
static inline u_long uticks(void)
{
    u_long count;
    outb_p(0x00, 0x43);
    count = inb_p(0x40);
    count |= inb(0x40) << 8;
    count = ((LATCH-1) - count) * 10000;
    count = (count + LATCH/2) / LATCH;
    count += jiffies * 10000;
    return count;
}
#endif

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

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

static void sleep_or_spin(wait_queue_head_t *queue)
{
    if (do_sleep)
      interruptible_sleep_on_timeout(queue, 1);
    else
      udelay(50);
}

static void log_esr(char *s, volatile u_short *esr)
{
    u_short CSR, GSR, BSR;

    writew(IF_READ_CSR, esr);
    CSR = readw(esr);
    writew(IF_READ_ESR, esr);
    BSR = readw(esr+2);
    GSR = readw(esr+4);
    printk("%sCSR = 0x%04x, BSR = 0x%04x, GSR = 0x%04x\n",
         (s ? s : KERN_NOTICE), CSR, BSR, GSR);
}

static void abort_cmd(volatile u_short *esr)
{
    u_short i;

    writew(IF_ABORT, esr);
    writew(IF_READ_ESR, esr);
    for (i = 0; i < max_tries; i++)
      if ((readw(esr+4) & GSR_SLEEP) == GSR_SLEEP) break;
    if (i == max_tries)
      printk(KERN_NOTICE "iflash2+_mtd: abort cmd failed!\n");
    writew(IF_READ_ARRAY, esr);
    writew(IF_CLEAR_CSR, esr);
}

static int set_rdy_mode(volatile u_short *esr, u_short mode)
{
    u_short i, j;

    DEBUG(3, "iflash2+_mtd: set_rdy_mode(%04x)\n", mode);
    for (j = 0; j < retry_limit; j++) {
      writew(IF_READ_ESR, esr);
      for (i = 0; i < max_tries; i++)
          if (!(readw(esr+4) & GSR_QUEUE_FULL)) break;
      if (i == max_tries)
          goto failed;
      writew(IF_RDY_MODE, esr);
      writew(mode, esr);
      writew(IF_READ_ESR, esr);
      for (i = 0; i < max_tries; i++)
          if ((readw(esr+4) & GSR_WR_READY) == GSR_WR_READY) break;
      if (i == max_tries)
          goto failed;
      if (!(readw(esr+4) & GSR_OP_ERR))
          return CS_SUCCESS;
      writew(IF_READ_ARRAY, esr);
      writew(IF_CLEAR_CSR, esr);
    }
failed:
    printk(KERN_NOTICE "iflash2+_mtd: set_rdy_mode failed!\n");
    log_esr(NULL, esr);
    return CS_GENERAL_FAILURE;
}

static int check_write(wait_queue_head_t *queue, volatile u_short *esr)
{
    u_long end = jiffies + write_timeout;
    writew(IF_READ_ESR, esr);
    while (((readw(esr+2) & BSR_READY) != BSR_READY) && 
         (jiffies < end))
      sleep_or_spin(queue);
    if ((readw(esr+2) & BSR_READY) != BSR_READY) {
      printk(KERN_NOTICE "iflash2+_mtd: check_write: timed out!\n");
      log_esr(NULL, esr);
      return CS_GENERAL_FAILURE;
    }
    if (readw(esr+2) & BSR_FAILED) {
      log_esr(KERN_DEBUG "write error: ", esr);
      return CS_WRITE_FAILURE;
    } else
      return CS_SUCCESS;
}

static int page_setup(wait_queue_head_t *queue, volatile u_short *esr,
                  volatile u_short *address, u_short count)
{
    u_long end = jiffies + write_timeout;
    u_short nw;
    writew(IF_READ_ESR, esr);
    while (((readw(esr+4) & GSR_PAGE_AVAIL) != GSR_PAGE_AVAIL) &&
         (jiffies < end))
      sleep_or_spin(queue);
    if ((readw(esr+4) & GSR_PAGE_AVAIL) != GSR_PAGE_AVAIL) {
      printk(KERN_NOTICE "iflash2+_mtd: page_setup timed out\n");
      log_esr(NULL, esr);
      return CS_GENERAL_FAILURE;
    }

    nw = count >> 1;
    if (nw == 0) {
      /* Special case of single byte write */
      writeb(LOW(IF_SINGLE_LOAD), address);
    } else {
      writew(IF_SEQ_LOAD, address);
      /* Tricky: split count into low bytes and high bytes */
      nw = (count-nw-1) | ((nw-1) << 8);
      if ((u_long)address & 2) {
          writew(0, address);
          writew(nw, address);
      } else {
          writew(nw, address);
          writew(0, address);
      }
    }
    return CS_SUCCESS;
}

static int page_write(volatile u_short *esr, volatile u_short *address,
                  u_short count)
{
    u_short nw;
    u_short i;

    writew(IF_READ_ESR, esr);
    for (i = 0; i < max_tries; i++)
      if (!(readw(esr+2) & BSR_QUEUE_FULL)) break;
    if (i == max_tries) {
      printk(KERN_NOTICE "iflash2+_mtd: page_write timed out\n");
      log_esr(NULL, esr);
      return CS_GENERAL_FAILURE;
    }
    nw = count >> 1;
    if (nw == 0) {
      writeb(LOW(IF_PAGE_WRITE), address);
      writeb(0, address);
      writeb(0, address);
    } else {
      writew(IF_PAGE_WRITE, address);
      /* Tricky: split count into low bytes and high bytes */
      nw = (count-nw-1) | ((nw-1) << 8);
      if ((u_long)address & 2) {
          writew(0, address);
          writew(nw, address);
      } else {
          writew(nw, address);
          writew(0, address);
      }
    }
    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)) {
      log_esr(KERN_NOTICE "erase error: ", address);
      return CS_WRITE_FAILURE;
    } else
      return CS_SUCCESS;
}

static int suspend_erase(volatile u_short *esr)
{
    u_short i;

    DEBUG(1, "iflash2+_mtd: suspending erase...\n");
    writew(IF_ERASE_SUSPEND, esr);
    writew(IF_READ_ESR, esr);
    for (i = 0; i < max_tries; i++)
      if ((readw(esr+4) & GSR_WR_READY) == GSR_WR_READY) break;
    if (i == max_tries) {
      printk(KERN_NOTICE "iflash2+_mtd: suspend_erase timed out\n");
      log_esr(NULL, esr);
      return CS_GENERAL_FAILURE;
    }
    writew(IF_READ_ARRAY, esr);
    return CS_SUCCESS;
}

static void resume_erase(volatile u_short *esr)
{
    DEBUG(1, "iflash2+_mtd: resuming erase...\n");
    writew(IF_READ_ESR, esr);
    /* Only give resume signal if the erase is really suspended */
    if (readw(esr+4) & GSR_OP_SUSPEND)
      writew(IF_CONFIRM, esr);
}

static void reset_block(volatile u_short *esr)
{
    writew(IF_READ_ARRAY, esr);
    writew(IF_CLEAR_CSR, esr);
}

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

static void set_global_lock(window_handle_t win,
                      volatile caddr_t base, int set)
{
    mtd_mod_win_t mod;
    mod.Attributes = WIN_MEMORY_TYPE_AM;
    mod.AccessSpeed = 250;
    mod.CardOffset = 0x4000;
    MTDHelperEntry(MTDModifyWindow, win, &mod);
    writeb((set) ? WP_BLKEN : 0, base+CISREG_WP);
}

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

    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 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 = 120;
            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;
    mtd_vpp_req_t req;

    DEBUG(1, "iflash2+_mtd: lowering Vpp...\n");
    dev = (flash_dev_t *)link->priv;
    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;
    dev = (flash_dev_t *)link->priv;
    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;
    init_waitqueue_head(&link->pending);
    
    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 |
      CS_EVENT_READY_CHANGE;
    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;

    /* Allocate a memory window for ESR accesses*/
    req.Base = 0;
    dev->ESRwin = (window_handle_t)handle;
    ret = MTDHelperEntry(MTDRequestWindow, &dev->ESRwin, &req);
    if (ret != 0) {
      cs_error(handle, RequestWindow, ret);
      link->state &= ~DEV_CONFIG_PENDING;
      flash_release((u_long)link);
      return;
    }
    dev->ESRbase = ioremap(req.Base, 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));
          dev->flash[i]->region = region;
          /* Distinguish between 4MB..20MB cards and 40MB cards */
          if (region.RegionSize > 0x1400000)
            dev->flash[i]->cell_size = 0x800000; /* 8MB components */
          else
            dev->flash[i]->cell_size = 0x400000; /* 4MB components */
          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->ESRwin) {
      iounmap(dev->ESRbase);
      i = MTDHelperEntry(MTDReleaseWindow, dev->ESRwin);
      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;
    int ret;
#ifdef BENCHMARK
    u_long time;
#endif
    
    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)) {
          DEBUG(1, "iflash2+_mtd: delaying read...\n");
          req->Status = MTD_WAITREQ;
          return CS_BUSY;
      }
      link->state |= DEV_BUSY;
      mod.CardOffset = flash->cell[cell].erase_addr;
      ret = MTDHelperEntry(MTDModifyWindow, dev->ESRwin, &mod);
      if (ret != CS_SUCCESS) goto done;
      ret = suspend_erase((u_short *)dev->ESRbase);
      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;
#ifdef BENCHMARK
    time = uticks();
#endif
    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 BENCHMARK
    time = uticks() - time;
    if (time < 10000000)
      DEBUG(3, "iflash2+_mtd: read complete, time = %ld,"
            " avg = %ld ns/word, rate = %ld kb/sec\n", time,
            time*2000/req->TransferLength,
            req->TransferLength*977/time);
#endif
    
done:
    if (flash->cell[cell].state & FLASH_ERASE_SUSPEND) {
      resume_erase((u_short *)dev->ESRbase);
      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.  It does a series
    of pipelined page buffer writes.
    
======================================================================*/

static int basic_write(wait_queue_head_t *queue, char *esr, char *dest,
                   char *buf, u_int nb, u_int is_krnl)
{
    u_short npb;
    int ret;

    /* Enable interrupts on write complete */
    ret = set_rdy_mode((u_short *)esr, IF_RDY_LEVEL);
    if (ret != CS_SUCCESS) return ret;
    
    /* Fix for mis-aligned writes */
    if ((u_long)dest & 1) {
      DEBUG(2, "iflash2+_mtd: odd address fixup at 0x%p\n", dest);
      ret = page_setup(queue, (u_short *)esr, (u_short *)dest, 1);
      if (ret != CS_SUCCESS) return ret;
      if (is_krnl)
          writeb(*buf, dest);
      else {
          char c;
          get_user(c, buf);
          writeb(c, dest);
      }
      ret = page_write((u_short *)esr, (u_short *)dest, 1);
      if (ret != CS_SUCCESS) return ret;
      dest++; buf++; nb--;
    }
    
    for (; nb > 0; nb -= npb) {
      /* npb = # of bytes to write to page buffer */
      npb = (nb > 512) ? 512 : nb;
      /* sleep until page buffer is free */
      ret = page_setup(queue, (u_short *)esr, (u_short *)dest, npb);
      if (ret != CS_SUCCESS) return ret;
      
      if (is_krnl)
          copy_to_pc(dest, buf, npb);
      else
          copy_user_to_pc(dest, buf, npb);
      
      ret = page_write((u_short *)esr, (u_short *)dest, npb);
      if (ret != CS_SUCCESS) return ret;
      check_write(queue, (u_short *)esr);
      
      dest += npb;
      buf += npb;
    }
    
    /* sleep until block is ready */
    return check_write(queue, (u_short *)esr);
}
    
/*======================================================================

    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;
    mtd_rdy_req_t rdy;
    flash_region_t *flash;
    region_info_t *region;
    u_int from, length, nb, retry, cell;
    cs_status_t status;
    int ret;
#ifdef BENCHMARK
    u_long time;
#endif

    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 or written? */
    cell = (req->DestCardOffset - region->CardOffset) / flash->cell_size;
    if (flash->cell[cell].state & FLASH_ERASING) {
      DEBUG(1, "iflash2+_mtd: delaying write...\n");
      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;

    /* Set up window for ESR accesses */
    mod.CardOffset = req->DestCardOffset & ~(region->BlockSize-1);
    ret = MTDHelperEntry(MTDModifyWindow, dev->ESRwin, &mod);
    if (ret != CS_SUCCESS) goto done;

    rdy.Mask = CS_EVENT_READY_CHANGE;
    MTDHelperEntry(MTDRDYMask, link->handle, &rdy);

#ifdef BENCHMARK
    time = uticks();
#endif
    mod.CardOffset = req->DestCardOffset & ~(dev->Size-1);
    from = req->DestCardOffset & (dev->Size-1);
    
    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;

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

#ifdef BENCHMARK
    time = uticks() - time;
    if (time < 10000000)
      DEBUG(3, "iflash2+_mtd: write complete, time = %ld,"
            " avg = %ld us/word, rate = %ld kb/sec\n", time,
            time*2/req->TransferLength,
            req->TransferLength*977/time);
#endif
    
done:
    reset_block((u_short *)dev->ESRbase);
    rdy.Mask = 0;
    MTDHelperEntry(MTDRDYMask, link->handle, &rdy);
    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)) {
          DEBUG(1, "iflash2+_mtd: delaying erase...\n");
          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;
      set_global_lock(dev->ESRwin, dev->ESRbase, 0);
      /* Disable busy signal during the erase */
      set_rdy_mode((u_short *)dev->Base, IF_RDY_DISABLE);
      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((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");
      log_esr(NULL, (u_short *)dev->Base);
      abort_cmd((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->ESRbase);
    set_global_lock(dev->ESRwin, dev->ESRbase, 1);
    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(3, "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_READY_CHANGE:
      wake_up_interruptible(&link->pending);
      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_iflash2x_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;
    write_timeout = (write_timeout * 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_iflash2x_mtd(void)
{
    DEBUG(0, "iflash2+_mtd: unloading\n");
    unregister_pccard_driver(&dev_info);
    while (dev_list != NULL)
      flash_detach(dev_list);
}

module_init(init_iflash2x_mtd);
module_exit(exit_iflash2x_mtd);

Generated by  Doxygen 1.6.0   Back to index