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
Version 0.2 Jan 4 2002 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, Alpha (DU 4.0x and Linux kernel 2.2.x) and x86 (Linux
kernel 2.2.x and 2.4.x) are 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/

In newest versions, there may be some more...

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.

In step 3, you are asked, beside others,  two rather obscure questions:
Which clocking scheme do you use?(0,1)
0: board EPROM before DEC 2001
1: board EPROM after DEC 2001

Which PCI card version do you use?(0,1)
0: card EPROM before DEC 2001
1: card EPROM after DEC 2001

This is to configure the software to match the version of EPROMs on
processor board and PCI interface card. If you got your GRAPE-6 after
Feb 2002, you are likely to have the new EPROMs. If not, Hamamatsu
metrix will be sending (or should have sent) the DEC 2001 version to
you with instructions for replacement. If you have installed it,
please answer 1. If not, 0 should be supplied.


2) Test programs

Basic tests are performed in step 5 of the install script. Problem
with these tests are that depending on the vesion of the gcc, the
result could be different from what is assumed, in particular for long
tests.


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!
