home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -seriously_amiga- / hardware / cnetdevice / readme < prev    next >
Encoding:
Text File  |  1998-04-27  |  7.7 KB  |  209 lines
  1.        --------------------------------------------------------------
  2.        "cnet.device" An Experimental Amiga PCMCIA Network Card Driver
  3.        --------------------------------------------------------------
  4.                 V0.7 By Bruce Abbott (bhabbott@inhb.co.nz)
  5.  
  6.  
  7. Introduction:
  8.  
  9.   Many A1200 owners have been asking the question "will a PC-CARD work
  10.   on my Amiga?". The usual reply to this is "No, because there are no
  11.   drivers for the Amiga". It has also been suggested that the A1200
  12.   PCMCIA port is incompatible with the PC-CARD standard.
  13.  
  14.   With PC-CARD Modems and Ethernet cards being so cheap, it was only a
  15.   matter of time before "Only the Amiga makes it possible". Thus I now
  16.   present "cnet.device", an Amiga driver for the CNet CN40BC and Accton
  17.   EN2216 PC-CARD ethernet adapters!
  18.  
  19.  
  20.  
  21. Requirements:
  22.  
  23.   - A CNet CN40BC or Accton EN2216 PCMCIA Ethernet card. (Some other
  24.     cards have also been reported to work - see the compatibility list).
  25.  
  26.   - An Amiga 1200 or Amiga 600.
  27.  
  28.   - Network software. Tested with AmiTCP 3.0b, Miami 2.0g and Envoy 2.0
  29.  
  30.   - A network :^)
  31.  
  32.  
  33.  
  34. Usage:
  35.  
  36.   Simply copy the file "cnet.device" to where you want it (usually
  37.   "DEVS:networks/") and set up your network software for an ethernet
  38.   driver. For AmiTCP 3.0 this would involve editing the "interfaces"
  39.   file and adding a line like "cnet dev = devs:networks/cnet.device".
  40.   Then you would start it up with "ifconfig cnet0 192.168.0.1".
  41.  
  42.  
  43.  
  44. Performance:
  45.  
  46.   My network consists of an A1200 030/40MHz conected via co-ax cable
  47.   to a 486DX-33 running Windoze 95. Software on the Amiga is AmiTCP3.0b
  48.   and ch_NFS, and the pecee is using MSTCP/IP and SOSNT. This gives me
  49.   access to the peecee drives on the Workbench. With this setup, file
  50.   transfer speeds reach about 200KBytes/Sec. FTP transfers between my
  51.   A1200 and an A600 with Viper630 (030/40MHz) have acheived 300KBytes/Sec.
  52.  
  53.  
  54.  
  55. Limitations:
  56.  
  57.   Some advanced SANA-II functions are not working in this version.
  58.   This should not affect normal operation.
  59.  
  60.   The only way to remove the device from memory is to re-boot!
  61.  
  62.   A1200s require an internal modification to the CreditCardReset line
  63.   to ensure correct card initialisation. If you haven't done this mod,
  64.   you may need to wait until after powering up your A1200 before plugging
  65.   the card in. If the 'Link' LED stays on but you are using co-ax cable,
  66.   this indicates that the card is NOT working properly. Also, sometimes
  67.   the card can appear to be OK but still doesn't work correctly.
  68.  
  69.   cnet.device v0.7 has more stringent testing than earlier versions, and
  70.   will not go online unless the PCMCIA attributes are correct (this is
  71.   required to enable hot-swapping and to be compatible with more cards).
  72.   In most cases if the card passes these tests then it is OK, but for best
  73.   results you should apply the reset modification!
  74.  
  75.  
  76. Hardware Modification Needed for A1200 PCMCIA port
  77.  
  78.   Cnet.device v0.5 used a config file to compensate for the Card Reset
  79.   problem with A1200s. In V0.6 this was abolished, and replaced by a more
  80.   reliable hardware modification. This may also help with cards that worked
  81.   with v0.4, but not with v0.5. If for some reason you cannot have the
  82.   hardware modification done you can now remove and re-insert the card to
  83.   make sure that it is reset properly, even if the device has already been
  84.   opened (however this is not recommended).
  85.  
  86.  
  87. Surf Squirrel Problems
  88.  
  89.   The Surf Squirrel SCSI/Serial adapter is not a proper PCMCIA card, and
  90.   has no attribute memory. Unfortunately, its driver takes over the PCMCIA
  91.   port and prevents other drivers from owning their cards. This will happen
  92.   whenever squirrelscsi.device is opened, even if the Surf Squirrel card is
  93.   never plugged in!
  94.  
  95.  
  96. Card_info Diagnostic Tool
  97.  
  98.   The 'card_info' program can be used to identify a PCMCIA card, and
  99.   will display a summary of its attributes. It also produces a binary
  100.   dump of the attribute and I/O memory, which can be analysed for more
  101.   detailed information. If you have an unknown card that doesn't seem
  102.   to work, run this program and send the 'card_info.bin' file to me -
  103.   after examining this I might be able to solve your problem.
  104.  
  105.  
  106. Example Network Files
  107.  
  108.  Because many people seem to have trouble setting up an Ethernet network,
  109.  I have included a copy of my own network configuration and startup script
  110.  files, which you can use as a template for your own installation. Please
  111.  change the username etc. to suit.
  112.  
  113.  
  114. History:
  115.  
  116.    V0.1 First Aminet Release
  117.  
  118.    - It worked, just.
  119.  
  120.  
  121.    V0.4 Second Aminet Release
  122.  
  123.    - Added several SANAII commands for compatibility with Miami.
  124.  
  125.    - Enabled interrupts during RemoteWrite. Should no longer cause
  126.      serial port overruns.
  127.  
  128.    - Improved error checking in case of card initialisation failure.
  129.      Now doesn't GURU if device is opened twice! Also tested it with
  130.      Enforcer, which did not detect any illegal memory accesses.
  131.  
  132.    - Relaxed hardware address verification to accept the Accton EN2216.
  133.      Now it might possibly work with other 'NE2000 compatible' cards.
  134.  
  135.    - Unrolled loops to improve data transfer speed. Now about 20% faster
  136.      on an unexpanded A600. Code size got bigger as a result :(
  137.  
  138.    - Hack to fix problem with missed interrupts. Now the device clears
  139.      the Gayle interrupt bits instead of letting card.resource do it.
  140.  
  141.  
  142.    V0.5  Third Aminet Release
  143.  
  144.    - Accepts 802.3 packets (probably, untested).
  145.  
  146.    - Sets BROADCAST bit in io_flags when appropriate.
  147.  
  148.    - Now examines PCMCIA attribute memory to determine the value to write
  149.      into the Card Configuration Register. This should work with all NE2000
  150.      compatible PCMCIA network cards, even those with different CCR offsets.
  151.  
  152.    - If attribute memory is not found, cnet.device tries to open the file
  153.      "s:cnetdev.config" and read from it the Card Configuration Register
  154.      offset, Configuration ID, and ROM Station Address. This often revives
  155.      a card that did not power up properly. The 'cnetconfig' program is
  156.      supplied for creating this file.
  157.  
  158.  
  159.    V0.6 Fourth Aminet Release
  160.  
  161.    - Removed cnet.config stuff, and replaced with a hardware mod. This
  162.      mod should be done on all A1200s (not required on the A600).
  163.  
  164.    - Now cards are hot-swappable. As a result, only proper network
  165.      cards will be accepted. Other types of cards are ignored so
  166.      that other drivers can access them.
  167.  
  168.    - I/O addressing now supports a 64KByte range. Previously this was
  169.      only 1KB, which may have prevented some cards from working.
  170.  
  171.    - Accepts all Card Configuration Register address sizes (previously
  172.      the address was assumed to be 16bit, but some cards are 24 bit!).
  173.  
  174.    - Tighter data transfer loops, which are slightly faster on a
  175.      machine with small CPU caches (eg. 68030).
  176.  
  177.    - Un-supported commands now return S2ERR_NOT_SUPPORTED.
  178.  
  179.    - 'card_info' program provided for viewing card attributes.
  180.  
  181.    v0.7  Fifth Aminet Release
  182.  
  183.    - fixed harmless bug in init_nic - remote DMA timeout test
  184.      could not fail!
  185.  
  186.    - Now remembers copytobuf/copyfrombuf tags for each opener.
  187.      Allows simultaneous use of eg. AmiTCP and Envoy.
  188.  
  189.    - OnEvent types ONLINE and OFFLINE now return immediately
  190.      if the device is already in the wanted state.
  191.  
  192.  
  193.  
  194.  
  195. Legal Mush:
  196.  
  197.   To encourage further development in PC-CARD devices for the Amiga, I am
  198.   placing the source code for this project into the Public Domain. You
  199.   can freely use or abuse it as you wish. I have also included some other
  200.   authors' code for reference purposes, please respect their copyrights.
  201.  
  202.   Please note that this driver is not a finished product, and is almost
  203.   certain to harbour a few bugs. Thus I will not be held responsible for
  204.   any loss or injury that you may incur while using it.
  205.  
  206.   I cannot guarantee compatibility with your system. All I can say is it
  207.   works for me.
  208.  
  209.