kernel/include/linux/mtd/fsmc.h

   1 /*
   2  * incude/mtd/fsmc.h
   3  *
   4  * ST Microelectronics
   5  * Flexible Static Memory Controller (FSMC)
   6  * platform data interface and header file
   7  *
   8  * Copyright © 2010 ST Microelectronics
   9  * Vipin Kumar <vipin.kumar@st.com>
  10  *
  11  * This file is licensed under the terms of the GNU General Public
  12  * License version 2. This program is licensed "as is" without any
  13  * warranty of any kind, whether express or implied.
  14  */
  15
  16 #ifndef __MTD_FSMC_H
  17 #define __MTD_FSMC_H
  18
  19 #include <linux/io.h>
  20 #include <linux/platform_device.h>
  21 #include <linux/mtd/physmap.h>
  22 #include <linux/types.h>
  23 #include <linux/mtd/partitions.h>
  24 #include <asm/param.h>
  25
  26 #define FSMC_NAND_BW8           1
  27 #define FSMC_NAND_BW16          2
  28
  29 #define FSMC_MAX_NOR_BANKS      4
  30 #define FSMC_MAX_NAND_BANKS     4
  31
  32 #define FSMC_FLASH_WIDTH8       1
  33 #define FSMC_FLASH_WIDTH16      2
  34
  35 /* fsmc controller registers for NOR flash */
  36 #define CTRL                    0x0
  37         /* ctrl register definitions */
  38         #define BANK_ENABLE             (1 << 0)
  39         #define MUXED                   (1 << 1)
  40         #define NOR_DEV                 (2 << 2)
  41         #define WIDTH_8                 (0 << 4)
  42         #define WIDTH_16                (1 << 4)
  43         #define RSTPWRDWN               (1 << 6)
  44         #define WPROT                   (1 << 7)
  45         #define WRT_ENABLE              (1 << 12)
  46         #define WAIT_ENB                (1 << 13)
  47
  48 #define CTRL_TIM                0x4
  49         /* ctrl_tim register definitions */
  50
  51 #define FSMC_NOR_BANK_SZ        0x8
  52 #define FSMC_NOR_REG_SIZE       0x40
  53
  54 #define FSMC_NOR_REG(base, bank, reg)           (base + \
  55                                                 FSMC_NOR_BANK_SZ * (bank) + \
  56                                                 reg)
  57
  58 /* fsmc controller registers for NAND flash */
  59 #define PC                      0x00
  60         /* pc register definitions */
  61         #define FSMC_RESET              (1 << 0)
  62         #define FSMC_WAITON             (1 << 1)
  63         #define FSMC_ENABLE             (1 << 2)
  64         #define FSMC_DEVTYPE_NAND       (1 << 3)
  65         #define FSMC_DEVWID_8           (0 << 4)
  66         #define FSMC_DEVWID_16          (1 << 4)
  67         #define FSMC_ECCEN              (1 << 6)
  68         #define FSMC_ECCPLEN_512        (0 << 7)
  69         #define FSMC_ECCPLEN_256        (1 << 7)
  70         #define FSMC_TCLR_1             (1)
  71         #define FSMC_TCLR_SHIFT         (9)
  72         #define FSMC_TCLR_MASK          (0xF)
  73         #define FSMC_TAR_1              (1)
  74         #define FSMC_TAR_SHIFT          (13)
  75         #define FSMC_TAR_MASK           (0xF)
  76 #define STS                     0x04
  77         /* sts register definitions */
  78         #define FSMC_CODE_RDY           (1 << 15)
  79 #define COMM                    0x08
  80         /* comm register definitions */
  81         #define FSMC_TSET_0             0
  82         #define FSMC_TSET_SHIFT         0
  83         #define FSMC_TSET_MASK          0xFF
  84         #define FSMC_TWAIT_6            6
  85         #define FSMC_TWAIT_SHIFT        8
  86         #define FSMC_TWAIT_MASK         0xFF
  87         #define FSMC_THOLD_4            4
  88         #define FSMC_THOLD_SHIFT        16
  89         #define FSMC_THOLD_MASK         0xFF
  90         #define FSMC_THIZ_1             1
  91         #define FSMC_THIZ_SHIFT         24
  92         #define FSMC_THIZ_MASK          0xFF
  93 #define ATTRIB                  0x0C
  94 #define IOATA                   0x10
  95 #define ECC1                    0x14
  96 #define ECC2                    0x18
  97 #define ECC3                    0x1C
  98 #define FSMC_NAND_BANK_SZ       0x20
  99
 100 #define FSMC_NAND_REG(base, bank, reg)          (base + FSMC_NOR_REG_SIZE + \
 101                                                 (FSMC_NAND_BANK_SZ * (bank)) + \
 102                                                 reg)
 103
 104 #define FSMC_BUSY_WAIT_TIMEOUT  (1 * HZ)
 105
 106 /*
 107  * There are 13 bytes of ecc for every 512 byte block in FSMC version 8
 108  * and it has to be read consecutively and immediately after the 512
 109  * byte data block for hardware to generate the error bit offsets
 110  * Managing the ecc bytes in the following way is easier. This way is
 111  * similar to oobfree structure maintained already in u-boot nand driver
 112  */
 113 #define MAX_ECCPLACE_ENTRIES    32
 114
 115 struct fsmc_nand_eccplace {
 116         uint8_t offset;
 117         uint8_t length;
 118 };
 119
 120 struct fsmc_eccplace {
 121         struct fsmc_nand_eccplace eccplace[MAX_ECCPLACE_ENTRIES];
 122 };
 123
 124 struct fsmc_nand_timings {
 125         uint8_t tclr;
 126         uint8_t tar;
 127         uint8_t thiz;
 128         uint8_t thold;
 129         uint8_t twait;
 130         uint8_t tset;
 131 };
 132
 133 enum access_mode {
 134         USE_DMA_ACCESS = 1,
 135         USE_WORD_ACCESS,
 136 };
 137
 138 /**
 139  * fsmc_nand_platform_data - platform specific NAND controller config
 140  * @nand_timings: timing setup for the physical NAND interface
 141  * @partitions: partition table for the platform, use a default fallback
 142  * if this is NULL
 143  * @nr_partitions: the number of partitions in the previous entry
 144  * @options: different options for the driver
 145  * @width: bus width
 146  * @bank: default bank
 147  * @select_bank: callback to select a certain bank, this is
 148  * platform-specific. If the controller only supports one bank
 149  * this may be set to NULL
 150  */
 151 struct fsmc_nand_platform_data {
 152         struct fsmc_nand_timings *nand_timings;
 153         struct mtd_partition    *partitions;
 154         unsigned int            nr_partitions;
 155         unsigned int            options;
 156         unsigned int            width;
 157         unsigned int            bank;
 158
 159         enum access_mode        mode;
 160
 161         void                    (*select_bank)(uint32_t bank, uint32_t busw);
 162
 163         /* priv structures for dma accesses */
 164         void                    *read_dma_priv;
 165         void                    *write_dma_priv;
 166 };
 167
 168 extern int __init fsmc_nor_init(struct platform_device *pdev,
 169                 unsigned long base, uint32_t bank, uint32_t width);
 170 extern void __init fsmc_init_board_info(struct platform_device *pdev,
 171                 struct mtd_partition *partitions, unsigned int nr_partitions,
 172                 unsigned int width);
 173
 174 #endif /* __MTD_FSMC_H */