mirror of
https://salsa.debian.org/gnuk-team/gnuk/gnuk.git
synced 2024-09-21 19:30:08 +00:00
137 lines
9.9 KiB
HTML
137 lines
9.9 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
<title>ChibiOS/RT: Setting up a free embedded IDE</title>
|
|
<link href="custom.css" rel="stylesheet" type="text/css">
|
|
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
</head><body>
|
|
<table style="text-align: center; width: 100%;" border="0"
|
|
cellpadding="2" cellspacing="2">
|
|
<tbody>
|
|
<tr>
|
|
<td style="width: 80px;"><img alt="ChibiOS/RT Logo" src="logo_small.png"></td>
|
|
<td><big><big>ChibiOS/RT</big></big><br><br>Architecture - Reference Manual - Guides</td>
|
|
<td style="width: 80px;"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<hr size="1">
|
|
<!-- Generated by Doxygen 1.6.3 -->
|
|
<div class="navigation" id="top">
|
|
<div class="tabs">
|
|
<ul>
|
|
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
<li><a href="annotated.html"><span>Data Structures</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="navpath"><a class="el" href="main.html">ChibiOS/RT</a> » <a class="el" href="articles.html">Articles and Code Samples</a> » <a class="el" href="page__general.html">General</a>
|
|
</div>
|
|
</div>
|
|
<div class="contents">
|
|
|
|
|
|
<h1><a class="anchor" id="article_eclipse">Setting up a free embedded IDE </a></h1><p>Free advanced embedded IDE for ChibiOS/RT. details This article will explain how to setup a free toolchain for use with ChibiOS/RT and general embedded development.<br/>
|
|
The guide is meant mainly for Windows users but notes about Linux and MAC OSX are present where the setup differs, mostly the toolchain is exactly the same.</p>
|
|
<h2>What this guide does not cover</h2>
|
|
<p>We will not enter in details of common system tasks like and not limited to:</p>
|
|
<ul>
|
|
<li>Installing applications (unless a special procedure is required).</li>
|
|
<li>Creating desktop shortcuts.</li>
|
|
<li>Adding paths to the PATH variable.</li>
|
|
<li>Creating environment variables.</li>
|
|
<li>Any other normal PC usage task.</li>
|
|
<li>Use of the toolchain, the use is covered by the <a class="el" href="article__eclipse2.html">Embedded development using Eclipse</a> article.</li>
|
|
</ul>
|
|
<h2>Article Index</h2>
|
|
<ul>
|
|
<li><a class="el" href="article__eclipse.html#required_components">Required Components</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_chibios">ChibiOS/RT Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_compiler">GCC ARM Compiler Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_eclipse">Eclipse Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_zylin">Zylin Plugin Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_openocd">OpenOCD Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_doxygen">Doxygen Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_graphviz">Graphviz Installation</a></li>
|
|
<li><a class="el" href="article__eclipse.html#install_eclox">Eclox Installation</a></li>
|
|
</ul>
|
|
<h2><a class="anchor" id="required_components">
|
|
Required Components</a></h2>
|
|
<p>The first thing to do is to download all the required components, beginners should avoid the optional components initially:</p>
|
|
<ul>
|
|
<li>A JTAG probe supporting GDB and OpenOCD, a list of compatible devices is available on the <a href="http://openocd.berlios.de/web/" target="_blank">OpenOCD home page</a>, more exactly <a href="http://openocd.berlios.de/doc/html/Debug-Adapter-Hardware.html#Debug-Adapter-Hardware" target="_blank">here</a>.</li>
|
|
<li><a href="https://sourceforge.net/projects/chibios/" target="_blank">ChibiOS/RT latest stable release</a>.</li>
|
|
<li><a href="http://www.java.com/en/" target="_blank">Java runtime</a>, you probably already have this installed.</li>
|
|
<li><a href="http://www.eclipse.org/downloads/" target="_blank">Eclipse IDE for C/C++ Developers</a></li>
|
|
<li><a href="http://www.yagarto.de/" target="_blank">YAGARTO ARM toolchain for Windows</a>, note that you need both the compiler and the tools (make and binutils).</li>
|
|
<li>Zylin plugin for on-board debugging, see <a class="el" href="article__eclipse.html#install_zylin">Zylin Plugin Installation</a> section.</li>
|
|
<li>OpenOCD binaries for Windows, YAGARTO does not provide those anymore but you can download them from <a href="http://www.freddiechopin.info/" target="_blank">here</a>. Linux users can try <a href="http://home.comcast.net/~mcatudal/" target="_blank">here</a>.</li>
|
|
<li><b>Optional</b>, <a href="http://www.stack.nl/~dimitri/doxygen/" target="_blank">MinGW compiler</a>, needed if you want to compile, debug and run the simulator from within Eclipse. Linux users do not need this one because all Linux distributions include the native GCC.</li>
|
|
<li><b>Optional</b>, <a href="http://www.stack.nl/~dimitri/doxygen/" target="_blank">Doxygen</a>, it is only required if you want to generate documentation from source files.</li>
|
|
<li><b>Optional</b>, <a href="http://www.graphviz.org/" target="_blank">Graphwiz</a>, it is only required if you want to generate diagrams within documentation from source files.</li>
|
|
<li><b>Optional</b>, <a href="http://home.gna.org/eclox/" target="_blank">Eclox</a>, it is only required if you want to generate documentation from source files from within Eclipse.</li>
|
|
</ul>
|
|
<h2><a class="anchor" id="install_chibios">
|
|
ChibiOS/RT Installation</a></h2>
|
|
<p>Just unzip it into a directory in your home folder, Windows users may consider c:\projects\chibios. It is strongly suggested to not put version numbers into the ChibiOS/RT directory name because Eclipse workspaces have absolute paths inside and you don't want to setup everything again each time a new ChibiOS/RT version is released, use plain "chibios".</p>
|
|
<h2><a class="anchor" id="install_compiler">
|
|
GCC ARM Compiler Installation</a></h2>
|
|
<p>Simply follow the YAGARTO installation guide. Linux/MACOS users have several other options:</p>
|
|
<ul>
|
|
<li>Download the latest CodeSourcery free Linux package.</li>
|
|
<li>Build it yourself, Liam recommended a build script <a href="http://github.com/esden/summon-arm-toolchain" target="_blank">here</a>, it looks interesting.</li>
|
|
</ul>
|
|
<p>Make sure that the compiler binaries directory is listed in the PATH variable or Eclipse would not be able to locate it.</p>
|
|
<h2><a class="anchor" id="install_eclipse">
|
|
Eclipse Installation</a></h2>
|
|
<p>Eclipse is distributed into a compressed archive, there is no installation procedure:</p>
|
|
<ul>
|
|
<li>Verify if you have Java installed, if not install the runtime. You may verify this using the command: "java -version". Make sure you have at least version 1.6.</li>
|
|
<li>Create an eclipse directory in your home and unpack the archive there. Windows users may unpack it into c:\program files\eclipse.</li>
|
|
<li>Create a desktop shortcut or other way to launch the Eclipse executable easily.</li>
|
|
<li>Launch Eclipse.</li>
|
|
<li>Eclipse will ask you a directory for its initial workspace, make it point to the ChibiOS/RT root directory (you may have as many workspaces you want, keep this for later), make sure to select the check box or it will ask you again each time. <br/>
|
|
<br/>
|
|
<div align="center">
|
|
<img src="tool001.jpg" alt="tool001.jpg"/>
|
|
</div>
|
|
<br/>
|
|
</li>
|
|
<li>Now you should see the welcome screen, close it and you will be in the normal C/C++ perspective.</li>
|
|
<li>Unselect "Project->Build Automatically" unless you like insanity.</li>
|
|
<li>Disable the "usage collector" in "Window->Preferences->Usage_Data_Collector" by unselecting "Enable
|
|
capture".</li>
|
|
<li>If you are behind a proxy or firewall (corporate users usually are) configure the correct parameters in "Window->Preferences->General->Network_Connections".</li>
|
|
<li>Let Eclipse auto update to the latest version "Help->Check_for_Updates".</li>
|
|
</ul>
|
|
<h2><a class="anchor" id="install_zylin">
|
|
Zylin Plugin Installation</a></h2>
|
|
<p>Eclipse requires an hardware debugger component in order to perform on board execution and debug.</p>
|
|
<ul>
|
|
<li>Open Eclipse, then "Help->Install_New_Software...".</li>
|
|
<li>Press the "Add..." button and put <a href="http://opensource.zylin.com/zylincdt">http://opensource.zylin.com/zylincdt</a> into the location field, then press OK. The Zylin plugin will appear in the available plugins view, select and install it. <br/>
|
|
<br/>
|
|
<div align="center">
|
|
<img src="tool002.jpg" alt="tool002.jpg"/>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
<h2><a class="anchor" id="install_openocd">
|
|
OpenOCD Installation</a></h2>
|
|
<p>Windows users just have to use the installer. Linux user should follow the normal installation procedure for deb or rpm packages, of course it is also possible to build it from the source code.</p>
|
|
<h2><a class="anchor" id="install_doxygen">
|
|
Doxygen Installation</a></h2>
|
|
<p>Just use the installer, Linux users probably have Doxygen already available from the repositories. Make sure that the Doxygen binaries directory is listed in the PATH variable or Eclipse would not be able to locate it.</p>
|
|
<h2><a class="anchor" id="install_graphviz">
|
|
Graphviz Installation</a></h2>
|
|
<p>Just use the installer, Linux users probably have Graphviz already available from the repositories. Make sure that the Graphviz binaries directory is listed in the PATH variable or Doxygen would not be able to locate it.</p>
|
|
<h2><a class="anchor" id="install_eclox">
|
|
Eclox Installation</a></h2>
|
|
<p>Use the same installation steps used for the Zylin plugin except use <a href="http://download.gna.org/eclox/update">http://download.gna.org/eclox/update</a> as URL. Install "Eclox" not "Eclox
|
|
Hot". After installing Eclox you will be able to compile Doxygen documentation using the button with the blue @ inside. </p>
|
|
</div>
|
|
<hr size="1"><address style="text-align: right;"><small>
|
|
Generated on Sun Jul 11 13:13:09 2010 for ChibiOS/RT by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.6.3</small></address>
|
|
</body>
|
|
</html>
|