test

ChorusOS 5.0 Installation Guide

Building the System Image

The following procedure assumes that the Sun Embedded Workshop software has already been correctly installed on the host workstation. See Chapter 1, Installing on the Host for installation instructions.

  1. Create and change to a build directory where you will build the system image:


    $ mkdir build_dir
$ cd build_dir
    Note -

    The file system containing the build_dir directory must be accessible by NFS from the remote ChorusOS target.

  2. Set an environment variable to use with the configure(1CC) command as a shortcut to the directory.

    For example:


    $ export DIR=/opt/SUNWconn/SEW/5.0-UltraSPARC/chorus-usparc

  3. Verify that the PATH environment variable has been set correctly to include the directory:

    install_dir/chorus-usparc/tools/host/bin

    where the default install_dir is /opt/SUNWconn/SEW/5.0-UltraSPARC.

    The PATH environment variable must include /usr/openwin/bin, which contains the imake utility.

  4. Configure the build directory, using the configure(1CC) command:

    • If you are building from a binary distribution:


      $ configure -b $DIR/kernel \ 
$DIR/os \ 
$DIR/tools \ 
-s $DIR/src/nucleus/bsp \ 
$DIR/src/nucleus/bsp/usparc/cpxxxx
      Note -

      The preceding command configures the build directory to include components installed during a "Default Install". This command does not include optional components, such as the X library or code examples, that you may choose decide to install separately on Solaris host workstations. For example, to include everything in your build environment:


      $ configure -b $DIR/kernel \ 
$DIR/os \ 
$DIR/opt/X11 \ 
$DIR/tools \ 
-s $DIR/src/nucleus/bsp \ 
$DIR/src/nucleus/bsp/usparc/cpxxxx \ 
$DIR/src/opt/examples

    • If you are building the system image from a source distribution, see the ChorusOS 5.0 Source Delivery Guide.

    As a result of the configuration, build_dir contains the Makefile, which generates the build environment, and the Paths file, which specifies paths to files required by and created in the build environment.

  5. Generate the build environment:


    $ make

  6. Define the target board using the TARGET feature using the configurator(1CC):


    $ configurator -set TARGET=CP1500

    The following options are available with the TARGET feature:

    • CP1500 (default)

    • CP2000

  7. Build the system image:


    $ make chorus

    The resulting system image file, chorus.obp, is located in the build_dir directory.

    Note -

    You can also make a smaller system image that includes only the operating system microkernel:


    $ make kernonly

  8. Generate the NFS root file system:


    $ make root

    This command creates a root directory in the build directory. The root directory contains binary and configuration files that are accessed by the target system.