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