Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: Update GCC_Toolchain instructions for AM335x/AM437x/AM57x #149

Merged
merged 2 commits into from
Jan 10, 2025
Merged

fix: Update GCC_Toolchain instructions for AM335x/AM437x/AM57x #149

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3105fdb
fix: Update GCC_Toolchain instructions for AM335x/AM437x/AM57x
jeevantelukula Jan 3, 2025
289f93f
fix: AM335x/AM437x/AM57x: Update Directory Structure and ARM architec…
jeevantelukula Jan 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 51 additions & 20 deletions source/linux/Overview/GCC_ToolChain.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,8 @@ Before compiling any of the sources referenced in this document, set the cross c

host# export CROSS_COMPILE_32="${SDK_INSTALL_DIR}/linux-devkit/sysroots/x86_64-arago-linux/usr/bin/arm-oe-linux-gnueabi/arm-oe-linux-gnueabi-"
host# export SYSROOT_32="${SDK_INSTALL_DIR}/linux-devkit/sysroots/armv7at2hf-neon-oe-linux-gnueabi"
host# export CC_32="${CROSS_COMPILE_32}gcc --sysroot=${SYSROOT_32}"
host# export CFLAGS="-march=armv7-a -mthumb -mfpu=neon -mfloat-abi=hard"
host# export CC_32="${CROSS_COMPILE_32}gcc ${CFLAGS} --sysroot=${SYSROOT_32}"

.. ifconfig:: CONFIG_part_variant not in ('AM335X', 'AM437X', 'AM57X')

Expand All @@ -33,9 +34,17 @@ If the Processor SDK is not installed, the Arm GNU toolchains can be downloaded
Yocto-built SDK Toolchains
--------------------------

The |__SDK_FULL_NAME__| package contains cross compile toolchains for the ARMv8
(:ref:`linux-devkit`) and ARMv7 (:ref:`k3r5-devkit`) architectures. These toolchains
are used by the :ref:`top level makefile <top-level-makefile>` when
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM57X')

The |__SDK_FULL_NAME__| package contains cross compile toolchain for the ARMv7
(:ref:`linux-devkit`) architecture.

.. ifconfig:: CONFIG_part_variant not in ('AM335X', 'AM437X', 'AM57X')

The |__SDK_FULL_NAME__| package contains cross compile toolchains for the ARMv8
(:ref:`linux-devkit`) and ARMv7 (:ref:`k3r5-devkit`) architectures.

These toolchains are used by the :ref:`top level makefile <top-level-makefile>` when
compiling the binaries for the target. These also package an environment setup
script that, when sourced, sets all the right variables to compile binaries for
the target architecture. The toolchain installers are built through the yocto
Expand Down Expand Up @@ -65,13 +74,13 @@ referred to using the first column in the following sections.
- Description
* - CROSS_COMPILE_32
- linux-devkit/sysroots/x86_64-arago-linux/usr/bin/arm-oe-linux-gnueabi/arm-oe-linux-gnueabi-
- Cross compiler toolchain for the ARMv8 architecture
- Cross compiler toolchain for the ARMv7 architecture
* - SYSROOT_32
- linux-devkit/sysroots/armv7at2hf-neon-oe-linux-gnueabi/
- Sysroot with the cross compiled libraries and headers for the ARMv8 architecture with Linux OS
- Sysroot with the cross compiled libraries and headers for the ARMv7 architecture with Linux OS
* - ENV_SETUP_32
- linux-devkit/environment-setup-armv7at2hf-neon-oe-linux-gnueabi
- Shell script that sets environment variables to compile binaries for the ARMv8 linux target
- Shell script that sets environment variables to compile binaries for the ARMv7 linux target

.. ifconfig:: CONFIG_part_variant not in ('AM335X', 'AM437X', 'AM57X')

Expand All @@ -98,24 +107,36 @@ referred to using the first column in the following sections.
The toolchain within the Linux SDK contains more than just the
cross-compiler, it also contains pre-built libraries that can be used
in your applications without requiring you to cross-compile them
yourself. These libraries include packages from alsa to zlib.
or a list of the
libraries you can refer to the software manifest found in the **<SDK
INSTALL DIR>/manifest** directory or look at the list of libraries
available in the **<SYSROOT_64>/usr/lib** directory. You will
also find the header files corresponding to these libraries in the
**<SYSROOT_64>/usr/include** directory. As
an example if your application wants access to the alsa asound library
then you can now do the following command:
yourself.

.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM57X')

These libraries include packages from alsa to zlib.
or a list of the
jeevantelukula marked this conversation as resolved.
Show resolved Hide resolved
libraries you can refer to the software manifest found in the **<SDK
INSTALL DIR>/manifest** directory or look at the list of libraries
available in the **<SYSROOT_32>/usr/lib** directory. You will
also find the header files corresponding to these libraries in the
**<SYSROOT_32>/usr/include** directory. As
an example if your application wants access to the alsa asound library
then you can now do the following command:

.. code-block:: console

host# ${CROSS_COMPILE_32}gcc -lasound app.c -o app.out

.. ifconfig:: CONFIG_part_variant not in ('AM335X', 'AM437X', 'AM57X')

These libraries include packages from alsa to zlib.
or a list of the
libraries you can refer to the software manifest found in the **<SDK
jeevantelukula marked this conversation as resolved.
Show resolved Hide resolved
INSTALL DIR>/manifest** directory or look at the list of libraries
available in the **<SYSROOT_64>/usr/lib** directory. You will
also find the header files corresponding to these libraries in the
**<SYSROOT_64>/usr/include** directory. As
an example if your application wants access to the alsa asound library
then you can now do the following command:

.. code-block:: console

host# ${CROSS_COMPILE_64}gcc -lasound app.c -o app.out
Expand Down Expand Up @@ -194,7 +215,7 @@ libraries.

.. code-block:: console

host# ${CROSS_COMPILE_32}gcc --sysroot=${SYSROOT_32} helloworld.c -o helloworld
host# ${CROSS_COMPILE_32}gcc -march=armv7-a -mthumb -mfpu=neon -mfloat-abi=hard --sysroot=${SYSROOT_32} helloworld.c -o helloworld

.. ifconfig:: CONFIG_part_variant not in ('AM335X', 'AM437X', 'AM57X')

Expand Down Expand Up @@ -227,10 +248,19 @@ libraries.
simple way to check this is to run the "file" command. It should
return an output similar to below:

.. code-block:: console
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM57X')

.. code-block:: console

host# file helloworld
helloworld: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, BuildID[sha1]=f163acd736f827b9743b27d9a94e431d63990711, for GNU/Linux 3.2.0, with debug_info, not stripped

.. ifconfig:: CONFIG_part_variant not in ('AM335X', 'AM437X', 'AM57X')

.. code-block:: console

host# file helloworld
helloworld: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-aarch64.so.1, BuildID[sha1]=bb96180ad71bd44e07fc148015a55c844134f30d, for GNU/Linux 3.14.0, with debug_info, not stripped
host# file helloworld
StaticRocket marked this conversation as resolved.
Show resolved Hide resolved
helloworld: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-aarch64.so.1, BuildID[sha1]=bb96180ad71bd44e07fc148015a55c844134f30d, for GNU/Linux 3.14.0, with debug_info, not stripped

|

Expand Down Expand Up @@ -299,4 +329,5 @@ commands of the Foundational Components in this document.
host# export CROSS_COMPILE_64=$COMPILER_PATH/arm-gnu-toolchain-11.3.rel1-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu-
host# export CROSS_COMPILE_32=$COMPILER_PATH/arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-
host# export CC_64="${CROSS_COMPILE_64}gcc"
host# export CC_32="${CROSS_COMPILE_32}gcc"

Loading