root/drivers/mtd/devices/docg3.h

INCLUDED FROM

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  * Handles the M-Systems DiskOnChip G3 chip
   4  *
   5  * Copyright (C) 2011 Robert Jarzmik
   6  */
   7 
   8 #ifndef _MTD_DOCG3_H
   9 #define _MTD_DOCG3_H
  10 
  11 #include <linux/mtd/mtd.h>
  12 
  13 /*
  14  * Flash memory areas :
  15  *   - 0x0000 .. 0x07ff : IPL
  16  *   - 0x0800 .. 0x0fff : Data area
  17  *   - 0x1000 .. 0x17ff : Registers
  18  *   - 0x1800 .. 0x1fff : Unknown
  19  */
  20 #define DOC_IOSPACE_IPL                 0x0000
  21 #define DOC_IOSPACE_DATA                0x0800
  22 #define DOC_IOSPACE_SIZE                0x2000
  23 
  24 /*
  25  * DOC G3 layout and adressing scheme
  26  *   A page address for the block "b", plane "P" and page "p":
  27  *   address = [bbbb bPpp pppp]
  28  */
  29 
  30 #define DOC_ADDR_PAGE_MASK              0x3f
  31 #define DOC_ADDR_BLOCK_SHIFT            6
  32 #define DOC_LAYOUT_NBPLANES             2
  33 #define DOC_LAYOUT_PAGES_PER_BLOCK      64
  34 #define DOC_LAYOUT_PAGE_SIZE            512
  35 #define DOC_LAYOUT_OOB_SIZE             16
  36 #define DOC_LAYOUT_WEAR_SIZE            8
  37 #define DOC_LAYOUT_PAGE_OOB_SIZE                                \
  38         (DOC_LAYOUT_PAGE_SIZE + DOC_LAYOUT_OOB_SIZE)
  39 #define DOC_LAYOUT_WEAR_OFFSET          (DOC_LAYOUT_PAGE_OOB_SIZE * 2)
  40 #define DOC_LAYOUT_BLOCK_SIZE                                   \
  41         (DOC_LAYOUT_PAGES_PER_BLOCK * DOC_LAYOUT_PAGE_SIZE)
  42 
  43 /*
  44  * ECC related constants
  45  */
  46 #define DOC_ECC_BCH_M                   14
  47 #define DOC_ECC_BCH_T                   4
  48 #define DOC_ECC_BCH_PRIMPOLY            0x4443
  49 #define DOC_ECC_BCH_SIZE                7
  50 #define DOC_ECC_BCH_COVERED_BYTES                               \
  51         (DOC_LAYOUT_PAGE_SIZE + DOC_LAYOUT_OOB_PAGEINFO_SZ +    \
  52          DOC_LAYOUT_OOB_HAMMING_SZ)
  53 #define DOC_ECC_BCH_TOTAL_BYTES                                 \
  54         (DOC_ECC_BCH_COVERED_BYTES + DOC_LAYOUT_OOB_BCH_SZ)
  55 
  56 /*
  57  * Blocks distribution
  58  */
  59 #define DOC_LAYOUT_BLOCK_BBT            0
  60 #define DOC_LAYOUT_BLOCK_OTP            0
  61 #define DOC_LAYOUT_BLOCK_FIRST_DATA     6
  62 
  63 #define DOC_LAYOUT_PAGE_BBT             4
  64 
  65 /*
  66  * Extra page OOB (16 bytes wide) layout
  67  */
  68 #define DOC_LAYOUT_OOB_PAGEINFO_OFS     0
  69 #define DOC_LAYOUT_OOB_HAMMING_OFS      7
  70 #define DOC_LAYOUT_OOB_BCH_OFS          8
  71 #define DOC_LAYOUT_OOB_UNUSED_OFS       15
  72 #define DOC_LAYOUT_OOB_PAGEINFO_SZ      7
  73 #define DOC_LAYOUT_OOB_HAMMING_SZ       1
  74 #define DOC_LAYOUT_OOB_BCH_SZ           7
  75 #define DOC_LAYOUT_OOB_UNUSED_SZ        1
  76 
  77 
  78 #define DOC_CHIPID_G3                   0x200
  79 #define DOC_ERASE_MARK                  0xaa
  80 #define DOC_MAX_NBFLOORS                4
  81 /*
  82  * Flash registers
  83  */
  84 #define DOC_CHIPID                      0x1000
  85 #define DOC_TEST                        0x1004
  86 #define DOC_BUSLOCK                     0x1006
  87 #define DOC_ENDIANCONTROL               0x1008
  88 #define DOC_DEVICESELECT                0x100a
  89 #define DOC_ASICMODE                    0x100c
  90 #define DOC_CONFIGURATION               0x100e
  91 #define DOC_INTERRUPTCONTROL            0x1010
  92 #define DOC_READADDRESS                 0x101a
  93 #define DOC_DATAEND                     0x101e
  94 #define DOC_INTERRUPTSTATUS             0x1020
  95 
  96 #define DOC_FLASHSEQUENCE               0x1032
  97 #define DOC_FLASHCOMMAND                0x1034
  98 #define DOC_FLASHADDRESS                0x1036
  99 #define DOC_FLASHCONTROL                0x1038
 100 #define DOC_NOP                         0x103e
 101 
 102 #define DOC_ECCCONF0                    0x1040
 103 #define DOC_ECCCONF1                    0x1042
 104 #define DOC_ECCPRESET                   0x1044
 105 #define DOC_HAMMINGPARITY               0x1046
 106 #define DOC_BCH_HW_ECC(idx)             (0x1048 + idx)
 107 
 108 #define DOC_PROTECTION                  0x1056
 109 #define DOC_DPS0_KEY                    0x105c
 110 #define DOC_DPS1_KEY                    0x105e
 111 #define DOC_DPS0_ADDRLOW                0x1060
 112 #define DOC_DPS0_ADDRHIGH               0x1062
 113 #define DOC_DPS1_ADDRLOW                0x1064
 114 #define DOC_DPS1_ADDRHIGH               0x1066
 115 #define DOC_DPS0_STATUS                 0x106c
 116 #define DOC_DPS1_STATUS                 0x106e
 117 
 118 #define DOC_ASICMODECONFIRM             0x1072
 119 #define DOC_CHIPID_INV                  0x1074
 120 #define DOC_POWERMODE                   0x107c
 121 
 122 /*
 123  * Flash sequences
 124  * A sequence is preset before one or more commands are input to the chip.
 125  */
 126 #define DOC_SEQ_RESET                   0x00
 127 #define DOC_SEQ_PAGE_SIZE_532           0x03
 128 #define DOC_SEQ_SET_FASTMODE            0x05
 129 #define DOC_SEQ_SET_RELIABLEMODE        0x09
 130 #define DOC_SEQ_READ                    0x12
 131 #define DOC_SEQ_SET_PLANE1              0x0e
 132 #define DOC_SEQ_SET_PLANE2              0x10
 133 #define DOC_SEQ_PAGE_SETUP              0x1d
 134 #define DOC_SEQ_ERASE                   0x27
 135 #define DOC_SEQ_PLANES_STATUS           0x31
 136 
 137 /*
 138  * Flash commands
 139  */
 140 #define DOC_CMD_READ_PLANE1             0x00
 141 #define DOC_CMD_SET_ADDR_READ           0x05
 142 #define DOC_CMD_READ_ALL_PLANES         0x30
 143 #define DOC_CMD_READ_PLANE2             0x50
 144 #define DOC_CMD_READ_FLASH              0xe0
 145 #define DOC_CMD_PAGE_SIZE_532           0x3c
 146 
 147 #define DOC_CMD_PROG_BLOCK_ADDR         0x60
 148 #define DOC_CMD_PROG_CYCLE1             0x80
 149 #define DOC_CMD_PROG_CYCLE2             0x10
 150 #define DOC_CMD_PROG_CYCLE3             0x11
 151 #define DOC_CMD_ERASECYCLE2             0xd0
 152 #define DOC_CMD_READ_STATUS             0x70
 153 #define DOC_CMD_PLANES_STATUS           0x71
 154 
 155 #define DOC_CMD_RELIABLE_MODE           0x22
 156 #define DOC_CMD_FAST_MODE               0xa2
 157 
 158 #define DOC_CMD_RESET                   0xff
 159 
 160 /*
 161  * Flash register : DOC_FLASHCONTROL
 162  */
 163 #define DOC_CTRL_VIOLATION              0x20
 164 #define DOC_CTRL_CE                     0x10
 165 #define DOC_CTRL_UNKNOWN_BITS           0x08
 166 #define DOC_CTRL_PROTECTION_ERROR       0x04
 167 #define DOC_CTRL_SEQUENCE_ERROR         0x02
 168 #define DOC_CTRL_FLASHREADY             0x01
 169 
 170 /*
 171  * Flash register : DOC_ASICMODE
 172  */
 173 #define DOC_ASICMODE_RESET              0x00
 174 #define DOC_ASICMODE_NORMAL             0x01
 175 #define DOC_ASICMODE_POWERDOWN          0x02
 176 #define DOC_ASICMODE_MDWREN             0x04
 177 #define DOC_ASICMODE_BDETCT_RESET       0x08
 178 #define DOC_ASICMODE_RSTIN_RESET        0x10
 179 #define DOC_ASICMODE_RAM_WE             0x20
 180 
 181 /*
 182  * Flash register : DOC_ECCCONF0
 183  */
 184 #define DOC_ECCCONF0_WRITE_MODE         0x0000
 185 #define DOC_ECCCONF0_READ_MODE          0x8000
 186 #define DOC_ECCCONF0_AUTO_ECC_ENABLE    0x4000
 187 #define DOC_ECCCONF0_HAMMING_ENABLE     0x1000
 188 #define DOC_ECCCONF0_BCH_ENABLE         0x0800
 189 #define DOC_ECCCONF0_DATA_BYTES_MASK    0x07ff
 190 
 191 /*
 192  * Flash register : DOC_ECCCONF1
 193  */
 194 #define DOC_ECCCONF1_BCH_SYNDROM_ERR    0x80
 195 #define DOC_ECCCONF1_UNKOWN1            0x40
 196 #define DOC_ECCCONF1_PAGE_IS_WRITTEN    0x20
 197 #define DOC_ECCCONF1_UNKOWN3            0x10
 198 #define DOC_ECCCONF1_HAMMING_BITS_MASK  0x0f
 199 
 200 /*
 201  * Flash register : DOC_PROTECTION
 202  */
 203 #define DOC_PROTECT_FOUNDRY_OTP_LOCK    0x01
 204 #define DOC_PROTECT_CUSTOMER_OTP_LOCK   0x02
 205 #define DOC_PROTECT_LOCK_INPUT          0x04
 206 #define DOC_PROTECT_STICKY_LOCK         0x08
 207 #define DOC_PROTECT_PROTECTION_ENABLED  0x10
 208 #define DOC_PROTECT_IPL_DOWNLOAD_LOCK   0x20
 209 #define DOC_PROTECT_PROTECTION_ERROR    0x80
 210 
 211 /*
 212  * Flash register : DOC_DPS0_STATUS and DOC_DPS1_STATUS
 213  */
 214 #define DOC_DPS_OTP_PROTECTED           0x01
 215 #define DOC_DPS_READ_PROTECTED          0x02
 216 #define DOC_DPS_WRITE_PROTECTED         0x04
 217 #define DOC_DPS_HW_LOCK_ENABLED         0x08
 218 #define DOC_DPS_KEY_OK                  0x80
 219 
 220 /*
 221  * Flash register : DOC_CONFIGURATION
 222  */
 223 #define DOC_CONF_IF_CFG                 0x80
 224 #define DOC_CONF_MAX_ID_MASK            0x30
 225 #define DOC_CONF_VCCQ_3V                0x01
 226 
 227 /*
 228  * Flash register : DOC_READADDRESS
 229  */
 230 #define DOC_READADDR_INC                0x8000
 231 #define DOC_READADDR_ONE_BYTE           0x4000
 232 #define DOC_READADDR_ADDR_MASK          0x1fff
 233 
 234 /*
 235  * Flash register : DOC_POWERMODE
 236  */
 237 #define DOC_POWERDOWN_READY             0x80
 238 
 239 /*
 240  * Status of erase and write operation
 241  */
 242 #define DOC_PLANES_STATUS_FAIL          0x01
 243 #define DOC_PLANES_STATUS_PLANE0_KO     0x02
 244 #define DOC_PLANES_STATUS_PLANE1_KO     0x04
 245 
 246 /*
 247  * DPS key management
 248  *
 249  * Each floor of docg3 has 2 protection areas: DPS0 and DPS1. These areas span
 250  * across block boundaries, and define whether these blocks can be read or
 251  * written.
 252  * The definition is dynamically stored in page 0 of blocks (2,3) for DPS0, and
 253  * page 0 of blocks (4,5) for DPS1.
 254  */
 255 #define DOC_LAYOUT_DPS_KEY_LENGTH       8
 256 
 257 /**
 258  * struct docg3_cascade - Cascade of 1 to 4 docg3 chips
 259  * @floors: floors (ie. one physical docg3 chip is one floor)
 260  * @base: IO space to access all chips in the cascade
 261  * @bch: the BCH correcting control structure
 262  * @lock: lock to protect docg3 IO space from concurrent accesses
 263  */
 264 struct docg3_cascade {
 265         struct mtd_info *floors[DOC_MAX_NBFLOORS];
 266         void __iomem *base;
 267         struct bch_control *bch;
 268         struct mutex lock;
 269 };
 270 
 271 /**
 272  * struct docg3 - DiskOnChip driver private data
 273  * @dev: the device currently under control
 274  * @cascade: the cascade this device belongs to
 275  * @device_id: number of the cascaded DoCG3 device (0, 1, 2 or 3)
 276  * @if_cfg: if true, reads are on 16bits, else reads are on 8bits
 277 
 278  * @reliable: if 0, docg3 in normal mode, if 1 docg3 in fast mode, if 2 in
 279  *            reliable mode
 280  *            Fast mode implies more errors than normal mode.
 281  *            Reliable mode implies that page 2*n and 2*n+1 are clones.
 282  * @bbt: bad block table cache
 283  * @oob_write_ofs: offset of the MTD where this OOB should belong (ie. in next
 284  *                 page_write)
 285  * @oob_autoecc: if 1, use only bytes 0-7, 15, and fill the others with HW ECC
 286  *               if 0, use all the 16 bytes.
 287  * @oob_write_buf: prepared OOB for next page_write
 288  */
 289 struct docg3 {
 290         struct device *dev;
 291         struct docg3_cascade *cascade;
 292         unsigned int device_id:4;
 293         unsigned int if_cfg:1;
 294         unsigned int reliable:2;
 295         int max_block;
 296         u8 *bbt;
 297         loff_t oob_write_ofs;
 298         int oob_autoecc;
 299         u8 oob_write_buf[DOC_LAYOUT_OOB_SIZE];
 300 };
 301 
 302 #define doc_err(fmt, arg...) dev_err(docg3->dev, (fmt), ## arg)
 303 #define doc_info(fmt, arg...) dev_info(docg3->dev, (fmt), ## arg)
 304 #define doc_dbg(fmt, arg...) dev_dbg(docg3->dev, (fmt), ## arg)
 305 #define doc_vdbg(fmt, arg...) dev_vdbg(docg3->dev, (fmt), ## arg)
 306 #endif
 307 
 308 /*
 309  * Trace events part
 310  */
 311 #undef TRACE_SYSTEM
 312 #define TRACE_SYSTEM docg3
 313 
 314 #if !defined(_MTD_DOCG3_TRACE) || defined(TRACE_HEADER_MULTI_READ)
 315 #define _MTD_DOCG3_TRACE
 316 
 317 #include <linux/tracepoint.h>
 318 
 319 TRACE_EVENT(docg3_io,
 320             TP_PROTO(int op, int width, u16 reg, int val),
 321             TP_ARGS(op, width, reg, val),
 322             TP_STRUCT__entry(
 323                     __field(int, op)
 324                     __field(unsigned char, width)
 325                     __field(u16, reg)
 326                     __field(int, val)),
 327             TP_fast_assign(
 328                     __entry->op = op;
 329                     __entry->width = width;
 330                     __entry->reg = reg;
 331                     __entry->val = val;),
 332             TP_printk("docg3: %s%02d reg=%04x, val=%04x",
 333                       __entry->op ? "write" : "read", __entry->width,
 334                       __entry->reg, __entry->val)
 335         );
 336 #endif
 337 
 338 /* This part must be outside protection */
 339 #undef TRACE_INCLUDE_PATH
 340 #undef TRACE_INCLUDE_FILE
 341 #define TRACE_INCLUDE_PATH .
 342 #define TRACE_INCLUDE_FILE docg3
 343 #include <trace/define_trace.h>