[Clfs-commits] [CLFS Embedded]Cross-LFS Embedded Book branch, master, updated. e2ce5d5b9693be79d12734d4226180ae0e831b54

git git at cross-lfs.org
Tue Sep 18 13:02:00 PDT 2012


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Cross-LFS Embedded Book".

The branch, master has been updated
       via  e2ce5d5b9693be79d12734d4226180ae0e831b54 (commit)
       via  295d48f7fa016d84ff19b733d4297ccc1384e22a (commit)
       via  c31ae75f62f867e924a3d1568806716dcbce571a (commit)
       via  2e5c4b9cae4c382f7db68bed9e37c3663c764da3 (commit)
      from  8ffc08dd20231c5fba638436797be53524b6d109 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e2ce5d5b9693be79d12734d4226180ae0e831b54
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Tue Sep 18 08:40:27 2012 -0400

    Update date
    
    Signed-off-by: Andrew Bradford <andrew at bradfordembedded.com>

diff --git a/BOOK/general.ent b/BOOK/general.ent
index bfa0698..b4f1e34 100644
--- a/BOOK/general.ent
+++ b/BOOK/general.ent
@@ -2,7 +2,7 @@
 
 <!ENTITY month "09"> <!-- Use two digits -->
 <!ENTITY month_name "September">
-<!ENTITY day "13"> <!-- Use two digits -->
+<!ENTITY day "18"> <!-- Use two digits -->
 <!ENTITY year "2012"> <!-- Use four digits -->
 
 <!ENTITY releasedate "&month_name; &day;, &year;">

commit 295d48f7fa016d84ff19b733d4297ccc1384e22a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Tue Sep 18 08:39:49 2012 -0400

    arm/changelog: Recommendation of ARM ABI & build vars
    
    Signed-off-by: Andrew Bradford <andrew at bradfordembedded.com>

diff --git a/BOOK/introduction/arm/changelog.xml b/BOOK/introduction/arm/changelog.xml
index 079b7d6..6a95095 100644
--- a/BOOK/introduction/arm/changelog.xml
+++ b/BOOK/introduction/arm/changelog.xml
@@ -33,6 +33,16 @@
 -->
 
     <listitem>
+      <para>September 18, 2012</para>
+      <itemizedlist>
+        <listitem>
+          <para>[abradford] - Provide recommendations for selection of ARM
+          ABI and build variables.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>April 8, 2011</para>
       <itemizedlist>
         <listitem>

commit c31ae75f62f867e924a3d1568806716dcbce571a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Tue Sep 18 08:36:23 2012 -0400

    cross-tools/arm/vars: Add recommended build vars
    
    ARM build variable selection is confusing.  There's too many
    combinations of choices.  Provide some recommendations for ARM9 and
    Cortex-A{8,9} that generally hold true.  ARM9 and Cortex-A{8,9} are
    generally the processors people build for today.
    
    Signed-off-by: Andrew Bradford <andrew at bradfordembedded.com>

diff --git a/BOOK/cross-tools/arm/variables.xml b/BOOK/cross-tools/arm/variables.xml
index c79b659..60cc3c9 100644
--- a/BOOK/cross-tools/arm/variables.xml
+++ b/BOOK/cross-tools/arm/variables.xml
@@ -20,7 +20,15 @@
   do not know what values can be chosen for each of these, you can use the 
   tables at the bottom of this page as a reference.</para>
 
-  <para os="a1">First, set the host and target triplets:</para>
+  <para os="a1">Most ARM processors are little endian, it is a safe choice.
+  If your processor is an ARM9, good choices include: triplet of
+  armv5l-unknown-linux-uclibeabi, ARM arch of armv5t, float of softfp, and fpu
+  of either none or softvfp. ARM9 processors do not always have hardware
+  floating point abilities. If your processor is a Cortex-A8 or Cortex-A9, good
+  choices include: triplet of armv7a-unknown-linux-uclibceabi, ARM arch of
+  armv7-a, float of hard, and fpu of vfpv3-d16.</para>
+
+  <para os="a2">First, set the host and target triplets:</para>
 
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
   href="../common/variables.xml"
@@ -216,6 +224,8 @@ echo export CLFS_FPU=\""${CLFS_FPU}\"" >> ~/.bashrc</userinput></screen>
         </row>
         <row>
           <entry>neon-vfpv4</entry>
+          <entry>softvfp</entry>
+          <entry>none</entry>
         </row>
       </tbody>
     </tgroup>

commit 2e5c4b9cae4c382f7db68bed9e37c3663c764da3
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Tue Sep 18 08:19:15 2012 -0400

    cross-tools/arm/abi: Provide recommendations on ABI
    
    ABI selection for ARM is often confusing and the -support list often
    has people reporting that they have difficulty selecting the best ABI
    for their board.
    
    Add some clarification and recommendations.  Move aapcs-linux and
    apcs-gnu to the top of the table as those are really the only two
    choices that should be used.
    
    Signed-off-by: Andrew Bradford <andrew at bradfordembedded.com>

diff --git a/BOOK/cross-tools/arm/abi.xml b/BOOK/cross-tools/arm/abi.xml
index bda9948..fd81f8d 100644
--- a/BOOK/cross-tools/arm/abi.xml
+++ b/BOOK/cross-tools/arm/abi.xml
@@ -12,16 +12,17 @@
 
   <para os="a">On the ARM architecture, there are two major ABI types to choose
   from: EABI and OABI.  There is also a Thumb ABI and an Intel IWMMX specific
-  ABI.</para>
+  ABI but these are generally not recommended for most uses.</para>
 
   <para os="b">The EABI (Embedded ABI) is newer and supports additional
   features, faster software floating point operations, and Thumb interworking,
   but is only compatible with ARMv4t and newer cores.  The EABI has
   sub-ABIs of: aapcs-linux and aapcs.  aapcs-linux has standard Linux 4 byte
-  enums while aapcs has variable length enums.</para>
+  enums while aapcs has variable length enums.  aapcs-linux is recommended over
+  aapcs.</para>
 
   <para os="c">The OABI (old ABI) is called apcs-gnu and supports ARMv4 and 
-  older cores.</para>
+  older cores.  Generally the OABI is not used by modern ARM processors.</para>
 
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
   href="../common/abi.xml"
@@ -55,9 +56,14 @@
 
       <tbody>
         <row>
+          <entry>aapcs-linux</entry>
+          <entry>aapcs-linux</entry>
+          <entry>Recommended for EABI. Standard Linux 32 bit (int) enums</entry>
+        </row>
+        <row>
           <entry>apcs-gnu</entry>
           <entry>apcs-gnu</entry>
-          <entry>OABI</entry>
+          <entry>Recommended for OABI</entry>
         </row>
         <row>
           <entry>atpcs</entry>
@@ -70,11 +76,6 @@
           <entry>EABI w/ variable size enums</entry>
         </row>
         <row>
-          <entry>aapcs-linux</entry>
-          <entry>aapcs-linux</entry>
-          <entry>EABI w/ standard Linux 32 bit (int) enums</entry>
-        </row>
-        <row>
           <entry>iwmmxt</entry>
           <entry>iwmmxt</entry>
           <entry>Supports Intel XScale MMX extensions</entry>

-----------------------------------------------------------------------

Summary of changes:
 BOOK/cross-tools/arm/abi.xml        |   19 ++++++++++---------
 BOOK/cross-tools/arm/variables.xml  |   12 +++++++++++-
 BOOK/general.ent                    |    2 +-
 BOOK/introduction/arm/changelog.xml |   10 ++++++++++
 4 files changed, 32 insertions(+), 11 deletions(-)


hooks/post-receive
-- 
Cross-LFS Embedded Book



More information about the Clfs-commits mailing list