~ubuntu-branches/ubuntu/breezy/linux-atm/breezy

« back to all changes in this revision

Viewing changes to src/extra/drivers/README.he

  • Committer: Bazaar Package Importer
  • Author(s): Peter De Schrijver (p2)
  • Date: 2005-03-17 23:02:03 UTC
  • mfrom: (2.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050317230203-7vc1pxi0oua0nw5w
Tags: 2.4.1-17
Fix build problem with gcc 4.0 (Closes: )

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Description
2
 
===========
3
 
 
4
 
This is a Linux ATM driver for the FORE Systems ForeRunnerHE adapters.
5
 
It supports both the 155 and 622 flavors of the card.  The driver was
6
 
primarily developed on a powerpc (604e@200MHz) but it has been ported
7
 
and tested on an i386 (2 i686@800Mhz).
8
 
 
9
 
This is the sixth public release of the driver.   Its mainly to provide
10
 
interrupt sharing fixes and updates for the latest 2.4 kernels.
11
 
 
12
 
Current features:
13
 
 
14
 
        . interrupt sharing
15
 
        . hardware traffic shaping
16
 
        . cbr
17
 
        . tasklet support
18
 
        . uses new pci loadable module scheme
19
 
        . 64bit PCI bus operation tested
20
 
        . SMP tested
21
 
        . 2.2 kernel support
22
 
 
23
 
Feedback (including fixes or suggestions) is welcome. 
24
 
Contact chas@cmf.nrl.navy.mil.
25
 
 
26
 
History
27
 
=======
28
 
 
29
 
This driver has been an informal project for Eric Kinzie,
30
 
ekinzie@cmf.nrl.navy.mil, and I.  It represents most of our spare time
31
 
during the month of March, 2000.  It started last November when we wanted a
32
 
cheap oc-12c capable router.  I wrote the skeleton in about a week but had
33
 
to put it aside until recently.  Most of the brain damage in the driver
34
 
can be attributed directly to me and my lack of understanding regarding
35
 
linux internals.  Eric has the i386 with the 622 board (and a slightly
36
 
out of date linux device driver book).
37
 
 
38
 
Requirements
39
 
============
40
 
 
41
 
ATM 0.59 - ATM 0.78
42
 
 
43
 
Installation
44
 
============
45
 
 
46
 
copy atm_he.h to /usr/src/linux/include/linux:
47
 
 
48
 
        % cp atm_he.h /usr/src/linux/include/linux
49
 
 
50
 
copy he.c and he.h to /usr/src/linux/drivers/atm:
51
 
 
52
 
        % cp he.c he.h /usr/src/linux/drivers/atm
53
 
 
54
 
apply the patches:
55
 
 
56
 
        % cd /usr/src/inux/drivers/atm
57
 
 
58
 
        [2.2 KERNELS ONLY]
59
 
        % patch < he.patch-2.2
60
 
 
61
 
        [2.4 KERNELS ONLY]
62
 
        % patch < he.patch-2.4
63
 
 
64
 
reconfigure your kernel and select the 'FORE HE' driver in the Network
65
 
Device/ATM Adapters menu and rebuild your kernel:
66
 
 
67
 
        % cd /usr/src/linux
68
 
        % make menuconfig (enable the HE card in the Networking/ATM menu)
69
 
        % make dep
70
 
        % make (or 'make modules' if you building as a module)
71
 
 
72
 
boot your new kernel or insmod the driver.
73
 
 
74
 
Miscellaneous
75
 
=============
76
 
 
77
 
hediag.c is a utility to dump the various registers on the adapter.
78
 
Its handy for debugging the driver.
79
 
 
80
 
BUGS
81
 
====
82
 
 
83
 
. aal0 receive only (atmdump works though)
84
 
 
85
 
. the driver seems to use a fair amount of memory.  this can be a problem
86
 
  for smaller memory (<64M) machines.  there should possibly be a small
87
 
  memory config.
88
 
 
89
 
--chas
90
 
chas@cmf.nrl.navy.mil