nuttx/configs/rgmp
patacongo f7227347d4 updates to RGMP files
git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3612 42af7a65-404d-4744-a932-0658087f49c3
2011-05-15 14:58:46 +00:00
..
default updates to RGMP files 2011-05-15 14:58:46 +00:00
include First set of changes to incorporate the RGMP port 2011-05-12 17:42:01 +00:00
nsh updates to RGMP files 2011-05-15 14:58:46 +00:00
src First set of changes to incorporate the RGMP port 2011-05-12 17:42:01 +00:00
README.txt updates to RGMP files 2011-05-15 14:58:46 +00:00

RGMP README File
================

RGMP stands for RTOS and GPOS on Multi-Processor.  RGMP is a project for 
running GPOS and RTOS simultaneously on multi-processor platforms. You can
port your favorite RTOS to RGMP together with an unmodified Linux to form a
hybrid operating system. This makes your application able to use both RTOS
and GPOS features.

See http://rgmp.sourceforge.net/wiki/index.php/Main_Page for further
information about RGMP.

Ubuntu Build Instructions
--------------------------
Build requirements:
Hardware: x86 PC
Software: Ubuntu 10.04 or Ubuntu 10.10

Run requirements:
Hardware: multi-processor x86 PC
Software: Ubuntu 10.04 or Ubuntu 10.10

1. Download RGMP from the following URL:

   http://rgmp.sourceforge.net/wiki/index.php/Download

   You should choose a right verion of RGMP compatible with this NuttX release.
   Extract the tar file:

   $ tar -xjvf rgmp-<RGMP-version>.tar.bz2

2. Get Linux kernel header:

   $ sudo apt-get install linux-headers-$(uname -r)

3. Build and install RGMP:

   $ cd <rgmp-dir>
   $ ./configure
   $ make
   $ sudo make install
   $ sudo /usr/rgmp/setup
   $ exit

4. Configure NuttX.  For example, for the RGMP NSH configuration, do the
   following:

   $ cd <nuttx-dir>
   $ cd tools
   $ ./configure.sh rgmp/nsh
   $ cd ..

5. Build NuttX. Get the binary image at <nuttx-dir>/kernel.img.

   $ cd <nuttx-dir>
   $ make

6. Run NuttX in RGMP:

   $ cd <nuttx-dir>
   $ su
   $ rgmp_run


Other Linux OS Build Instruction
--------------------------------------
Requirements:
Hardware: multi-processor x86 PC
Software: running Linux kernel 2.6.32 or 2.6.35 kernel

1. Get your running Linux kernel header under /usr/src/linux-headers-$(uname -r)
   directory.

2. Following the Ubuntu steps begin at 3. 

Note: You can configure the RGMP to find Linux kernel header in a different
      place and install RGMP to a different place. See information printed
      by the following instruction:

      $ cd <rgmp-dir>
      $ ./configure -h