linux/drivers/mtd/nand/r852.h
<<
>>
Prefs
   1/*
   2 * Copyright © 2009 - Maxim Levitsky
   3 * driver for Ricoh xD readers
   4 *
   5 * This program is free software; you can redistribute it and/or modify
   6 * it under the terms of the GNU General Public License version 2 as
   7 * published by the Free Software Foundation.
   8 */
   9
  10#include <linux/pci.h>
  11#include <linux/completion.h>
  12#include <linux/workqueue.h>
  13#include <linux/mtd/nand.h>
  14#include <linux/spinlock.h>
  15
  16
  17/* nand interface + ecc
  18   byte write/read does one cycle on nand data lines.
  19   dword write/read does 4 cycles
  20   if R852_CTL_ECC_ACCESS is set in R852_CTL, then dword read reads
  21   results of ecc correction, if DMA read was done before.
  22   If write was done two dword reads read generated ecc checksums
  23*/
  24#define R852_DATALINE           0x00
  25
  26/* control register */
  27#define R852_CTL                0x04
  28#define R852_CTL_COMMAND        0x01    /* send command (#CLE)*/
  29#define R852_CTL_DATA           0x02    /* read/write data (#ALE)*/
  30#define R852_CTL_ON             0x04    /* only seem to controls the hd led, */
  31                                        /* but has to be set on start...*/
  32#define R852_CTL_RESET          0x08    /* unknown, set only on start once*/
  33#define R852_CTL_CARDENABLE     0x10    /* probably (#CE) - always set*/
  34#define R852_CTL_ECC_ENABLE     0x20    /* enable ecc engine */
  35#define R852_CTL_ECC_ACCESS     0x40    /* read/write ecc via reg #0*/
  36#define R852_CTL_WRITE          0x80    /* set when performing writes (#WP) */
  37
  38/* card detection status */
  39#define R852_CARD_STA           0x05
  40
  41#define R852_CARD_STA_CD        0x01    /* state of #CD line, same as 0x04 */
  42#define R852_CARD_STA_RO        0x02    /* card is readonly */
  43#define R852_CARD_STA_PRESENT   0x04    /* card is present (#CD) */
  44#define R852_CARD_STA_ABSENT    0x08    /* card is absent */
  45#define R852_CARD_STA_BUSY      0x80    /* card is busy - (#R/B) */
  46
  47/* card detection irq status & enable*/
  48#define R852_CARD_IRQ_STA       0x06    /* IRQ status */
  49#define R852_CARD_IRQ_ENABLE    0x07    /* IRQ enable */
  50
  51#define R852_CARD_IRQ_CD        0x01    /* fire when #CD lights, same as 0x04*/
  52#define R852_CARD_IRQ_REMOVE    0x04    /* detect card removal */
  53#define R852_CARD_IRQ_INSERT    0x08    /* detect card insert */
  54#define R852_CARD_IRQ_UNK1      0x10    /* unknown */
  55#define R852_CARD_IRQ_GENABLE   0x80    /* general enable */
  56#define R852_CARD_IRQ_MASK      0x1D
  57
  58
  59
  60/* hardware enable */
  61#define R852_HW                 0x08
  62#define R852_HW_ENABLED         0x01    /* hw enabled */
  63#define R852_HW_UNKNOWN         0x80
  64
  65
  66/* dma capabilities */
  67#define R852_DMA_CAP            0x09
  68#define R852_SMBIT              0x20    /* if set with bit #6 or bit #7, then */
  69                                        /* hw is smartmedia */
  70#define R852_DMA1               0x40    /* if set w/bit #7, dma is supported */
  71#define R852_DMA2               0x80    /* if set w/bit #6, dma is supported */
  72
  73
  74/* physical DMA address - 32 bit value*/
  75#define R852_DMA_ADDR           0x0C
  76
  77
  78/* dma settings */
  79#define R852_DMA_SETTINGS       0x10
  80#define R852_DMA_MEMORY         0x01    /* (memory <-> internal hw buffer) */
  81#define R852_DMA_READ           0x02    /* 0 = write, 1 = read */
  82#define R852_DMA_INTERNAL       0x04    /* (internal hw buffer <-> card) */
  83
  84/* dma IRQ status */
  85#define R852_DMA_IRQ_STA                0x14
  86
  87/* dma IRQ enable */
  88#define R852_DMA_IRQ_ENABLE     0x18
  89
  90#define R852_DMA_IRQ_MEMORY     0x01    /* (memory <-> internal hw buffer) */
  91#define R852_DMA_IRQ_ERROR      0x02    /* error did happen */
  92#define R852_DMA_IRQ_INTERNAL   0x04    /* (internal hw buffer <-> card) */
  93#define R852_DMA_IRQ_MASK       0x07    /* mask of all IRQ bits */
  94
  95
  96/* ECC syndrome format - read from reg #0 will return two copies of these for
  97   each half of the page.
  98   first byte is error byte location, and second, bit location + flags */
  99#define R852_ECC_ERR_BIT_MSK    0x07    /* error bit location */
 100#define R852_ECC_CORRECT                0x10    /* no errors - (guessed) */
 101#define R852_ECC_CORRECTABLE    0x20    /* correctable error exist */
 102#define R852_ECC_FAIL           0x40    /* non correctable error detected */
 103
 104#define R852_DMA_LEN            512
 105
 106#define DMA_INTERNAL    0
 107#define DMA_MEMORY      1
 108
 109struct r852_device {
 110        void __iomem *mmio;             /* mmio */
 111        struct mtd_info *mtd;           /* mtd backpointer */
 112        struct nand_chip *chip;         /* nand chip backpointer */
 113        struct pci_dev *pci_dev;        /* pci backpointer */
 114
 115        /* dma area */
 116        dma_addr_t phys_dma_addr;       /* bus address of buffer*/
 117        struct completion dma_done;     /* data transfer done */
 118
 119        dma_addr_t phys_bounce_buffer;  /* bus address of bounce buffer */
 120        uint8_t *bounce_buffer;         /* virtual address of bounce buffer */
 121
 122        int dma_dir;                    /* 1 = read, 0 = write */
 123        int dma_stage;                  /* 0 - idle, 1 - first step,
 124                                           2 - second step */
 125
 126        int dma_state;                  /* 0 = internal, 1 = memory */
 127        int dma_error;                  /* dma errors */
 128        int dma_usable;                 /* is it possible to use dma */
 129
 130        /* card status area */
 131        struct delayed_work card_detect_work;
 132        struct workqueue_struct *card_workqueue;
 133        int card_registred;             /* card registered with mtd */
 134        int card_detected;              /* card detected in slot */
 135        int card_unstable;              /* whenever the card is inserted,
 136                                           is not known yet */
 137        int readonly;                   /* card is readonly */
 138        int sm;                         /* Is card smartmedia */
 139
 140        /* interrupt handling */
 141        spinlock_t irqlock;             /* IRQ protecting lock */
 142        int irq;                        /* irq num */
 143        /* misc */
 144        void *tmp_buffer;               /* temporary buffer */
 145        uint8_t ctlreg;                 /* cached contents of control reg */
 146};
 147
 148#define DRV_NAME "r852"
 149
 150
 151#define dbg(format, ...) \
 152        if (debug) \
 153                printk(KERN_DEBUG DRV_NAME ": " format "\n", ## __VA_ARGS__)
 154
 155#define dbg_verbose(format, ...) \
 156        if (debug > 1) \
 157                printk(KERN_DEBUG DRV_NAME ": " format "\n", ## __VA_ARGS__)
 158
 159
 160#define message(format, ...) \
 161        printk(KERN_INFO DRV_NAME ": " format "\n", ## __VA_ARGS__)
 162