summaryrefslogtreecommitdiff
path: root/Documentation/mtd/spi-nor.txt
blob: 294d5b06f892bd8d3ef0fb97797267b699f597d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
                          SPI NOR framework
               ============================================

Part I - why we need this framework?
-------------------------------------

The SPI bus controller only deals with the byte stream.
Some controller does not works like a SPI bus controller, it works
like a SPI NOR controller instead, such as the Freescale's QuadSPI controller.

The Freescale's QuadSPI controller should know the NOR commands to
find the right LUT sequence. Unfortunately, the old code can not meet
this requirement.

Part II - How does the framework work?
-------------------------------------

This framework just adds a new layer between the MTD and the SPI bus driver.
With this new layer, the SPI NOR controller driver does not depend on the
m25p80 code anymore.

   Before this framework, the layer is like:

                   MTD
         ------------------------
                  m25p80
         ------------------------
	       SPI bus driver
         ------------------------
	        SPI NOR chip

   After this framework, the layer is like:
                   MTD
         ------------------------
              SPI NOR framework
         ------------------------
                  m25p80
         ------------------------
	       SPI bus driver
         ------------------------
	       SPI NOR chip

  With the SPI NOR controller driver(Freescale QuadSPI), it looks like:
                   MTD
         ------------------------
              SPI NOR framework
         ------------------------
                fsl-quadSPI
         ------------------------
	       SPI NOR chip

Part III - How can the drivers use the framework
-------------------------------------

The main API is the spi_nor_scan(). Before you call the hook, you should
initialize the necessary fields for spi_nor{}.
Please see the drivers/mtd/spi-nor/spi-nor.c for detail.
Please also reference to the fsl-quadspi.c when you want to write a new driver
for a SPI NOR controller.