[deliverable/linux.git] / Documentation / devicetree / bindings / mtd / jedec,spi-nor.txt

* SPI NOR flash: ST M25Pxx (and similar) serial flash chips

Required properties:
- #address-cells, #size-cells : Must be present if the device has sub-nodes
  representing partitions.
- compatible : May include a device-specific string consisting of the
               manufacturer and name of the chip. A list of supported chip
               names follows.
               Must also include "jedec,spi-nor" for any SPI NOR flash that can
               be identified by the JEDEC READ ID opcode (0x9F).

               Supported chip names:
                 at25df321a
                 at25df641
                 at26df081a
                 mr25h256
                 mx25l4005a
                 mx25l1606e
                 mx25l6405d
                 mx25l12805d
                 mx25l25635e
                 n25q064
                 n25q128a11
                 n25q128a13
                 n25q512a
                 s25fl256s1
                 s25fl512s
                 s25sl12801
                 s25fl008k
                 s25fl064k
                 sst25vf040b
                 m25p40
                 m25p80
                 m25p16
                 m25p32
                 m25p64
                 m25p128
                 w25x80
                 w25x32
                 w25q32
                 w25q32dw
                 w25q80bl
                 w25q128
                 w25q256

               The following chip names have been used historically to
               designate quirky versions of flash chips that do not support the
               JEDEC READ ID opcode (0x9F):
                 m25p05-nonjedec
                 m25p10-nonjedec
                 m25p20-nonjedec
                 m25p40-nonjedec
                 m25p80-nonjedec
                 m25p16-nonjedec
                 m25p32-nonjedec
                 m25p64-nonjedec
                 m25p128-nonjedec

- reg : Chip-Select number
- spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at

Optional properties:
- m25p,fast-read : Use the "fast read" opcode to read data from the chip instead
                   of the usual "read" opcode. This opcode is not supported by
                   all chips and support for it can not be detected at runtime.
                   Refer to your chips' datasheet to check if this is supported
                   by your chip.

Example:

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