From: bj0rn@blox.se (Bjorn Ekwall)
To: waltje@nic.NL.Mugnet.ORG
Subject: Re: NET-2 and the D-Link Ethernet driver
X-Mailer: Mail User's Shell (7.2.4 2/2/92)
Message-ID: <m0nvKUE-0001OLC@blox.se>
Date: Tue, 18 May 1993 07:45:13 +0000
Hello Fred!
> My collegue put a copy of your article regarding the Dlink 0.20
> driver on my desk. I wasn't aware such a driver already existed...
>
> Anyway. I'd like to get a copy of your driver to add it to the
> current "new" kernel code (called NET-2). Many people are waiting
> for it, and now is the time to add it... right?
That's true, I'm waiting too :-)
Enclosed is the most current release that has been shipped so far (== v 0.20+).
Note that there are some things that still needs some attention:
- There is a not yet fully tested part of the code for handling
alternations of transmitter pages. Enable with "-DD_LINK_FIFO".
- I am only 99% sure that I have not missed any valid
interrupt-code from the adapter.
- There is always(?) a spurious IRQ 7 interrupt at boot. This might
come from the port being initialized by lp_init(), but I haven't
been able to stomp it out. Kludge found in d_link_interrupt().
Anyway, there seems to be some people out there using the driver,
and I haven't received any bugreports yet on this version
(hope that Murphy doesn't read email :-))
Good luck with the code,
Bjorn Ekwall == bj0rn@blox.se
= = = = = = Release shar-file follows = = = = = = = = = = = = = = = = = = =
Now, here it is!
A driver for the D-Link Ethernet pocket adapter in the parallel port,
to use with Linux on a laptop PC.
It has been tested with mount, rsh, ftp, telnet and remote X-clients.
TCP/IP throughput can be expected to be around 70-80 kbytes/second.
It now "runs" on:
- linux 0.99pl5, (with supplied patch for linux/net/tcp/dev.c)
- linux 0.99pl6, and later
(using a 386-25 Taiwan-made with 5Mb DRAM + 120Mb disk (60Mb == linux)).
Since this still is an alpha-release, some bugs might still be lurking...
All comments/requests/fixes to Bjorn Ekwall == bj0rn@blox.se
*** If you read nothing else, at least check around line 20 in the source! ***
(You may want to unshar this in /linux/net/tcp)
This is version 0.20
---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ----
= = = = = = Release shar-file ends = = = = = = = = = = = = = = = = = = =
CONTENTS:
1. Introduction.
2. License.
3. Files in this release.
4. Installation.
5. Known problems and some solutions.
6. Acknowledgments.
1. INTRODUCTION.
This is an Ethernet driver for the D-Link Ethernet pocket
adapter for the parallel port, used with Linux on a laptop.
This is an ALPHA release, i.e. it might not work flawlessly! (:-)
It now runs on SLS (beg. of February) linux 0.99pl5, patched
in linux/net/tcp/dev.c, and 0.99pl6 (and later), in a 386-25
Taiwan-made with 5Mb DRAM + 120Mb disk (60Mb == linux).
I have used this driver for ftp, telnet and X-clients on
remote machines. Transmissions with ftp seems to work as
good as can be expected (i.e. about 80k bytes/sec) from a
parallel port...:-)
All comments/fixes to Bjorn Ekwall (bj0rn@blox.se).
2. LICENSE.
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2, or (at your option) any later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
02139, USA.
3. FILES IN THIS RELEASE.
README.d_link This file.
d_link.c The Source (,may it be with You :-).
Makefile.new Replaced "we.o" with "d_link.o"
Space.c.new An entry for "d_link" instead of "wdxxx"
4. INSTALLATION.
o Replace (or edit) /linux/net/tcp/Makefile with
Makefile.new (save the original!). Actually, you only
have to make sure that "d_link.o" is included in the list
at "OBJS =".
o Replace /linux/net/tcp/Space.c with Space.c.new (save the
original!). If your kernel source is later than 0.99p5,
check your original for any greater differences
(shouldn't really be any).
o Copy d_link.c to /linux/net/tcp if you unshared somewhere
else.
o If you have linux 0.99p5, then add two lines close to the
end of /linux/net/tcp/dev.c (thanks Ross Biro, for the
information!):
...
}
}
skb->next = NULL;
skb->prev = NULL;
sti();
/* this will send it through the process again. */
dev->queue_xmit (skb, dev, -i-1);
+ if (dev->tbusy)
+ return;
}
}
...
o Read the NET_FAQ and the relevant files in /etc/inet
(hint: "hosts")
o Make sure that TCP/IP is included in your config, and
then do:
# cd /linux
# make clean
# make depend
# make Image (or whatever magic you usually do)
o I use lilo to boot multiple kernels, so that I at least
can have one working kernel :-). If you do too, append
these lines to /etc/lilo/config:
...
image = /usr/src/linux/Image
label = newlinux
root = /dev/hda2 (or whatever YOU have...)
...
# /etc/lilo/install
o Do "sync" and reboot the new kernel with a D-Link pocket
adapter connected.
Now, watch for any fireworks (try to ignore (or live with)
the smoke... :-) or:
do
read NET-FAQ and all info in /etc/inet
if fix in code needed...
vi /linux/net/tcp/d_link.c
cd /linux
make Image
/etc/lilo/install
sync
reboot
endif
try it...
until satisfied
5. KNOWN "PROBLEMS" AND SOME SOLUTIONS.
o Some machines have trouble handling the parallel port and
the adapter at high speed. If you experience problems
like "Strange interrupt...", try to uncomment the
"#define REALLY_SLOW_IO" near line 20 in d_link.c
o A frequent number of "eth0: transmit timed out..." might
indicate a heavy load on your network or some strange
internal driver bug. You can decrease the number of
messages by changing about 25 lines into the function
"d_link_start_xmit()", where it looks like:
if (tickssofar < 5)
Change the "5" to something greater, like 10, 20 or
whatever... Every "tick" equals 10 milliseconds.
o There has been some "hangs" when communicating with other
systems. As of now I'm not clear of where the trouble
might come from. It seems that reception of large
amounts of information can trigger this. Try to be
patient and see if the machines can clear up the mess
without any help (can happen!). If not, try to switch to
another virtual console and call the other system with
telnet and see what happens. If your machine seems
completely locked, there might be a race of transmit and
receive interrupts emanating from inet_bh() in dev.c .
The reason why this driver can trigger this is not quite
clear yet.
o There will always(?) be a spurious IRQ 7 interrupt at
boot. This might come from the port being initialized by
lp_init(), but I haven't been able to stomp it out.
Kludge can be found in d_link_interrupt().
o The code inside d_link_interrupt() is somewhat of a
guesswork since I'm not quite clear about how the adapter
REALLY tells us about its internal status. Since my only
source of information is the asm-source (:-), I'm not
sure of how to improve on it. Some more turns around the
edit_a_hack-compile-boot-tryout loop...
o There is some rudimentary support for debugging, see
the source. Use "-DD_LINK_DEBUG=3" when compiling.
6. ACKNOWLEDGMENTS.
This driver wouldn't have been done without the base
(and support) from Ross Biro (bir7@leland.stanford.edu).
The driver also relies upon GPL-ed source from D-Link Inc.
and from Russel Nelson at Crynwr Software (nelson@crynwr.com).
Additional input also from Donald Becker (becker@super.org).
Alpha release primary victim^H^H^H^H^H^Htester:
Erik Proper (erikp@cs.kun.nl).
Happy hacking!
Bjorn Ekwall == bj0rn@blox.se
![[bottom]](../icons/bottom.png){kind=icon}
![[previous]](../icons/n_left.png){kind=icon}
![[next]](../icons/n_right.png){kind=icon}
![[first]](../icons/n_first.png){kind=icon}
![[last]](../icons/n_last.png){kind=icon}
![[top]](../icons/n_top.png){kind=icon}
![[index]](../icons/index.png){kind=icon}
![[help]](../icons/help.png){kind=icon}
*/
![[top]](../icons/top.png){kind=icon}
![[bottom]](../icons/n_bottom.png){kind=icon}