Pull events into release branch
[linux-2.6] / Documentation / networking / cops.txt
1 Text File for the COPS LocalTalk Linux driver (cops.c).
2         By Jay Schulist <jschlst@samba.org>
3
4 This driver has two modes and they are: Dayna mode and Tangent mode.
5 Each mode corresponds with the type of card. It has been found
6 that there are 2 main types of cards and all other cards are
7 the same and just have different names or only have minor differences
8 such as more IO ports. As this driver is tested it will
9 become more clear exactly what cards are supported. 
10
11 Right now these cards are known to work with the COPS driver. The
12 LT-200 cards work in a somewhat more limited capacity than the
13 DL200 cards, which work very well and are in use by many people.
14
15 TANGENT driver mode:
16         Tangent ATB-II, Novell NL-1000, Daystar Digital LT-200
17 DAYNA driver mode:
18         Dayna DL2000/DaynaTalk PC (Half Length), COPS LT-95,
19         Farallon PhoneNET PC III, Farallon PhoneNET PC II
20 Other cards possibly supported mode unknown though:
21         Dayna DL2000 (Full length)
22
23 The COPS driver defaults to using Dayna mode. To change the driver's 
24 mode if you built a driver with dual support use board_type=1 or
25 board_type=2 for Dayna or Tangent with insmod.
26
27 ** Operation/loading of the driver.
28 Use modprobe like this: /sbin/modprobe cops.o (IO #) (IRQ #)
29 If you do not specify any options the driver will try and use the IO = 0x240,
30 IRQ = 5. As of right now I would only use IRQ 5 for the card, if autoprobing.
31
32 To load multiple COPS driver Localtalk cards you can do one of the following.
33
34 insmod cops io=0x240 irq=5
35 insmod -o cops2 cops io=0x260 irq=3
36
37 Or in lilo.conf put something like this:
38         append="ether=5,0x240,lt0 ether=3,0x260,lt1"
39
40 Then bring up the interface with ifconfig. It will look something like this:
41 lt0       Link encap:UNSPEC  HWaddr 00-00-00-00-00-00-00-F7-00-00-00-00-00-00-00-00
42           inet addr:192.168.1.2  Bcast:192.168.1.255  Mask:255.255.255.0
43           UP BROADCAST RUNNING NOARP MULTICAST  MTU:600  Metric:1
44           RX packets:0 errors:0 dropped:0 overruns:0 frame:0
45           TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 coll:0
46
47 ** Netatalk Configuration
48 You will need to configure atalkd with something like the following to make
49 it work with the cops.c driver.
50
51 * For single LTalk card use.
52 dummy -seed -phase 2 -net 2000 -addr 2000.10 -zone "1033"
53 lt0 -seed -phase 1 -net 1000 -addr 1000.50 -zone "1033"
54
55 * For multiple cards, Ethernet and LocalTalk.
56 eth0 -seed -phase 2 -net 3000 -addr 3000.20 -zone "1033"
57 lt0 -seed -phase 1 -net 1000 -addr 1000.50 -zone "1033"
58
59 * For multiple LocalTalk cards, and an Ethernet card.
60 * Order seems to matter here, Ethernet last.
61 lt0 -seed -phase 1 -net 1000 -addr 1000.10 -zone "LocalTalk1"
62 lt1 -seed -phase 1 -net 2000 -addr 2000.20 -zone "LocalTalk2"
63 eth0 -seed -phase 2 -net 3000 -addr 3000.30 -zone "EtherTalk"