Subversion Repositories HelenOS

Rev

Go to most recent revision | Blame | Last modification | View Log | Download | RSS feed

===============================================================================
                 HelenOS arm32 HOWTO for HelenOS newcomers
===============================================================================


-------------------------------------------------------------------------------
o HelenOS
-------------------------------------------------------------------------------

A lot of information about HelenOS may be found at http://www.helenos.eu. HelenOS
user manual is a good starting point. We'll cover only HelenOS arm32 specifics
in this document. 

-------------------------------------------------------------------------------
o ARM emulator (GXemul)
-------------------------------------------------------------------------------

Currenly we support GXemul emulator (testarm machine). Since we had to improve
this emulator a little bit (by adding an interrupt controller) you must download
it from  http://www.ms.mff.cuni.cz/~stepp3am/mygxemul-0.4.4.1.tar.gz

We are in contact with GXemul author to include our patch into the main release.

Download and install GXemul:

wget http://www.ms.mff.cuni.cz/~stepp3am/mygxemul-0.4.4.1.tar.gz
tar -xzf mygxemul-0.4.4.1.tar.gz
cd gxemul-0.4.4.1
./configure && make
# since make install is not supported, copy 'gxemul' somewhere to your PATH
# or anywhere you want
make clean

Cygwin note: you will need cygwin1.dll library

-------------------------------------------------------------------------------
o Sources
-------------------------------------------------------------------------------

All the source files may be get using Subversion and the following command.

svn co svn://svn.helenos.eu/HelenOS/branches/arm

HelenOS arm32 port should be inserted into the trunk soon.

-------------------------------------------------------------------------------
o Tools (GCC and binutils)
-------------------------------------------------------------------------------

When you get the sources, go to 'contrib/toolchain' directory and run
'toolchain.arm32.sh' to download, compile and install ARM GCC cross-compiler
and binutils.

-------------------------------------------------------------------------------
o Building HelenOS
-------------------------------------------------------------------------------

Run 'make' in HelenOS root directory. Select 'ARM 32-bit' and 'Cross-compiler'
then. Other options are up to you. 

Cygwin note: run 'tools/cygwin_symlink_path.sh' before 'make'

-------------------------------------------------------------------------------
o Running HelenOS
-------------------------------------------------------------------------------

If you compiled with framebuffer support run

gxemul -X -E testarm image.boot

otherwise run

gxemul -E testarm image.boot