Root/
1 | Released 1994-06-13 |
2 | |
3 | |
4 | CONTENTS: |
5 | |
6 | 1. Introduction. |
7 | 2. License. |
8 | 3. Files in this release. |
9 | 4. Installation. |
10 | 5. Problems and tuning. |
11 | 6. Using the drivers with earlier releases. |
12 | 7. Acknowledgments. |
13 | |
14 | |
15 | 1. INTRODUCTION. |
16 | |
17 | This is a set of Ethernet drivers for the D-Link DE-600/DE-620 |
18 | pocket adapters, for the parallel port on a Linux based machine. |
19 | Some adapter "clones" will also work. Xircom is _not_ a clone... |
20 | These drivers _can_ be used as loadable modules, |
21 | and were developed for use on Linux 1.1.13 and above. |
22 | For use on Linux 1.0.X, or earlier releases, see below. |
23 | |
24 | I have used these drivers for NFS, ftp, telnet and X-clients on |
25 | remote machines. Transmissions with ftp seems to work as |
26 | good as can be expected (i.e. > 80k bytes/sec) from a |
27 | parallel port...:-) Receive speeds will be about 60-80% of this. |
28 | Depending on your machine, somewhat higher speeds can be achieved. |
29 | |
30 | All comments/fixes to Bjorn Ekwall (bj0rn@blox.se). |
31 | |
32 | |
33 | 2. LICENSE. |
34 | |
35 | This program is free software; you can redistribute it |
36 | and/or modify it under the terms of the GNU General Public |
37 | License as published by the Free Software Foundation; either |
38 | version 2, or (at your option) any later version. |
39 | |
40 | This program is distributed in the hope that it will be |
41 | useful, but WITHOUT ANY WARRANTY; without even the implied |
42 | warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
43 | PURPOSE. See the GNU General Public License for more |
44 | details. |
45 | |
46 | You should have received a copy of the GNU General Public |
47 | License along with this program; if not, write to the Free |
48 | Software Foundation, Inc., 675 Mass Ave, Cambridge, MA |
49 | 02139, USA. |
50 | |
51 | |
52 | 3. FILES IN THIS RELEASE. |
53 | |
54 | README.DLINK This file. |
55 | de600.c The Source (may it be with You :-) for the DE-600 |
56 | de620.c ditto for the DE-620 |
57 | de620.h Macros for de620.c |
58 | |
59 | If you are upgrading from the d-link tar release, there will |
60 | also be a "dlink-patches" file that will patch Linux 1.1.18: |
61 | linux/drivers/net/Makefile |
62 | linux/drivers/net/CONFIG |
63 | linux/drivers/net/MODULES |
64 | linux/drivers/net/Space.c |
65 | linux/config.in |
66 | Apply the patch by: |
67 | "cd /usr/src; patch -p0 < linux/drivers/net/dlink-patches" |
68 | The old source, "linux/drivers/net/d_link.c", can be removed. |
69 | |
70 | |
71 | 4. INSTALLATION. |
72 | |
73 | o Get the latest net binaries, according to current net.wisdom. |
74 | |
75 | o Read the NET-2 and Ethernet HOWTOs and modify your setup. |
76 | |
77 | o If your parallel port has a strange address or irq, |
78 | modify "linux/drivers/net/CONFIG" accordingly, or adjust |
79 | the parameters in the "tuning" section in the sources. |
80 | |
81 | If you are going to use the drivers as loadable modules, do _not_ |
82 | enable them while doing "make config", but instead make sure that |
83 | the drivers are included in "linux/drivers/net/MODULES". |
84 | |
85 | If you are _not_ going to use the driver(s) as loadable modules, |
86 | but instead have them included in the kernel, remember to enable |
87 | the drivers while doing "make config". |
88 | |
89 | o To include networking and DE600/DE620 support in your kernel: |
90 | # cd /linux |
91 | (as modules:) |
92 | # make config (answer yes on CONFIG_NET and CONFIG_INET) |
93 | (else included in the kernel:) |
94 | # make config (answer yes on CONFIG _NET, _INET and _DE600 or _DE620) |
95 | # make clean |
96 | # make zImage (or whatever magic you usually do) |
97 | |
98 | o I use lilo to boot multiple kernels, so that I at least |
99 | can have one working kernel :-). If you do too, append |
100 | these lines to /etc/lilo/config: |
101 | |
102 | image = /linux/zImage |
103 | label = newlinux |
104 | root = /dev/hda2 (or whatever YOU have...) |
105 | |
106 | # /etc/lilo/install |
107 | |
108 | o Do "sync" and reboot the new kernel with a D-Link |
109 | DE-600/DE-620 pocket adapter connected. |
110 | |
111 | o The adapter can be configured with ifconfig eth? |
112 | where the actual number is decided by the kernel |
113 | when the drivers are initialized. |
114 | |
115 | |
116 | 5. "PROBLEMS" AND TUNING, |
117 | |
118 | o If you see error messages from the driver, and if the traffic |
119 | stops on the adapter, try to do "ifconfig" and "route" once |
120 | more, just as in "rc.inet1". This should take care of most |
121 | problems, including effects from power loss, or adapters that |
122 | aren't connected to the printer port in some way or another. |
123 | You can somewhat change the behaviour by enabling/disabling |
124 | the macro SHUTDOWN_WHEN_LOST in the "tuning" section. |
125 | For the DE-600 there is another macro, CHECK_LOST_DE600, |
126 | that you might want to read about in the "tuning" section. |
127 | |
128 | o Some machines have trouble handling the parallel port and |
129 | the adapter at high speed. If you experience problems: |
130 | |
131 | DE-600: |
132 | - The adapter is not recognized at boot, i.e. an Ethernet |
133 | address of 00:80:c8:... is not shown, try to add another |
134 | "; SLOW_DOWN_IO" |
135 | at DE600_SLOW_DOWN in the "tuning" section. As a last resort, |
136 | uncomment: "#define REALLY_SLOW_IO" (see <asm/io.h> for hints). |
137 | |
138 | - You experience "timeout" messages: first try to add another |
139 | "; SLOW_DOWN_IO" |
140 | at DE600_SLOW_DOWN in the "tuning" section, _then_ try to |
141 | increase the value (original value: 5) at |
142 | "if (tickssofar < 5)" near line 422. |
143 | |
144 | DE-620: |
145 | - Your parallel port might be "sluggish". To cater for |
146 | this, there are the macros LOWSPEED and READ_DELAY/WRITE_DELAY |
147 | in the "tuning" section. Your first step should be to enable |
148 | LOWSPEED, and after that you can "tune" the XXX_DELAY values. |
149 | |
150 | o If the adapter _is_ recognized at boot but you get messages |
151 | about "Network Unreachable", then the problem is probably |
152 | _not_ with the driver. Check your net configuration instead |
153 | (ifconfig and route) in "rc.inet1". |
154 | |
155 | o There is some rudimentary support for debugging, look at |
156 | the source. Use "-DDE600_DEBUG=3" or "-DDE620_DEBUG=3" |
157 | when compiling, or include it in "linux/drivers/net/CONFIG". |
158 | IF YOU HAVE PROBLEMS YOU CAN'T SOLVE: PLEASE COMPILE THE DRIVER |
159 | WITH DEBUGGING ENABLED, AND SEND ME THE RESULTING OUTPUT! |
160 | |
161 | |
162 | 6. USING THE DRIVERS WITH EARLIER RELEASES. |
163 | |
164 | The later 1.1.X releases of the Linux kernel include some |
165 | changes in the networking layer (a.k.a. NET3). This affects |
166 | these drivers in a few places. The hints that follow are |
167 | _not_ tested by me, since I don't have the disk space to keep |
168 | all releases on-line. |
169 | Known needed changes to date: |
170 | - release patchfile: some patches will fail, but they should |
171 | be easy to apply "by hand", since they are trivial. |
172 | (Space.c: d_link_init() is now called de600_probe()) |
173 | - de600.c: change "mark_bh(NET_BH)" to "mark_bh(INET_BH)". |
174 | - de620.c: (maybe) change the code around "netif_rx(skb);" to be |
175 | similar to the code around "dev_rint(...)" in de600.c |
176 | |
177 | |
178 | 7. ACKNOWLEDGMENTS. |
179 | |
180 | These drivers wouldn't have been done without the base |
181 | (and support) from Ross Biro, and D-Link Systems Inc. |
182 | The driver relies upon GPL-ed source from D-Link Systems Inc. |
183 | and from Russel Nelson at Crynwr Software <nelson@crynwr.com>. |
184 | |
185 | Additional input also from: |
186 | Donald Becker <becker@super.org>, Alan Cox <A.Cox@swansea.ac.uk> |
187 | and Fred N. van Kempen <waltje@uWalt.NL.Mugnet.ORG> |
188 | |
189 | DE-600 alpha release primary victim^H^H^H^H^H^Htester: |
190 | - Erik Proper <erikp@cs.kun.nl>. |
191 | Good input also from several users, most notably |
192 | - Mark Burton <markb@ordern.demon.co.uk>. |
193 | |
194 | DE-620 alpha release victims^H^H^H^H^H^H^Htesters: |
195 | - J. Joshua Kopper <kopper@rtsg.mot.com> |
196 | - Olav Kvittem <Olav.Kvittem@uninett.no> |
197 | - Germano Caronni <caronni@nessie.cs.id.ethz.ch> |
198 | - Jeremy Fitzhardinge <jeremy@suite.sw.oz.au> |
199 | |
200 | |
201 | Happy hacking! |
202 | |
203 | Bjorn Ekwall == bj0rn@blox.se |
204 |
Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master
Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9