Merge tag 'spi-fix-v5.3-rc3' of git://git.kernel.org/pub/scm/linux/kernel/git/broonie/spi
[linux-2.6-microblaze.git] / Documentation / arm / marvel.rst
1 ================
2 ARM Marvell SoCs
3 ================
4
5 This document lists all the ARM Marvell SoCs that are currently
6 supported in mainline by the Linux kernel. As the Marvell families of
7 SoCs are large and complex, it is hard to understand where the support
8 for a particular SoC is available in the Linux kernel. This document
9 tries to help in understanding where those SoCs are supported, and to
10 match them with their corresponding public datasheet, when available.
11
12 Orion family
13 ------------
14
15   Flavors:
16         - 88F5082
17         - 88F5181
18         - 88F5181L
19         - 88F5182
20
21                - Datasheet: http://www.embeddedarm.com/documentation/third-party/MV88F5182-datasheet.pdf
22                - Programmer's User Guide: http://www.embeddedarm.com/documentation/third-party/MV88F5182-opensource-manual.pdf
23                - User Manual: http://www.embeddedarm.com/documentation/third-party/MV88F5182-usermanual.pdf
24         - 88F5281
25
26                - Datasheet: http://www.ocmodshop.com/images/reviews/networking/qnap_ts409u/marvel_88f5281_data_sheet.pdf
27         - 88F6183
28   Core:
29         Feroceon 88fr331 (88f51xx) or 88fr531-vd (88f52xx) ARMv5 compatible
30   Linux kernel mach directory:
31         arch/arm/mach-orion5x
32   Linux kernel plat directory:
33         arch/arm/plat-orion
34
35 Kirkwood family
36 ---------------
37
38   Flavors:
39         - 88F6282 a.k.a Armada 300
40
41                 - Product Brief  : http://www.marvell.com/embedded-processors/armada-300/assets/armada_310.pdf
42         - 88F6283 a.k.a Armada 310
43
44                 - Product Brief  : http://www.marvell.com/embedded-processors/armada-300/assets/armada_310.pdf
45         - 88F6190
46
47                 - Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6190-003_WEB.pdf
48                 - Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F619x_OpenSource.pdf
49                 - Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
50         - 88F6192
51
52                 - Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6192-003_ver1.pdf
53                 - Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F619x_OpenSource.pdf
54                 - Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
55         - 88F6182
56         - 88F6180
57
58                 - Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6180-003_ver1.pdf
59                 - Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F6180_OpenSource.pdf
60                 - Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
61         - 88F6281
62
63                 - Product Brief  : http://www.marvell.com/embedded-processors/kirkwood/assets/88F6281-004_ver1.pdf
64                 - Hardware Spec  : http://www.marvell.com/embedded-processors/kirkwood/assets/HW_88F6281_OpenSource.pdf
65                 - Functional Spec: http://www.marvell.com/embedded-processors/kirkwood/assets/FS_88F6180_9x_6281_OpenSource.pdf
66   Homepage:
67         http://www.marvell.com/embedded-processors/kirkwood/
68   Core:
69         Feroceon 88fr131 ARMv5 compatible
70   Linux kernel mach directory:
71         arch/arm/mach-mvebu
72   Linux kernel plat directory:
73         none
74
75 Discovery family
76 ----------------
77
78   Flavors:
79         - MV78100
80
81                 - Product Brief  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/MV78100-003_WEB.pdf
82                 - Hardware Spec  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/HW_MV78100_OpenSource.pdf
83                 - Functional Spec: http://www.marvell.com/embedded-processors/discovery-innovation/assets/FS_MV76100_78100_78200_OpenSource.pdf
84         - MV78200
85
86                 - Product Brief  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/MV78200-002_WEB.pdf
87                 - Hardware Spec  : http://www.marvell.com/embedded-processors/discovery-innovation/assets/HW_MV78200_OpenSource.pdf
88                 - Functional Spec: http://www.marvell.com/embedded-processors/discovery-innovation/assets/FS_MV76100_78100_78200_OpenSource.pdf
89         - MV76100
90
91                 Not supported by the Linux kernel.
92
93   Core:
94         Feroceon 88fr571-vd ARMv5 compatible
95
96   Linux kernel mach directory:
97         arch/arm/mach-mv78xx0
98   Linux kernel plat directory:
99         arch/arm/plat-orion
100
101 EBU Armada family
102 -----------------
103
104   Armada 370 Flavors:
105         - 88F6710
106         - 88F6707
107         - 88F6W11
108
109     - Product Brief:   http://www.marvell.com/embedded-processors/armada-300/assets/Marvell_ARMADA_370_SoC.pdf
110     - Hardware Spec:   http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA370-datasheet.pdf
111     - Functional Spec: http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA370-FunctionalSpec-datasheet.pdf
112
113   Core:
114         Sheeva ARMv7 compatible PJ4B
115
116   Armada 375 Flavors:
117         - 88F6720
118
119     - Product Brief: http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA_375_SoC-01_product_brief.pdf
120
121   Core:
122         ARM Cortex-A9
123
124   Armada 38x Flavors:
125         - 88F6810       Armada 380
126         - 88F6820 Armada 385
127         - 88F6828 Armada 388
128
129     - Product infos:   http://www.marvell.com/embedded-processors/armada-38x/
130     - Functional Spec: https://marvellcorp.wufoo.com/forms/marvell-armada-38x-functional-specifications/
131
132   Core:
133         ARM Cortex-A9
134
135   Armada 39x Flavors:
136         - 88F6920 Armada 390
137         - 88F6928 Armada 398
138
139     - Product infos: http://www.marvell.com/embedded-processors/armada-39x/
140
141   Core:
142         ARM Cortex-A9
143
144   Armada XP Flavors:
145         - MV78230
146         - MV78260
147         - MV78460
148
149     NOTE:
150         not to be confused with the non-SMP 78xx0 SoCs
151
152     Product Brief:
153         http://www.marvell.com/embedded-processors/armada-xp/assets/Marvell-ArmadaXP-SoC-product%20brief.pdf
154
155     Functional Spec:
156         http://www.marvell.com/embedded-processors/armada-xp/assets/ARMADA-XP-Functional-SpecDatasheet.pdf
157
158     - Hardware Specs:
159
160         - http://www.marvell.com/embedded-processors/armada-xp/assets/HW_MV78230_OS.PDF
161         - http://www.marvell.com/embedded-processors/armada-xp/assets/HW_MV78260_OS.PDF
162         - http://www.marvell.com/embedded-processors/armada-xp/assets/HW_MV78460_OS.PDF
163
164   Core:
165         Sheeva ARMv7 compatible Dual-core or Quad-core PJ4B-MP
166
167   Linux kernel mach directory:
168         arch/arm/mach-mvebu
169   Linux kernel plat directory:
170         none
171
172 EBU Armada family ARMv8
173 -----------------------
174
175   Armada 3710/3720 Flavors:
176         - 88F3710
177         - 88F3720
178
179   Core:
180         ARM Cortex A53 (ARMv8)
181
182   Homepage:
183         http://www.marvell.com/embedded-processors/armada-3700/
184
185   Product Brief:
186         http://www.marvell.com/embedded-processors/assets/PB-88F3700-FNL.pdf
187
188   Device tree files:
189         arch/arm64/boot/dts/marvell/armada-37*
190
191   Armada 7K Flavors:
192           - 88F7020 (AP806 Dual + one CP110)
193           - 88F7040 (AP806 Quad + one CP110)
194
195   Core: ARM Cortex A72
196
197   Homepage:
198         http://www.marvell.com/embedded-processors/armada-70xx/
199
200   Product Brief:
201           - http://www.marvell.com/embedded-processors/assets/Armada7020PB-Jan2016.pdf
202           - http://www.marvell.com/embedded-processors/assets/Armada7040PB-Jan2016.pdf
203
204   Device tree files:
205         arch/arm64/boot/dts/marvell/armada-70*
206
207   Armada 8K Flavors:
208         - 88F8020 (AP806 Dual + two CP110)
209         - 88F8040 (AP806 Quad + two CP110)
210   Core:
211         ARM Cortex A72
212
213   Homepage:
214         http://www.marvell.com/embedded-processors/armada-80xx/
215
216   Product Brief:
217           - http://www.marvell.com/embedded-processors/assets/Armada8020PB-Jan2016.pdf
218           - http://www.marvell.com/embedded-processors/assets/Armada8040PB-Jan2016.pdf
219
220   Device tree files:
221         arch/arm64/boot/dts/marvell/armada-80*
222
223 Avanta family
224 -------------
225
226   Flavors:
227        - 88F6510
228        - 88F6530P
229        - 88F6550
230        - 88F6560
231
232   Homepage:
233         http://www.marvell.com/broadband/
234
235   Product Brief:
236         http://www.marvell.com/broadband/assets/Marvell_Avanta_88F6510_305_060-001_product_brief.pdf
237
238   No public datasheet available.
239
240   Core:
241         ARMv5 compatible
242
243   Linux kernel mach directory:
244         no code in mainline yet, planned for the future
245   Linux kernel plat directory:
246         no code in mainline yet, planned for the future
247
248 Storage family
249 --------------
250
251   Armada SP:
252         - 88RC1580
253
254   Product infos:
255         http://www.marvell.com/storage/armada-sp/
256
257   Core:
258         Sheeva ARMv7 comatible Quad-core PJ4C
259
260   (not supported in upstream Linux kernel)
261
262 Dove family (application processor)
263 -----------------------------------
264
265   Flavors:
266         - 88AP510 a.k.a Armada 510
267
268    Product Brief:
269         http://www.marvell.com/application-processors/armada-500/assets/Marvell_Armada510_SoC.pdf
270
271    Hardware Spec:
272         http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Hardware-Spec.pdf
273
274   Functional Spec:
275         http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Functional-Spec.pdf
276
277   Homepage:
278         http://www.marvell.com/application-processors/armada-500/
279
280   Core:
281         ARMv7 compatible
282
283   Directory:
284         - arch/arm/mach-mvebu (DT enabled platforms)
285         - arch/arm/mach-dove (non-DT enabled platforms)
286
287 PXA 2xx/3xx/93x/95x family
288 --------------------------
289
290   Flavors:
291         - PXA21x, PXA25x, PXA26x
292              - Application processor only
293              - Core: ARMv5 XScale1 core
294         - PXA270, PXA271, PXA272
295              - Product Brief         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_pb.pdf
296              - Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_design_guide.pdf
297              - Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_dev_man.pdf
298              - Specification         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_emts.pdf
299              - Specification update  : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_spec_update.pdf
300              - Application processor only
301              - Core: ARMv5 XScale2 core
302         - PXA300, PXA310, PXA320
303              - PXA 300 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA300_PB_R4.pdf
304              - PXA 310 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA310_PB_R4.pdf
305              - PXA 320 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA320_PB_R4.pdf
306              - Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Design_Guide.pdf
307              - Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Developers_Manual.zip
308              - Specifications        : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_EMTS.pdf
309              - Specification Update  : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Spec_Update.zip
310              - Reference Manual      : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_TavorP_BootROM_Ref_Manual.pdf
311              - Application processor only
312              - Core: ARMv5 XScale3 core
313         - PXA930, PXA935
314              - Application processor with Communication processor
315              - Core: ARMv5 XScale3 core
316         - PXA955
317              - Application processor with Communication processor
318              - Core: ARMv7 compatible Sheeva PJ4 core
319
320    Comments:
321
322     * This line of SoCs originates from the XScale family developed by
323       Intel and acquired by Marvell in ~2006. The PXA21x, PXA25x,
324       PXA26x, PXA27x, PXA3xx and PXA93x were developed by Intel, while
325       the later PXA95x were developed by Marvell.
326
327     * Due to their XScale origin, these SoCs have virtually nothing in
328       common with the other (Kirkwood, Dove, etc.) families of Marvell
329       SoCs, except with the MMP/MMP2 family of SoCs.
330
331    Linux kernel mach directory:
332         arch/arm/mach-pxa
333    Linux kernel plat directory:
334         arch/arm/plat-pxa
335
336 MMP/MMP2/MMP3 family (communication processor)
337 ----------------------------------------------
338
339    Flavors:
340         - PXA168, a.k.a Armada 168
341              - Homepage             : http://www.marvell.com/application-processors/armada-100/armada-168.jsp
342              - Product brief        : http://www.marvell.com/application-processors/armada-100/assets/pxa_168_pb.pdf
343              - Hardware manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_datasheet.pdf
344              - Software manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_software_manual.pdf
345              - Specification update : http://www.marvell.com/application-processors/armada-100/assets/ARMADA16x_Spec_update.pdf
346              - Boot ROM manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_ref_manual.pdf
347              - App node package     : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_app_note_package.pdf
348              - Application processor only
349              - Core: ARMv5 compatible Marvell PJ1 88sv331 (Mohawk)
350         - PXA910/PXA920
351              - Homepage             : http://www.marvell.com/communication-processors/pxa910/
352              - Product Brief        : http://www.marvell.com/communication-processors/pxa910/assets/Marvell_PXA910_Platform-001_PB_final.pdf
353              - Application processor with Communication processor
354              - Core: ARMv5 compatible Marvell PJ1 88sv331 (Mohawk)
355         - PXA688, a.k.a. MMP2, a.k.a Armada 610
356              - Product Brief        : http://www.marvell.com/application-processors/armada-600/assets/armada610_pb.pdf
357              - Application processor only
358              - Core: ARMv7 compatible Sheeva PJ4 88sv581x core
359         - PXA2128, a.k.a. MMP3 (OLPC XO4, Linux support not upstream)
360              - Product Brief      : http://www.marvell.com/application-processors/armada/pxa2128/assets/Marvell-ARMADA-PXA2128-SoC-PB.pdf
361              - Application processor only
362              - Core: Dual-core ARMv7 compatible Sheeva PJ4C core
363         - PXA960/PXA968/PXA978 (Linux support not upstream)
364              - Application processor with Communication Processor
365              - Core: ARMv7 compatible Sheeva PJ4 core
366         - PXA986/PXA988 (Linux support not upstream)
367              - Application processor with Communication Processor
368              - Core: Dual-core ARMv7 compatible Sheeva PJ4B-MP core
369         - PXA1088/PXA1920 (Linux support not upstream)
370              - Application processor with Communication Processor
371              - Core: quad-core ARMv7 Cortex-A7
372         - PXA1908/PXA1928/PXA1936
373              - Application processor with Communication Processor
374              - Core: multi-core ARMv8 Cortex-A53
375
376    Comments:
377
378     * This line of SoCs originates from the XScale family developed by
379       Intel and acquired by Marvell in ~2006. All the processors of
380       this MMP/MMP2 family were developed by Marvell.
381
382     * Due to their XScale origin, these SoCs have virtually nothing in
383       common with the other (Kirkwood, Dove, etc.) families of Marvell
384       SoCs, except with the PXA family of SoCs listed above.
385
386    Linux kernel mach directory:
387         arch/arm/mach-mmp
388    Linux kernel plat directory:
389         arch/arm/plat-pxa
390
391 Berlin family (Multimedia Solutions)
392 -------------------------------------
393
394   - Flavors:
395         - 88DE3010, Armada 1000 (no Linux support)
396                 - Core:         Marvell PJ1 (ARMv5TE), Dual-core
397                 - Product Brief:        http://www.marvell.com.cn/digital-entertainment/assets/armada_1000_pb.pdf
398         - 88DE3005, Armada 1500 Mini
399                 - Design name:  BG2CD
400                 - Core:         ARM Cortex-A9, PL310 L2CC
401         - 88DE3006, Armada 1500 Mini Plus
402                 - Design name:  BG2CDP
403                 - Core:         Dual Core ARM Cortex-A7
404         - 88DE3100, Armada 1500
405                 - Design name:  BG2
406                 - Core:         Marvell PJ4B-MP (ARMv7), Tauros3 L2CC
407         - 88DE3114, Armada 1500 Pro
408                 - Design name:  BG2Q
409                 - Core:         Quad Core ARM Cortex-A9, PL310 L2CC
410         - 88DE3214, Armada 1500 Pro 4K
411                 - Design name:  BG3
412                 - Core:         ARM Cortex-A15, CA15 integrated L2CC
413         - 88DE3218, ARMADA 1500 Ultra
414                 - Core:         ARM Cortex-A53
415
416   Homepage: https://www.synaptics.com/products/multimedia-solutions
417   Directory: arch/arm/mach-berlin
418
419   Comments:
420
421    * This line of SoCs is based on Marvell Sheeva or ARM Cortex CPUs
422      with Synopsys DesignWare (IRQ, GPIO, Timers, ...) and PXA IP (SDHCI, USB, ETH, ...).
423
424    * The Berlin family was acquired by Synaptics from Marvell in 2017.
425
426 CPU Cores
427 ---------
428
429 The XScale cores were designed by Intel, and shipped by Marvell in the older
430 PXA processors. Feroceon is a Marvell designed core that developed in-house,
431 and that evolved into Sheeva. The XScale and Feroceon cores were phased out
432 over time and replaced with Sheeva cores in later products, which subsequently
433 got replaced with licensed ARM Cortex-A cores.
434
435   XScale 1
436         CPUID 0x69052xxx
437         ARMv5, iWMMXt
438   XScale 2
439         CPUID 0x69054xxx
440         ARMv5, iWMMXt
441   XScale 3
442         CPUID 0x69056xxx or 0x69056xxx
443         ARMv5, iWMMXt
444   Feroceon-1850 88fr331 "Mohawk"
445         CPUID 0x5615331x or 0x41xx926x
446         ARMv5TE, single issue
447   Feroceon-2850 88fr531-vd "Jolteon"
448         CPUID 0x5605531x or 0x41xx926x
449         ARMv5TE, VFP, dual-issue
450   Feroceon 88fr571-vd "Jolteon"
451         CPUID 0x5615571x
452         ARMv5TE, VFP, dual-issue
453   Feroceon 88fr131 "Mohawk-D"
454         CPUID 0x5625131x
455         ARMv5TE, single-issue in-order
456   Sheeva PJ1 88sv331 "Mohawk"
457         CPUID 0x561584xx
458         ARMv5, single-issue iWMMXt v2
459   Sheeva PJ4 88sv581x "Flareon"
460         CPUID 0x560f581x
461         ARMv7, idivt, optional iWMMXt v2
462   Sheeva PJ4B 88sv581x
463         CPUID 0x561f581x
464         ARMv7, idivt, optional iWMMXt v2
465   Sheeva PJ4B-MP / PJ4C
466         CPUID 0x562f584x
467         ARMv7, idivt/idiva, LPAE, optional iWMMXt v2 and/or NEON
468
469 Long-term plans
470 ---------------
471
472  * Unify the mach-dove/, mach-mv78xx0/, mach-orion5x/ into the
473    mach-mvebu/ to support all SoCs from the Marvell EBU (Engineering
474    Business Unit) in a single mach-<foo> directory. The plat-orion/
475    would therefore disappear.
476
477  * Unify the mach-mmp/ and mach-pxa/ into the same mach-pxa
478    directory. The plat-pxa/ would therefore disappear.
479
480 Credits
481 -------
482
483 - Maen Suleiman <maen@marvell.com>
484 - Lior Amsalem <alior@marvell.com>
485 - Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
486 - Andrew Lunn <andrew@lunn.ch>
487 - Nicolas Pitre <nico@fluxnic.net>
488 - Eric Miao <eric.y.miao@gmail.com>