nuttx/configs/rgmp
patacongo c512c176e7 RGMP 0.2.0 patch applied
git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3687 42af7a65-404d-4744-a932-0658087f49c3
2011-06-09 14:11:33 +00:00
..
default Add E1000 PIC NIC driver from Yu Qiang 2011-05-21 18:25:31 +00:00
include First set of changes to incorporate the RGMP port 2011-05-12 17:42:01 +00:00
nsh Add E1000 PIC NIC driver from Yu Qiang 2011-05-21 18:25:31 +00:00
src First set of changes to incorporate the RGMP port 2011-05-12 17:42:01 +00:00
README.txt RGMP 0.2.0 patch applied 2011-06-09 14:11:33 +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.

The updated build instructions can be found at:
http://rgmp.sourceforge.net/wiki/index.php/Documentation

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

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

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, 2.6.35 or 2.6.38

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