home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / os2 / mode / dmode.doc < prev    next >
Encoding:
Text File  |  1993-04-06  |  5.9 KB  |  142 lines
  1.  
  2.                         DigiWARE DMODE for OS/2    (DMODE V1.4.1)
  3.  
  4.     Introduction
  5.  
  6.     DMODE is a 'work-alike' of the MODE command under OS/2 but with a
  7.     number of added features and a few different rules of behavior.
  8.     It came to the attention of the DigiBoard Technical Support Staff
  9.     that the standard MODE command -- though useful for many things --
  10.     was limited in the following ways:
  11.  
  12.     -- No communications device names besides COM1 - COM8 could be used.
  13.     -- Timeout, Handshake signals, etc. could not be set without having
  14.        to re-specify the Baud rate, Parity and Data type parameters.
  15.     -- If any of the set of Baud_rate:Parity:Databits:Stopbits was left
  16.        off the command line, MODE would assign them to ITS defaults of
  17.        1200,e,7,1, instead of the defaults of whatever those values are
  18.        CURRENTLY set to.  Thus a user wanting only to change Baud rate
  19.        would unknowingly also re-set the Data type and Parity of the
  20.        device.
  21.  
  22.     DMODE addresses these issues while attempting to remain compliant 
  23.     with the familiar MODE command syntax.
  24.  
  25.     In general, DMODE attempts to forgive as much as possible in terms 
  26.     of both the order of the arguments and of each argument's 
  27.     requirements for other unrelated arguments.  Given the limited range 
  28.     of values that most of the parameters can assume, DMODE will assign 
  29.     a parameter based on its value instead of its position in the command 
  30.     line.  The syntax of the DMODE command is then
  31.  
  32.         DMODE device-name[:] [arguments]
  33.  
  34.     where the device name must be the name of a character-device that
  35.     supports Generic IOCtl system calls.  The Colon is optional and is
  36.     there only to be backward compatible with MODE.  The remainder of 
  37.     the arguments are parsed according the following rules.  The 
  38.     arguments may appear in any order and must be separated from 
  39.     each other with a space and/or comma.  Any parameters left unspecified 
  40.     on the command line will be left in their current settings.  In any 
  41.     case, DMODE will report the current settings of all parameters AFTER 
  42.     such changes as requested on the command line have been assigned.  
  43.     Thus with no arguments (i.e. no changes to current settings), DMODE 
  44.     simply reports the current settings.  
  45.  
  46. Baud Rate Rules:
  47.     Baud Rates parameters are recognized to be any 2 to 5 decimal 
  48.     digit argument to be mapped as follows.
  49.     Accepted values....            Assigned Baud rate
  50.     -----------------------------------------------------------
  51.     11  110                          110
  52.     15  150                          150
  53.     30  300                          300
  54.     60  600                          600
  55.     12  120  1200                     1200
  56.     24  240  2400                     2400
  57.     48  480  4800                     4800
  58.     96  960  9600                     9600
  59.     19  192  1920 19200                19200
  60.     38  384  3840 38400                38400
  61.     57  576  5760 57600                57600
  62.  
  63. Data Bit Rules:
  64.     Data Bit parameters are recognized to be any 1 digit 
  65.     consisting of 5,6,7, or 8.
  66.  
  67. Stop Bit Rules:
  68.     Stop Bit parameters are recognized to be any argument with
  69.     the value of 1, 2, or 1.5.
  70.  
  71. Parity Rules:
  72.     The Parity parameter is recognized to be any single-letter
  73.     argument with the value of   E, O, N, M, S  -- For (E)ven, 
  74.     (O)dd, (N)one, (M)ark, and (S)pace.   Upper or lower case letters
  75.     are acceptable.
  76.  
  77.  
  78. Handshake Signals and Timeout parameter Rules:
  79.     These arguments follow the documentation for standard MODE command.
  80.     The accepted signal names are listed below.  In all cases the
  81.     name and assignment may be in any mix of upper an lower
  82.     case characters.
  83.  
  84.     Full name              Argument       State Assignments
  85.     -----------------------------------------------------
  86.     Read-timeout            TO    ON  OFF
  87.     Xon/Xoff handshake        XON    ON  OFF
  88.     Input DSR sensitivity        IDSR    ON  OFF
  89.     Output DSR sensitivity        ODSR    ON  OFF
  90.     Output handshake on CTS     OCTS    ON  OFF
  91.     DTR signal control        DTR    ON  OFF  HS
  92.     RTS signal control        RTS    ON  OFF  HS  TOG
  93.  
  94. ALT_PIN processing: [--intelligent DigiBoards ONLY--]
  95.     In some cases it is useful to have the driver report changes in
  96.     DSR as if they were changes in CD (the modem Carrier Detect Signal).
  97.     This is sometimes done to get around a limitation of the 
  98.     8-wire RJ45 connector -- a connector which leaves pin1 and pin10
  99.     of the standard 10-wire RJ45 unterminated.  Since pin10 is defined to
  100.     be Carrier Detect and so many communications programs depend on
  101.     accurate reporting of the state of this CD signal use of 8-wire
  102.     RJ45 connectors can prevent these programs from working.  A work-around
  103.     is to slightly change the wiring scheme of the 8-wire RJ45 so that
  104.     the CD wire is brought into the middle 8 wires which DO make contact.
  105.     Of course this means that the signal that USED to be defined for that
  106.     location must be moved out to pin10, where CD used to be.  In
  107.     general the LEAST payed-attention-to signal is DSR (on Pin2) so if
  108.     CD is wired to Pin2 and DSR is wired to Pin10 close to full modem 
  109.     control can be acheived on an 8-wire RJ45.  The final step in this
  110.     trick is then to instruct the Device driver that for THIS channel
  111.     pin2 is to be interpretted as CD instead of DSR.  DMODE permits
  112.     this ALTERNATE PIN ASSIGNMENT PROCESSING mode to be established on
  113.     channels by issueing the requisite custom command to the XALL driver.
  114.  
  115.     dmode {devname} ALT=ON        ;; report PIN2 as CD
  116.         or
  117.     dmode {devname} ALT=OFF        ;; report PIN2 as DSR (default)
  118.  
  119.     Those interested in implementing this custom call in software should
  120.     look at the file XALL.DOC on the distribution diskette for information.
  121.  
  122. Examples:
  123.  
  124.     dmode digi12        [ interrogative; no settings changed ]
  125.  
  126.     dmode com5 2        [ the '2' assumed to be stop bits..  ]
  127.  
  128.     dmode com5:38 rts=ON    [ the '38' is parsed to the baud rate]
  129.                 [ of 38.4K baud, and RTS is turned ON]
  130.  
  131.     dmode com5 8        [ the '8' parsed as  data bits       ]
  132.  
  133.     dmode comdev83 IDSR=OFF,TO=off e 7 12
  134.                 [ IDSR is turned OFF, timeout on reads]
  135.                 [ is set to off, Even-parity is set,  ]
  136.                 [ 7 data bits is set, 1200 baud is set]
  137.  
  138.     dmode com5 38 ALT=ON    [ set 38.4Kbaud, report PIN2 as CD    ]
  139.  
  140.     dmode com5 e alt=off
  141.                 [ set EVEN parity, report PIN2 as DSR , ]
  142.