summaryrefslogtreecommitdiffstats
path: root/meta/conf/machine/include/README
blob: 6a3a63dbcac96bafef9e7a46388e4e627092198d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
2012/03/30 - Mark Hatle <mark.hatle@windriver.com>
 - Initial Revision

The individual CPU, and ABI tunings are contained in this directory.  A 
number of local and global variables are used to control the way the 
tunings are setup and how they work together to specify an optimized 
configuration.

The following is brief summary of the generic components that are used 
in these tunings.

AVAILTUNES - This is a list of all of the tuning definitions currently 
available in the system.  Not all tunes in this list may be compatible 
with the machine configuration, or each other in a multilib 
configuration.  Each tuning file can add to this list using "+=", but 
should never replace the list using "=".

DEFAULTTUNE - This specifies the tune to use for a particular build.  
Each tune should specify a reasonable default, which can be overriden by 
a machine or multilib configuration.  The specified tune must be listed 
in the AVAILTUNES.

TUNEVALID[feature] - The <feature> is defined with a human readable 
explanation for what it does.  All architectural, cpu, abi, etc tuning 
features must be defined using TUNEVALID.

TUNE_FEATURES - This is automatically defined as TUNE_FEATURES_tune-<tune>.
See TUNE_FEATURES_tune-<tune> for more information.

TUNE_FEATURES_tune-<tune> - Specify the features used to describe a 
specific tune.  This is a list of features that a tune support, each 
feature must be in the TUNEVALID list.  Note: the tune and a given 
feature name may be the same, but they have different purposes.  Only 
features may be used to change behavior, while tunes are used to 
describe an overall set of features.

ABIEXTENSION - An ABI extension may be specified by a specific feature 
or other tuning setting, such as TARGET_FPU.  Any ABI extensions either 
need to be defined in the architectures base arch file, i.e.  
ABIEXTENSION = "eabi" in the arm case, or appended to in specific tune 
files with a ".=".  Spaces are not allowed in this variable.

TUNE_CCARGS - Setup the cflags based on the TUNE_FEATURES settings.  
These should be additive when defined using "+=".  All items in this 
list should be dynamic! i.e. 
${@bb.utils.contains("TUNE_FEATURES", "feature", "cflag", "!cflag", d)}

TUNE_ARCH - The GNU canonical arch for a specific architecture.  i.e. 
arm, armeb, mips, mips64, etc.  This value is by bitbake to setup 
configure. TUNE_ARCH definitions are specific to a given architecture.  
They may be a single static definitions, or may be dynamically adjusted.  
See each architectures README for details for that CPU family.

TUNE_PKGARCH - The package architecture used by the packaging systems to 
define the architecture, abi and tuning of a particular package.  
Similarly to TUNE_ARCH, the definition of TUNE_PKGARCH is specific to 
each architecture. See each architectures README for details for that 
CPU family.

PACKAGE_EXTRA_ARCHS - Lists all runtime compatible package 
architectures.  By default this is equal to 
PACKAGE_EXTRA_ARCHS_tune-<tune>.  If an architecture deviates from the 
default it will be listed in the architecture README.

PACKAGE_EXTRA_ARCHS_tune-<tune> - List all of the package architectures 
that are compatible with this specific tune.  The package arch of this 
tune must be in the list.

TARGET_FPU - The FPU setting for a given tune, hard (generate floating 
point instructions), soft (generate internal gcc calls), "other" 
architecture specific floating point.  This is synchronized with the 
compiler and other toolchain items.  This should be dynamically 
configured in the same way that TUNE_CCARGS is.

BASE_LIB_tune-<tune> - The "/lib" location for a specific ABI.  This is 
used in a multilib configuration to place the libraries in the correct, 
non-conflicting locations.