1
0
mirror of https://github.com/elua/elua.git synced 2025-01-08 20:56:17 +08:00
elua/doc/en/downloads.html
Bogdan Marinescu a6f8f4d8a1 Added partial integration of AsciiDoc (http://www.methods.co.nz/asciidoc/) to our documentation system. For now:
- AsciiDoc doesn't work on automatically generated documentation (eluadoc/), just on the static content (but it will)
- Both AsciiDoc and the previous HTML versions are supported, HTML has priority over AsciiDoc

You need at least version 8.6.0 of AsciiDoc to test this.
To give an example of how cool AsciiDoc is, the News page (en/news.html) was rewritten in AsciiDoc format (en/news.txt). 
If you can't see the beauty of writing HTML in such a way that the overall structure of the document remains clear and easy to understand, I reserve the right to question your mental health :)
And yes, the long term goal is to have everything written in AsciiDoc.
2010-10-04 20:55:39 +00:00

227 lines
11 KiB
HTML

$$HEADER$$
<h3>Downloading eLua</h3>
<p>You have a few options for downloading <b>eLua</b>:</p>
<ul>
<li>download a binary <b>eLua</b> image for the platform of your choice. Binary images are provided with each official release
and also for some specific applications (ie: games). This is generally the best option if you have a
board that's officially
supported by <b>eLua</b> (see <a href="status.html">here</a> for details) and you want to have <b>eLua</b> up and running on your board as quickly as possible.</li>
<li>download the source code to build <b>eLua</b> yourself. You can either download the source code of an official release or get the "bleeding edge" version from the SVN repository. Download the source code instead of a
binary image if you need to make adjustments to the source code to support your board, or if you want to customize the <b>eLua</b> image, or if you simply want to take a look at what
happens behind the <i>eLua# </i> prompt :)</li>
</ul>
<a name="binaries" /><h3>Binary images</h3>
<p>Pre-built images of <b>eLua</b> can be downloaded for each official release. Only the latest official <b>eLua</b> release is covered in this
paragraph. If you want to download a pre-built image from an older release (although this isn't generally advisable), check <a href="dl_old.html">this page</a>.
</p>
<p>Choose the corresponding image file from the table below, flash it into your
board, connect a serial terminal (or Ethernet if you board supports) and enjoy <b>eLua</b>.
Please also note that <b>eLua binaries</b>, like the <a href="#source">source code distribution</a>,
include some example programs in it's file system, so you can run and play (yes! we have games too! :) them , following the instructions in our <a href="using.html">Using eLua</a> page.
The available example programs are described in our <a href="examples.html">examples page</a>.
</p>
<p>
If you need a customized binary image for an already supported platform (for example with an autorun program, with some code of yours in the file system, with your LAN IP settings) and the
<a href="building.html">instructions for building eLua</a> didn't work for you, feel free to
ask for one in <a href="https://lists.berlios.de/mailman/listinfo/elua-dev">our discussion
list</a> explaining what you need. We may find some time to
build one for you and eventually make it available here too.
</p>
<h2>Official Latest Release Binaries</h2>
<p>
To understand what's in a file name (for example <i>elua_lualong_lm3s8962.bin</i>) check our <a href="building.html">building eLua</a> page.
</p>
<table class="table_center">
<tbody>
<tr>
<th>Version</th>
<th>MCU</th>
<th>Board</th>
<th>Lua number type</th>
<th>Image file</th>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.luminarymicro.com/products/LM3S8962.html">LM3S8962</a></td>
<td><a href="http://www.luminarymicro.com/products/lm3s8962_can_ethernet_evaluation_kit.html">EK-LM3S8962</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_lm3s8962.bin">elua0.7_lua_lm3s8962.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.luminarymicro.com/products/lm3s6965.html">LM3S6965</a></td>
<td><a href="http://www.luminarymicro.com/products/lm3s6965_ethernet_evaluation_kit.html">EK-LM3S6965</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_lm3s6965.bin">elua0.7_lua_lm3s6965.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.luminarymicro.com/products/LM3S6918.html">LM3S6918</a></td>
<td><a href="http://www.micromint.com/index.php/SBC/eagle-100.html">Micromint Eagle 100</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_lm3s6918.bin">elua0.7_lua_lm3s918.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.luminarymicro.com/products/lm3s9b92.html">LM3S9B92</a></td>
<td><a href="http://www.luminarymicro.com/products/ek-lm3s9b92.html">EK-LM3S9B92</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_lm3s9b92.bin">elua0.7_lua_lm3s9b92.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.atmel.com/dyn/products/Product_card.asp?part_id=3755">AT91SAM7X256</a></td>
<td><a href="http://www.olimex.com/dev/sam7-ex256.html">SAM7-EX256</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_at91sam7x256.bin">elua0.7_lua_at91sam7x256.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.atmel.com/dyn/products/Product_card.asp?part_id=4104">AT91SAM7X512</a></td>
<td>None</td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_at91sam7x512.bin">elua0.7_lua_at91sam7x512.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.atmel.com/dyn/products/product_card.asp?part_id=4117">AT32UC3A0512</a></td>
<td><a href="http://www.atmel.com/dyn/Products/tools_card.asp?tool_id=4114">ATEVK1100</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_at32uc3a0512.hex">elua0.7_lua_at32uc3a0512.hex</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.standardics.nxp.com/microcontrollers/to/pip/LPC2880FET180.html">LPC2888</a></td>
<td><a href="http://www.olimex.com/dev/lpc-h2888.html">LPC-H2888</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_lpc2888.bin">elua0.7_lua_lpc2888.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.nxp.com/#/pip/pip=[pip=LPC2468_4]|pp=[t=pip,i=LPC2468_4]">LPC2468</a></td>
<td><a href="http://www.giga.puc-rio.br/site/embedded/eluademoboard">PUC-Rio eLua board</a></td>
<td>double</td>
<td><a
href="http://prdownload.berlios.de/elua/elua0.7_lua_lpc2468.hex">elua0.7_lua_lpc2468.hex</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.st.com/mcu/devicedocs-STR711FR2.html">STR711FR2</a></td>
<td><a href="http://www.sctec.com.br/content/view/101/30/">MOD711</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_str711fr2.bin">elua0.7_lua_str711fr2.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.st.com/mcu/devicedocs-STR912FAW44-101.html">STR912FAW44</a></td>
<td><a href="http://www.olimex.com/dev/str-e912.html">STR-E912</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_str912faw44.bin">elua0.7_lua_str912faw44.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.st.com/mcu/devicedocs-STM32F103RE-110.html">STM32F103RE</a></td>
<td><a href="http://www.futurlec.com/ET-STM32_Stamp.shtml">ET-STM32 Stamp</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_stm32f103re.bin">elua0.7_lua_stm32f103re.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.st.com/mcu/devicedocs-STM32F103ZE-110.html">STM32F103ZE</a></td>
<td><a href="http://www.st.com/mcu/contentid-100-110-STM3210E_EVAL.html">STM3210E-EVAL</a></td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_stm32f103ze.bin">elua0.7_lua_stm32f103ze.bin</a></td>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://www.intel.com">i386 (generic)</a></td>
<td>PCs/emulators</td>
<td>double</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7_lua_i386.elf">elua0.7_lua_i386.elf</a></td>
</tr>
</tbody>
</table>
<p>
<b>NOTE:</b> <i>Lua number type</i> refers to the built Lua interpreter number type, float or integer, as explained in the <a href="building.html">building eLua</a> page.
<h2>Official Custom Build Binaries</h2>
<p>
Besides the regular <b>eLua</b> binary images (above), which also come bundled
with examples on the rom file system, we offer here some custom build
images with programs for specific boards and/or specific
aplications. They are ready to be flashed directly on your kits and usually
run automatically using our autorun feature (see <a
href="http://www.eluaproject.net/en_arch_overview.html#boot">booting
<b>eLua</b></a> for details).
If you own one of the supported boards listed below, just
download a binary image, flash it on the kit and enjoy it. If you write nice
and ilustrative programs, don't hesitate to share and we'll publish
them in ready-to-use, custom built, binary images too.
</p>
<table class="table_center">
<tbody>
<tr>
<th>Aplication description</th>
<th>Board</th>
<th>Image file</th>
</tr>
<tr>
<td>EK-LM3S8962 Games & Demos</td>
<td><a
href="http://www.luminarymicro.com/products/lm3s8962_can_ethernet_evaluation_kit.html">EK-LM3S8962</a></td>
<td><a
href="./downloads/elua_games_EK-LM3S8962.bin">elua_games_EK-LM3S8962.bin</a></td>
</tr>
<tr>
<td>EK-LM3S6965 Games & Demos</td>
<td><a
href="http://www.luminarymicro.com/products/lm3s6965_ethernet_evaluation_kit.html">EK-LM3S6965</a></td>
<td>(comming soon!)</td>
</tr>
</table>
<p/>
<a name="source" /><h3>Source code</h3>
<p>If all you want is to take a quick peek at <b>eLua</b>'s source code, but you don't need to download it, it's probably enough to use the
<a href="http://svn.berlios.de/wsvn/elua">BerliOS WebSVN interface</a>. You can browse through the complete source of <b>eLua</b> using this method.<br />
If you need to download the source code of <b>eLua</b> you can either:</p>
<ul>
<li>download the source code archive of an official release</li>
<li>checkout the latest (bleeding edge) source code from the SVN repository in read-only mode (anonymous) mode</li>
<li>checkout the latest (bleeding edge) source code from the SVN repository in read-write mode (for developers)</li>
</ul>
<a name="official" /><h2>Source code archives</h2></a>
<p>Check the table below for the download link of the source code associated with the latest official release of <b>eLua</b>. If you want to get the source
code of an older version, check out <a href="dl_old.html">this page.</p>
<!-- [NEWVER] -->
<table class="table_center">
<tbody>
<tr>
<th>Version</th>
<th>Source code archive</th>
</tr>
<tr>
<td>0.7</td>
<td><a href="http://prdownload.berlios.de/elua/elua0.7.tgz">eLua 0.7</a></td>
</tr>
</tbody></table>
<a name="svnpublic" /><h2>SVN public repository (anonymous read-only mode)</h2>
<p>If you'd rather have the very last development ("bleeding edge") version, just check it out from our Subversion Repository:</p>
<pre>$ svn checkout svn://svn.berlios.de/elua/trunk</pre>
<p>Once checked out, the repository can be easily updated by the svn client command:</p>
<pre>$ svn update</pre>
<a name="svndev" /><h2>SVN public repository (authenticated login r/w mode, for developers)</h2>
<p>Follow the steps below if you need write access to the <b>eLua</b> repository:</p>
<ul>
<li>if you don't have an account on <a href="http://developer.berlios.de/">developer.berlios.de</a>
and you plan to contribute with code for the project, please create one.</li>
<li><a href="overview.html#contacts">contact us</a> specifying your BerliOS ID and we'll give you write
(commit) access to the subversion repository.</li>
</ul>
<p>Then checkout the repository:</p>
<pre>$ export SVN_SSH='ssh -l &lt;yourberliosid&gt;'
$ svn checkout svn+ssh://svn.berlios.de/svnroot/repos/elua/trunk</pre>
<p>Once checked out, the repository can be easily updated:</p>
<pre>$ svn update</pre>
$$FOOTER$$