test

ChorusOS 5.0 Installation Guide

Using the visionXD Tool

For the following procedures, it is assumed that you use the visionXD tool either to boot the target system or to place the bootMonitor image in flash memory on the target system. The URL for the visionXD tool is: http://www.windriver.com/products/html/vxd.html

Note -

For simplicity, it would help if the visionXD tool is installed on the host.

To Build a ChorusOS System Image

The following procedure assumes that the ChorusOS product has already been correctly installed on the host workstation. See Part I, Installing on the Host.

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


    $ mkdir build_dir
$ cd build_dir

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

    For example:


    $ export DIR=/opt/SUNWconn/SEW/5.0-PowerPC/chorus-powerpc

  3. The PATH environment variable must be set correctly to include the directory:

    install_dir/chorus-powerpc/tools/host/bin

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

    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/powerpc/sbc8260
      Note -

      The above command configures the build directory to include components installed during a "Default Install". It does not include optional components, such as the X library or code examples, that you decide to install separately on Solaris host workstations. For example, in order 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/powerpc/sbc8260 \ 
$DIR/src/opt/examples

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

    As a result of configuration, build_dir now 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. Configure the system image:


    $ configurator -set ETHER_ADDR=xx:xx:xx:xx:xx:xx

    where xx:xx:xx:xx:xx:xx is the target system Ethernet address.

  7. Build a system image:


    $ make chorus

    The resulting system image file is located in the build directory, build_dir, and is called chorus.RAM.

    Note -

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


    $ make kernonly
To Place the System Image on the Boot Server

See the Chapter 5, Setting Up a Boot Server, for instructions on how to configure the boot server.

  1. Copy the system image to the boot server.

    For example, on a Solaris host workstation:


    $ rcp chorus.RAM boot_server:/tftpboot

  2. Verify that at least read permissions are available for the system image on the boot server.

    For example:


    $ rlogin boot_server
Password: password_for_user
$ ls -l /tftpboot/chorus.RAM
-rwxr-xr-x   1 user    group     1613824 Dec 15 17:33 chorus.RAM*

  3. (Optional) While logged in to the boot server, create a configuration file for the target.

    For a target system with IP address 129.157.173.199 using a boot server with IP address 129.157.173.144, the configuration file contains the following:

    AUTOBOOT=YES
BOOTFILE=chorus.RAM
BOOTSERVER=129.157.173.144

    The configuration file is named /tftpboot/819DADC7.ChorusOS.5.0, which is constructed from the target system IP address 129.157.173.199 as a concatenation of the following:

    • 129 in decimal translates to 81 in hexadecimal.

    • 157 in decimal translates to 9D in hexadecimal.

    • 173 in decimal translates to AD in hexadecimal.

    • 199 in decimal translates to C7 in hexadecimal.

    • (optional) A .ChorusOS.5.0 extension identifies the release, and is appended to the concatenation of the IP address expressed in hexadecimal.

    Note -

    The system first looks for the configuration file with the .ChorusOS.5.0 extension. If no such file exists, the system looks for a configuration file without the .ChorusOS.5.0 extension.

To Set Up the visionXD and visionICE Tools

See the visionXD and visionICE documentation for detailed installation instructions.

  1. Connect visionICE to the target system, plugging the transceiver into the MII connector and switching the transceiver to UP.

  2. Connect the target system to the network.

  3. Connect and configure visionICE and visionNET.

  4. Install the visionXD tool on the host workstation.

  5. Select Configure Global Settings... from the Tasks menu, and use the dialog box displayed to configure the connection to the target system.

To Boot the SBC8260 Target System Using the visionXD Tool

  1. Start the visionXD tool.

  2. Select Connect from the Target menu to connect the visionXD tool to the target system.

  3. Click the terminal button to display a terminal window with the BKM prompt.

  4. Enter in at the BKM prompt to set initialization values for the target system registers:


    >BKM> in

  5. Select Load Executable... from the File menu.

  6. Select the chorus.RAM system image and click Load.

  7. After the target system has finished downloading the system image, click Run.