home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / DIGI_OS2.ZIP / DMODE.DOC < prev    next >
Text File  |  1990-06-11  |  4KB  |  114 lines
  1.                         DigiWARE Release Notes
  2.                           for
  3.                                  DMODE
  4.  
  5.     Introduction
  6.  
  7.     DMODE is a 'work-alike' of the MODE command under OS/2 but with a
  8.     number of added features and a few different rules of behavior.
  9.     It came to the attention of the DigiBoard Technical Support Staff
  10.     that the standard MODE command -- though useful for many things --
  11.     was limited in the following ways:
  12.  
  13.     -- No communications device names besides COM1 - COM8 could be used.
  14.     -- Baud rates above 9600 could not be assigned.
  15.     -- Timeout, Handshake signals, etc. could not be set without having
  16.        to respecify the Baud rate, Parity and Data type parameters.
  17.     -- If any of the set of Baud_rate:Parity:Databits:Stopbits was left
  18.        off the command line, MODE would assign them to ITS defaults of
  19.        1200,e,7,1, instead of the defaults of whatever those values are
  20.        CURRENTLY set to.  Thus a user wanting only to change Baud rate
  21.        would unknowingly also reset the Data type and Parity of the
  22.        device.
  23.  
  24.     DMODE addresses these issues while attempting to remain compliant 
  25.     with the familiar MODE command syntax.
  26.  
  27.     In general, DMODE attempts to forgive as much as possible in terms 
  28.     of both the order of the arguments and as each argument's 
  29.     requirements for other unrelated arguments.  Given the limited range 
  30.     of values that most of the parameters can assume, DMODE will assign 
  31.     a parameter based on its value instead of its position in the command 
  32.     line.  The syntax of the DMODE command is then
  33.  
  34.         DMODE device-name[:] [arguments]
  35.  
  36.     where the device name must be the name of a character-device that
  37.     supports Generic IOCtl system calls.  The Colon is optional and is
  38.     there only to be backward compatible with MODE.  The remainder of 
  39.     the arguments are parsed according the following rules.  The 
  40.     arguments may appear in any order and must be separated from 
  41.     each other with a space and/or comma.  Any parameters left unspecified 
  42.     on the command line will be left in their current settings.  In any 
  43.     case, DMODE will report the current settings of all parameters AFTER 
  44.     such changes as requested on the command line have been assigned.  
  45.     Thus with no arguments (i.e. no changes to current settings), DMODE 
  46.     simply reports the current settings.  
  47.  
  48. Baud Rate Rules:
  49.     Baud Rates parameters are recognized to be any 2 to 5 decimal 
  50.     digit argument to be mapped as follows.
  51.     Accepted values....            Assigned Baud rate
  52.     -----------------------------------------------------------
  53.     11  110                          110
  54.     15  150                          150
  55.     30  300                          300
  56.     60  600                          600
  57.     12  120  1200                     1200
  58.     24  240  2400                     2400
  59.     48  480  4800                     4800
  60.     96  960  9600                     9600
  61.     19  192  1920 19200                19200
  62.     38  384  3840 38400                38400
  63.  
  64.  
  65. Data Bit Rules:
  66.     Data Bit parameters are recognized to be any 1 digit 
  67.     consisting of 5,6,7, or 8.
  68.  
  69. Stop Bit Rules:
  70.     Stop Bit parameters are recognized to be any argument with
  71.     the value of 1, 2, or 1.5.
  72.  
  73. Parity Rules:
  74.     The Parity parameter is recognized to be any single-letter
  75.     argument with the value of   E, O, N, M, S  -- For (E)ven, 
  76.     (O)dd, (N)one, (M)ark, and (S)pace.   Upper or lower case letters
  77.     are acceptable.
  78.  
  79.  
  80. Handshake Signals and Timeout parameter Rules:
  81.     These arguments follow the documentation for standard MODE command.
  82.     The accepted signal names are listed below.  In all cases the
  83.     name and assignment may be in any mix of upper an lower
  84.     case characters.
  85.  
  86.     Full name              Argument       State Assignments
  87.     -----------------------------------------------------
  88.     Read-timeout            TO    ON  OFF
  89.     Xon/Xoff handshake        XON    ON  OFF
  90.     Input DSR sensitivity        IDSR    ON  OFF
  91.     Output DSR sensitivity        ODSR    ON  OFF
  92.     Output handshake on CTS     OCTS    ON  OFF
  93.     DTR signal control        DTR    ON  OFF  HS
  94.     RTS signal control        RTS    ON  OFF  HS  TOG
  95.  
  96.  
  97.  
  98.  
  99. Examples:
  100.  
  101.     dmode digi12        [ interrogative; no settings changed ]
  102.  
  103.     dmode com5 2        [ the '2' assumed to be stop bits..  ]
  104.  
  105.     dmode com5:38 rts=ON    [ the '38' is parsed to the baud rate]
  106.                 [ of 38.4K baud, and RTS is turned ON]
  107.  
  108.     dmode com5 8        [ the '8' parsed as  data bits       ]
  109.  
  110.     dmode comdev83 IDSR=OFF,TO=off e 7 12
  111.                 [ IDSR is turned OFF, timeout on reads]
  112.                 [ is set to off, Even-parity is set,  ]
  113.                 [ 7 data bits is set, 1200 baud is set]
  114.