From fc98d482a7c68f321b295c00f00b8b29f7ee673e Mon Sep 17 00:00:00 2001 From: Bogdan Marinescu Date: Thu, 26 Feb 2009 14:54:28 +0000 Subject: [PATCH] - Added "installing on AVR32" page - Minor changes to the other "installing" pages --- doc/en/installing_at91sam7x.html | 2 +- doc/en/installing_avr32.html | 81 ++++++++++++++++++++++++++++++++ doc/en/installing_lm3s.html | 2 +- doc/en/installing_lpc2888.html | 2 +- doc/en/installing_str7.html | 2 +- doc/en/installing_str9.html | 2 +- doc/style.css | 1 + 7 files changed, 87 insertions(+), 5 deletions(-) create mode 100644 doc/en/installing_avr32.html diff --git a/doc/en/installing_at91sam7x.html b/doc/en/installing_at91sam7x.html index 7fb7035d..de97918b 100644 --- a/doc/en/installing_at91sam7x.html +++ b/doc/en/installing_at91sam7x.html @@ -25,7 +25,7 @@ tedious to use. If you still want to use it though, you might want to check the forementioned Olimex page, they have some OpenOCD related links there. That said, from now on I'm going to assume that you use Windows. I'm using XP, Vista should work too.
  • you have installed the AT91 In-system Programmer (ISP) package from Atmel.
    • -
  • you already built your eLua image for the AT91SAM7X256 CPU.
    • +
  • you already have your eLua image for the AT91SAM7X256 CPU (built or downloaded).

    • Programming eLua on the SAM7-EX256 board

    This involves some jumper tricks, but it's still easy enough to do. We'll need to play with four jumpers: the "USB/EXT" jumper (located to the right of the USB connector diff --git a/doc/en/installing_avr32.html b/doc/en/installing_avr32.html new file mode 100644 index 00000000..afa97f7a --- /dev/null +++ b/doc/en/installing_avr32.html @@ -0,0 +1,81 @@ + + + + + + Installing eLua on AVR32 CPUs +

    Installing eLua on the AVR32 CPUs from Atmel

    +

    AVR32 is a family of high performance 32-bit CPUs from Atmel. They were built as direct competitors for the various ARM core implementation of the market, and offer very good + performance (91 MIPS @ 66MHz) and power efficieny (1.3mW/MHz). Atmel claims that their AVR32 core outperforms ARMv5 (in ARM and Thumb mode) in terms of + both performance and code size. It's a proprietary architecture (so it's only implemented by Atmel), yet it has a very good support package, and an + open source toolchain based on GCC, which made it an ideal candidate for the first non-ARM (and also the first big endian) eLua target. Atmel + also sells a number of development boards based on their AVR23 CPUs. The one used for eLua is the + ATEVK1100 board, built around the + AT32UC3A0512 AVR32 MCU (512k internal Flash/64k internal ARM). + It's a very powerful board, featuring (among other things) an external 32 MByte SDRAM memory, which is more than enough to run any eLua + program I can think of :).

    +

    Prerequisites

    +

    Before you'll be able to use eLua on the AT32UC3A0512 CPU, make sure that:

    +

    +

    Installing FLIP in Ubuntu Linux

    +

    Follow the steps below to install FLIP under Linux: +

      +
    1. download the Linux version of FLIP from the Atmel FLIP page. Save it + (or move it later) to your /usr/local/ directory (you need to have superuser privileges to do that). At the moment of writing this tutorial, the + latest FLIP version is 3.2.1, so this is what we're going to use here.
      2. +
    2. untar the FLIP archive: + 

      $ cd /usr/local
+$ sudo tar xvzf flip_linux_3-2-1.tgz
      + This will create the /usr/local/flip.3.2.1 directory.
      3. +
    3. you need to install OpenJDK if it is not installed: + 

      $ sudo apt-get install openjdk-6-jre

      +
      4. +
    4. edit /usr/local/flip.3.2.1/bin/batchisp3.sh and add the two bolded lines before at the beginning of the file: + 

      #!/bin/bash -f
+
+export JAVA_HOME=/usr/lib/jvm/java-6-openjdk/jre/
+export FLIP_HOME=/usr/local/flip.3.2.1/bin/
+
+if [ "$FLIP_HOME" = "" ]; then

      +
      5. +
    5. you need to edit a binary file this time (/usr/local/flip.3.2.1/libatlibusbdfu.so). This happens because FLIP comes compiled for RedHat by + default, and Ubuntu some different system paths. See this topic + for full details. All you have to do is change all the /sys/bus/usb strings inside libatlibusbdfu.so to /dev/bus/usb.
      6. +
    6. add the FLIP directory to your PATH: + 

      $ export PATH=/usr/local/flip.3.2.1/bin:$PATH

      +
      7. +
    7. FLIP interferes with a program that comes pre-installed on Ubuntu system, called brltty. It's meant to help the visually + impaired, so if you're not one of them, simply remove it (as it seems to interfere with a lot of other USB devices too): + 

      $ sudo apt-get remove brltty

      +
      8. +
    +

    +

    Burning eLua to the EVK1100 board

    +

    After you installed FLIP and added it to your $PATH, burning the eLua image should be quite easy: +

    +

    That's all, your eLua image is (finally) installed on your ATEVK1100 board.

    + + diff --git a/doc/en/installing_lm3s.html b/doc/en/installing_lm3s.html index 383afe64..f09ebfa1 100644 --- a/doc/en/installing_lm3s.html +++ b/doc/en/installing_lm3s.html @@ -21,7 +21,7 @@ an emulator in Linux, it doesn't matter, you can even try to run it from Wine if you're really, really brave. I'm using XP, Vista should work too.
  • you have installed the LM Flash Programmer tool from Luminary. Look for it on this page, for example (the link is in the "Software updates" table).
    • -
  • you already built your eLua image for the LM3S8962 CPU.
    • +
  • you already have your eLua image for the LM3S8962 CPU (built or downloaded).

    • Installing eLua on EKx-LM3S8962EK and EKx-LM3S6965

    Fortunately, this is as easy and painless as possible. One of the nicest things about these two kits is they use the on-board USB port for both firmware downloading and for diff --git a/doc/en/installing_lpc2888.html b/doc/en/installing_lpc2888.html index 1a5bf0f4..b05908d7 100644 --- a/doc/en/installing_lpc2888.html +++ b/doc/en/installing_lpc2888.html @@ -27,7 +27,7 @@

  • if you're using DFU, you have installed the LPC2888 flash programming utility from here (the package also contains the Windows DFU drivers).
  • if you're using OpenOCD, you have followed the instructions from my OpenOCD tutorial.
    • -
  • you already built your eLua image for the LPC2888 CPU.
    • +
  • you already have your eLua image for the LPC2888 CPU (built or downloaded).

    • Burning eLua to the LPC2888 using the DFU tool from NXP

    The DFU flashing application doesn't work directly on the .bin files you get after building eLua, you need to run them though NXP's "hostcrypt" program (which is part of the LPC2888 DFU package). After you have your eLua .bin file, diff --git a/doc/en/installing_str7.html b/doc/en/installing_str7.html index c573b8ec..0c431dbe 100644 --- a/doc/en/installing_str7.html +++ b/doc/en/installing_str7.html @@ -11,7 +11,7 @@ based on this STR711FR2 variant of the STR7 family. Since this is not a full-fle

    Before you'll be able to use eLua on the STR711FR2 CPU, make sure that:

    Burning eLua to the MOD711 board

    You need OpenOCD to do this. Just follow the instructions from my OpenOCD tutorial . On the tutorial page you'll also find links to the OpenOCD diff --git a/doc/en/installing_str9.html b/doc/en/installing_str9.html index c898979a..b2db440b 100644 --- a/doc/en/installing_str9.html +++ b/doc/en/installing_str9.html @@ -16,7 +16,7 @@

    Burning eLua to the STR9-comStick

    You need OpenOCD to do this. Just follow the instructions from my OpenOCD tutorial . On the tutorial page you'll also find links to the OpenOCD diff --git a/doc/style.css b/doc/style.css index 25b8d8dd..9b10e823 100644 --- a/doc/style.css +++ b/doc/style.css @@ -34,6 +34,7 @@ pre { line-height: 125%; margin-left: 1em; margin-right: 1em; + overflow: auto; } p.info { margin-left: 3em;