Merge tag 'amdtee-fixes-for-v5.13' of git://git.linaro.org/people/jens.wiklander...
[linux-2.6-microblaze.git] / Documentation / arm / marvell.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: http://www.marvell.com/content/dam/marvell/en/public-collateral/embedded-processors/marvell-embedded-processors-armada-38x-functional-specifications-2015-11.pdf
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/content/dam/marvell/en/public-collateral/embedded-processors/marvell-embedded-processors-armada-37xx-product-brief-2016-01.pdf
187
188   Hardware Spec:
189         http://www.marvell.com/content/dam/marvell/en/public-collateral/embedded-processors/marvell-embedded-processors-armada-37xx-hardware-specifications-2019-09.pdf
190
191   Device tree files:
192         arch/arm64/boot/dts/marvell/armada-37*
193
194   Armada 7K Flavors:
195           - 88F7020 (AP806 Dual + one CP110)
196           - 88F7040 (AP806 Quad + one CP110)
197
198   Core: ARM Cortex A72
199
200   Homepage:
201         http://www.marvell.com/embedded-processors/armada-70xx/
202
203   Product Brief:
204           - http://www.marvell.com/embedded-processors/assets/Armada7020PB-Jan2016.pdf
205           - http://www.marvell.com/embedded-processors/assets/Armada7040PB-Jan2016.pdf
206
207   Device tree files:
208         arch/arm64/boot/dts/marvell/armada-70*
209
210   Armada 8K Flavors:
211         - 88F8020 (AP806 Dual + two CP110)
212         - 88F8040 (AP806 Quad + two CP110)
213   Core:
214         ARM Cortex A72
215
216   Homepage:
217         http://www.marvell.com/embedded-processors/armada-80xx/
218
219   Product Brief:
220           - http://www.marvell.com/embedded-processors/assets/Armada8020PB-Jan2016.pdf
221           - http://www.marvell.com/embedded-processors/assets/Armada8040PB-Jan2016.pdf
222
223   Device tree files:
224         arch/arm64/boot/dts/marvell/armada-80*
225
226 Avanta family
227 -------------
228
229   Flavors:
230        - 88F6510
231        - 88F6530P
232        - 88F6550
233        - 88F6560
234
235   Homepage:
236         http://www.marvell.com/broadband/
237
238   Product Brief:
239         http://www.marvell.com/broadband/assets/Marvell_Avanta_88F6510_305_060-001_product_brief.pdf
240
241   No public datasheet available.
242
243   Core:
244         ARMv5 compatible
245
246   Linux kernel mach directory:
247         no code in mainline yet, planned for the future
248   Linux kernel plat directory:
249         no code in mainline yet, planned for the future
250
251 Storage family
252 --------------
253
254   Armada SP:
255         - 88RC1580
256
257   Product infos:
258         http://www.marvell.com/storage/armada-sp/
259
260   Core:
261         Sheeva ARMv7 comatible Quad-core PJ4C
262
263   (not supported in upstream Linux kernel)
264
265 Dove family (application processor)
266 -----------------------------------
267
268   Flavors:
269         - 88AP510 a.k.a Armada 510
270
271    Product Brief:
272         http://www.marvell.com/application-processors/armada-500/assets/Marvell_Armada510_SoC.pdf
273
274    Hardware Spec:
275         http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Hardware-Spec.pdf
276
277   Functional Spec:
278         http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Functional-Spec.pdf
279
280   Homepage:
281         http://www.marvell.com/application-processors/armada-500/
282
283   Core:
284         ARMv7 compatible
285
286   Directory:
287         - arch/arm/mach-mvebu (DT enabled platforms)
288         - arch/arm/mach-dove (non-DT enabled platforms)
289
290 PXA 2xx/3xx/93x/95x family
291 --------------------------
292
293   Flavors:
294         - PXA21x, PXA25x, PXA26x
295              - Application processor only
296              - Core: ARMv5 XScale1 core
297         - PXA270, PXA271, PXA272
298              - Product Brief         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_pb.pdf
299              - Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_design_guide.pdf
300              - Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_dev_man.pdf
301              - Specification         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_emts.pdf
302              - Specification update  : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_spec_update.pdf
303              - Application processor only
304              - Core: ARMv5 XScale2 core
305         - PXA300, PXA310, PXA320
306              - PXA 300 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA300_PB_R4.pdf
307              - PXA 310 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA310_PB_R4.pdf
308              - PXA 320 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA320_PB_R4.pdf
309              - Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Design_Guide.pdf
310              - Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Developers_Manual.zip
311              - Specifications        : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_EMTS.pdf
312              - Specification Update  : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Spec_Update.zip
313              - Reference Manual      : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_TavorP_BootROM_Ref_Manual.pdf
314              - Application processor only
315              - Core: ARMv5 XScale3 core
316         - PXA930, PXA935
317              - Application processor with Communication processor
318              - Core: ARMv5 XScale3 core
319         - PXA955
320              - Application processor with Communication processor
321              - Core: ARMv7 compatible Sheeva PJ4 core
322
323    Comments:
324
325     * This line of SoCs originates from the XScale family developed by
326       Intel and acquired by Marvell in ~2006. The PXA21x, PXA25x,
327       PXA26x, PXA27x, PXA3xx and PXA93x were developed by Intel, while
328       the later PXA95x were developed by Marvell.
329
330     * Due to their XScale origin, these SoCs have virtually nothing in
331       common with the other (Kirkwood, Dove, etc.) families of Marvell
332       SoCs, except with the MMP/MMP2 family of SoCs.
333
334    Linux kernel mach directory:
335         arch/arm/mach-pxa
336    Linux kernel plat directory:
337         arch/arm/plat-pxa
338
339 MMP/MMP2/MMP3 family (communication processor)
340 ----------------------------------------------
341
342    Flavors:
343         - PXA168, a.k.a Armada 168
344              - Homepage             : http://www.marvell.com/application-processors/armada-100/armada-168.jsp
345              - Product brief        : http://www.marvell.com/application-processors/armada-100/assets/pxa_168_pb.pdf
346              - Hardware manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_datasheet.pdf
347              - Software manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_software_manual.pdf
348              - Specification update : http://www.marvell.com/application-processors/armada-100/assets/ARMADA16x_Spec_update.pdf
349              - Boot ROM manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_ref_manual.pdf
350              - App node package     : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_app_note_package.pdf
351              - Application processor only
352              - Core: ARMv5 compatible Marvell PJ1 88sv331 (Mohawk)
353         - PXA910/PXA920
354              - Homepage             : http://www.marvell.com/communication-processors/pxa910/
355              - Product Brief        : http://www.marvell.com/communication-processors/pxa910/assets/Marvell_PXA910_Platform-001_PB_final.pdf
356              - Application processor with Communication processor
357              - Core: ARMv5 compatible Marvell PJ1 88sv331 (Mohawk)
358         - PXA688, a.k.a. MMP2, a.k.a Armada 610
359              - Product Brief        : http://www.marvell.com/application-processors/armada-600/assets/armada610_pb.pdf
360              - Application processor only
361              - Core: ARMv7 compatible Sheeva PJ4 88sv581x core
362         - PXA2128, a.k.a. MMP3 (OLPC XO4, Linux support not upstream)
363              - Product Brief      : http://www.marvell.com/application-processors/armada/pxa2128/assets/Marvell-ARMADA-PXA2128-SoC-PB.pdf
364              - Application processor only
365              - Core: Dual-core ARMv7 compatible Sheeva PJ4C core
366         - PXA960/PXA968/PXA978 (Linux support not upstream)
367              - Application processor with Communication Processor
368              - Core: ARMv7 compatible Sheeva PJ4 core
369         - PXA986/PXA988 (Linux support not upstream)
370              - Application processor with Communication Processor
371              - Core: Dual-core ARMv7 compatible Sheeva PJ4B-MP core
372         - PXA1088/PXA1920 (Linux support not upstream)
373              - Application processor with Communication Processor
374              - Core: quad-core ARMv7 Cortex-A7
375         - PXA1908/PXA1928/PXA1936
376              - Application processor with Communication Processor
377              - Core: multi-core ARMv8 Cortex-A53
378
379    Comments:
380
381     * This line of SoCs originates from the XScale family developed by
382       Intel and acquired by Marvell in ~2006. All the processors of
383       this MMP/MMP2 family were developed by Marvell.
384
385     * Due to their XScale origin, these SoCs have virtually nothing in
386       common with the other (Kirkwood, Dove, etc.) families of Marvell
387       SoCs, except with the PXA family of SoCs listed above.
388
389    Linux kernel mach directory:
390         arch/arm/mach-mmp
391    Linux kernel plat directory:
392         arch/arm/plat-pxa
393
394 Berlin family (Multimedia Solutions)
395 -------------------------------------
396
397   - Flavors:
398         - 88DE3010, Armada 1000 (no Linux support)
399                 - Core:         Marvell PJ1 (ARMv5TE), Dual-core
400                 - Product Brief:        http://www.marvell.com.cn/digital-entertainment/assets/armada_1000_pb.pdf
401         - 88DE3005, Armada 1500 Mini
402                 - Design name:  BG2CD
403                 - Core:         ARM Cortex-A9, PL310 L2CC
404         - 88DE3006, Armada 1500 Mini Plus
405                 - Design name:  BG2CDP
406                 - Core:         Dual Core ARM Cortex-A7
407         - 88DE3100, Armada 1500
408                 - Design name:  BG2
409                 - Core:         Marvell PJ4B-MP (ARMv7), Tauros3 L2CC
410         - 88DE3114, Armada 1500 Pro
411                 - Design name:  BG2Q
412                 - Core:         Quad Core ARM Cortex-A9, PL310 L2CC
413         - 88DE3214, Armada 1500 Pro 4K
414                 - Design name:  BG3
415                 - Core:         ARM Cortex-A15, CA15 integrated L2CC
416         - 88DE3218, ARMADA 1500 Ultra
417                 - Core:         ARM Cortex-A53
418
419   Homepage: https://www.synaptics.com/products/multimedia-solutions
420   Directory: arch/arm/mach-berlin
421
422   Comments:
423
424    * This line of SoCs is based on Marvell Sheeva or ARM Cortex CPUs
425      with Synopsys DesignWare (IRQ, GPIO, Timers, ...) and PXA IP (SDHCI, USB, ETH, ...).
426
427    * The Berlin family was acquired by Synaptics from Marvell in 2017.
428
429 CPU Cores
430 ---------
431
432 The XScale cores were designed by Intel, and shipped by Marvell in the older
433 PXA processors. Feroceon is a Marvell designed core that developed in-house,
434 and that evolved into Sheeva. The XScale and Feroceon cores were phased out
435 over time and replaced with Sheeva cores in later products, which subsequently
436 got replaced with licensed ARM Cortex-A cores.
437
438   XScale 1
439         CPUID 0x69052xxx
440         ARMv5, iWMMXt
441   XScale 2
442         CPUID 0x69054xxx
443         ARMv5, iWMMXt
444   XScale 3
445         CPUID 0x69056xxx or 0x69056xxx
446         ARMv5, iWMMXt
447   Feroceon-1850 88fr331 "Mohawk"
448         CPUID 0x5615331x or 0x41xx926x
449         ARMv5TE, single issue
450   Feroceon-2850 88fr531-vd "Jolteon"
451         CPUID 0x5605531x or 0x41xx926x
452         ARMv5TE, VFP, dual-issue
453   Feroceon 88fr571-vd "Jolteon"
454         CPUID 0x5615571x
455         ARMv5TE, VFP, dual-issue
456   Feroceon 88fr131 "Mohawk-D"
457         CPUID 0x5625131x
458         ARMv5TE, single-issue in-order
459   Sheeva PJ1 88sv331 "Mohawk"
460         CPUID 0x561584xx
461         ARMv5, single-issue iWMMXt v2
462   Sheeva PJ4 88sv581x "Flareon"
463         CPUID 0x560f581x
464         ARMv7, idivt, optional iWMMXt v2
465   Sheeva PJ4B 88sv581x
466         CPUID 0x561f581x
467         ARMv7, idivt, optional iWMMXt v2
468   Sheeva PJ4B-MP / PJ4C
469         CPUID 0x562f584x
470         ARMv7, idivt/idiva, LPAE, optional iWMMXt v2 and/or NEON
471
472 Long-term plans
473 ---------------
474
475  * Unify the mach-dove/, mach-mv78xx0/, mach-orion5x/ into the
476    mach-mvebu/ to support all SoCs from the Marvell EBU (Engineering
477    Business Unit) in a single mach-<foo> directory. The plat-orion/
478    would therefore disappear.
479
480  * Unify the mach-mmp/ and mach-pxa/ into the same mach-pxa
481    directory. The plat-pxa/ would therefore disappear.
482
483 Credits
484 -------
485
486 - Maen Suleiman <maen@marvell.com>
487 - Lior Amsalem <alior@marvell.com>
488 - Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
489 - Andrew Lunn <andrew@lunn.ch>
490 - Nicolas Pitre <nico@fluxnic.net>
491 - Eric Miao <eric.y.miao@gmail.com>