Merge tag 'xfs-4.15-merge-3' of git://git.kernel.org/pub/scm/fs/xfs/xfs-linux
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mtd / jedec,spi-nor.txt
1 * SPI NOR flash: ST M25Pxx (and similar) serial flash chips
2
3 Required properties:
4 - #address-cells, #size-cells : Must be present if the device has sub-nodes
5   representing partitions.
6 - compatible : May include a device-specific string consisting of the
7                manufacturer and name of the chip. A list of supported chip
8                names follows.
9                Must also include "jedec,spi-nor" for any SPI NOR flash that can
10                be identified by the JEDEC READ ID opcode (0x9F).
11
12                Supported chip names:
13                  at25df321a
14                  at25df641
15                  at26df081a
16                  en25s64
17                  mr25h256
18                  mr25h10
19                  mr25h40
20                  mx25l4005a
21                  mx25l1606e
22                  mx25l6405d
23                  mx25l12805d
24                  mx25l25635e
25                  n25q064
26                  n25q128a11
27                  n25q128a13
28                  n25q512a
29                  s25fl256s1
30                  s25fl512s
31                  s25sl12801
32                  s25fl008k
33                  s25fl064k
34                  sst25vf040b
35                  sst25wf040b
36                  m25p40
37                  m25p80
38                  m25p16
39                  m25p32
40                  m25p64
41                  m25p128
42                  w25x80
43                  w25x32
44                  w25q32
45                  w25q64
46                  w25q32dw
47                  w25q80bl
48                  w25q128
49                  w25q256
50
51                The following chip names have been used historically to
52                designate quirky versions of flash chips that do not support the
53                JEDEC READ ID opcode (0x9F):
54                  m25p05-nonjedec
55                  m25p10-nonjedec
56                  m25p20-nonjedec
57                  m25p40-nonjedec
58                  m25p80-nonjedec
59                  m25p16-nonjedec
60                  m25p32-nonjedec
61                  m25p64-nonjedec
62                  m25p128-nonjedec
63
64 - reg : Chip-Select number
65 - spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at
66
67 Optional properties:
68 - m25p,fast-read : Use the "fast read" opcode to read data from the chip instead
69                    of the usual "read" opcode. This opcode is not supported by
70                    all chips and support for it can not be detected at runtime.
71                    Refer to your chips' datasheet to check if this is supported
72                    by your chip.
73
74 Example:
75
76         flash: m25p80@0 {
77                 #address-cells = <1>;
78                 #size-cells = <1>;
79                 compatible = "spansion,m25p80", "jedec,spi-nor";
80                 reg = <0>;
81                 spi-max-frequency = <40000000>;
82                 m25p,fast-read;
83         };