Merge tag 'imx-soc-3.17' of git://git.kernel.org/pub/scm/linux/kernel/git/shawnguo...
[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-kirkwood
57   Linux kernel plat directory: arch/arm/plat-orion
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
106   No public datasheet available.
107
108   Core: Sheeva ARMv7 compatible
109
110   Linux kernel mach directory: arch/arm/mach-mvebu
111   Linux kernel plat directory: none
112
113 Avanta family
114 -------------
115
116   Flavors:
117        88F6510
118        88F6530P
119        88F6550
120        88F6560
121   Homepage     : http://www.marvell.com/broadband/
122   Product Brief: http://www.marvell.com/broadband/assets/Marvell_Avanta_88F6510_305_060-001_product_brief.pdf
123   No public datasheet available.
124
125   Core: ARMv5 compatible
126
127   Linux kernel mach directory: no code in mainline yet, planned for the future
128   Linux kernel plat directory: no code in mainline yet, planned for the future
129
130 Dove family (application processor)
131 -----------------------------------
132
133   Flavors:
134         88AP510 a.k.a Armada 510
135                 Product Brief   : http://www.marvell.com/application-processors/armada-500/assets/Marvell_Armada510_SoC.pdf
136                 Hardware Spec   : http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Hardware-Spec.pdf
137                 Functional Spec : http://www.marvell.com/application-processors/armada-500/assets/Armada-510-Functional-Spec.pdf
138   Homepage: http://www.marvell.com/application-processors/armada-500/
139   Core: ARMv7 compatible
140   Directory: arch/arm/mach-dove
141
142 PXA 2xx/3xx/93x/95x family
143 --------------------------
144
145   Flavors:
146         PXA21x, PXA25x, PXA26x
147              Application processor only
148              Core: ARMv5 XScale core
149         PXA270, PXA271, PXA272
150              Product Brief         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_pb.pdf
151              Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_design_guide.pdf
152              Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_dev_man.pdf
153              Specification         : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_emts.pdf
154              Specification update  : http://www.marvell.com/application-processors/pxa-family/assets/pxa_27x_spec_update.pdf
155              Application processor only
156              Core: ARMv5 XScale core
157         PXA300, PXA310, PXA320
158              PXA 300 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA300_PB_R4.pdf
159              PXA 310 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA310_PB_R4.pdf
160              PXA 320 Product Brief : http://www.marvell.com/application-processors/pxa-family/assets/PXA320_PB_R4.pdf
161              Design guide          : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Design_Guide.pdf
162              Developers manual     : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Developers_Manual.zip
163              Specifications        : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_EMTS.pdf
164              Specification Update  : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_Spec_Update.zip
165              Reference Manual      : http://www.marvell.com/application-processors/pxa-family/assets/PXA3xx_TavorP_BootROM_Ref_Manual.pdf
166              Application processor only
167              Core: ARMv5 XScale core
168         PXA930, PXA935
169              Application processor with Communication processor
170              Core: ARMv5 XScale core
171         PXA955
172              Application processor with Communication processor
173              Core: ARMv7 compatible Sheeva PJ4 core
174
175    Comments:
176
177     * This line of SoCs originates from the XScale family developed by
178       Intel and acquired by Marvell in ~2006. The PXA21x, PXA25x,
179       PXA26x, PXA27x, PXA3xx and PXA93x were developed by Intel, while
180       the later PXA95x were developed by Marvell.
181
182     * Due to their XScale origin, these SoCs have virtually nothing in
183       common with the other (Kirkwood, Dove, etc.) families of Marvell
184       SoCs, except with the MMP/MMP2 family of SoCs.
185
186    Linux kernel mach directory: arch/arm/mach-pxa
187    Linux kernel plat directory: arch/arm/plat-pxa
188
189 MMP/MMP2 family (communication processor)
190 -----------------------------------------
191
192    Flavors:
193         PXA168, a.k.a Armada 168
194              Homepage             : http://www.marvell.com/application-processors/armada-100/armada-168.jsp
195              Product brief        : http://www.marvell.com/application-processors/armada-100/assets/pxa_168_pb.pdf
196              Hardware manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_datasheet.pdf
197              Software manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_software_manual.pdf
198              Specification update : http://www.marvell.com/application-processors/armada-100/assets/ARMADA16x_Spec_update.pdf
199              Boot ROM manual      : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_ref_manual.pdf
200              App node package     : http://www.marvell.com/application-processors/armada-100/assets/armada_16x_app_note_package.pdf
201              Application processor only
202              Core: ARMv5 compatible Marvell PJ1 (Mohawk)
203         PXA910
204              Homepage             : http://www.marvell.com/communication-processors/pxa910/
205              Product Brief        : http://www.marvell.com/communication-processors/pxa910/assets/Marvell_PXA910_Platform-001_PB_final.pdf
206              Application processor with Communication processor
207              Core: ARMv5 compatible Marvell PJ1 (Mohawk)
208         MMP2, a.k.a Armada 610
209              Product Brief        : http://www.marvell.com/application-processors/armada-600/assets/armada610_pb.pdf
210              Application processor only
211              Core: ARMv7 compatible Sheeva PJ4 core
212
213    Comments:
214
215     * This line of SoCs originates from the XScale family developed by
216       Intel and acquired by Marvell in ~2006. All the processors of
217       this MMP/MMP2 family were developed by Marvell.
218
219     * Due to their XScale origin, these SoCs have virtually nothing in
220       common with the other (Kirkwood, Dove, etc.) families of Marvell
221       SoCs, except with the PXA family of SoCs listed above.
222
223    Linux kernel mach directory: arch/arm/mach-mmp
224    Linux kernel plat directory: arch/arm/plat-pxa
225
226 Berlin family (Digital Entertainment)
227 -------------------------------------
228
229   Flavors:
230         88DE3005, Armada 1500-mini
231                 Design name:    BG2CD
232                 Core:           ARM Cortex-A9, PL310 L2CC
233                 Homepage:       http://www.marvell.com/digital-entertainment/armada-1500-mini/
234         88DE3100, Armada 1500
235                 Design name:    BG2
236                 Core:           Marvell PJ4B (ARMv7), Tauros3 L2CC
237                 Homepage:       http://www.marvell.com/digital-entertainment/armada-1500/
238                 Product Brief:  http://www.marvell.com/digital-entertainment/armada-1500/assets/Marvell-ARMADA-1500-Product-Brief.pdf
239         88DE3114, Armada 1500 Pro
240                 Design name:    BG2-Q
241                 Core:           Quad Core ARM Cortex-A9, PL310 L2CC
242                 Homepage:       http://www.marvell.com/digital-entertainment/armada-1500-pro/
243                 Product Brief:  http://www.marvell.com/digital-entertainment/armada-1500-pro/assets/Marvell_ARMADA_1500_PRO-01_product_brief.pdf
244         88DE????
245                 Design name:    BG3
246                 Core:           ARM Cortex-A15, CA15 integrated L2CC
247
248   Homepage: http://www.marvell.com/digital-entertainment/
249   Directory: arch/arm/mach-berlin
250
251   Comments:
252    * This line of SoCs is based on Marvell Sheeva or ARM Cortex CPUs
253      with Synopsys DesignWare (IRQ, GPIO, Timers, ...) and PXA IP (SDHCI, USB, ETH, ...).
254
255 Long-term plans
256 ---------------
257
258  * Unify the mach-dove/, mach-mv78xx0/, mach-orion5x/ and
259    mach-kirkwood/ into the mach-mvebu/ to support all SoCs from the
260    Marvell EBU (Engineering Business Unit) in a single mach-<foo>
261    directory. The plat-orion/ would therefore disappear.
262
263  * Unify the mach-mmp/ and mach-pxa/ into the same mach-pxa
264    directory. The plat-pxa/ would therefore disappear.
265
266 Credits
267 -------
268
269  Maen Suleiman <maen@marvell.com>
270  Lior Amsalem <alior@marvell.com>
271  Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
272  Andrew Lunn <andrew@lunn.ch>
273  Nicolas Pitre <nico@fluxnic.net>
274  Eric Miao <eric.y.miao@gmail.com>