162306a36Sopenharmony_ci========================
262306a36Sopenharmony_ciSPEAr ARM Linux Overview
362306a36Sopenharmony_ci========================
462306a36Sopenharmony_ci
562306a36Sopenharmony_ciIntroduction
662306a36Sopenharmony_ci------------
762306a36Sopenharmony_ci
862306a36Sopenharmony_ci  SPEAr (Structured Processor Enhanced Architecture).
962306a36Sopenharmony_ci  weblink : http://www.st.com/spear
1062306a36Sopenharmony_ci
1162306a36Sopenharmony_ci  The ST Microelectronics SPEAr range of ARM9/CortexA9 System-on-Chip CPUs are
1262306a36Sopenharmony_ci  supported by the 'spear' platform of ARM Linux. Currently SPEAr1310,
1362306a36Sopenharmony_ci  SPEAr1340, SPEAr300, SPEAr310, SPEAr320 and SPEAr600 SOCs are supported.
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ci  Hierarchy in SPEAr is as follows:
1662306a36Sopenharmony_ci
1762306a36Sopenharmony_ci  SPEAr (Platform)
1862306a36Sopenharmony_ci
1962306a36Sopenharmony_ci	- SPEAr3XX (3XX SOC series, based on ARM9)
2062306a36Sopenharmony_ci		- SPEAr300 (SOC)
2162306a36Sopenharmony_ci			- SPEAr300 Evaluation Board
2262306a36Sopenharmony_ci		- SPEAr310 (SOC)
2362306a36Sopenharmony_ci			- SPEAr310 Evaluation Board
2462306a36Sopenharmony_ci		- SPEAr320 (SOC)
2562306a36Sopenharmony_ci			- SPEAr320 Evaluation Board
2662306a36Sopenharmony_ci	- SPEAr6XX (6XX SOC series, based on ARM9)
2762306a36Sopenharmony_ci		- SPEAr600 (SOC)
2862306a36Sopenharmony_ci			- SPEAr600 Evaluation Board
2962306a36Sopenharmony_ci	- SPEAr13XX (13XX SOC series, based on ARM CORTEXA9)
3062306a36Sopenharmony_ci		- SPEAr1310 (SOC)
3162306a36Sopenharmony_ci			- SPEAr1310 Evaluation Board
3262306a36Sopenharmony_ci		- SPEAr1340 (SOC)
3362306a36Sopenharmony_ci			- SPEAr1340 Evaluation Board
3462306a36Sopenharmony_ci
3562306a36Sopenharmony_ciConfiguration
3662306a36Sopenharmony_ci-------------
3762306a36Sopenharmony_ci
3862306a36Sopenharmony_ci  A generic configuration is provided for each machine, and can be used as the
3962306a36Sopenharmony_ci  default by::
4062306a36Sopenharmony_ci
4162306a36Sopenharmony_ci	make spear13xx_defconfig
4262306a36Sopenharmony_ci	make spear3xx_defconfig
4362306a36Sopenharmony_ci	make spear6xx_defconfig
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ciLayout
4662306a36Sopenharmony_ci------
4762306a36Sopenharmony_ci
4862306a36Sopenharmony_ci  The common files for multiple machine families (SPEAr3xx, SPEAr6xx and
4962306a36Sopenharmony_ci  SPEAr13xx) are located in the platform code contained in arch/arm/plat-spear
5062306a36Sopenharmony_ci  with headers in plat/.
5162306a36Sopenharmony_ci
5262306a36Sopenharmony_ci  Each machine series have a directory with name arch/arm/mach-spear followed by
5362306a36Sopenharmony_ci  series name. Like mach-spear3xx, mach-spear6xx and mach-spear13xx.
5462306a36Sopenharmony_ci
5562306a36Sopenharmony_ci  Common file for machines of spear3xx family is mach-spear3xx/spear3xx.c, for
5662306a36Sopenharmony_ci  spear6xx is mach-spear6xx/spear6xx.c and for spear13xx family is
5762306a36Sopenharmony_ci  mach-spear13xx/spear13xx.c. mach-spear* also contain soc/machine specific
5862306a36Sopenharmony_ci  files, like spear1310.c, spear1340.c spear300.c, spear310.c, spear320.c and
5962306a36Sopenharmony_ci  spear600.c.  mach-spear* doesn't contains board specific files as they fully
6062306a36Sopenharmony_ci  support Flattened Device Tree.
6162306a36Sopenharmony_ci
6262306a36Sopenharmony_ci
6362306a36Sopenharmony_ciDocument Author
6462306a36Sopenharmony_ci---------------
6562306a36Sopenharmony_ci
6662306a36Sopenharmony_ci  Viresh Kumar <vireshk@kernel.org>, (c) 2010-2012 ST Microelectronics
67