drivers/mtd/chips/Kconfig

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 menu "RAM/ROM/Flash chip drivers"
   3         depends on MTD!=n
   4
   5 config MTD_CFI
   6         tristate "Detect flash chips by Common Flash Interface (CFI) probe"
   7         select MTD_GEN_PROBE
   8         select MTD_CFI_UTIL
   9         help
  10           The Common Flash Interface specification was developed by Intel,
  11           AMD and other flash manufactures that provides a universal method
  12           for probing the capabilities of flash devices. If you wish to
  13           support any device that is CFI-compliant, you need to enable this
  14           option. Visit <https://www.amd.com/products/nvd/overview/cfi.html>
  15           for more information on CFI.
  16
  17 config MTD_JEDECPROBE
  18         tristate "Detect non-CFI AMD/JEDEC-compatible flash chips"
  19         select MTD_GEN_PROBE
  20         select MTD_CFI_UTIL
  21         help
  22           This option enables JEDEC-style probing of flash chips which are not
  23           compatible with the Common Flash Interface, but will use the common
  24           CFI-targeted flash drivers for any chips which are identified which
  25           are in fact compatible in all but the probe method. This actually
  26           covers most AMD/Fujitsu-compatible chips and also non-CFI
  27           Intel chips.
  28
  29 config MTD_GEN_PROBE
  30         tristate
  31
  32 config MTD_CFI_ADV_OPTIONS
  33         bool "Flash chip driver advanced configuration options"
  34         depends on MTD_GEN_PROBE
  35         help
  36           If you need to specify a specific endianness for access to flash
  37           chips, or if you wish to reduce the size of the kernel by including
  38           support for only specific arrangements of flash chips, say 'Y'. This
  39           option does not directly affect the code, but will enable other
  40           configuration options which allow you to do so.
  41
  42           If unsure, say 'N'.
  43
  44 choice
  45         prompt "Flash cmd/query data swapping"
  46         depends on MTD_CFI_ADV_OPTIONS
  47         default MTD_CFI_NOSWAP
  48         help
  49           This option defines the way in which the CPU attempts to arrange
  50           data bits when writing the 'magic' commands to the chips. Saying
  51           'NO', which is the default when CONFIG_MTD_CFI_ADV_OPTIONS isn't
  52           enabled, means that the CPU will not do any swapping; the chips
  53           are expected to be wired to the CPU in 'host-endian' form.
  54           Specific arrangements are possible with the BIG_ENDIAN_BYTE and
  55           LITTLE_ENDIAN_BYTE, if the bytes are reversed.
  56
  57 config MTD_CFI_NOSWAP
  58         bool "NO"
  59
  60 config MTD_CFI_BE_BYTE_SWAP
  61         bool "BIG_ENDIAN_BYTE"
  62
  63 config MTD_CFI_LE_BYTE_SWAP
  64         bool "LITTLE_ENDIAN_BYTE"
  65
  66 endchoice
  67
  68 config MTD_CFI_GEOMETRY
  69         bool "Specific CFI Flash geometry selection"
  70         depends on MTD_CFI_ADV_OPTIONS
  71         select MTD_MAP_BANK_WIDTH_1 if  !(MTD_MAP_BANK_WIDTH_2 || \
  72                  MTD_MAP_BANK_WIDTH_4  || MTD_MAP_BANK_WIDTH_8 || \
  73                  MTD_MAP_BANK_WIDTH_16 || MTD_MAP_BANK_WIDTH_32)
  74         select MTD_CFI_I1 if !(MTD_CFI_I2 || MTD_CFI_I4 || MTD_CFI_I8)
  75         help
  76           This option does not affect the code directly, but will enable
  77           some other configuration options which would allow you to reduce
  78           the size of the kernel by including support for only certain
  79           arrangements of CFI chips. If unsure, say 'N' and all options
  80           which are supported by the current code will be enabled.
  81
  82 config MTD_MAP_BANK_WIDTH_1
  83         bool "Support  8-bit buswidth" if MTD_CFI_GEOMETRY
  84         default y
  85         help
  86           If you wish to support CFI devices on a physical bus which is
  87           8 bits wide, say 'Y'.
  88
  89 config MTD_MAP_BANK_WIDTH_2
  90         bool "Support 16-bit buswidth" if MTD_CFI_GEOMETRY
  91         default y
  92         help
  93           If you wish to support CFI devices on a physical bus which is
  94           16 bits wide, say 'Y'.
  95
  96 config MTD_MAP_BANK_WIDTH_4
  97         bool "Support 32-bit buswidth" if MTD_CFI_GEOMETRY
  98         default y
  99         help
 100           If you wish to support CFI devices on a physical bus which is
 101           32 bits wide, say 'Y'.
 102
 103 config MTD_MAP_BANK_WIDTH_8
 104         bool "Support 64-bit buswidth" if MTD_CFI_GEOMETRY
 105         default n
 106         help
 107           If you wish to support CFI devices on a physical bus which is
 108           64 bits wide, say 'Y'.
 109
 110 config MTD_MAP_BANK_WIDTH_16
 111         bool "Support 128-bit buswidth" if MTD_CFI_GEOMETRY
 112         default n
 113         help
 114           If you wish to support CFI devices on a physical bus which is
 115           128 bits wide, say 'Y'.
 116
 117 config MTD_MAP_BANK_WIDTH_32
 118         bool "Support 256-bit buswidth" if MTD_CFI_GEOMETRY
 119         select MTD_COMPLEX_MAPPINGS if HAS_IOMEM
 120         default n
 121         help
 122           If you wish to support CFI devices on a physical bus which is
 123           256 bits wide, say 'Y'.
 124
 125 config MTD_CFI_I1
 126         bool "Support 1-chip flash interleave" if MTD_CFI_GEOMETRY
 127         default y
 128         help
 129           If your flash chips are not interleaved - i.e. you only have one
 130           flash chip addressed by each bus cycle, then say 'Y'.
 131
 132 config MTD_CFI_I2
 133         bool "Support 2-chip flash interleave" if MTD_CFI_GEOMETRY
 134         default y
 135         help
 136           If your flash chips are interleaved in pairs - i.e. you have two
 137           flash chips addressed by each bus cycle, then say 'Y'.
 138
 139 config MTD_CFI_I4
 140         bool "Support 4-chip flash interleave" if MTD_CFI_GEOMETRY
 141         default n
 142         help
 143           If your flash chips are interleaved in fours - i.e. you have four
 144           flash chips addressed by each bus cycle, then say 'Y'.
 145
 146 config MTD_CFI_I8
 147         bool "Support 8-chip flash interleave" if MTD_CFI_GEOMETRY
 148         default n
 149         help
 150           If your flash chips are interleaved in eights - i.e. you have eight
 151           flash chips addressed by each bus cycle, then say 'Y'.
 152
 153 config MTD_OTP
 154         bool "Protection Registers aka one-time programmable (OTP) bits"
 155         depends on MTD_CFI_ADV_OPTIONS
 156         default n
 157         help
 158           This enables support for reading, writing and locking so called
 159           "Protection Registers" present on some flash chips.
 160           A subset of them are pre-programmed at the factory with a
 161           unique set of values. The rest is user-programmable.
 162
 163           The user-programmable Protection Registers contain one-time
 164           programmable (OTP) bits; when programmed, register bits cannot be
 165           erased. Each Protection Register can be accessed multiple times to
 166           program individual bits, as long as the register remains unlocked.
 167
 168           Each Protection Register has an associated Lock Register bit. When a
 169           Lock Register bit is programmed, the associated Protection Register
 170           can only be read; it can no longer be programmed. Additionally,
 171           because the Lock Register bits themselves are OTP, when programmed,
 172           Lock Register bits cannot be erased. Therefore, when a Protection
 173           Register is locked, it cannot be unlocked.
 174
 175           This feature should therefore be used with extreme care. Any mistake
 176           in the programming of OTP bits will waste them.
 177
 178 config MTD_CFI_INTELEXT
 179         tristate "Support for CFI command set 0001 (Intel/Sharp chips)"
 180         depends on MTD_GEN_PROBE
 181         select MTD_CFI_UTIL
 182         help
 183           The Common Flash Interface defines a number of different command
 184           sets which a CFI-compliant chip may claim to implement. This code
 185           provides support for command set 0001, used on Intel StrataFlash
 186           and other parts.
 187
 188 config MTD_CFI_AMDSTD
 189         tristate "Support for CFI command set 0002 (AMD/Fujitsu/Spansion chips)"
 190         depends on MTD_GEN_PROBE
 191         select MTD_CFI_UTIL
 192         help
 193           The Common Flash Interface defines a number of different command
 194           sets which a CFI-compliant chip may claim to implement. This code
 195           provides support for command set 0002, used on chips including
 196           the AMD Am29LV320.
 197
 198 config MTD_CFI_STAA
 199         tristate "Support for CFI command set 0020 (ST (Advanced Architecture) chips)"
 200         depends on MTD_GEN_PROBE
 201         select MTD_CFI_UTIL
 202         help
 203           The Common Flash Interface defines a number of different command
 204           sets which a CFI-compliant chip may claim to implement. This code
 205           provides support for command set 0020.
 206
 207 config MTD_CFI_UTIL
 208         tristate
 209
 210 config MTD_RAM
 211         tristate "Support for RAM chips in bus mapping"
 212         help
 213           This option enables basic support for RAM chips accessed through
 214           a bus mapping driver.
 215
 216 config MTD_ROM
 217         tristate "Support for ROM chips in bus mapping"
 218         help
 219           This option enables basic support for ROM chips accessed through
 220           a bus mapping driver.
 221
 222 config MTD_ABSENT
 223         tristate "Support for absent chips in bus mapping"
 224         help
 225           This option enables support for a dummy probing driver used to
 226           allocated placeholder MTD devices on systems that have socketed
 227           or removable media.  Use of this driver as a fallback chip probe
 228           preserves the expected registration order of MTD device nodes on
 229           the system regardless of media presence.  Device nodes created
 230           with this driver will return -ENODEV upon access.
 231
 232 config MTD_XIP
 233         bool "XIP aware MTD support"
 234         depends on !SMP && (MTD_CFI_INTELEXT || MTD_CFI_AMDSTD) && ARCH_MTD_XIP
 235         default y if XIP_KERNEL
 236         help
 237           This allows MTD support to work with flash memory which is also
 238           used for XIP purposes.  If you're not sure what this is all about
 239           then say N.
 240
 241 endmenu