Documents/Install on Suse

From Nutwiki
Jump to: navigation, search

SuSE 9.3 - Professional Version - 23rd May, 2005

The following seven step instructions where those undertaked by the author with the assistance of Harald Kipp to build the new wxWidgets based ethernut-3.9.6 release. These steps may be a little disconcerting to people new to Linux but I strongly suggest that you just stick with it, follow each instruction carefully and you too will have the latest ethernut version installed and running on your system. What an acheivement!

If you get stuck somewhere and you wish to bring it to the attention of the author then please feel free to email me - grahame@wildpossum.com. I volunteered to build and maintain this page to keep it up to date for SuSE users.

You will need to install the following files if they do not currently exist on your system.

  • gcc-c++
  • libgcc
  • gcc
  • lua
  • autoconf
  • automake

Additionally you also need to delete the following files if they are already on your system

  • wxGTK including wxGTK-compat, wxGTK-gl
  • doxygen

Remember you can add & delete all the required files in one operation using Yast.

In using Yast2 or the command line Yast you may encounter complaints about program dependencies. If this is the case you will have to remove the offending program (taking note of which ones you are deleting) until your dependencies list is considered by Yast to be OK. If you had to delete required programs, you can simply use Yast to restore them at some later time.

Adding source code files from external sites

You now need to download the following (I suggest you save them in a new directory within your home directory e.g:. /home/myname/Downloads).

http://packages.debian.org/testing/libdevel/libgtk2.0-dev

http://www.wxwidgets.org => downloads => Unix/GTK+ => wxGTK-2.6.0.tar.bz2

http://www.doxygen.org => downloads => latest release => Source and select doxygen-1.4.3.src.tar.gz

http://www.gtk.org => downloads => GTK+-2.6 =>Source and select gtk+-2.6.7.tar.bz2

http://packages.debian.org/testing/devel/binutils-avr => below "More information" you will see the source filename [ binutils-avr_2.15.orig.tar.gz] simply point and click on this and save to your directory..

Having downloaded each file, make sure you downloaded the complete file (I noticed that when trying to download the wxWidgets.org site selecting the Sourceforge download didn't download the complete but rather a partial portion of wxGTK-2.6.0.tar.bz2 file. I had to download from the UK site. Note: This was a particular problem at my end, and this should not be the result you get).

Compiling the downloaded source files

1. Change Directory to your download directory e.g.: /home/myname/Downloads. You should have:

-rw-r--r-- 1 myname users 2767795 2005-05-23 02:33 doxygen-1.4.3.src.tar.gz

-rw-r--r-- 1 myname users 4371071 2005-05-23 02:35 graphviz-2.2.1.tar.gz

-rw-r--r-- 1 myname users 9448465 2005-05-23 02:47 wxGTK-2.6.0.tar.gz

-rw-r--r-- 1 myname users 11078546 2005-05-23 09:51 binutils-avr_2.15.orig.tar.gz

2. Now uncompress each file.

$ bunzip2 wxGTK-2.6.0.tar.bz2; tar xfv wxGTK-2.6.0.tar

$ tar xfvz doxygen-1.4.3.src.tar.gz

$ tar xfvz graphviz-2.2.1.tar.gz

$ tar xfvz wxGTK-2.6.0.tar.gz

$ tar xfvz binutils-avr_2.15.orig.tar.gz

Now you should have (new directories as highlighed):

drwxr-xr-x 15 myname users 800 2005-05-23 02:51 doxygen-1.4.3

-rw-r--r-- 1 myname users 2767795 2005-05-23 02:33 doxygen-1.4.3.src.tar.gz

drwxr-xr-x 33 myname users 1848 2005-05-23 03:14 graphviz-2.2.1

-rw-r--r-- 1 myname users 4371071 2005-05-23 02:35 graphviz-2.2.1.tar.gz

drwxr-xr-x 12 myname users 14536 2005-05-23 03:21 wxGTK-2.6.0

-rw-r--r-- 1 myname users 9448465 2005-05-23 02:47 wxGTK-2.6.0.tar.gz

drwxr-xr-x 2 myname users 88 2004-12-27 03:32 binutils-avr-2.15.orig

Unfortunately within the binutils-avr-2.15.orig directory is

-rw-r--r-- 1 myname users 11515075 2004-12-27 03:32 binutils-2.15.tar.bz2

So we have to uncompress this file to:

$ bunzip2 binutils-2.15.tar.bz2

which will finally give us a tar file that we uncompress with:

-rw-r--r-- 1 myname users 74608640 2004-12-27 03:32 binutils-2.15.tar

$ tar xfv binutils-2.15.tar

finally we have:

drwxr-xr-x 15 root root 1272 2005-05-23 10:01 binutils-2.15




3. Now enter each new directory and as superuser run ./configure; make and make install.

Depending on the speed of your system and the amount of memory it has it will take anywhere from an hour or two before doxygen-1.4.3, graphviz-2.2.1, binutils-2.15 and wxGTK-2.6.0 have configured, compiled and installed their respective programs, documentation and examples. I strongly suggest running three separate shell (x terminal) and doing your configure, make and make install all at once. This way you can have a break and do something else. If any of the .configuration(s) or make(s) complain about missing tools then you will have to correct this before continuing. If you see warning messages about depreciated calls or other compiler warnings don't worry about them, they are simply saying the original programmer is using some term that have been superceeded and they didn't use those updated term(s).




4. Once finished, as superuser do ldconfig to reload the library cache. This must be done.




5. Now you have to download the latest Ethernut release from its CVS. To do this simply set CVSROOT to :pserver:anonymous@cvs.sourceforge.net:/cvsroot/ethernut as shown below:

$ export CVSROOT=:pserver:anonymous@cvs.sourceforge.net:/cvsroot/ethernut

Now create a directory called /home/myname/ethernut change into this directory and do the following:

$ cvs login

At the password prompt simply press enter,

$ cvs co nut

and you should see the cvs system downloading into /home/myname/ethernut directory all the subdirectories and files that exist in the original ethernut CVS that holds the Ethernut source code. Once completed, you now have to run commands that will build the Ethernut system for you.




6. Build the Ethernut System.

Change to /home/myname/ethernut/nut directory and do:

$ aclocal

$ autoconf

$ autoheader

$ automake -add-missing

$ ./configure

$ make

$ make install




7. Now your almost finished. All you have to do is run /usr/local/bin/nutconf and follow the Ethernut site instructions as per http://www.ethernut.de/en/nutconf/index.html

Your Finished.... congratulate yourself on a job well done, make another coffee or herbal tea and enjoy EtherNUT. Cheers Grahame.