Difference between revisions of "LinuxInstall"

From ArmadeusWiki
Jump to: navigation, search
(Enjoy the result: add step to copy binary images to /tftpboot)
Line 147: Line 147:
  
 
<noinclude>
 
<noinclude>
 +
 +
You then copy the binary image to your server directory:
 +
<pre class="host">
 +
$ cp buildroot/output/images/* /tftpboot
 +
</pre>
 +
  
 
==To keep your local copy/repository up-to-date with the armadeus GIT repository==
 
==To keep your local copy/repository up-to-date with the armadeus GIT repository==
Line 171: Line 177:
 
  $ make apfXX_defconfig
 
  $ make apfXX_defconfig
 
  $ make
 
  $ make
 +
$ cp buildroot/output/images/* /tftpboot
  
 
Enjoy!
 
Enjoy!
 
</noinclude>
 
</noinclude>

Revision as of 16:16, 19 April 2012

How-To install Armadeus Software Development Kit (SDK) on Linux systems. This SDK is currently based on the (excellent) Buildroot.


The installation was successfully tested on the following distributions:

  • Debian Sarge (3.1), Etch (4.0), Lenny (5.0) & Squeeze
  • X/KUbuntu Edgy Eft (6.10), Gutsy Gibbon (7.10), Hardy Heron (8.04) & Jaunty Jackalope (9.04)
  • Ubuntu Dapper Drake (6.04), Hardy Heron (8.04), Intrepid Ibex (8.10) & Lucid Lynx (10.04) (64bits)
  • Mandriva 2006
  • Fedora Core 3 & 4, Fedora 10, Laughlin (14)
  • Red Hat Enterprise 5.2
  • Gentoo 10.0 (32 & 64 bits)
  • SuSE 10.1, OpenSUSE 11.3

The installation may fail on:

  • Ubuntu Karmic Koala (9.10): tslib fails to build


Prerequisites for Linux installation

Note Note: From here we assume that your Linux system has a make version greater or equal to 3.81. To check it:
$ make -v
GNU Make 3.81
...

For armadeus up to 3.4, make should be strictly make-3.81 (make-3.82 is too strict). A Fedora (14 and 15) -specific solution can be found later; other recent distributions such as mageia1 also have make-3.82, and a generic solution, based on configure&& make&& sudo make install can be used to install make-3.81 (which can be retrieved from http://ftp.gnu.org/gnu/make/make-6.81.tar.gz) in /usr/local/bin (and , according to one's PATH, make 3-81 can be invoked directly or as /usr/local/bin/make).

Depending on your distribution, some additional packages are required:

Debian/Ubuntu based systems

Ubuntu/Debian installation prerequisites

Mandriva based systems

Mandriva installation prerequisites

RPM-based systems (RedHat, Fedora, CentOS)

RedHat/Fedora installation prerequisites

OpenSuse based systems

OpenSuse installation prerequisites

Get Armadeus software

 $ tar xjvf armadeus-4.1.tar.bz2
  • If you want the latest snapshot, the whole development tree can checked out from the GIT repository. (SVN repository is no more maintained !!!)
 $ git clone git://armadeus.git.sourceforge.net/gitroot/armadeus/armadeus armadeus
  • depending on your previous choice, a directory named armadeus/ or armadeus-4.1/ will be created on your hard-disk and will contain all the files you need.

Remarks:

Configure SDK options

Note Note: If you are new to Armadeus and have troubles compiling armadeus-4.1 using the following instructions, you may find some hints here: Armadeus 4.1 Troubleshots
  • Go to the directory where you put the Armadeus sources:
 $ cd armadeus/  (or armadeus-4.1/)
  • The first time you compile an Armadeus distribution you have to specify the target (here the APF9328) to work with.
 $ make apf9328_defconfig

This command reloads the default configuration to support your target and automatically start a Buildroot's configuration menu.

  • Current valid default configurations are:
apf9328_defconfig  apf27_defconfig  pps_defconfig  apf28_defconfig  apf51_defconfig

For PPS, please see APF27_PPS for details on its specific build.

  • After some downloads, you will get the Buildroot configuration interface:
Note Note: If you ever made changes in the following steps, at any time you can reload the default configuration with the same command


Menuconfig3.png

  • If you are not familiar with Buildroot here are some tips:
    1. you can move the highlighted item with the "up"/"down" arrow keys
    2. with the "left"/"right" arrow keys you can choose between "Select", "Exit" or "Help" buttons
    3. "space"/"enter":
      • selects the currently highlighted item if you are on the "Select" button
      • go back in previous menu if you are on "Exit" button
      • show you some Help for current item if you are on "Help" button
    4. for more Help about Buildroot commands, select "Help" in the main configuration screen
  • Update the memory configuration of your board:
In menu:
System configuration  --->    [*] Armadeus Device Support  --->


you can check and change the quantity of RAM available on your Armadeus board:
Build config memory.png
For APF9328 the memory can be either 16 or 32MiB (be sure to select 1 RAM chip)
For APF27 it could be either 64MiB or 128MiB (2 x 64MiB) (in that case be sure to select 2 chips of 64MiB instead of 1 chip of 128MiB).
For APF51 it could be either 256MiB or 512MiB (2x256MiB) (in such case be sure to select 2 chips of 256MiB instead of 1 chip of 512).
For APF28 The memory can be 128, 256, 512 or 1024MiB (be sure to select 1 RAM chip)
  • You may decrease the compilation time by increasing the number of parallel jobs running simultaneously on your system (the result is not guaranteed). This option is located in
Build Options --->    (1) Number of jobs to run simultaneously
  • During the toolchain/distribution automatic build, a lot of software archives are downloaded from Internet. The downloaded files are put by default in the armadeus/downloads/ directory. If you have several views or plan to build the toolchain several times, we advise you to put all the downloaded files in /local/downloads (for example). This is done by configuring Buildroot to use this directory for all your views. Nevertheless, buildroot will be downloaded separately for each build environment you set up.
Build options  --->    (...) Download dir
Build config menu download.png

Build config download.png

Of course, /local/downloads should exists on your system and you should have writing rights on it !

  • After the build, we advise you too to copy all the files in downloads/ on a removable medium, in case you want to install the development tools on several systems.
  • Now, Exit the configuration tool and save your configuration
  • You can come back to this configuration menu, by typing (your changes will be kept):
make menuconfig

Launch build

$ make

The toolchain and the full distribution are automatically built. During this procedure, several files are downloaded from Internet.
Please wait for a while.... it takes at least one hour for the first run!
By default, the downloaded files/tarball are put in the armadeus/downloads/ directory. Please see the previous chapter to know how to optimize that if you plan to build several views or want to build faster.

Enjoy the result

The generated binary files can be found in the subdirectory buildroot/output/images:

Please note the new naming convention of binary files and directories (since Armadeus 4.0)

  • buildroot/output/build: contains all the build results for target filesystem, linux, busybox and u-boot...
  • buildroot/output/toolchain/: cross compilation toolchain's build dir. Binaries usable for cross-compilation are in buildroot/output/host/usr/bin.
  • buildroot/output/target/: target filessytem before generating rootfs images

More information is available in the Buildroot's documentation

  • Note: Previous versions (3.x) of Armadeus SDK stored the generated binary files at a different place: buildroot/binaries/XX/ (where XX was the name of your board).


You then copy the binary image to your server directory:

 $ cp buildroot/output/images/* /tftpboot


To keep your local copy/repository up-to-date with the armadeus GIT repository

 $ git pull

This will update your working directory to the latest release.

Note: if "git pull" fails because a directory or a file already exists, then do:

$ rm -rf <this-directory/file>
$ git pull

You can do a:

$ make apfXX_defconfig

to have the latest features automatically activated.

You have to do a make to rebuild binary files and then upload the binary files to your target.

Note: if definitively everything goes wrong while it worked before the last update. You can apply the following procedure (all your modifications in buildroot will be lost):

$ rm -rf buildroot/
$ rm Makefile
$ git pull
$ make apfXX_defconfig
$ make
$ cp buildroot/output/images/* /tftpboot

Enjoy!