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