Install Guide for 

GRAPE-6 library and test programs

(C)  May 19 2001 Jun Makino All rights reserved
Version 0.1 September 24 2001 Jun Makino

0. Overview

In this document, I'll describe how to install library files for
GRAPE-6, and how to run test programs.

At present, only Linux (Alpha or x86) is supported. The kernel version 
must be 2.2.x (2.2.14 and later). Present version, 2.4.x, is not yet
supported. 

1) Installing library

First, download the newest version from

http://grape.astron.s.u-tokyo.ac.jp/pub/people/makino/softwares/GRAPE6/
(select "Current Library")

You will get g6libs.tar.gz. untar it by

> tar xvzf g6libs.tar.gz

at the directory where you want to place the source files. The
following subdirectories will be created:

g6hib/      g6hibddx86/  grape6-x86/   phibdd/  simple-grape/
g6hib-x86/  grape6/      grape6board/  pit/

Goto g6hib by
> cd g6hib

and start the install script by

> csh -f install.csh

You will see the menu:

========= Main Menu ========
1. Compiling the device driver
2. Compiling libraries and sample applications.
3. Installing the device driver (need to be a superuser)
4. Testing the basic device driver functions and the PCI card.
5. Testing the libraries and sample applications
enter menu number (1-5, or 0 to exit):

Select items 1-5 in turn, and follow instructions. Note that you need
to be a  superuser to execute step 3.

Also note that libraries and header files will be created by the above
script, but will not be installed to any specified location. If
necessary, please copy the following files to locations you prefer. 


(Alpha)
g6hib/grape6.h
grape6/libg6lasim2.a
g6hib/libg6la.a
g6hib/libg6lasim.a
(X86)
g6hib/grape6.h
grape6-x86/libg6lxsim2.a
g6hib-x86/libg6lx.a
g6hib-x86/libg6lxsim.a

2) Test programs

Basic tests are performed in step 5 of the install script.
If you need more detailed diagnostics, you can use

g6cbtest 

or

g6ptest

located (you might need to make them) in directory g6hib(-x86)

g6cbtest is the most basic test program to check the PCI interface
card. To use this program, you need to connect the IP port and FO port
of the PCI card (see hardware installation guide, g6hib/g6hard.tex
[Maybe not ready yet. You should also consult the document provided by
HAMAMATSU METRIX] for details) using straight cable. After you did so,
you can simply type

g6cbtest

with no additional argument.


g6ptest calculates the force between two particles and compare the
result with that of software GRAPE-6 simulator.

3) User Guide

User Guide is g6hib/g6user.tex

Good luck!
