Skip to content

Latest commit

 

History

History
100 lines (69 loc) · 3.65 KB

README-8.2.1-1.6.md

File metadata and controls

100 lines (69 loc) · 3.65 KB

GNU MCU Eclipse ARM Embedded GCC

This is the GNU MCU Eclipse (formerly GNU ARM Eclipse) version of the GNU Arm Embedded Toolchain.

Easy install

The GNU MCU Eclipse ARM Embedded GCC toolchain is also available as a binary xPack and can be conveniently installed with xpm:

$ xpm install --global @gnu-mcu-eclipse/arm-none-eabi-gcc

For more details on how to install the toolchain, please see How to install the ARM toolchain? page.

Compliance

This release closely follows the official ARM distribution, as described in the original ARM release text files:

  • gnu-mcu-eclipse/arm-readme.txt
  • gnu-mcu-eclipse/arm-release.txt

Changes

Compared to the ARM distribution, the build procedure is more or less the same and there should be no functional differences, except the following bug fixes:

  • [Issue:#4] the Windows paths with spaces bug apparently was caused by an old version of and with the new version (5.0.4) the 89249 gcc.c patch is no longer needed;
  • [Issue:#3] due to a problem in the GCC configure script and the specifics of the static build, LTO was not effective on Windows, and the initial workaround proved not effective either; in the new build environment the configure script is enables LTO and it is functional on windows too;
  • [Issue:#1] the liblto_plugin copied/linked to the lib/bdf-plugins for ar to find it and be able to process archives with LTO objects
  • a patch was applied to binutils to fix the 32-bit objcopy bug 24065
  • a patch was applied to gcc to fix the Windows LTO with -g bug 89183

GDB was built with the latest Git commit bda678b9 from 2019-05-09, corresponding to GDB 8.3.50, to fix the bugs affecting C++ LTO projects 24145

Compatibility

The binaries were built using xPack Build Box (XBB), a set of build environments based on slightly older distributions, that should be compatible with most recent systems.

  • GNU/Linux: all binaries were built with GCC 7.4, running in a CentOS 6 Docker container
  • Windows: all binaries were built with mingw-w64 GCC 7.4, running in a CentOS 6 Docker container
  • macOS: most binaries were built with GCC 7.4, running in a separate
    folder on macOS 10.10.5; GDB cannot be compiled with GCC, so Apple clang was used.

Partial support for Python3 was added to GDB for GNU/Linux and macOS; not yet available on Windows (24469).

Build

The scripts used to build this distribution are in:

  • gnu-mcu-eclipse/scripts

For the prerequisites and more details on the build procedure, please see the How to build the ARM Embedded GCC binaries? page.

Documentation

The original PDF documentation is available in:

  • share/doc/pdf

More info

For more info and support, please see the GNU MCU Eclipse project site:

http://gnu-mcu-eclipse.github.io

Thank you for using GNU MCU Eclipse,

Liviu Ionescu