home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / comms / a / freenet / !FreeNet_Docs_SLIPdriver < prev    next >
Encoding:
Text File  |  1995-04-08  |  4.2 KB  |  100 lines
  1.                                SLIPdriver
  2.  
  3.                           (C) Tom Hughes 1995
  4.  
  5. 0. Copyright
  6.  
  7.   The SLIPdriver module described by this document and this document
  8.   itself are copyright (C) Tom Hughes 1994. They are however released as
  9.   freeware subject to certain terms and conditions. These are described
  10.   in the file named 'Licence' which should have accompanied this
  11.   document.
  12.  
  13. 1. Introduction
  14.  
  15.   This file describes the SLIPdriver module supplied with the FreeNet
  16.   TCP/IP stack. This module implements a hardware driver conforming to
  17.   version three of the Acorn DCI specification for hardware drivers and
  18.   provides hardware interfaces which talk the SLIP protocol over serial
  19.   lines.
  20.  
  21.   The driver supports up to four interfaces (this is a DCI limitation),
  22.   each of which is attached to a specified serial line. The serial lines
  23.   are driven using the blockdrivers, thus providing support for various
  24.   dual serial cards as well as the internal serial port.
  25.  
  26.   The module provides two commands, plus a number of SWIs and service
  27.   calls for implementing the DCI protocol. It can be loaded before or
  28.   after loading the TCP/IP stack it is going to work with, but the
  29.   interfaces you intend to use must be configured using the slattach
  30.   command before you can configure them into the TCP/IP stack using
  31.   ifconfig.
  32.  
  33. 2. The Serial Blockdrivers
  34.  
  35.   The SLIPdriver module uses the serial blockdrivers written by Hugo
  36.   Fiennes to talk to whatever serial interfaces you may have. These
  37.   reside in an application named !SerialDev which will need to have been
  38.   seen by the filer before attempting to use the SLIPdriver module.
  39.  
  40.   These blockdrivers should be available from ftp.demon.co.uk in the
  41.   directory /pub/archimedes. They are also available from most major
  42.   Acorn bulletin boards and FTP sites.
  43.  
  44.   If you intend to use the 'Internal' or 'InternalPC' drivers (used to
  45.   drive the built in serial port), you will need to be using at least
  46.   revision 11 of the blockdrivers, as there is a bug in earlier releases
  47.   that prevents these drivers working correctly with SLIPdriver.
  48.  
  49. 3. Configuring SLIP interfaces
  50.  
  51.   In order to use SLIP interfaces, you will need to load the SLIPdriver
  52.   module using RMRun, and this is usually done in the FreeNet startup
  53.   script. If a numeric argument is given on the command line when running
  54.   the module, this is taken as the MTU (largest pack size) to use for
  55.   the SLIP interfaces, otherwise the default 576 byte MTU will be used.
  56.  
  57.   Once the module has been loaded, the SLIP interfaces you wish to use
  58.   will need to be configured using the slattach command, the syntax of
  59.   which is as follows:
  60.  
  61.       slattach <driver> <port> <speed>
  62.  
  63.   Where <driver> is the name of a blockdriver, <port> is the port number
  64.   for that driver, and <speed> is the speed at which you wish to run the
  65.   connection. Obviously, because this command needs to be able to load a
  66.   blockdriver, the !SerialDev application will need to have been seen by
  67.   the filer beforehand.
  68.  
  69.   As an example, the following line configures the internal serial port
  70.   for use with the SLIP driver, running at 19200 baud:
  71.  
  72.       slattach internal 0 19200
  73.  
  74.   Equally, the following configures two interfaces using the two ports
  75.   on a Serial Port dual serial card, each running at 38400 baud, with
  76.   one using a PC cable and one an Acorn cable:
  77.  
  78.       slattach sp_dual 0 38400
  79.       slattach sp_dualpc 1 38400
  80.  
  81.   Each configured port (up to a maximum of four) will be assigned a
  82.   number from zero to three, with the resulting interfaces being named
  83.   sl0 to sl3. The numbers are assigned in order, starting from zero, so
  84.   the first interface to be configured will be sl0, the next sl1 and so
  85.   on.
  86.  
  87. 4. Checking the modules status
  88.  
  89.   A second command is provided to check on the current status of the
  90.   SLIP driver, including what interfaces are configured, whether they
  91.   are currently active, and how much data has flowed through them. This
  92.   command is slstat, and takes no parameters.
  93.  
  94. 5. Closing the SLIP connections
  95.  
  96.   Killing the module will cause the TCP/IP stack to be informed that the
  97.   configured interfaces are no longer available, after which each of the
  98.   serial lines will be dropped, hence informing the remote system that
  99.   the link is being dropped.
  100.