Embedded/elua
1
0
Fork 0
mirror of https://github.com/elua/elua.git synced 2025-01-08 20:56:17 +08:00
Code Issues Projects Releases Wiki Activity

Update Windows building doc to reflect current git usage

Browse Source
This commit is contained in:
James Snyder 2011-12-02 20:00:27 -06:00
parent 9c27aed33a
commit 7d6d28bd7f
2 changed files with 33 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
doc/en/building_win.html
View File

@ -1,35 +0,0 @@
$$HEADER$$
<h3>Building eLua in Windows</h3>
<p>Starting with version 0.7, building <b>eLua</b> in Windows is officially supported. The following instructions were tested in Windows 7 Professional, but they
should work with little or no modification in any version of Windows 7, Vista or XP. You need to download and install a few things first:</p>
<ul>
<li><b>a toolchain</b>: building a GCC-based toolchain under Windows is possible but not easy. We found that the easiest thing to do is to download a pre-built toolchain
and install it. Currently, all the targets supported by <b>eLua</b> (except i386) have at least one toolchain that runs under Windows:
<ul>
<li>For ARM7, ARM9 and Cortex-M3 targets, you can download and install the CodeSourcery Lite Edition (supported by <b>eLua</b> out of the box) from
<a href="http://www.codesourcery.com/sgpp/lite/arm/portal/subscription?@template=lite">here</a>. For reference, the version used in this tutorial is
"Sourcery G++ Lite 2009q3-68 for ARM EABI". Future (and some previous) versions of this toolchain should also work. Remember to specify
<code>toolchain=codesourcery</code> when using this toolchain (see <a href="building.html#buildoptions">here</a> for details).</li>
<li>AVR32 has its own Windows based GNU toolchain that can be downloaded from Atmel <a href="http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4118">here</a>.</li>
</ul></li>
<li><b>Python</b>: my favourite Windows distribution of Python is <a href="http://www.activestate.com/activepython/">ActivePython</a>. Simply download it and install it. ActivePython
2.6.4.8 will be used in this tutorial. Other Python distribution might work equally as well.</li>
<li><b>scons</b>: download the Windows installer package from <a href="http://www.scons.org/download.php">here</a>. For this tutorial, scons 1.2.0 will be used. Remember to install
scons <b>after</b> you install Python. </li>
<li><b>lua</b>: a very good and versatile Lua distribution for Windows is "Lua for Windows", it can be downloaded from <a href="http://luaforwindows.luaforge.net/">here</a>. Besides
Lua itself, it includes a lot of very useful Lua modules, so I highly recommend it. Version 5.1.4.30 of Lua for Windows will be used in this tutorial.</li>
<li><b>svn</b>: if you need to checkout the <b>eLua</b> source code from the SVN repository, then you will need to install SVN for Windows. There are a few pre-compiled SVN packages for
Windows. I'm using the Tigris binaries that can be downloaded from <a href="http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100">here</a>. In this
tutorial I'll use version 1.6.6. If you require developer access (svn+ssh), additional steps are needed to make "svn+ssh" work in Windows. A lot of tutorials
that cover this topic are available, for example <a href="http://agateau.wordpress.com/2007/07/03/windows-svnssh-and-the-subversion-command-line-client/">this one</a>.</li>
<li><b>gcc</b>: if you want to use the ROMFS pre-compiled feature (see <a href="arch_romfs.html#mode">here</a> for details), then you will need to build an image for the <b>eLua</b> cross compiler, and you will need an i386
toolchain for this. I'm using MinGW for this task. It can be downloaded from <a href="http://www.mingw.org/">here</a>. This tutorial uses MinGW version 5.1.6. Note that you
don't need to install MSYS; MinGW should be enough. Cygwin should work equally as well, or even Microsoft's Visual Studio (not tested). To build the cross compiler, run
this command from the command line:
<pre><code>scons -f cross-lua.py</code></pre>
</li>
</ul>
<p>Make sure that all the programs listed above are added to %PATH%. Most of them do this automatically, or have an option to do this automatically, but some
(for example MinGW and SCons) do not and you will need to add them to %PATH% manually.</p>
<p>After you setup your build environment as described above, follow <a href="building.html#configuring">this tutorial</a> to build your <b>eLua</b> image.</p>
$$FOOTER$$

33
doc/en/building_win.txt Normal file
View File

@ -0,0 +1,33 @@
// $$HEADER$$
Building eLua in Windows
------------------------
Starting with version 0.7, building eLua in Windows is officially supported. The following instructions were tested in Windows 7 Professional, but they should work with little or no modification in any version of Windows 7, Vista or XP. You need to download and install a few things first:
* *a toolchain*: building a GCC-based toolchain under Windows is possible but not easy. We found that the easiest thing to do is to download a pre-built toolchain and install it. Currently, all the targets supported by eLua (except i386) have at least one toolchain that runs under Windows:
** For ARM7, ARM9 and Cortex-M3 targets, you can download and install the CodeSourcery Lite Edition (supported by eLua out of the box) from link:http://www.codesourcery.com/sgpp/lite/arm/portal/subscription?@template=lite[here]. For reference, the version used in this tutorial is
"Sourcery G++ Lite 2009q3-68 for ARM EABI". Future (and some previous) versions of this toolchain should also work. Remember to specify `toolchain=codesourcery` when using this toolchain (see link:building.html#buildoptions[build options] for details).
** AVR32 has its own Windows based GNU toolchain that can be downloaded from Atmel link:http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4118[here].
* *Python*: my favourite Windows distribution of Python is link:http://www.activestate.com/activepython/[ActivePython]. Simply download it and install it. ActivePython
2.6.4.8 will be used in this tutorial. Other Python distribution might work equally as well.
* *scons*: download the Windows installer package from link:http://www.scons.org/download.php[here]. For this tutorial, scons 1.2.0 will be used. Remember to install scons *after* you install Python.
* *lua*: a very good and versatile Lua distribution for Windows is "Lua for Windows", it can be downloaded from link:http://luaforwindows.luaforge.net/[here]. Besides Lua itself, it includes a lot of very useful Lua modules, so I highly recommend it. Version 5.1.4.30 of Lua for Windows will be used in this tutorial.
* *git*: if you need to checkout the *eLua* source code from the link:https://github.com/elua/elua[project git repository], then you will need to install git for Windows. The instructions at GitHub describing how to link:http://help.github.com/win-set-up-git/[set up git] for Windows should work well. You will only need the ssh key setup section if you want to push code to GitHub. For a version of git that integrates with the Windows shell (similar to TortoiseSVN), check out link:http://code.google.com/p/tortoisegit/[TortoiseGIT].
* *gcc*: if you want to use the ROMFS pre-compiled feature (see link:arch_romfs.html#mode[here] for details), then you will need to build an image for the eLua cross compiler, and you will need an i386 toolchain for this. I'm using MinGW for this task. It can be downloaded from link:http://www.mingw.org/[here]. This tutorial uses MinGW version 5.1.6. Note that you don't need to install MSYS; MinGW should be enough. Cygwin should work equally as well, or even Microsoft's Visual Studio (not tested). To build the cross compiler, run this command from the command line:
-----------------------
$ scons -f cross-lua.py
-----------------------
Make sure that all the programs listed above are added to %PATH%. Most of them do this automatically, or have an option to do this automatically, but some
(for example MinGW and SCons) do not and you will need to add them to %PATH% manually.
After you setup your build environment as described above, follow link:building.html#configuring[this tutorial] to build your eLua image.
// $$FOOTER$$