treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / Documentation / arm / marvel.rst
blob16ab2eb085b862b4684e4c2a4c33313a647690f3
1 ================
2 ARM Marvell SoCs
3 ================
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.
12 Orion family
13 ------------
15   Flavors:
16         - 88F5082
17         - 88F5181
18         - 88F5181L
19         - 88F5182
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
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
35 Kirkwood family
36 ---------------
38   Flavors:
39         - 88F6282 a.k.a Armada 300
41                 - Product Brief  : http://www.marvell.com/embedded-processors/armada-300/assets/armada_310.pdf
42         - 88F6283 a.k.a Armada 310
44                 - Product Brief  : http://www.marvell.com/embedded-processors/armada-300/assets/armada_310.pdf
45         - 88F6190
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
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
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
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
75 Discovery family
76 ----------------
78   Flavors:
79         - MV78100
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
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
91                 Not supported by the Linux kernel.
93   Core:
94         Feroceon 88fr571-vd ARMv5 compatible
96   Linux kernel mach directory:
97         arch/arm/mach-mv78xx0
98   Linux kernel plat directory:
99         arch/arm/plat-orion
101 EBU Armada family
102 -----------------
104   Armada 370 Flavors:
105         - 88F6710
106         - 88F6707
107         - 88F6W11
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
113   Core:
114         Sheeva ARMv7 compatible PJ4B
116   Armada 375 Flavors:
117         - 88F6720
119     - Product Brief: http://www.marvell.com/embedded-processors/armada-300/assets/ARMADA_375_SoC-01_product_brief.pdf
121   Core:
122         ARM Cortex-A9
124   Armada 38x Flavors:
125         - 88F6810       Armada 380
126         - 88F6820 Armada 385
127         - 88F6828 Armada 388
129     - Product infos:   http://www.marvell.com/embedded-processors/armada-38x/
130     - Functional Spec: https://marvellcorp.wufoo.com/forms/marvell-armada-38x-functional-specifications/
132   Core:
133         ARM Cortex-A9
135   Armada 39x Flavors:
136         - 88F6920 Armada 390
137         - 88F6928 Armada 398
139     - Product infos: http://www.marvell.com/embedded-processors/armada-39x/
141   Core:
142         ARM Cortex-A9
144   Armada XP Flavors:
145         - MV78230
146         - MV78260
147         - MV78460
149     NOTE:
150         not to be confused with the non-SMP 78xx0 SoCs
152     Product Brief:
153         http://www.marvell.com/embedded-processors/armada-xp/assets/Marvell-ArmadaXP-SoC-product%20brief.pdf
155     Functional Spec:
156         http://www.marvell.com/embedded-processors/armada-xp/assets/ARMADA-XP-Functional-SpecDatasheet.pdf
158     - Hardware Specs:
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
164   Core:
165         Sheeva ARMv7 compatible Dual-core or Quad-core PJ4B-MP
167   Linux kernel mach directory:
168         arch/arm/mach-mvebu
169   Linux kernel plat directory:
170         none
172 EBU Armada family ARMv8
173 -----------------------
175   Armada 3710/3720 Flavors:
176         - 88F3710
177         - 88F3720
179   Core:
180         ARM Cortex A53 (ARMv8)
182   Homepage:
183         http://www.marvell.com/embedded-processors/armada-3700/
185   Product Brief:
186         http://www.marvell.com/embedded-processors/assets/PB-88F3700-FNL.pdf
188   Device tree files:
189         arch/arm64/boot/dts/marvell/armada-37*
191   Armada 7K Flavors:
192           - 88F7020 (AP806 Dual + one CP110)
193           - 88F7040 (AP806 Quad + one CP110)
195   Core: ARM Cortex A72
197   Homepage:
198         http://www.marvell.com/embedded-processors/armada-70xx/
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
204   Device tree files:
205         arch/arm64/boot/dts/marvell/armada-70*
207   Armada 8K Flavors:
208         - 88F8020 (AP806 Dual + two CP110)
209         - 88F8040 (AP806 Quad + two CP110)
210   Core:
211         ARM Cortex A72
213   Homepage:
214         http://www.marvell.com/embedded-processors/armada-80xx/
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
220   Device tree files:
221         arch/arm64/boot/dts/marvell/armada-80*
223 Avanta family
224 -------------
226   Flavors:
227        - 88F6510
228        - 88F6530P
229        - 88F6550
230        - 88F6560
232   Homepage:
233         http://www.marvell.com/broadband/
235   Product Brief:
236         http://www.marvell.com/broadband/assets/Marvell_Avanta_88F6510_305_060-001_product_brief.pdf
238   No public datasheet available.
240   Core:
241         ARMv5 compatible
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
248 Storage family
249 --------------
251   Armada SP:
252         - 88RC1580
254   Product infos:
255         http://www.marvell.com/storage/armada-sp/
257   Core:
258         Sheeva ARMv7 comatible Quad-core PJ4C
260   (not supported in upstream Linux kernel)
262 Dove family (application processor)
263 -----------------------------------
265   Flavors:
266         - 88AP510 a.k.a Armada 510
268    Product Brief:
269         http://www.marvell.com/application-processors/armada-500/assets/Marvell_Armada510_SoC.pdf
271    Hardware Spec:
272         http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Hardware-Spec.pdf
274   Functional Spec:
275         http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Functional-Spec.pdf
277   Homepage:
278         http://www.marvell.com/application-processors/armada-500/
280   Core:
281         ARMv7 compatible
283   Directory:
284         - arch/arm/mach-mvebu (DT enabled platforms)
285         - arch/arm/mach-dove (non-DT enabled platforms)
287 PXA 2xx/3xx/93x/95x family
288 --------------------------
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
320    Comments:
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.
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.
331    Linux kernel mach directory:
332         arch/arm/mach-pxa
333    Linux kernel plat directory:
334         arch/arm/plat-pxa
336 MMP/MMP2/MMP3 family (communication processor)
337 ----------------------------------------------
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
376    Comments:
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.
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.
386    Linux kernel mach directory:
387         arch/arm/mach-mmp
388    Linux kernel plat directory:
389         arch/arm/plat-pxa
391 Berlin family (Multimedia Solutions)
392 -------------------------------------
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
416   Homepage: https://www.synaptics.com/products/multimedia-solutions
417   Directory: arch/arm/mach-berlin
419   Comments:
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, ...).
424    * The Berlin family was acquired by Synaptics from Marvell in 2017.
426 CPU Cores
427 ---------
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.
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
469 Long-term plans
470 ---------------
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.
477  * Unify the mach-mmp/ and mach-pxa/ into the same mach-pxa
478    directory. The plat-pxa/ would therefore disappear.
480 Credits
481 -------
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>