home *** CD-ROM | disk | FTP | other *** search
/ Dream 44 / Amiga_Dream_44.iso / Amiga / workbench / pilotes / pcmcia / cnetdevice.lha / cnetdevice / readme < prev    next >
Text File  |  1997-07-30  |  7KB  |  204 lines
  1.        --------------------------------------------------------------
  2.        "cnet.device" An Experimental Amiga PCMCIA Network Card Driver
  3.        --------------------------------------------------------------
  4.                 V0.5 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. The following
  24.     cards (and their owners) have also been reported to work:-
  25.  
  26.        - Socket Communications model AAA-1001 (Jimmy Nyholm)
  27.  
  28.        - DLink DE-650 (Marcus Klein)
  29.  
  30.        - SureCom EP-527 (Ondrej Filip)
  31.  
  32.        Note: 3COM cards are known to NOT work with the current driver.
  33.  
  34.   - An Amiga 1200 or Amiga 600.
  35.  
  36.   - Network software. Tested with AmiTCP 3.0b, Miami 2.0g and Envoy 2.0
  37.  
  38.   - A network :^)
  39.  
  40.  
  41.  
  42. Usage:
  43.  
  44.   Simply copy the file "cnet.device" to where you want it (usually
  45.   "DEVS:networks/") and set up your network software for an ethernet
  46.   driver. For AmiTCP 3.0 this would involve editing the "interfaces"
  47.   file and adding a line like "cnet dev = devs:networks/cnet.device".
  48.   Then you would start it up with "ifconfig cnet0 192.168.0.1".
  49.  
  50.  
  51.  
  52. Performance:
  53.  
  54.   My network consists of an A1200 030/40MHz conected via co-ax cable
  55.   to a 486DX-33 running Windoze 95. Software on the Amiga is AmiTCP3.0b
  56.   and ch_NFS, and the pecee is using MSTCP/IP and SOSNT. This gives me
  57.   access to the peecee drives on the Workbench. With this setup, file
  58.   transfer speeds reach about 200KBytes/Sec. FTP transfers between my
  59.   A1200 and an A600 with Viper630 (030/40MHz) have acheived 300KBytes/Sec.
  60.  
  61.  
  62.  
  63. Limitations:
  64.  
  65.   Some advanced SANA-II functions are not working in this version.
  66.   This should not affect normal operation.
  67.  
  68.   Do not try to run multiple protocol stacks on this driver, as the
  69.   device can only operate with a single opener.
  70.  
  71.   The only way to remove the device is to re-boot! (even if it didn't
  72.   open properly).
  73.  
  74.   The device does not handle "hot swapping" cards. However you can pull
  75.   out and re-insert the card if you wish, just remember to reboot after-
  76.   wards. New for V0.4 - You can safely remove the card, which will cause
  77.   the device to go Offline. However it will _not_ go back online when
  78.   re-inserted!
  79.  
  80.   On my A1200, the card sometimes refuses to initialise properly on power
  81.   up. Simply unplugging and re-inserting it usually clears this error. I
  82.   suspect that this may be caused by slow power supply startup, although
  83.   there is the possibility that software may be involved. When properly
  84.   initialised, the card runs perfectly, and has often been online for
  85.   several days at a time.
  86.  
  87.  
  88.  
  89. Configuration Procedure (New for V0.5)
  90.  
  91.   Often the card may still work OK even when power-up problems have made
  92.   the PCMCIA attribute memory and ROM Station Address invalid. To allow
  93.   operation under these circumstances, cnet.device will now try to read
  94.   this info from a configuration file ("s:cnetdev.config") if the PCMCIA
  95.   attribute memory is not found.
  96.  
  97.   To create the config file, first make sure that the card is working
  98.   properly (usually plugging the card in after power on, but BEFORE
  99.   attempting access, will ensure this). Then run the program "cnetconfig"
  100.   which will read the required attributes from the card, and create the
  101.   config file automatically. The format of the file is as follows:-
  102.  
  103.   - the CCR offset in hex eg. "$03F8"
  104.  
  105.   - an "="
  106.  
  107.   - the ConfigID in hex eg. "$20"
  108.  
  109.   - a LineFeed
  110.  
  111.   - an "@"
  112.  
  113.   - the Hardware Station Address as 12 hex digits eg. "00C01E27D503"
  114.  
  115.   - another LineFeed
  116.  
  117.   Any other characters in the file will cause it to be rejected, so don't
  118.   edit it with a word processor!
  119.  
  120.   Cnetconfig only needs to be run once (unless you change to another card).
  121.   It will work either with or without network software running, and can
  122.   also be useful for simply determining whether the card is working.
  123.  
  124.  
  125.  
  126. Note to existing users:
  127.  
  128.  If you upgrade to V0.5 but do not create a config file, you may find that
  129.  the card is less likely to work properly. This is because cnet.device no 
  130.  longer tries to jam fixed values into the CCR. Therefore, make sure that 
  131.  you run "cnetconfig" after installing the new device driver.
  132.  
  133.  
  134.  
  135. Example Network Files
  136.  
  137.  Because many people seem to have trouble setting up an Ethernet network,
  138.  I have included a copy of my own network configuration and startup script
  139.  files, which you can use as a template for your own installation. Please
  140.  change the username etc. However, you should use the same domain for all
  141.  all local IP addresses ie. 192.168.0.x
  142.  
  143.  
  144. History:
  145.  
  146.    V0.1 First Aminet Release
  147.  
  148.    - It worked, just.
  149.  
  150.  
  151.    V0.4 Second Aminet Release
  152.  
  153.    - Added several SANAII commands for compatibility with Miami.
  154.  
  155.    - Enabled interrupts during RemoteWrite. Should no longer cause
  156.      serial port overruns.
  157.  
  158.    - Improved error checking in case of card initialisation failure.
  159.      Now doesn't GURU if device is opened twice! Also tested it with
  160.      Enforcer, which did not detect any illegal memory accesses.
  161.  
  162.    - Relaxed hardware address verification to accept the Accton EN2216.
  163.      Now it might possibly work with other 'NE2000 compatible' cards.
  164.  
  165.    - Unrolled loops to improve data transfer speed. Now about 20% faster
  166.      on an unexpanded A600. Code size got bigger as a result :(
  167.  
  168.    - Hack to fix problem with missed interrupts. Now the device clears
  169.      the Gayle interrupt bits instead of letting card.resource do it.
  170.  
  171.  
  172.    V0.5  Third Aminet Release
  173.  
  174.    - Accepts 802.3 packets (probably, untested).
  175.  
  176.    - Sets BROADCAST bit in io_flags when appropriate.
  177.  
  178.    - Now examines PCMCIA attribute memory to determine the value to write
  179.      into the Card Configuration Register. This should work with all NE2000
  180.      compatible PCMCIA network cards, even those with different CCR offsets.
  181.  
  182.    - If attribute memory is not found, cnet.device tries to open the file
  183.      "s:cnetdev.config" and read from it the Card Configuration Register
  184.      offset, Configuration ID, and ROM Station Address. This often revives
  185.      a card that did not power up properly. The 'cnetconfig' program is
  186.      supplied for creating this file.
  187.  
  188.  
  189.  
  190. Legal Mush:
  191.  
  192.   To encourage further development in PC-CARD devices for the Amiga, I am
  193.   placing the source code for this project into the Public Domain. You
  194.   can freely use or abuse it as you wish. I have also included some other
  195.   authors' code for reference purposes, please respect their copyrights.
  196.  
  197.   Please note that this driver is not a finished product, and is almost
  198.   certain to harbour a few bugs. Thus I will not be held responsible for
  199.   any loss or injury that you may incur while using it.
  200.  
  201.   I cannot guarantee compatibility with your system. All I can say is it
  202.   works for me.
  203.  
  204.