Installation instructions  -  ATM on Linux, release 0.6 (pre-alpha)
-------------------------------------------------------------------

This is experimental software. There are known major bugs and certainly
even many more yet unknown problems. Internal and external interfaces are
far from being stable. In fact, they change almost daily. Use at your own
risk.

In order to install this package, you need
 - the package itself, of course
   lrcftp.epfl.ch:/pub/linux/atm/dist/atm-0.6.tar.gz
 - Linux kernel 1.3.24
   ftp.funet.fi:/pub/OS/Linux/PEOPLE/Linus/v1.3/linux-1.3.24.tar.gz

First, create a directory in which the linux/ kernel source directory
and the ATM on Linux distribution directory (atm/) should be created,
and put all the files listed above there. Then extract the ATM on Linux
distribution

  tar xfz atm-0.6.tar.gz

and the kernel source

  tar xfz linux-1.3.24.tar.gz

Finally, you can extract the ATM-related patches:

  cd linux
  patch -s -p1 <../atm/atm-0.6.patch

The distribution installs into the following directories:

  atm/		Documentation, kernel patch, top-level Makefile, and
		distribution scripts
  atm/sigd/	UNI 3.0 (and later UNI 3.1) signaling demon: atmsigd
		Test program: svc
  atm/qgen/	Q.2931-style message handling
  atm/ilmid/	ILMI address registration demon: ilmid
  atm/maint/	ATM maintenance programs: atmaddr, atmdiag, atmdump,
		atmtcp, and sonetdiag
  atm/test/	Test programs: aread, awrite, br, bw, ttcp
  atm/ip/	IP over ATM: clip, atmarp
  atm/arpd/	ATMARP demon
  atm/debug/	Debugging tools: ed, en, encopy, endump, zndump
  atm/lib/	Libraries for applications and demons

Now, change links (if necessary) and do the usual  make config
You should find the following new options:

  Asynchronous Transfer Mode (ATM) (CONFIG_ATM)
  ATM over TCP (CONFIG_ATM_TCP)
  Efficient Networks ENI155P (CONFIG_ATM_ENI)
   Enable extended debugging (CONFIG_ATM_ENI_DEBUG)
  ZeitNet ZN1221 (CONFIG_ATM_ZATM)
   Enable extended debugging (CONFIG_ATM_ZATM_DEBUG)

Note that the "MMU hacks" are not included in this version, because the
structure of skbuffs has changed. It's generally a good idea to enable
extended debugging, although this might slow down the drivers a bit.

Support for a simple type of serial consoles is automatically added by the
ATM patch. If you're using LILO, you can enable it by putting a line like

append="scon=N"

with N indicating the serial port (equal to the first number in the
serial=  line) into /etc/lilo.conf. Use the SERIAL option of LILO to make
LILO use the serial console too.

Then build your kernel and reboot.

If you've configured the ATM over TCP driver, you should see eight lines
like this one:

  atmtcp(itf 1): ready

If you've configured the ENI155p-MF driver, you should see one line like
this one:

  eni(itf 0): rev.0,base=0xff400000,irq=10,mem=512kB (00-20-EA-00-07-56)
  eni(itf 0): FPGA,MMF

(512kB for the -C version, 2048kB for the -S version.)

If you've configured the ZN1221 driver, you will get something like

  zatm(itf 0): rev.3,base=0xf800,irq=11,mem=128kB (00-20-D4-10-2A-80)
  zatm(itf 0): uPD98401 0.5 at 30.048 MHz

plus a few strange debugging messages. Note that you need to have at
least a rev.3 board if you want to use it in a Triton-based system.

Now, as the final step, build the ATM tools:

  cd ../atm
  make depend
  make
  make install

See the file USAGE for how to use them.
