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