Changes between Version 67 and Version 68 of TBR/UserManual/MinGW_Tools_for_Windows


Ignore:
Timestamp:
Feb 22, 2012, 12:25:48 PM (8 years ago)
Author:
ChrisJohns
Comment:

Change to use the mingw installer.

Legend:

Unmodified
Added
Removed
Modified
  • TBR/UserManual/MinGW_Tools_for_Windows

    v67 v68  
    2525
    2626
    27 If you want some excellent tools or wish to build RTEMS on Windows the MinGW project provides just what you need.  The RTEMS Tools as installed do not need any extra packages, DLLs or installs to work.  You could use any available ''make'' program or tools to build any RTEMS application.  Please note that the MinGW and MSYS installation is only necessary if you want to build RTEMS.  If someone else provides you with your desired RTEMS board support package you do not need them.  The RTEMS Tools (compiler, assembler, linker etc.) do not depend on them.  The only exception is the RTEMS ''Autoconf and Automake'' subpackage, but this package is only needed if you want do build RTEMS from the CVS sources.
     27If you want some excellent tools or wish to build RTEMS on Windows the MinGW project provides just what you need.  The RTEMS Tools as installed do not need any extra packages, DLLs or installs to work.  You could use any available ''make'' program or tools to build any RTEMS application.  Please note that the MinGW and MSYS installation is only necessary if you want to build RTEMS as RTEMS uses autoconf and automake.  If someone else provides you with your desired RTEMS board support package you do not need them.  The RTEMS Tools (compiler, assembler, linker etc.) do not depend on them.  The only exception is the RTEMS ''Autoconf and Automake'' subpackage, but this package is only needed if you want do build RTEMS from the CVS sources.
    2828
    29 The MinGW project has four [http://www.essaymill.com essay writing help] packages we are interested in using.  You should install them before you install the RTEMS Tools.  The first MinGW package contains a Windows native GCC compiler.  The second package is the Minimal SYStem (MSYS), the third is the MSYS Developer Tool Kit (DTK) and the fourth is M4 for MSYS.  MSYS is a stand alone package based on the excellent and successful Cygwin package but simplified to providing a self hosted mingw32 target POSIX style environment.  It provides a shell with enough functionality to run configure scripts from the Autoconf package.  It is simpler to install and setup than the larger more complex Cygwin package.
     29The MinGW project has a package management tool that will install and manage your MinGW installation. The [http://mingw.org/wiki/Getting_Started MinGW Getting Started Guide] will step you through installing MinGW and MSYS. Open the [http://mingw.org/wiki/Getting_Started MinGW Getting Started Guide] and select the link to download the GUI installer. Save this to disk and run it. Click through the default including the default path of "C:\MinGW". At the "Select Components" page select the C++ compiler and "MSYS Basic System" and "MinGW Developer Toolkit". Once installed you can use to the CLI version of the tool to upgrade and install further packages.
    3030
    31 You can also use an existing MinGW or MSYS installation.  In this case you have to take care that a recent M4 is provided, see also [wiki:#MSYS_-_M4 MSYS - M4].
    32 = Download =
    33 
    34 
    35 Download the following files:
    36  *[http://prdownloads.sf.net/mingw/MinGW-5.1.4.exe?download MinGW]
    37  *[http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download MSYS - Base]
    38  *[http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download MSYS - Developer Tool Kit]
    39  *[http://prdownloads.sf.net/mingw/m4-1.4.7-MSYS.tar.bz2?download MSYS - M4]
     31Download the latest GUI installer from:
     32 *http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/
    4033
    4134If there are problems with the above links or to check for other MinGW packages, visit the  [http://www.mingw.org/download.shtml MinGW Download Site] which should refer you to the [http://sourceforge.net/project/showfiles.php?group_id=2435 MinGW Sourceforge Files] page.
    42 = MinGW =
    43 
    44 
    45 Follow the instructions of the installer to download and install MinGW.  All default values from the installer are suitable.
    46 = MSYS - Base =
    47 
    48 
    49 Follow the instructions of the installer to install [http://www.mingw.org/wiki/MSYS MSYS].  All default values from the installer are suitable.  Continue with the post install process and enter the MinGW installation location from above.
    50 <center>[[Image(msys-post-install.jpg)]]</center>
    51 
    52 If you have Cygwin installed or another package which contains Cygwin you should consider removing any paths to those packages from your global path variable and using batch files to set paths specifically.  It can be confusing if you end up mixing MSYS and Cygwin executables in the same environment.  The batch file <tt>rtems.bat</tt> shows how you can manage specific paths for MinGW and RTEMS (this file is part of the RTEMS Tools).
    53 
    54 To avoid trouble you need to set a home directory for the MSYS shell.  The home directory path must not contain any space characters.  The default home directory is derived from your login name, so it may contain space characters.  Open the file <tt>C:\msys\1.0\etc\profile</tt> with a capable editor.  The standard Windows editors Notepad and WordPad are not suitable.  In the next picture the open source editor [http://notepad-plus.sourceforge.net/uk/site.htm notepad++] is used to highlight the changes.  Set the <tt>HOME</tt> environment variable to the fixed location <tt>/c/home</tt> (or whatever you want).  In the [wiki:#MSYS_Shell Advanced Users] section you find more information regarding the home directory.
    55 <center>[[Image(msys-home.jpg)]]</center>
    56 = MSYS - Developer Tool Kit =
    57 
    58 
    59 Follow the instructions of the installer to install the MSYS - DTK.  For the installation location you should choose the one of your MSYS installation like:
    60 <center><tt>C:\msys\1.0</tt></center>
    61 For all other settings the default values from the installer are suitable.
    62 = MSYS - M4 =
    63 
    64 
    65 The Autotools used for RTEMS require a recent version of M4 (>= 1.4.7).  As of 2 February 2009, the current MSYS release delivers an outdated version so we have to upgrade it manually.  We assume that you have downloaded the M4 package into the directory <tt>C:\download</tt>.  Now open a Windows command shell (''cmd.exe'') and type in the following three commands (the '>' prompt indicates the Windows command shell):
    66 
    67  > cd C:\msys\1.0
    68  > set PATH=C:\msys\1.0\bin;%PATH%
    69  > tar xjf /c/download/m4-1.4.7-MSYS.tar.bz2
    70 
    71 Alternatively you can use a MSYS shell (''Start > All Programs > MinGW > MSYS > msys'') with the commands below (the '$' prompt indicates the MSYS shell):
    72 
    73  $ cd /
    74  $ tar xjf /c/download/m4-1.4.7-MSYS.tar.bz2
    75 
    76 If you downloaded a GZIP compressed TAR-file you can use
    77  tar xzf /c/download/m4-1.4.7-MSYS.tar.gz
    78 instead of the previous <tt>tar</tt> commands to extract it.
    79 
    80 You can also use an archive extractor like [http://www.izarc.org IZArc] to extract the bzip2 compressed TAR-file into <tt>C:\msys\1.0</tt>.
    81 
    82 You can verify the installation of M4 with the following command in a shell:
    83 
    84  m4 --version
    85 
    86 It should produce the following output:
    87 
    88  GNU M4 1.4.7
    89  Copyright (C) 2006 Free Software Foundation, Inc.
    90  This is free software; see the source for copying conditions.  There is NO
    91  warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    92  
    93  Written by Rene' Seindal.
    9435= RTEMS Tools Installation =
    9536
     
    202143
    203144If you are using RTEMS with these tools on Windows you may find the [http://realterm.sourceforge.net RealTerm] program useful when connecting to the console of your target.
    204 = =RTEMS Tools License and Sources ==
     145= RTEMS Tools License and Sources =
    205146
    206147