Stream User’s Guide
Document revision history
Download 0.95 Mb.
|
- Navigate this page:
- 2Installation
- 2.1Install the toolset
- 2.2Distribution contents
1.2Document revision history
2InstallationThis chapter describes the installation of SPI Stream tools for Linux. Shell script install.sh installs the toolset from compressed tar archive files on the SPI customer support website or on a distribution CD. The Stream development environment runs on a Linux host system and compiles Stream programs using a gcc-based MIPS cross compiler. The toolset is extensively tested running on FedoraCore 8.0, but it should also run successfully on most other x86 Linux distributions. For users who wish to run the SPI Stream tools under Windows, SPI provides a Linux virtual machine that runs under the free VMware player (see www.vmware.com/products/player/ ). A separate document VMware Player Installation and Setup Guide provides instructions for the installation and use of the SPI VMware distribution. 2.1Install the toolsetYou should normally run as the superuser root to install the SPI Stream tools under Linux. If you need to install the tools on a machine on which you do not have root privileges, first install the SPI virtual machine distribution, and then perform the installation as root under the VMware player. Alternatively, you can specify the -no_root option to the installation script install.sh; in this case, the installation will not include an NFS-mountable filesystem for use with Linux running on System MIPS on an SPI development board. Shell script install.sh installs the Stream distribution from a source (for example, the SPI customer support website or a distribution CD) to an arbitrary destination. By default, it downloads packages required for installation. Its usage is: Usage: install.sh [ option ... ] Options:
-d dest Install to given directory dest [default: /opt/spi/Stream_nnn] -no_root Install without root permissions [does not produce NFS-mountable filesystem] -r rep Use directory rep as package download repository [default: /opt/spi/download] -s src Find packages locally in repository directory src -url url Download and install packages from url [default: SPI website] To install the Stream distribution from the SPI customer support website, type: $ ./install.sh [ -d dest ] where dest gives an optional destination (default: /opt/spi/Stream_nnn). To install from a CD distribution instead, use the -s option: $ src/install.sh -s src [ -d dest ] where src gives the Stream distribution location (e.g., /media/Stream_nnn for a mounted CD). After the installation is complete, you must add the Stream tools bin and lib directories to the settings of environment variables PATH and LD_LIBRARY_PATH, respectively. For example, for the bash shell, type:
export PATH=dest/bin:$PATH You may want to add these lines to your $HOME/.bashrc or to the global /etc/bashrc. The bsp directory in the Stream distribution contains firmware for an SPI development board. It may be used to update board firmware using the on-board web pages. The bsp directory also includes compressed tar files containing sources. These sources are supplied in compliance with the GNU Public License. 2.2Distribution contentsThis section gives a quick overview of the directory structure of the Stream distribution.
Later chapters of this manual use spm_demo to illustrate the Stream programming model and the use of the Stream tools. The demos/ directory includes a video demo application video_demo in addition to spm_demo. The doc/ directory includes Stream User’s Guide, Stream Reference Manual, and Storm-1 Benchmarks in PDF format. Download 0.95 Mb. Share with your friends:
|