Merge tag 'dmaengine-3.17' of git://git.kernel.org/pub/scm/linux/kernel/git/djbw...
[firefly-linux-kernel-4.4.55.git] / Documentation / arm / Marvell / README
1 ARM Marvell SoCs
2 ================
3
4 This document lists all the ARM Marvell SoCs that are currently
5 supported in mainline by the Linux kernel. As the Marvell families of
6 SoCs are large and complex, it is hard to understand where the support
7 for a particular SoC is available in the Linux kernel. This document
8 tries to help in understanding where those SoCs are supported, and to
9 match them with their corresponding public datasheet, when available.
10
11 Orion family
12 ------------
13
14   Flavors:
15         88F5082
16         88F5181
17         88F5181L
18         88F5182
19                Datasheet               : http://www.embeddedarm.com/documentation/third-party/MV88F5182-datasheet.pdf
20                Programmer's User Guide : http://www.embeddedarm.com/documentation/third-party/MV88F5182-opensource-manual.pdf
21                User Manual             : http://www.embeddedarm.com/documentation/third-party/MV88F5182-usermanual.pdf
22         88F5281
23                Datasheet               : http://www.ocmodshop.com/images/reviews/networking/qnap_ts409u/marvel_88f5281_data_sheet.pdf
24         88F6183
25   Core: Feroceon ARMv5 compatible
26   Linux kernel mach directory: arch/arm/mach-orion5x
27   Linux kernel plat directory: arch/arm/plat-orion
28
29 Kirkwood family
30 ---------------
31
32   Flavors:
33         88F6282 a.k.a Armada 300
34                 Product Brief  : http://www.marvell.com/embedded-processors/armada-300/assets/armada_310.pdf
35         88F6283 a.k.a Armada 310
36                 Product Brief  : http://www.marvell.com/embedded-processors/armada-300/assets/armada_310.pdf
37         88F6190
38                 Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6190-003_WEB.pdf
39                 Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F619x_OpenSource.pdf
40                 Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
41         88F6192
42                 Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6192-003_ver1.pdf
43                 Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F619x_OpenSource.pdf
44                 Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
45         88F6182
46         88F6180
47                 Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6180-003_ver1.pdf
48                 Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F6180_OpenSource.pdf
49                 Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
50         88F6281
51                 Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6281-004_ver1.pdf
52                 Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F6281_OpenSource.pdf
53                 Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
54   Homepage: http://www.marvell.com/embedded-processors/kirkwood/
55   Core: Feroceon ARMv5 compatible
56   Linux kernel mach directory: arch/arm/mach-mvebu
57   Linux kernel plat directory: none
58
59 Discovery family
60 ----------------
61
62   Flavors:
63         MV78100
64                 Product Brief  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/MV78100-003_WEB.pdf
65                 Hardware Spec  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/HW_MV78100_OpenSource.pdf
66                 Functional Spec: http://www.marvell.com/embedded-processors/discovery-innovation/assets/FS_MV76100_78100_78200_OpenSource.pdf
67         MV78200
68                 Product Brief  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/MV78200-002_WEB.pdf
69                 Hardware Spec  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/HW_MV78200_OpenSource.pdf
70                 Functional Spec: http://www.marvell.com/embedded-processors/discovery-innovation/assets/FS_MV76100_78100_78200_OpenSource.pdf
71         MV76100
72                 Not supported by the Linux kernel.
73
74   Core: Feroceon ARMv5 compatible
75
76   Linux kernel mach directory: arch/arm/mach-mv78xx0
77   Linux kernel plat directory: arch/arm/plat-orion
78
79 EBU Armada family
80 -----------------
81
82   Armada 370 Flavors:
83         88F6710
84         88F6707
85         88F6W11
86     Product Brief:   http://www.marvell.com/embedded-processors/armada-300/assets/Marvell_ARMADA_370_SoC.pdf
87     Hardware Spec:   http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA370-datasheet.pdf
88     Functional Spec: http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA370-FunctionalSpec-datasheet.pdf
89
90   Armada 375 Flavors:
91         88F6720
92     Product Brief: http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA_375_SoC-01_product_brief.pdf
93
94   Armada 380/385 Flavors:
95         88F6810
96         88F6820
97         88F6828
98
99   Armada XP Flavors:
100         MV78230
101         MV78260
102         MV78460
103     NOTE: not to be confused with the non-SMP 78xx0 SoCs
104     Product Brief: http://www.marvell.com/embedded-processors/armada-xp/assets/Marvell-ArmadaXP-SoC-product%20brief.pdf
105     Functional Spec: http://www.marvell.com/embedded-processors/armada-xp/assets/ARMADA-XP-Functional-SpecDatasheet.pdf
106
107   Core: Sheeva ARMv7 compatible
108
109   Linux kernel mach directory: arch/arm/mach-mvebu
110   Linux kernel plat directory: none
111
112 Avanta family
113 -------------
114
115   Flavors:
116        88F6510
117        88F6530P
118        88F6550
119        88F6560
120   Homepage     : http://www.marvell.com/broadband/
121   Product Brief: http://www.marvell.com/broadband/assets/Marvell_Avanta_88F6510_305_060-001_product_brief.pdf
122   No public datasheet available.
123
124   Core: ARMv5 compatible
125
126   Linux kernel mach directory: no code in mainline yet, planned for the future
127   Linux kernel plat directory: no code in mainline yet, planned for the future
128
129 Dove family (application processor)
130 -----------------------------------
131
132   Flavors:
133         88AP510 a.k.a Armada 510
134                 Product Brief   : http://www.marvell.com/application-processors/armada-500/assets/Marvell_Armada510_SoC.pdf
135                 Hardware Spec   : http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Hardware-Spec.pdf
136                 Functional Spec : http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Functional-Spec.pdf
137   Homepage: http://www.marvell.com/application-processors/armada-500/
138   Core: ARMv7 compatible
139
140   Directory: arch/arm/mach-mvebu (DT enabled platforms)
141              arch/arm/mach-dove (non-DT enabled platforms)
142
143 PXA 2xx/3xx/93x/95x family
144 --------------------------
145
146   Flavors:
147         PXA21x, PXA25x, PXA26x
148              Application processor only
149              Core: ARMv5 XScale core
150         PXA270, PXA271, PXA272
151              Product Brief         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_pb.pdf
152              Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_design_guide.pdf
153              Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_dev_man.pdf
154              Specification         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_emts.pdf
155              Specification update  : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_spec_update.pdf
156              Application processor only
157              Core: ARMv5 XScale core
158         PXA300, PXA310, PXA320
159              PXA 300 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA300_PB_R4.pdf
160              PXA 310 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA310_PB_R4.pdf
161              PXA 320 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA320_PB_R4.pdf
162              Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Design_Guide.pdf
163              Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Developers_Manual.zip
164              Specifications        : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_EMTS.pdf
165              Specification Update  : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Spec_Update.zip
166              Reference Manual      : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_TavorP_BootROM_Ref_Manual.pdf
167              Application processor only
168              Core: ARMv5 XScale core
169         PXA930, PXA935
170              Application processor with Communication processor
171              Core: ARMv5 XScale core
172         PXA955
173              Application processor with Communication processor
174              Core: ARMv7 compatible Sheeva PJ4 core
175
176    Comments:
177
178     * This line of SoCs originates from the XScale family developed by
179       Intel and acquired by Marvell in ~2006. The PXA21x, PXA25x,
180       PXA26x, PXA27x, PXA3xx and PXA93x were developed by Intel, while
181       the later PXA95x were developed by Marvell.
182
183     * Due to their XScale origin, these SoCs have virtually nothing in
184       common with the other (Kirkwood, Dove, etc.) families of Marvell
185       SoCs, except with the MMP/MMP2 family of SoCs.
186
187    Linux kernel mach directory: arch/arm/mach-pxa
188    Linux kernel plat directory: arch/arm/plat-pxa
189
190 MMP/MMP2 family (communication processor)
191 -----------------------------------------
192
193    Flavors:
194         PXA168, a.k.a Armada 168
195              Homepage             : http://www.marvell.com/application-processors/armada-100/armada-168.jsp
196              Product brief        : http://www.marvell.com/application-processors/armada-100/assets/pxa_168_pb.pdf
197              Hardware manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_datasheet.pdf
198              Software manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_software_manual.pdf
199              Specification update : http://www.marvell.com/application-processors/armada-100/assets/ARMADA16x_Spec_update.pdf
200              Boot ROM manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_ref_manual.pdf
201              App node package     : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_app_note_package.pdf
202              Application processor only
203              Core: ARMv5 compatible Marvell PJ1 (Mohawk)
204         PXA910
205              Homepage             : http://www.marvell.com/communication-processors/pxa910/
206              Product Brief        : http://www.marvell.com/communication-processors/pxa910/assets/Marvell_PXA910_Platform-001_PB_final.pdf
207              Application processor with Communication processor
208              Core: ARMv5 compatible Marvell PJ1 (Mohawk)
209         MMP2, a.k.a Armada 610
210              Product Brief        : http://www.marvell.com/application-processors/armada-600/assets/armada610_pb.pdf
211              Application processor only
212              Core: ARMv7 compatible Sheeva PJ4 core
213
214    Comments:
215
216     * This line of SoCs originates from the XScale family developed by
217       Intel and acquired by Marvell in ~2006. All the processors of
218       this MMP/MMP2 family were developed by Marvell.
219
220     * Due to their XScale origin, these SoCs have virtually nothing in
221       common with the other (Kirkwood, Dove, etc.) families of Marvell
222       SoCs, except with the PXA family of SoCs listed above.
223
224    Linux kernel mach directory: arch/arm/mach-mmp
225    Linux kernel plat directory: arch/arm/plat-pxa
226
227 Berlin family (Digital Entertainment)
228 -------------------------------------
229
230   Flavors:
231         88DE3005, Armada 1500-mini
232                 Design name:    BG2CD
233                 Core:           ARM Cortex-A9, PL310 L2CC
234                 Homepage:       http://www.marvell.com/digital-entertainment/armada-1500-mini/
235         88DE3100, Armada 1500
236                 Design name:    BG2
237                 Core:           Marvell PJ4B (ARMv7), Tauros3 L2CC
238                 Homepage:       http://www.marvell.com/digital-entertainment/armada-1500/
239                 Product Brief:  http://www.marvell.com/digital-entertainment/armada-1500/assets/Marvell-ARMADA-1500-Product-Brief.pdf
240         88DE3114, Armada 1500 Pro
241                 Design name:    BG2-Q
242                 Core:           Quad Core ARM Cortex-A9, PL310 L2CC
243                 Homepage:       http://www.marvell.com/digital-entertainment/armada-1500-pro/
244                 Product Brief:  http://www.marvell.com/digital-entertainment/armada-1500-pro/assets/Marvell_ARMADA_1500_PRO-01_product_brief.pdf
245         88DE????
246                 Design name:    BG3
247                 Core:           ARM Cortex-A15, CA15 integrated L2CC
248
249   Homepage: http://www.marvell.com/digital-entertainment/
250   Directory: arch/arm/mach-berlin
251
252   Comments:
253    * This line of SoCs is based on Marvell Sheeva or ARM Cortex CPUs
254      with Synopsys DesignWare (IRQ, GPIO, Timers, ...) and PXA IP (SDHCI, USB, ETH, ...).
255
256 Long-term plans
257 ---------------
258
259  * Unify the mach-dove/, mach-mv78xx0/, mach-orion5x/ into the
260    mach-mvebu/ to support all SoCs from the Marvell EBU (Engineering
261    Business Unit) in a single mach-<foo> directory. The plat-orion/
262    would therefore disappear.
263
264  * Unify the mach-mmp/ and mach-pxa/ into the same mach-pxa
265    directory. The plat-pxa/ would therefore disappear.
266
267 Credits
268 -------
269
270  Maen Suleiman <maen@marvell.com>
271  Lior Amsalem <alior@marvell.com>
272  Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
273  Andrew Lunn <andrew@lunn.ch>
274  Nicolas Pitre <nico@fluxnic.net>
275  Eric Miao <eric.y.miao@gmail.com>