TOC PREV NEXT INDEX

LynxOS Installation Guide


Introduction

LynxOS Overview

The LynxOS product family is comprised of many tools and features that collectively form a state-of-the-art development environment for writing, debugging, and deploying real-time embedded applications. The real-time LynxOS kernel is provided in two forms:

Libraries, compilers, linkers, debuggers, and other tools are provided in the LynxOS development environment for developing kernels and user applications.

Application and kernel development can take place in a supported Cross Development Environment, with tools installed on a host system running Windows, Solaris, or Linux. Applications and kernels compiled on a cross development environment can be downloaded and executed on a LynxOS target system.

Application and kernel development can also take place in a supported Native Development Environment, where all development tools run on the native CPU. Compilation, linking, debugging, and execution of the user's application occurs seamlessly on a single LynxOS target.

Note: See the LynxOS Release Notes for the supported versions of cross development hosts, supported target architecture, and processors.

Windows Cross Development Environment

The Windows Cross Development Environment allows users to develop LynxOS applications or kernels on a Windows desktop. The applications and kernels are built for a particular target system architecture with the LynxOS cross development tools. The cross development environment includes all the necessary tools and utilities to build applications or kernels for a specific target.

The base LynxOS Windows cross development package includes the following CD-ROMs:

This CD-ROM contains:

- Cross Development Kit for Windows (CDK)
- Open Development Environment (ODE)
- Board Support Package (BSP)

Descriptions of these CD-ROMs are provided in the section "LynxOS Media".

Cross development environment installation instructions are provided in "Installing LynxOS Cross Development Systems" .

UNIX Cross Development Environment

The Cross Development Environment for UNIX hosts (which includes all supported versions of Linux and Solaris) allows users to develop LynxOS applications or kernels for a particular target system architecture. The applications and kernels are built with the LynxOS cross development tools. The cross development environment includes all the necessary tools and utilities to build applications or kernels for a specific target.

The base LynxOS UNIX-hosted cross development package includes the following CD-ROMs:

This CD-ROM also contains the Board Support Package (BSP) for a particular target.

Descriptions of these CD-ROMs are provided in the section "LynxOS Media".

Cross development environment installation instructions are provided in "Installing LynxOS Cross Development Systems" .

Native Development Environment

The LynxOS Native Development Environment provides users the ability to develop LynxOS applications and kernels on the target architecture. The native development package includes tools and utilities that run natively on a target.

The native development environment includes the following CD-ROMs:

This CD-ROM also contains the Board Support Package (BSP) for a particular target.

Descriptions of these CD-ROMs are provided in the section "LynxOS Media".

Native development environment installation instructions are provided in "Installing LynxOS x86 Native Development Systems" , and "Installing LynxOS PowerPC Native Development Systems" .

LynxOS Media

The CD-ROMs included in each development environment are detailed in the following sections.

Open Development Environment (ODE) CD-ROM

The base LynxOS development package is called the Open Development Environment (ODE). The ODE contains all the components needed to develop LynxOS kernels and user applications in both native and cross development environments. The ODE includes tools, libraries, and utilities in built for a particular processor architecture (x86, or PowerPC, for example).

The ODE CD-ROMs also includes a Board Support Package (BSP) that includes tools to build applications and kernels for a particular target board.

Note: The x86 DRM and non-DRM ODEs are available as separate CD-ROMs.

Cross Development Kit (CDK) CD-ROM

The LynxOS Cross Development Kit (CDK) contains the cross development software (including the GNU compiler and debugger) for the Cross Development Host. This CD-ROM is available per operating system environment (i.e., Windows, Linux, or Solaris). Each CDK CD-ROM contains the cross development tools for supported architectures (PPC, x86, or others).

Messenger

LynxOS Messenger is included for supported BSPs only.

X and Motif CD-ROM

The X Windows/Motif/Posix Desktop CD is included with native development environments only, and contains the native LynxOS X & Motif system files. This CD also includes the LynxOS PosixWorks Desktop. This CD-ROM is available per target architecture. For cross development customers who want to use X & Motif libraries, the X & Motif CD-ROM is available for purchase separately.

The installation procedures for X11 and Motif libraries, servers, and tools are described in "Installing X & Motif"

Additional Components CD-ROM

The Additional Components CD-ROM contains various components for LynxOS, including:

These components are installed after the base LynxOS installation.

Other Products

Other tools and products, such as the TotalView debugger, SpyKer kernel event trace analyzer, and LynxInsure++ code quality tools, are sold separately and include their own installation instructions.

Before Installing

Review and complete the following sections before proceeding with the installation of LynxOS.

System Requirements

The following hardware requirements must be met before installing LynxOS on a system.

System Requirements for LynxOS  
Component
Requirement
RAM
(all platforms)
8 MB minimum
16 MB minimum for development systems
32 MB minimum for X & Motif
64 MB recommended for full development suite
Hard Disk Space (x86)
LynxOS
X & Motif
127 MB
350 MB
Hard Disk Space (PowerPC)
LynxOS
X & Motif
167 MB
350 MB

Native Hardware Checklist

Fill in the following table with your system's hardware before beginning the LynxOS installation:

System Hardware Checklist  
System Information
Example
Processor Type
400 mhz. Pentium 2 (i.e., x86)
RAM
128 MB
Hard Disk Information
Bus Type (SCSI/IDE)
IDE
Adapter Name
Motherboard IDE Bus
ID & Installation Partition
Master, IDE bus 1, partition a
Networking Information
Ethernet Adapter
Intel Pro100b
IP Address
192.168.0.1
Hostname
elmer
Video Information
Graphics Adapter
Diamond Stealth 64
Monitor Max Resolution & Refresh Rate
1024x768@75hz
Mouse Information
Mouse Port
PS2
Mouse Type
Logitech Mouseman

Basic Installation Overview

Use the following table to for basic installation steps. Refer to the relevant sections in this installation guide for detailed installation information.

Overview of Installing & Starting LynxOS  for Native Systems  
Step
Procedure
for Native Development
1
Determine Installation Type
Native
2
Locate Installation Media
ODE for <Target_CPU>
X & Motif (Optional)
3
Begin Installation
1. Insert the ODE CD-ROM into the CD-ROM drive.

2. Boot CD-ROM. LynxOS Preboot starts.

3. At the command line, run installit.

4. Set the configuration options as appropriate for your system. When finished with the configuration, begin the installation by typing "b" at the Main Menu.

5. After the installation, reboot the system. Secondary installation configurations are applied. Reboot the system again. The installation is complete.

6. Untar the BSP tar archive (in the tar_archives/ directory on the ODE CD-ROM) onto the LynxOS system.

7. Install optional components as required (Demo KDIs, X & Motif, LynxInsure++, TotalView, etc.)
4
Start using LynxOS
1. Log in as root

2. Type setup.

3. Add a user account and configure the system.
For more information, see the following sections or books:


Networking Configuration
LynxOS Networking Guide

System Administration
LynxOS User's Guide

.

Overview of Installing & Starting LynxOS for UNIX-hosted Systems  
Step
Procedure
for UNIX-hosted Cross Development
1
Determine Installation Type
Cross, UNIX hosts
(Linux or Solaris)
2
Locate Installation Media
· CDK for Linux, or for Solaris
· ODE for <Target_BSP>
3
Begin Installation
1. Create a directory for LynxOS on the host. For example:
     # mkdir /usr/lynx/4.0.0/ppc

1. Untar the CDK (cdk) tar file (located in the tar_images/ directory on the CDK CD-ROM) to the LynxOS directory on the host.

2. Untar ODE (devos) tar file (located in the tar_images/ directory on the ODE CD-ROM) to the LynxOS directory on the host.

3. Untar BSP tar archive (bsp) tar file (located in the tar_images/ directory on the ODE CD-ROM) to the LynxOS directory on the host (only if required).

4. Install optional components (Demo KDIs, CodeWarrior, SpyKer, etc.)
4
Start using LynxOS
1. Change to the LynxOS installation directory
 $ cd /usr/lynx/4.0.0/<cpu>

  where <cpu> is x86 or ppc

2. Start the LynxOS environment:
 $ . SETUP.bash
For detailed installation information, see

Networking Configuration
LynxOS Networking Guide

System Administration
LynxOS User's Guide

Overview of Installing & Starting LynxOS  for Windows Systems  
Step
Procedure
for Windows-hosted Cross Development
1
Determine Installation Type
Cross, Windows hosts
2
Locate Installation Media
ODE W
3
Begin Installation
1. Insert the ODEW CD-ROM into the CD-ROM drive.

2. Double-Click Setup.exe, Select install options.

3. Both the Cross Development Kit and Open Development Environment are installed.

4. Install additional components (Demo KDIs, VisualLynux, SpyKer, etc.)
4
Start using LynxOS
1. Open DOS prompt

2. Start bash
 C:\> bash

3. Change to the LynxOS installation directory
 $ cd /lynx/4p0p0/usr/lynx/4.0.0/<cpu>

  where <cpu> is x86 or ppc.

4. Start the LynxOS environment:
 $ . SETUP.bash
For more information, see the following sections or books:

Networking Configuration
LynxOS Networking Guide

System Administration
LynxOS User's Guide



LynuxWorks, Inc.
855 Branham Lane East
San Jose, CA 95138
http://www.lynuxworks.com
1.800.255.5969
TOC PREV NEXT INDEX