home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 54 / af054sub.adf / plip.lha / Plip / plip.doc < prev   
Text File  |  1993-06-10  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. PLIP.DEVICE(1)                                     PLIP.DEVICE(1)
  5.  
  6.  
  7. NAME
  8.        PLIP - A Parallel Line IP SANA2 Device Driver
  9.  
  10. OVERVIEW
  11.        PLIP  is  a  network device driver conforming to the SANA2
  12.        standard.  It allows linking of  two  Amigas  using  their
  13.        parallel  ports.   Transfer  speed is around 40 kbyte/sec.
  14.        The complete low level transfer protocol is integrated  in
  15.        the  device driver, including port arbitration handshaking
  16.        and interrupt driven reads.  Although the transfer process
  17.        itself is cpu intensive, the device needs no cpu resources
  18.        when no transfer is in progress.
  19.  
  20.        PLIP is intended as a low-cost networking solution,  since
  21.        the  capabilities  of  the  parallel hardware are somewhat
  22.        limited.  However, it gives much better results than  SLIP
  23.        and leaves the serial port free.
  24.  
  25. REQUIREMENTS
  26.        You  will  need   at   least kickstart and workbench V2.04
  27.        (37.175)  to use PLIP. Also some SANA2 compliant  network-
  28.        ing  protocol  (like  Envoy or AS225R2) will come in handy
  29.        :-).
  30.  
  31. INSTALLATION
  32.        Just copy plip.device to devs:networks.  See the  documen-
  33.        tation of your networking package for further installation
  34.        steps.  If you are going to use both Envoy and AS225  over
  35.        PLIP  at the same time, be sure to first start Envoy, then
  36.        AS225.  If you've  got  problems  with  multiple  protocol
  37.        stacks  you  might  try making the packet and host IDs for
  38.        each protocol unique.
  39.  
  40.        Since PLIP only allows two hosts to  be  linked  together,
  41.        addressing   is   limited   to   1  Bit.   One  host  uses
  42.        plip.device, Unit 0, the other one  plip.device,  Unit  1.
  43.        The  device  will  not  work if both machines use the same
  44.        unit number.
  45.  
  46.        PLIP   looks   for   an   environment   variable    called
  47.        ENV:SANA2/PLIP.config. This should contain one line termi-
  48.        nated with a newline, which will  be  parsed  by  ReadArgs
  49.        according to the template
  50.  
  51.        TIMEOUT/K/N,PRIORITY=PRI/K/N,MTU/K/N,BPS/K/N, where
  52.  
  53.        TIMEOUT=num
  54.                Packet receive timeout, default is 330000.  Set to
  55.                a higher value if  you  have  problems  with  slow
  56.                machines.
  57.  
  58.        PRIORITY=num
  59.                PLIP  task  priority, default is 15. Do not change
  60.                this.
  61.  
  62.  
  63.  
  64. Version 38.7                Release 3                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PLIP.DEVICE(1)                                     PLIP.DEVICE(1)
  71.  
  72.  
  73.        MTU=num Maximum packet data size, default and  maximum  is
  74.                8192.  If you change this, be sure to change it on
  75.                both machines to the same value!
  76.  
  77.        BPS=num The nominal bits per second rate returned  from  a
  78.                device  query.  Default is 25000 which is much too
  79.                low but works with beta Envoy.
  80.  
  81.        An example PLIP.config is included. All recognized parame-
  82.        ters will be printed into the startup window of PLIP.
  83.  
  84. CABLE
  85.        You  will  need  male  (A1000: female) DB25 connectors and
  86.        some (up to 4 meters) parallel cable. Connect:
  87.  
  88.             D0-D7/BUSY/POUT   to   D0-D7/BUSY/POUT
  89.             ACK               to   STROBE
  90.             STROBE            to   ACK
  91.             GND               to   GND
  92.  
  93.        You can look up the pin assignment in your Amiga User Man-
  94.        ual, appendix A.  Please note that this cable differs from
  95.        ParNet! Double check before using!
  96.  
  97.        There is a potential problem with the RI (ring  indicator)
  98.        line  on  the  serial  port.  If you have problems running
  99.        PLIP, first try to remove  any  device  connected  to  the
  100.        serial  port.  If that helps, you might try cutting the RI
  101.        line in the serial connector.
  102.  
  103. COPYRIGHT
  104.        PLIP is (C) Copyright 1993 Oliver Wagner & Michael Balzer,
  105.        All  Rights  Reserved.   You are granted a limited copying
  106.        license to distribute this version  of  plip  for  private
  107.        purposes only.
  108.  
  109.        Under  no  circumstances  may  PLIP be used on any machine
  110.        which is used for the research, development, construction,
  111.        testing  or production of weapons or other military appli-
  112.        cations.  This also includes any machine which is used for
  113.        training  persons for any of the above mentioned purposes.
  114.  
  115.        PLIP is SHAREWARE. You may test PLIP for two weeks. If you
  116.        decide  to use PLIP (regularly or irregularly) you have to
  117.        pay the
  118.  
  119.            ---> SHAREWARE FEE of 10,- DM (or 10 US$) <---.
  120.  
  121.        Please send the money to
  122.  
  123.             Oliver Wagner
  124.             Landsberge 5
  125.             W-4322 (from July 1993 on: 45549) Sprockhoevel
  126.             GERMANY
  127.  
  128.  
  129.  
  130. Version 38.7                Release 3                           2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PLIP.DEVICE(1)                                     PLIP.DEVICE(1)
  137.  
  138.  
  139.        Use PLIP at your own risk.  Please send bug reports to:
  140.             o.wagner@aworld-2.aworld.de / O.WAGNER@AWORLD-2.ZER
  141.        or
  142.             bilbo@bagsend.aworld.de     / M.BALZER@AWORLD.ZER
  143.  
  144.        Please  exactly  state  the  machine  configuration  which
  145.        causes PLIP to fail.
  146.  
  147. HISTORY
  148.        V37.11
  149.         - small speedups in transmission handshaking
  150.         - now uses utility library for parsing the buffer
  151.           management taglist
  152.  
  153.        V37.14
  154.         - optimized BPS and MTU
  155.         - cleaned up the code
  156.  
  157.        V38.5
  158.         - fixed CRC check
  159.         - added information window
  160.         - some protocol fixes
  161.  
  162.        V38.7
  163.         - changed hardware type to 13 (official PLIP ID)
  164.         - added configuration mechanism
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. Version 38.7                Release 3                           3
  197.  
  198.  
  199.