source: clfs-embedded/BOOK/cross-tools/arm/variables.xml@ 752c0e2

Last change on this file since 752c0e2 was 5c58544, checked in by Andrew Bradford <andrew@…>, 11 years ago

Fix pdf rendering errors

Tables must declare the proper number of columns in order for PDF
rendering to function properly. HTML output doesn't mind incorrect
<tgroup cols="X"> settings.
  • Property mode set to 100644
File size: 7.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-cross-tools-variables">
9 <?dbhtml filename="variables.html"?>
10
11 <title>Build Variables</title>
12
13 <bridgehead renderas="sect4">Setting Host and Target</bridgehead>
14
15 <para os="a">During the building of the cross-compile tools, you will need to
16 set a few variables that will be dependent on your particular needs.
17 You will need to select the target triplet for the target architecture, the CPU
18 endianess, the CPU architecture, the CPU mode, the CPU floating point hardware
19 availability, and (if available) the type of floating point hardware. If you
20 do not know what values can be chosen for each of these, you can use the
21 tables at the bottom of this page as a reference.</para>
22
23 <para os="a1">Most ARM processors are little endian, it is a safe choice.
24 If your processor is an ARM9, good choices include: triplet of
25 armv5l-unknown-linux-uclibeabi, ARM arch of armv5t, float of softfp, and fpu
26 of either none or softvfp. ARM9 processors do not always have hardware
27 floating point abilities. If your processor is a Cortex-A8 or Cortex-A9, good
28 choices include: triplet of armv7a-unknown-linux-uclibceabi, ARM arch of
29 armv7-a, float of hard, and fpu of vfpv3-d16.</para>
30
31 <para os="a2">First, set the host and target triplets:</para>
32
33 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
34 href="../common/variables.xml"
35 xpointer="xpointer(//*[@os='b'])"/>
36
37 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
38 href="../common/variables.xml"
39 xpointer="xpointer(//*[@os='c'])"/>
40
41<screen os="d"><userinput>export CLFS_ARCH=arm
42export CLFS_ENDIAN="<replaceable>[endianess]</replaceable>"</userinput></screen>
43
44 <para os="e">Choose the ARM architecture (see table below) and mode of
45 your CPU:</para>
46
47<screen os="f"><userinput>export CLFS_ARM_ARCH="<replaceable>[architecture]</replaceable>"
48export CLFS_ARM_MODE="<replaceable>[arm or thumb]</replaceable>"</userinput></screen>
49
50 <para os="f1">If your target CPU has hard floating point support (not all ARM
51 CPUs do), set the following CLFS_FLOAT variable to either "hard" or "softfp".
52 If your target CPU does not have hard floating point support, set the following
53 CLFS_FLOAT vairable to "soft".</para>
54
55<screen os="f2"><userinput>export CLFS_FLOAT="<replaceable>[hard, softfp, or soft]"</replaceable></userinput></screen>
56
57 <para os="f3">If you chose either "hard" or "softfp" for CLFS_FLOAT, you now
58 need to set which floating point hardware is actually included (see table below)
59 with your ARM CPU:</para>
60
61<screen os="f4"><userinput>export CLFS_FPU="<replaceable>[fpu version]</replaceable>"</userinput></screen>
62
63 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
64 href="../common/variables.xml"
65 xpointer="xpointer(//*[@os='g'])"/>
66
67<screen os="h"><userinput>echo export CLFS_HOST=\""${CLFS_HOST}\"" &gt;&gt; ~/.bashrc
68echo export CLFS_TARGET=\""${CLFS_TARGET}\"" &gt;&gt; ~/.bashrc
69echo export CLFS_ARCH=\""${CLFS_ARCH}\"" &gt;&gt; ~/.bashrc
70echo export CLFS_ENDIAN=\""${CLFS_ENDIAN}\"" &gt;&gt; ~/.bashrc
71echo export CLFS_ARM_ARCH=\""${CLFS_ARM_ARCH}\"" &gt;&gt; ~/.bashrc
72echo export CLFS_ARM_MODE=\""${CLFS_ARM_MODE}\"" &gt;&gt; ~/.bashrc
73echo export CLFS_FLOAT=\""${CLFS_FLOAT}\"" &gt;&gt; ~/.bashrc
74echo export CLFS_FPU=\""${CLFS_FPU}\"" &gt;&gt; ~/.bashrc</userinput></screen>
75
76 <table os="i">
77 <title>Example Processor Type, ABI, and Target Triplets</title>
78 <?dbfo table-width="7in" ?>
79
80 <tgroup cols="4">
81
82 <colspec colnum="1" colwidth="2.5in" colname="Processor"/>
83 <colspec colnum="2" colwidth="1in" colname="Endianess"/>
84 <colspec colnum="3" colwidth="1in" colname="ABI"/>
85 <colspec colnum="4" colwidth="2.5in" colname="Triplet"/>
86
87 <thead>
88 <row>
89 <entry>Processor</entry>
90 <entry>Endianess</entry>
91 <entry>ABI</entry>
92 <entry>Target Triplet</entry>
93 </row>
94 </thead>
95
96 <tbody>
97 <row>
98 <entry>Generic arm</entry>
99 <entry>little</entry>
100 <entry>OABI</entry>
101 <entry>arm-unknown-linux-uclibc</entry>
102 </row>
103 <row>
104 <entry>Generic arm, version 4</entry>
105 <entry>little</entry>
106 <entry>OABI</entry>
107 <entry>armv4-unknown-linux-uclibc</entry>
108 </row>
109 <row>
110 <entry>Generic arm, version 5</entry>
111 <entry>little</entry>
112 <entry>EABI</entry>
113 <entry>armv5l-unknown-linux-uclibceabi</entry>
114 </row>
115 <row>
116 <entry>Generic arm, version 5</entry>
117 <entry>big</entry>
118 <entry>EABI</entry>
119 <entry>armv5b-unknown-linux-uclibceabi</entry>
120 </row>
121 <row>
122 <entry>Generic arm</entry>
123 <entry>little</entry>
124 <entry>EABI</entry>
125 <entry>arm-unknown-linux-uclibceabi</entry>
126 </row>
127 <row>
128 <entry>Generic arm, version 7-a </entry>
129 <entry>little</entry>
130 <entry>EABI</entry>
131 <entry>armv7a-unknown-linux-uclibceabi</entry>
132 </row>
133 </tbody>
134
135 </tgroup>
136
137 </table>
138
139 <table os="j">
140 <title>ARM Archiecture Choices</title>
141 <?dbfo table-width="4in" ?>
142
143 <tgroup cols="4">
144
145 <colspec colnum="1" colwidth="1in" colname="Arch Choice"/>
146 <colspec colnum="2" colwidth="1in" colname="Arch Choice"/>
147 <colspec colnum="3" colwidth="1in" colname="Arch Choice"/>
148 <colspec colnum="4" colwidth="1in" colname="Arch Choice"/>
149
150 <tbody>
151 <row>
152 <entry>armv2</entry>
153 <entry>armv2a</entry>
154 <entry>armv3</entry>
155 <entry>armv3m</entry>
156 </row>
157 <row>
158 <entry>armv4</entry>
159 <entry>armv4t</entry>
160 <entry>armv5</entry>
161 <entry>armv5t</entry>
162 </row>
163 <row>
164 <entry>armv5te</entry>
165 <entry>armv6</entry>
166 <entry>armv6j</entry>
167 <entry>armv6t2</entry>
168 </row>
169 <row>
170 <entry>armv6z</entry>
171 <entry>armv6zk</entry>
172 <entry>armv6-m</entry>
173 <entry>armv7</entry>
174 </row>
175 <row>
176 <entry>armv7-a</entry>
177 <entry>armv7-r</entry>
178 <entry>armv7-m</entry>
179 <entry>iwmmxt</entry>
180 </row>
181 <row>
182 <entry>iwmmxt2</entry>
183 <entry>ep9312</entry>
184 </row>
185 </tbody>
186 </tgroup>
187 </table>
188
189 <table os="j">
190 <title>ARM Hard Floating Point Versions</title>
191 <?dbfo table-width="4in" ?>
192
193 <tgroup cols="4">
194
195 <colspec colnum="1" colwidth="1in" colname="FPU Choice"/>
196 <colspec colnum="2" colwidth="1in" colname="FPU Choice"/>
197 <colspec colnum="3" colwidth="1in" colname="FPU Choice"/>
198 <colspec colnum="4" colwidth="1in" colname="FPU Choice"/>
199
200 <tbody>
201 <row>
202 <entry>fpa</entry>
203 <entry>fpe2</entry>
204 <entry>fpe3</entry>
205 <entry>maverick</entry>
206 </row>
207 <row>
208 <entry>vfp</entry>
209 <entry>vfpv3</entry>
210 <entry>vfpv3-fp16</entry>
211 <entry>vfpv3-d16</entry>
212 </row>
213 <row>
214 <entry>vfpv3-d16-fp16</entry>
215 <entry>vfpv3xd</entry>
216 <entry>vfpv3xd-fp16</entry>
217 <entry>neon</entry>
218 </row>
219 <row>
220 <entry>neon-fp16</entry>
221 <entry>vfpv4</entry>
222 <entry>vfpv4-d16</entry>
223 <entry>fpv4-sp-d16</entry>
224 </row>
225 <row>
226 <entry>neon-vfpv4</entry>
227 <entry>softvfp</entry>
228 <entry>none</entry>
229 </row>
230 </tbody>
231 </tgroup>
232 </table>
233
234</sect1>
Note: See TracBrowser for help on using the repository browser.