xref: /OK3568_Linux_fs/yocto/poky/meta/conf/machine/include/mips/README (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun2016/09/30 - Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>
2*4882a593Smuzhiyun  - Add Release 6 support
3*4882a593Smuzhiyun
4*4882a593Smuzhiyun2012/03/30 - Mark Hatle <mark.hatle@windriver.com>
5*4882a593Smuzhiyun  - Initial Version
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunMIPS currently defines 12 ABIs.  Combinations of:
8*4882a593Smuzhiyun *) Big/Little Endian
9*4882a593Smuzhiyun *) Hardware/Software Floating Point
10*4882a593Smuzhiyun *) o32, n32, n64 ABI
11*4882a593Smuzhiyun
12*4882a593SmuzhiyunRelease 6 of the ISA is a major revision and doesn't build up on previous
13*4882a593Smuzhiyunreleases of the ISA.
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunFor more details about tuples, check https://wiki.debian.org/Multiarch/Tuples
16*4882a593Smuzhiyun
17*4882a593SmuzhiyunTUNE_ARCH, the GNU canonical arch, is defined as:
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun"mips${MIPSPKGSFX_32R6}${MIPSPKGSFX_64R6}${MIPSPKGSFX_BYTE}${MIPSPKGSFX_R6}${MIPSPKGSFX_ENDIAN}"
20*4882a593Smuzhiyun
21*4882a593SmuzhiyunThe package arch is defined in such a way to generated a standard naming
22*4882a593Smuzhiyunscheme.  The scheme is: <mips variant>[-nf][-n32]
23*4882a593Smuzhiyun
24*4882a593SmuzhiyunTUNE_PKGARCH is defined as:
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun${MIPSPKGSFX_VARIANT:tune-${DEFAULTTUNE}}${MIPSPKGSFX_FPU}${MIPSPKGSFX_ABI}
27*4882a593Smuzhiyun
28*4882a593SmuzhiyunThe following is a list of MIPS specific variables:
29*4882a593Smuzhiyun
30*4882a593SmuzhiyunMIPSPKGSFX_BYTE - This is defined as either blank and "64" for MIPS64 CPUs.
31*4882a593Smuzhiyun
32*4882a593SmuzhiyunMIPSPKGSFX_ENDIAN - For bigendian hardware this is blank, otherwise it's
33*4882a593Smuzhiyundefined as "el".
34*4882a593Smuzhiyun
35*4882a593SmuzhiyunMIPSPKGSFX_ENDIAN2 - For bigendian hardware this is "eb", otherwise it's
36*4882a593Smuzhiyundefined as "el".
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunMIPSPKGSFX_VARIANT:tune-<tune> - In the default tunings it is set to the
39*4882a593Smuzhiyunsame value as TUNE_ARCH.  In custom, optimized tunings, the value should
40*4882a593Smuzhiyunbe modified to more precisely describe the tuning.
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunMIPSPKGSFX_FPU - The value is set to "" or "-nf", where "-nf" indicates
43*4882a593Smuzhiyunthat the tune is using a non-floating point ABI.
44*4882a593Smuzhiyun
45*4882a593SmuzhiyunMIPSPKGSFX_ABI - This is used to specify an alternative ABI when the previous
46*4882a593Smuzhiyunvalues are not enough to distringuish the package.  "-n32" is added when
47*4882a593Smuzhiyunbuilding for N32 ABI.
48*4882a593Smuzhiyun
49*4882a593SmuzhiyunMIPSPKGSFX_R6 - This is used to specify the presence of release 6.
50*4882a593Smuzhiyun"r6" is added in the tuple for release 6 of the isa.
51*4882a593Smuzhiyun
52*4882a593SmuzhiyunMIPSPKGSFX_64R6 - This is used to specify "isa" in the tuple.
53*4882a593SmuzhiyunRelease 6 onwards we use "mipsisa64" instead of just "mips64".
54*4882a593Smuzhiyun
55*4882a593SmuzhiyunMIPSPKGSFX_32R6 -  This is used to specify "isa32" in the tuple.
56*4882a593SmuzhiyunRelease 6 onwards we use "mipsisa32" instead of just "mips".
57