18c2ecf20Sopenharmony_ci========================
28c2ecf20Sopenharmony_ciSPEAr ARM Linux Overview
38c2ecf20Sopenharmony_ci========================
48c2ecf20Sopenharmony_ci
58c2ecf20Sopenharmony_ciIntroduction
68c2ecf20Sopenharmony_ci------------
78c2ecf20Sopenharmony_ci
88c2ecf20Sopenharmony_ci  SPEAr (Structured Processor Enhanced Architecture).
98c2ecf20Sopenharmony_ci  weblink : http://www.st.com/spear
108c2ecf20Sopenharmony_ci
118c2ecf20Sopenharmony_ci  The ST Microelectronics SPEAr range of ARM9/CortexA9 System-on-Chip CPUs are
128c2ecf20Sopenharmony_ci  supported by the 'spear' platform of ARM Linux. Currently SPEAr1310,
138c2ecf20Sopenharmony_ci  SPEAr1340, SPEAr300, SPEAr310, SPEAr320 and SPEAr600 SOCs are supported.
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ci  Hierarchy in SPEAr is as follows:
168c2ecf20Sopenharmony_ci
178c2ecf20Sopenharmony_ci  SPEAr (Platform)
188c2ecf20Sopenharmony_ci
198c2ecf20Sopenharmony_ci	- SPEAr3XX (3XX SOC series, based on ARM9)
208c2ecf20Sopenharmony_ci		- SPEAr300 (SOC)
218c2ecf20Sopenharmony_ci			- SPEAr300 Evaluation Board
228c2ecf20Sopenharmony_ci		- SPEAr310 (SOC)
238c2ecf20Sopenharmony_ci			- SPEAr310 Evaluation Board
248c2ecf20Sopenharmony_ci		- SPEAr320 (SOC)
258c2ecf20Sopenharmony_ci			- SPEAr320 Evaluation Board
268c2ecf20Sopenharmony_ci	- SPEAr6XX (6XX SOC series, based on ARM9)
278c2ecf20Sopenharmony_ci		- SPEAr600 (SOC)
288c2ecf20Sopenharmony_ci			- SPEAr600 Evaluation Board
298c2ecf20Sopenharmony_ci	- SPEAr13XX (13XX SOC series, based on ARM CORTEXA9)
308c2ecf20Sopenharmony_ci		- SPEAr1310 (SOC)
318c2ecf20Sopenharmony_ci			- SPEAr1310 Evaluation Board
328c2ecf20Sopenharmony_ci		- SPEAr1340 (SOC)
338c2ecf20Sopenharmony_ci			- SPEAr1340 Evaluation Board
348c2ecf20Sopenharmony_ci
358c2ecf20Sopenharmony_ciConfiguration
368c2ecf20Sopenharmony_ci-------------
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ci  A generic configuration is provided for each machine, and can be used as the
398c2ecf20Sopenharmony_ci  default by::
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ci	make spear13xx_defconfig
428c2ecf20Sopenharmony_ci	make spear3xx_defconfig
438c2ecf20Sopenharmony_ci	make spear6xx_defconfig
448c2ecf20Sopenharmony_ci
458c2ecf20Sopenharmony_ciLayout
468c2ecf20Sopenharmony_ci------
478c2ecf20Sopenharmony_ci
488c2ecf20Sopenharmony_ci  The common files for multiple machine families (SPEAr3xx, SPEAr6xx and
498c2ecf20Sopenharmony_ci  SPEAr13xx) are located in the platform code contained in arch/arm/plat-spear
508c2ecf20Sopenharmony_ci  with headers in plat/.
518c2ecf20Sopenharmony_ci
528c2ecf20Sopenharmony_ci  Each machine series have a directory with name arch/arm/mach-spear followed by
538c2ecf20Sopenharmony_ci  series name. Like mach-spear3xx, mach-spear6xx and mach-spear13xx.
548c2ecf20Sopenharmony_ci
558c2ecf20Sopenharmony_ci  Common file for machines of spear3xx family is mach-spear3xx/spear3xx.c, for
568c2ecf20Sopenharmony_ci  spear6xx is mach-spear6xx/spear6xx.c and for spear13xx family is
578c2ecf20Sopenharmony_ci  mach-spear13xx/spear13xx.c. mach-spear* also contain soc/machine specific
588c2ecf20Sopenharmony_ci  files, like spear1310.c, spear1340.c spear300.c, spear310.c, spear320.c and
598c2ecf20Sopenharmony_ci  spear600.c.  mach-spear* doesn't contains board specific files as they fully
608c2ecf20Sopenharmony_ci  support Flattened Device Tree.
618c2ecf20Sopenharmony_ci
628c2ecf20Sopenharmony_ci
638c2ecf20Sopenharmony_ciDocument Author
648c2ecf20Sopenharmony_ci---------------
658c2ecf20Sopenharmony_ci
668c2ecf20Sopenharmony_ci  Viresh Kumar <vireshk@kernel.org>, (c) 2010-2012 ST Microelectronics
67