home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / 594p.zip / DMODE.DOC < prev    next >
Text File  |  1994-12-19  |  8KB  |  165 lines
  1.  
  2.             DigiWARE DMODE for OS/2 (DMODE V1.4.6)
  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.         115  1152 11520 115200                     115200
  63.         230  2300 23000 230000                     230000
  64.  
  65.  
  66. Data Bit Rules:
  67.     Data Bit parameters are recognized to be any 1 digit 
  68.     consisting of 5,6,7, or 8.
  69.  
  70. Stop Bit Rules:
  71.     Stop Bit parameters are recognized to be any argument with
  72.     the value of 1, 2, or 1.5.
  73.  
  74. Parity Rules:
  75.     The Parity parameter is recognized to be any single-letter
  76.     argument with the value of   E, O, N, M, S  -- For (E)ven, 
  77.     (O)dd, (N)one, (M)ark, and (S)pace.   Upper or lower case letters
  78.     are acceptable.
  79.  
  80.  
  81. Handshake Signals and Timeout parameter Rules:
  82.     These arguments follow the documentation for standard MODE command.
  83.     The accepted signal names are listed below.  In all cases the
  84.     name and assignment may be in any mix of upper an lower
  85.     case characters.
  86.  
  87.     Full name                  Argument     State Assignments
  88.     -----------------------------------------------------
  89.     Read-timeout                    TO      ON  OFF
  90.     Tx Xon/Xoff handshake           XON     ON  OFF  BOTH (Tx/Rx Xon/Xoff)
  91.     Input DSR sensitivity           IDSR    ON  OFF
  92.     Output DSR sensitivity          ODSR    ON  OFF
  93.     Output handshake on CTS         OCTS    ON  OFF
  94.     DTR signal control              DTR     ON  OFF  HS
  95.     RTS signal control              RTS     ON  OFF  HS  TOG
  96.  
  97. ALT_PIN processing: [--intelligent DigiBoards ONLY--]
  98.     In some cases it is useful to have the driver report changes in
  99.     DSR as if they were changes in CD (the modem Carrier Detect Signal).
  100.     This is sometimes done to get around a limitation of the
  101.     8-wire RJ45 connector -- a connector which leaves pin1 and pin10
  102.     of the standard 10-wire RJ45 unterminated.  Since pin10 is defined to
  103.     be Carrier Detect and so many communications programs depend on
  104.     accurate reporting of the state of this CD signal use of 8-wire
  105.     RJ45 connectors can prevent these programs from working.  A work-around
  106.     is to slightly change the wiring scheme of the 8-wire RJ45 so that
  107.     the CD wire is brought into the middle 8 wires which DO make contact.
  108.     Of course this means that the signal that USED to be defined for that
  109.     location must be moved out to pin10, where CD used to be.  In
  110.     general the LEAST payed-attention-to signal is DSR (on Pin2) so if
  111.     CD is wired to Pin2 and DSR is wired to Pin10 close to full modem
  112.     control can be acheived on an 8-wire RJ45.  The final step in this
  113.     trick is then to instruct the Device driver that for THIS channel
  114.     pin2 is to be interpretted as CD instead of DSR.  DMODE permits
  115.     this ALTERNATE PIN ASSIGNMENT PROCESSING mode to be established on
  116.     channels by issueing the requisite custom command to the XALL driver.
  117.  
  118.     dmode {devname} ALT=ON          ;; report PIN2 as CD
  119.         or
  120.     dmode {devname} ALT=OFF         ;; report PIN2 as DSR (default)
  121.  
  122.     Those interested in implementing this custom call in software should
  123.     look at the file XALL.DOC on the distribution diskette for information.
  124.  
  125.  
  126. QUICK_WRITE processing : [-- intelligent DigiBoards ONLY --]
  127.  
  128.         Quick-Write mode is the performance enhancing default mode of the
  129.         DigiBoard OS/2 intelligent card driver. This enhances performance
  130.         by causing DosWrite calls to return as soon as the transmit data is
  131.         copied to the DigiBoard's hardware transmit buffer. When this mode
  132.         is disabled, DosWrite calls will return only after the transmit data
  133.         has actually left the DigiBoard hardware, mimicing the OS/2 COM.SYS
  134.         driver. A side effect of using quick-writes is that when DosClose is
  135.         called, the driver must wait for any transmit data on the DigiBoard
  136.         hardware to drain before finishing the close processing. The quick-
  137.         write processing can be selected with the following parameters :
  138.  
  139.         dmode {devname} QW=ON            ;; enable quick-write mode
  140.         dmode {devname} QW=OFF           ;; disable quick-write mode
  141.  
  142.  
  143.  
  144.  
  145. Examples:
  146.  
  147.     dmode digi12            [ interrogative; no settings changed ]
  148.  
  149.     dmode com5 2            [ the '2' assumed to be stop bits..  ]
  150.  
  151.     dmode com5:38 rts=ON    [ the '38' is parsed to the baud rate]
  152.                 [ of 38.4K baud, and RTS is turned ON]
  153.  
  154.     dmode com5 8            [ the '8' parsed as  data bits       ]
  155.  
  156.     dmode comdev83 IDSR=OFF,TO=off e 7 12
  157.                 [ IDSR is turned OFF, timeout on reads]
  158.                 [ is set to off, Even-parity is set,  ]
  159.                 [ 7 data bits is set, 1200 baud is set]
  160.  
  161.     dmode com5 38 ALT=ON    [ set 38.4Kbaud, report PIN2 as CD      ]
  162.  
  163.     dmode com5 e alt=off
  164.                 [ set EVEN parity, report PIN2 as DSR , ]
  165.