home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / KERNEL-S / V1.0 / LINUX-1.0 / LINUX-1 / linux / drivers / net / README.DLINK < prev    next >
Encoding:
Text File  |  1993-12-01  |  7.0 KB  |  178 lines
  1. This is version 0.32
  2.  
  3.           CONTENTS:
  4.  
  5.             1. Introduction.
  6.             2. License.
  7.             3. Files in this release.
  8.             4. Installation.
  9.             5. Problems and tuning.
  10.             6. Acknowledgments.
  11.  
  12.  
  13.           1. INTRODUCTION.
  14.  
  15.           This is an Ethernet driver for the D-Link DE-600 Ethernet pocket
  16.           adapter for the parallel port, used with Linux on a laptop.
  17.           Some improvements over the 0.2X releases include:
  18.             o  driver code trying to send packets end to end,
  19.             o  a more solid interrupt handler,
  20.             o  a fix that modifies the tcp protocol so that
  21.                the DE-600 won't choke as easily on receives.
  22.  
  23.           This is a beta release, i.e. it ought to work! (:-)
  24.  
  25.           I have used this driver for NFS, ftp, telnet and X-clients on
  26.           remote machines. Transmissions with ftp seems to work as
  27.           good as can be expected (i.e. > 80k bytes/sec) from a
  28.           parallel port...:-)
  29.           The speed limit is now in the upper protocols,
  30.           at least for a 386SX-25 :-)
  31.  
  32.           All comments/fixes to Bjorn Ekwall (bj0rn@blox.se).
  33.  
  34.           (No, I have _not_ included any support for the DE-620 yet
  35.           since I have _no_ official documentation on how to program
  36.           that beast. There are some code modifications in place
  37.           already in case I get some _real_ info..., c'mon D-Link!)
  38.  
  39.  
  40.           2. LICENSE.
  41.  
  42.           This program is free software; you can redistribute it
  43.           and/or modify it under the terms of the GNU General Public
  44.           License as published by the Free Software Foundation; either
  45.           version 2, or (at your option) any later version.
  46.  
  47.           This program is distributed in the hope that it will be
  48.           useful, but WITHOUT ANY WARRANTY; without even the implied
  49.           warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  50.           PURPOSE. See the GNU General Public License for more
  51.           details.
  52.  
  53.           You should have received a copy of the GNU General Public
  54.           License along with this program; if not, write to the Free
  55.           Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
  56.           02139, USA.
  57.  
  58.  
  59.           3. FILES IN THIS RELEASE.
  60.  
  61.           README.DLINK  This file.
  62.           d_link.c      The Source (,may it be with You :-).
  63.  
  64.  
  65.           4. INSTALLATION.
  66.  
  67.            o Get the latest net binaries (those referring to /conf/net).
  68.  
  69.            o Read the NET-2 and Ethernet HOWTO's and modify your setup.
  70.  
  71.            o To include networking and the DE600 in your kernel, do:
  72.                # cd /linux
  73.                # make config       (answer yes on net and DE600)
  74.                # make clean
  75.                # make depend
  76.                # make zImage (or whatever magic you usually do)
  77.  
  78.            o I use lilo to boot multiple kernels, so that I at least
  79.              can have one working kernel :-). If you do too, append
  80.              these lines to /etc/lilo/config:
  81.  
  82.                   image = /usr/src/linux/zImage
  83.                        label = newlinux
  84.                        root = /dev/hda2 (or whatever YOU have...)
  85.  
  86.                # /etc/lilo/install
  87.  
  88.            o Do "sync" and reboot the new kernel with a D-Link pocket
  89.              adapter connected.
  90.  
  91.           Now, watch for any fireworks (try to ignore (or live with)
  92.           the smoke... :-) or:
  93.  
  94.                do
  95.                     read NET-FAQ and all info in /conf/net
  96.                     if fix in code needed...
  97.              vi /linux/net/inet/d_link.c
  98.              cd /linux
  99.                          make zImage
  100.              /etc/lilo/install
  101.                          sync
  102.                          reboot
  103.                     endif
  104.                     try it...
  105.                until satisfied
  106.  
  107.  
  108.           5. "PROBLEMS" AND TUNING,
  109.  
  110.            o Some machines have trouble handling the parallel port and
  111.              the adapter at high speed. If you experience problems:
  112.  
  113.              - The adapter is not recognized at boot, i.e. an Ethernet
  114.                adress of 00:80:c8:... is not shown, try to add another
  115.                  "; SLOW_DOWN_IO"
  116.                at D_LINK_SLOW_DOWN near line 43. As a last resort, uncomment:
  117.                  "#define REALLY_SLOW_IO"
  118.                near line 48 (see <asm/io.h> for hints).
  119.  
  120.              - You experience "timeout" messages: first try to add
  121.                another "; SLOW_DOWN_IO" at D_LINK_SLOW_DOWN near line 22,
  122.                _then_ try to increase the value (original value: 5)
  123.                at "if (tickssofar < 5)" near line 424.
  124.  
  125.              - The adapter _is_ recognized at boot but you get
  126.                messages about "Network Unreachable": The problem
  127.                is probably _not_ with the d_link driver.
  128.                Check your net configuration instead (ifconfig and route)
  129.                in "rc.inet1".
  130.              
  131.            o There might be some temporary "slowdowns" when communicating
  132.              with other systems when receiving through the TCP layer.
  133.              A "fix" for this is made lastly in the source, in the function
  134.              "d_link_rspace()" that is used to modify TCP if there is
  135.              a DE-600 in use (see comments around lines 320 and 730).
  136.  
  137.              The aim of this fix is to reduce the possibility of more
  138.              than two packets arriving adressed to the adapter within
  139.              the timespan it takes to copy one packet from the adapter.
  140.  
  141.              Transfers with ftp with a packetsize of >= 1k will be taken
  142.              care of with this "fix", but telnet with many small packets
  143.              might run into problems sometimes. The "slowdown" will usually
  144.              take care of itself, especially if there are some larger packets
  145.              arriving now and then...
  146.  
  147.              There is some room for "tuning" by changing (decreasing) the
  148.              values for "D_LINK_MAX_WINDOW" and "D_LINK_MIN_WINDOW"
  149.              defined near the end of the file (around line 726).
  150.              UDP (i.e. NFS) does not suffer from the same problem.
  151.  
  152.            o The code inside d_link_interrupt() is somewhat of a
  153.              (educated) guesswork since my only source of information
  154.              is the asm-source (:-), though I have tried to improve on it.
  155.  
  156.            o There is some rudimentary support for debugging, see
  157.          the source. Use "-DD_LINK_DEBUG=3" when compiling.
  158.  
  159.  
  160.           6. ACKNOWLEDGMENTS.
  161.  
  162.           This driver wouldn't have been done without the base
  163.           (and support) from Ross Biro (bir7@leland.stanford.edu).
  164.           The driver also relies upon GPL-ed source from D-Link Inc.
  165.           and from Russel Nelson at Crynwr Software (nelson@crynwr.com).
  166.           Additional input also from Donald Becker (becker@super.org).
  167.           Alpha release primary victim^H^H^H^H^H^Htester:
  168.           Erik Proper (erikp@cs.kun.nl).
  169.           Good input also from several users, most notably Mark Burton
  170.           <markb@ordern.demon.co.uk>.
  171.           Lastly, Fred van Kempen deserves all thanks for keeping up
  172.           the good work which will give us all a _great_ net package!
  173.  
  174.  
  175.           Happy hacking!
  176.  
  177.           Bjorn Ekwall == bj0rn@blox.se
  178.