home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / a / asm_one / asm-onev1.25a.dms / in.adf / Release3.1 / AutoDocs3.1.lha / doc / port-handler.doc < prev    next >
Encoding:
Text File  |  1993-08-12  |  3.2 KB  |  106 lines
  1. TABLE OF CONTENTS
  2.  
  3. port-handler/port_handler
  4. port-handler/port_handler                           port-handler/port_handler
  5.  
  6.    NAME
  7.        port_handler -- standard serial/parallel/printer port handler.
  8.  
  9.    SYNOPSIS
  10.     Open("PRT:[RAW]",...);
  11.  
  12.     Open("SER:[baud/control]",...);
  13.  
  14.     Open("PAR:",...);
  15.  
  16.    FUNCTION
  17.     Port-handler allows AmigaDOS to interface to a standard parallel
  18.     device, a standard printer device, and a standard serial device.
  19.  
  20.     Accessing "PAR:" connects AmigaDOS to the system's parallel port.
  21.  
  22.     Accessing "PRT:" connects AmigaDOS to the system's printer. Data
  23.     written to PRT: is processed by the Amiga's printer device, handling
  24.     conversions of ANSI sequences, and sent to the printer. Accessing
  25.     "PRT:RAW" instead causes carriage return translation to be turned
  26.     off in the printer device while printing.
  27.  
  28.     Accessing "SER:" connects AmigaDOS to the system's default serial port.
  29.     Following SER:, the baud rate and some control information can be
  30.     supplied. This is done in the form "SER:baud/control" where baud is
  31.     a number indicating the baud rate, and where control is a 3 letter
  32.     sequence denoting the number of read/write bits, the parity, and the
  33.     number of stop bits. For example, "SER:9600/8N1" connects to the
  34.     serial port, sets the baud rate to 9600, with 8 bit data, no parity,
  35.     and 1 stop bit. The possible control settings are:
  36.  
  37.         1st character: 7 or 8
  38.         2nd character: N (No parity), O (Odd parity), E (Even parity)
  39.                    M (Mark parity), S (Space parity)
  40.         3rd character: 1 or 2
  41.  
  42.     Specifying no baud rate or control values when accessing SER: gives you
  43.     the values set in Serial preferences.
  44.  
  45.    PACKETS
  46.     ACTION_FINDINPUT
  47.     ACTION_FINDOUTPUT
  48.     ACTION_FINDUPDATE
  49.     ACTION_READ
  50.     ACTION_WRITE
  51.     ACTION_END
  52.     ACTION_IS_FILESYSTEM
  53.  
  54.    MOUNTLIST ENTRIES
  55.     dos.library automatically mounts PAR:, PRT:, and SER: upon
  56.     system boot up. The mount entries used by dos.library are equivalent
  57.     to:
  58.  
  59.        SER:    Handler   = L:Port-Handler
  60.                Priority  = 5
  61.                StackSize = 800
  62.            GlobVec   = 1
  63.                Startup   = 0
  64.        #
  65.  
  66.        PAR:    Handler   = L:Port-Handler
  67.                Priority  = 5
  68.                StackSize = 800
  69.            GlobVec   = 1
  70.                Startup   = 1
  71.        #
  72.  
  73.        PRT:    Handler   = L:Port-Handler
  74.                Priority  = 5
  75.                StackSize = 1000
  76.            GlobVec   = 1
  77.                Startup   = 2
  78.        #
  79.  
  80.     Starting with V40, you can also provide disk-based mount entries
  81.     which let you use port-handler as a serial handler on various devices
  82.     and units. The form of these mount entries is:
  83.  
  84.        SER0:   EHandler  = L:Port-Handler
  85.                Priority  = 5
  86.                StackSize = 800
  87.            GlobVec   = 1
  88.                Device    = serial.device
  89.                Unit      = 0
  90.                Flags     = 0
  91.            Control   = "8N1"
  92.                Baud      = 9600
  93.     #
  94.  
  95.     The "Device", "Unit" and "Flags" keywords define the parameters
  96.     that the handler uses for OpenDevice(). "Baud" and "Control"
  97.     define the default values for baud rate and control information for
  98.     whenever that serial handler is accessed by name only, without
  99.     explicit baud rate and control information specified.
  100.  
  101.    NOTE
  102.     Prior to V40, the baud rate and control information for SER: were
  103.     only recognized if an A2232 multi-serial card was installed in the
  104.     system. Starting with V40, these values are always recognized.
  105.  
  106.