Installing TimeSys TimeStorm 3.2.2 Development Tools: A Quick Start Guide

Thank you for purchasing TimeSys TimeStorm software for your development environment. These steps will assist you in setting up the software from downloaded software archives.

Read the User's Guides provided with each software package to learn system requirements and detailed installation instructions. Please also read the Release Notes files provided with each software distribution to understand any limitations of the software and to learn workarounds.

The TimeStorm Development Environment

This document outlines the steps required to set up a TimeStorm-based development environment. Linux distributions from TimeSys or from other distributors can be used with TimeStorm tools.

The TimeStorm development environment includes:

• Host system – A Linux, Windows, or Solaris desktop workstation used for development work. The following items are installed on the host:
  • Toolchain – The cross-compiler, libraries, and other software that allow you to compile an application on the host for use on the target.
  • Linux RFS – The target’s root filesystem (RFS), which is accessed remotely to save space on the target. The target RFS can be hosted on a Linux or a Windows system.
  • TimeStorm IDE – The TimeStorm IDE is an integrated development environment that is customized for use with Linux distributions from TimeSys on a remote target. It also supports remote development for any other Linux distribution. The TimeStorm IDE supports C, C++, and Java application development.
  • TimeStorm Target Configurator – This optional plug-in simplifies the process of reconfiguring a Linux kernel and root filesystem for the target. (Currently, Target Configurator is not supported on Solaris systems.)
  • TimeStorm Linux Verification Suite (LVS) – This optional plug-in provides a testing environment for verifying a modified Linux kernel configuration or ported software development kit. (Currently, LVS is not supported on Solaris systems.)
  • TimeStorm Linux Profiling Suite (LPS) – This optional plug-in allows developers of embedded Linux products to find performance bottlenecks in their Linux source code quickly and easily. (Currently, LPS is not supported on Solaris systems.)
• Target system – The Linux system that runs your applications. Refer to the documentation provided with your Linux distribution for information about installing and configuring the target Linux software.

Unpacking Archive Files

TimeSys provides software for download as archives, generally in either .tgz or .tar.gz format. These formats are tar archives that also have been compressed by using the gzip utility. You must decompress and unpack the archives before installing the software.

On Linux or Solaris systems, unpack a .tgz archive by issuing a command like the following one:

$ tar -zvxf <filename>

and unpack a tar.gz archive by issuing a command like the following one:

$ tar --gzip -xvf <filename>

On Windows systems, you can use the WinZip utility (available from http://www.winzip.com) or Windows XP’s included file compression utility to unpack the archive.

Cygwin, which is a UNIX emulator for Windows systems, is provided as a .zip archive file. This archive can be extracted by using WinZip or the tools provided with your Windows operating system. To install Cygwin, first extract the files from the .zip archive, and then execute the install.exe file in the top level of the resulting directory.

Installation Procedures

Perform the procedures found in the following sections in the order shown to install the following products:

1. Install TimeStorm 3.2.2 and its optional Target Configurator, LVS, and LPS plug-ins on your host. If you are installing the software on a Windows host, you must install Cygwin, as well.
2. Install a TimeStorm license, and, optionally, set up a license server.
3. Install a Linux distribution from TimeSys, including a toolchain, on your host and configure the target.
4. Optionally, import TestWare to your host for use with the LVS plug-in, or for use from the command line.
   

Installing TimeStorm, Its Plug-ins, and Cygwin on Your Host

Software Download: TimeStorm 3.2.2; Windows systems also require the Cygwin binaries download (tstools-3.2.2-0317.tgz; cygwin-bin-1.5-050.zip or later); Target Configurator and LPS also require host utilities for your host’s platform (see Chapter 3 of Getting Started with TimeStorm)

Documentation: Getting Started with TimeStorm, Chapters 2 and 3: (https://linuxlink.timesys.com/files/getting_started_ts_322.pdf)

TimeStorm runs on a Windows or Linux PC, or on a Solaris UltraSPARC system, and provides the base component for TimeSys’ Target Configurator, LVS, and LPS tools, which are available as separate plug-ins. (These plug-ins are not supported on Solaris systems.) Please refer to Getting Started with TimeStorm for a list of supported platforms.

Installing TimeStorm and Its Plug-ins on Your Host

To install TimeStorm and its plug-ins:

1. Download the TimeStorm archive file from the TimeSys LinuxLink web site as follows.
1. Log in to LinuxLink at https://linuxlink.timesys.com/ and select the Repository button.
2. Select Tools from the drop-down menu.
3. Select TimeStorm Development Tools.
4. Click download to the right of the .tgz file.
2. Unpack the archive file according to the instructions in Unpacking Archive Files.
3. Ensure that your host meets the software and hardware requirements listed in Chapter 2 of Getting Started with TimeStorm.
4. TimeStorm IDE is required to use Target Configurator, LVS, and LPS. You install the optional plug-ins at the same time as the IDE. Follow the steps in Chapter 3 of Getting Started with TimeStorm to install the TimeStorm IDE and plug-in software on your host.

Installing Cygwin on Your Host

To install Cygwin:

1. Download the Cygwin binary .zip file from the TimeSys LinuxLink Repository page as follows:
   1. Log in to LinuxLink at https://linuxlink.timesys.com/ and select the Repository button.
   2. Click the Developer Tools tab.
   3. Click Cygwin.
   4. Click the Download this file button.
2. Unzip the binary archive according to the instructions in Unpacking Archive Files.
3. Follow the steps in Chapter 3 of Getting Started with TimeStorm to install Cygwin on your host.

Installing a TimeStorm License

Software Download: Macrovision FLEXlm Utilities supplemental documentation and server software (flexlm-3.1-195.tar.gz)

Documentation: Getting Started with TimeStorm, Chapter 3 (/doc/getting_started.pdf in the TimeStorm IDE download) and the FLEXnet Licensing End User Guide (included in the flexlm-3.1-195.tar.gz tar file as /doc/enduser.pdf and also available on the Macrovision web site at: http://www.macrovision.com/support/by_category/Software_Licensing.shtml)

To configure TimeStorm licenses, do the following:

1. Copy the license that you received from TimeSys Corporation to your TimeStorm host. (You must do this before you can use proprietary features of the TimeStorm software.) Refer to Chapter 3 of Getting Started with TimeStorm for basic information about obtaining and installing a license on a TimeStorm host.
2. Optionally, set up a license server to distribute licenses to other machines in your company. Details about setting up a license server are included in the FLEXnet Licensing End User Guide. The required server daemons are provided in the FLEXlm utilities archive, which is provided by TimeSys in the Repository page. You can download this archive, as follows:
   
   
   1. Log in to LinuxLink at https://linuxlink.timesys.com/ and select the Repository button.
   2. Select Tools from the drop-down menu.
   3. Select Flexlm Utility Programs.
   4. Click the Download this file button.

Installing a Linux Distribution on the Host and Configuring the Target

Software Download: A Linux distribution from TimeSys for your target (timesys-<toolchain>-<board>-basic--std-<build_number>-install.tgz); for example, a TimeSys 6.1 distribution for an AMCC 405GP board might have the following filename: timesys-ppc4xx-amcc405gp-basic--std-10-install.tgz

Documentation: Getting Started guide for your target, Chapters 2 and 3: (/docs/getting_started.pdf)

Toolchains include cross-compilers and other required utilities that allow you to build software for a different platform than the host system. If you use different machines to run TimeStorm and to host the target RFS, or if you use TimeStorm on a Windows PC, you must install the toolchain on your TimeStorm system separately from the rest of the Linux distribution. You can install multiple toolchains on one system. Also, you can install additional toolchains at any time.

To install the Linux distribution with toolchain and configure the target, do the following:

1. Log in to LinuxLink at https://linuxlink.timesys.com/ and select the Repository button.
2. Click on the Distributions tab.
3. Click on the Reference Linux Distribution link for your processor.
4. Click download to the right of the filename ending in -install.tgz/ to begin downloading the distribution.
5. Unpack the archive file according to the instructions in Unpacking Archive Files.
6. Follow the instructions in the Getting Started guide that came with your Linux distribution. The installation includes the following tasks:
   
   
   1. Checking the host hardware and software requirements.
   2. Installing Linux, including the toolchain, on the host PC.
   3. Configuring the RFS host to serve the root filesystem and kernel to the target board.
   4. Configuring the target to boot and to load the kernel from the RFS host.

If you do not need to use TestWare, your TimeStorm Tools installation is complete. If you want to use TestWare, follow the instructions in the next section.

Importing TestWare (optional)

Software Download: The TestWare packages that you want to use. These include the following archives:

• LTP_3.0.ts.tar
• NIST_3.0.ts.tar
• PCTS_3.0.ts.tar
• RTS_3.0.ts.tar
• TTS_3.0.ts.tar

Documentation: Top-level README.txt and a README.txt contained within each archive

TestWare consists of several software test suites that TimeSys provides for use with the Linux Verification Suite (LVS). TestWare can also be used separately from the command line. Skip this section if you did not purchase LVS or if you do not intend to use TestWare from the command line.

The following TestWare packages are available:

• The LTP package contains non-POSIX-specific tests.
• The RTS and TTS packages contain TimeSys-created test suites.
• The NIST and PCTS packages contain tests for POSIX-specific functionality.

To download TestWare from the TimeSys LinuxLink Repository, do the following:

1. Log in to LinuxLink at https://linuxlink.timesys.com/ and select the Repository button.
2. Click the Developer Tools tab.
3. Click Testware.
4. Click download to the right of a single TestWare archive that you want. Repeat for each archive that you want.

To import TestWare into your TimeStorm workspace for use with the LVS plug-in, do the following:

1. Start TimeStorm and switch to the LVS perspective, as described in Getting Started with TimeStorm.
2. Unpack each test suite archive file that you want to use.

   1. On Linux or Solaris hosts, unpack the archive by issuing a command like the following one:

      $ tar -xvf filename

   2. On Windows hosts, unpack the archive by using the WinZip utility or another file compression utility included with your Windows operating system.
3. Follow the instructions in either the TimeStorm LVS User’s Guide or the top-level README.txt file to import the tests into your TimeStorm workspace.

To use TestWare from the command line, do the following:

1. Unpack each test suite archive file that you want to use.
   1. On Linux or Solaris hosts, unpack the archive by issuing a command like the following one:

      $ tar -xvf filename

   2. On Windows hosts, unpack the archive by using the WinZip utility or another file compression utility included with your Windows operating system.
2. Follow the instructions in the README.txt file that is included in the archive. The TimeStorm LVS User’s Guide also contains information about using TestWare from the command line and about importing and viewing that data in LVS.

TimeSys Support

For information about TimeSys Support, click the get help button at the top of any page on the TimeSys LinuxLink web site at: https://linuxlink.timesys.com/, or send e-mail to: linuxlink-help@timesys.com.

Copyright Notice

Copyright © 2002-2007 TimeSys® Corporation, 925 Liberty Avenue, Pittsburgh, PA 15222. Unpublished and all rights reserved under U.S. copyright law and international treaties. TimeSys software documentation is “commercial computer software documentation” and licensed pursuant to the TimeSys End User License Agreement consistent with FAR 12.212. TimeSys, the TimeSys logo, and all TimeSys software product names are trademarks owned by TimeSys corporation. All other trademarks are property of their respective owners.