Miosix Toolchain: Difference between revisions

From Miosix Wiki
Jump to navigation Jump to search
(Created page with "The Miosix Toolchain is a specially patched version of the [https://gcc.gnu.org GCC] compiler, [https://www.sourceware.org/newlib Newlib] C library, and libstdc++ library. Th...")
 
mNo edit summary
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Miosix Toolchain is a specially patched version of the [https://gcc.gnu.org GCC] compiler, [https://www.sourceware.org/newlib Newlib] C library, and libstdc++ library.


The patches to the compiler and standard libraries are required to:
== Latest version of the Miosix Toolchain ==
 
Released '''08/06/2014'''. This version adds ''sys/ioctl.h'' and ''sys/termios.h'' to the C library. It is a mandatory release, newer kernels won't build with previous compiler. There are no bug fixes.
 
_MIOSIX_GCC_PATCH_VERSION is set to 1 in this release.
 
You can download it here
* [https://miosix.org/toolchain/MiosixToolchainInstaller.run Miosix Toolchain Linux] (sha1sum 6952ce2106e5a6f830a250b9b384e8dba0fe4100) This is self-installing shell script, run it with
<source lang="bash">sh MiosixToolchainInstaller.run</source>
* [https://miosix.org/toolchain/MiosixToolchainInstaller.exe Miosix Toolchain Windows] (sha1sum 9750cef4593c5eb5df8fc497cdd888d33f1e006d) This is a self-installing .exe
Both versions will automatically detect a previous version of the compiler and uninstall it, unless you are on Linux and you have installed the toolchain from sources. In such a case you should uninstall it manually using the ''uninstall.sh'' file in the ''miosix/_tools/compiler'' directory of the kernel git repository.
 
== Previous version of the Miosix Toolchain ==
 
Released '''06/04/2014.''' This is the first version of the Miosix Toolchain available as a binary self-installing package.
 
_MIOSIX_GCC_PATCH_VERSION is not defined in this release.
 
You can download it here
* [https://miosix.org/toolchain/v0/MiosixToolchainInstaller.run Miosix Toolchain Linux] (sha1sum 359878b78f2c462f0ce1d207b837d2313968b443) This is self-installing shell script.
* [https://miosix.org/toolchain/v0/MiosixToolchainInstaller.exe Miosix Toolchain Windows] (sha1sum a62cb3fa628f6ca47f1c8e248c0cf24d41bc28aa) This is a self-installing .exe
 
== Information on the Miosix Toolchain ==
 
The Miosix Toolchain is a specially patched version of the [https://gcc.gnu.org GCC] compiler, [https://www.sourceware.org/newlib Newlib] C library, and libstdc++ library. The patches to the compiler and standard libraries are required to:


* Provide thread safety of the C and C++ libraries. A lot of potential race conditions that occur when GCC is built for an embedded platform (i.e: not to produce binaries for a mainstream OS such as Linux or Windows where thread safety issues are already dealt with) have been fixed, for exemple throwing C++ exception from more threads at the same time is now thread safe, constructors of static objects are now thread safe, accessing the same FILE * handle from more threads is now thread safe... This cannot be done by the compiler alone, nor by the kernel alone, cooperation of the two is required, and this is the number one reason for having patches.
* Provide thread safety of the C and C++ libraries. A lot of potential race conditions that occur when GCC is built for an embedded platform (i.e: not to produce binaries for a mainstream OS such as Linux or Windows where thread safety issues are already dealt with) have been fixed, for exemple throwing C++ exception from more threads at the same time is now thread safe, constructors of static objects are now thread safe, accessing the same FILE * handle from more threads is now thread safe... This cannot be done by the compiler alone, nor by the kernel alone, cooperation of the two is required, and this is the number one reason for having patches.
Line 13: Line 36:
Also, due to the effort to achieve more POSIX compliance in Miosix 2.0, the compiler patches are updated from time to time, and users are required to upgrade to the latest version of the compiler when necessary.
Also, due to the effort to achieve more POSIX compliance in Miosix 2.0, the compiler patches are updated from time to time, and users are required to upgrade to the latest version of the compiler when necessary.


== Latest compiler ==
[[Category:Installation and Configuration]]

Revision as of 14:59, 17 June 2015

Latest version of the Miosix Toolchain

Released 08/06/2014. This version adds sys/ioctl.h and sys/termios.h to the C library. It is a mandatory release, newer kernels won't build with previous compiler. There are no bug fixes.

_MIOSIX_GCC_PATCH_VERSION is set to 1 in this release.

You can download it here

  • Miosix Toolchain Linux (sha1sum 6952ce2106e5a6f830a250b9b384e8dba0fe4100) This is self-installing shell script, run it with
sh MiosixToolchainInstaller.run

Both versions will automatically detect a previous version of the compiler and uninstall it, unless you are on Linux and you have installed the toolchain from sources. In such a case you should uninstall it manually using the uninstall.sh file in the miosix/_tools/compiler directory of the kernel git repository.

Previous version of the Miosix Toolchain

Released 06/04/2014. This is the first version of the Miosix Toolchain available as a binary self-installing package.

_MIOSIX_GCC_PATCH_VERSION is not defined in this release.

You can download it here

Information on the Miosix Toolchain

The Miosix Toolchain is a specially patched version of the GCC compiler, Newlib C library, and libstdc++ library. The patches to the compiler and standard libraries are required to:

  • Provide thread safety of the C and C++ libraries. A lot of potential race conditions that occur when GCC is built for an embedded platform (i.e: not to produce binaries for a mainstream OS such as Linux or Windows where thread safety issues are already dealt with) have been fixed, for exemple throwing C++ exception from more threads at the same time is now thread safe, constructors of static objects are now thread safe, accessing the same FILE * handle from more threads is now thread safe... This cannot be done by the compiler alone, nor by the kernel alone, cooperation of the two is required, and this is the number one reason for having patches.
  • Improved speed of the pthread API. For example, pthread_mutex_t is no longer an opaque pointer type but the real struct containing the mutex implementation. This results in a 7x speed increase with respect to the previous pthread_mutex code.
  • Some more code size and RAM requirement reductions, such as the redefinition of BUFSIZ from 1024 to 256 bytes which reduces the RAM used by the C stdio library.

Some of the patches, mainly those that increase performance and reduce code size in Newlib have also been contributed upstream, but to date compiling Miosix still requires patches.

In previous versions of the kernel, the user was required to download the compiler sources, patch it and compile it. Even though this was automated through a simple script, it took a long time to build the compiler, especially for older machines, and it was cumbersome to say the least to do it on Windows. Starting from Miosix 2.0, the compiler is also distributed as a self-installing precompiled package, for both Linux and Windows.

Also, due to the effort to achieve more POSIX compliance in Miosix 2.0, the compiler patches are updated from time to time, and users are required to upgrade to the latest version of the compiler when necessary.