home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / os2 / mode / uos2144c.doc < prev    next >
Encoding:
Text File  |  1993-06-14  |  26.3 KB  |  770 lines
  1.  
  2. Installation Guide
  3. Reference Manual
  4. for
  5. Universal OS/2 Device Driver
  6. for
  7. DigiCHANNEL Intelligent 
  8. Communications Boards
  9.  
  10. 92000100C
  11.  
  12.  
  13. DigiBoard, DigiCHANNEL, PC/Xi, PC/16i, PC/8i, PC/Xe, PC/16e, PC/8e, PC/4e,
  14. PC/2e, Xem, PC/Xem, MC/Xem, EISA/Xem, COM/Xi, COM/8i, COM/4i, MC/Xi, MC/16i, 
  15. MC/8i, MC/4i and C/X are trademarks of DigiBoard.  All other brand and product
  16. names are the trademarks of their respective holders.
  17.  
  18.  
  19. c Digi International, Inc.
  20. All Rights Reserved
  21.  
  22. Information in this document is subject to change without notice and does not
  23. represent a commitment on the part of DigiBoard.
  24. DigiBoard provides this document "as is," without warranty of any kind, either 
  25. expressed or implied, including, but not limited to, the particular purpose.
  26. DigiBoard may make improvements and/or changes in this manual or in the product(
  27. s) and/or the program(s) described in this manual at any time.
  28. This product could include technical inaccuracies or typographical errors. 
  29. Changes are periodically made to the information herein; these changes may be
  30. incorporated in new editions of the publication.
  31.  
  32. RESTRICTED RIGHTS:
  33.  
  34. For non-U. S. Government use:
  35. These programs are supplied under a license.  They may be used, disclosed,
  36. and/or copied only as permitted under such license agreement.  Any copy must 
  37. contain the above copyright notice and this restricted rights notice.  Use,
  38. coping , and/or disclosure of the programs is strictly prohibited unless
  39. otherwise provided in the license agreement. 
  40.  
  41. For U.S. Government use:
  42. Use, duplication, or disclosure by the Government is subject to restrictions
  43. as set forth in sub-paragraph (c)(1)(ii) of the Rights in Technical Data and
  44. Computer Software clause of DFARS 52.227-7013.
  45.  
  46. Table of Contents
  47. Table of Contents    3
  48. Introduction    4
  49. The Distribution Diskette    6
  50. Installing the Device Driver    7
  51. Global Parameters    7
  52. Per-Card Parameters    10
  53. Examples    13
  54. Testing the Ports    15
  55. Troubleshooting    16
  56. Error Messages    18
  57. DMODE I/O Port Configuration Utility    19
  58. Examples    23
  59. Appendix-Synchronous Communications Modes    25
  60.  
  61.  
  62. Introduction
  63. This release of the DigiWARE device driver for OS/2 supports the 
  64. entire line of DigiCHANNEL intelligent asynchronous serial 
  65. communications controllers:
  66.  
  67. Micro Channel (MCA) bus:    
  68. DigiCHANNEL MC/Xi 4, 8 and 16 port boards
  69. DigiCHANNEL MC C/X cluster controller system
  70. DigiCHANNEL MC/Xem
  71. PC/AT (ISA) bus:
  72. DigiCHANNEL PC/Xe 2, 4, 8 and 16 port boards
  73. DigiCHANNEL PC/Xi 8 and 16 port boards
  74. DigiCHANNEL COM/Xi 4 and 8 port boards
  75. DigiCHANNEL ISA C/X cluster controller system
  76. DigiCHANNEL PC/Xem
  77. EISA bus:
  78. DigiCHANNEL EISA C/X cluster controller system
  79. DigiCHANNEL EISA/Xem
  80.  
  81. The device driver software supports multiple boards and multiple 
  82. board types in a single machine, and can handle up to 256 ports 
  83. from any combination of the boards listed above.  As new products 
  84. are introduced, the driver will be upgraded to include those devices 
  85. as well.
  86. The driver takes all its configuration information from the device= 
  87. command line in CONFIG.SYS, and all DigiCHANNEL intelligent 
  88. boards in a system are configured from a single command line.
  89.  
  90.  
  91. In addition to the device driver, the configuration utility 
  92. DMODE.EXE is provided to change communication parameters for 
  93. individual ports without rebooting.  DMODE.EXE is similar to the 
  94. OS/2 MODE command, but has some added features, and supports 
  95. communications devices beyond OS/2's range of COM1 to 
  96. COM8.
  97.  
  98.  
  99. Before installing this device driver software, 
  100. complete the installation of the DigiCHANNEL 
  101. intelligent communications board(s) in your 
  102. system, according to the hardware installation 
  103. manual provided with the board(s), and write 
  104. down your configuration!  The driver supports all 
  105. legal I/O and memory address settings, but must 
  106. be informed of these settings in the device driver 
  107. command line.
  108.  
  109.  
  110. The Distribution Diskette
  111. The diskette accompanying this manual contains all of the files and 
  112. documentation needed to install the DigiWARE OS/2 Universal 
  113. Intelligent Device Driver in your system.  A list of these files 
  114. follows:
  115.  
  116. XALL.SYS        The installable device driver.
  117. DMODE.EXE        A MODE work-alike program for configuring I/O 
  118.             ports beyond COM8.
  119. INSTALL.DOC        Installation instructions for the current 
  120.             release of the driver.
  121. RELNOTES.DOC        Release notes.
  122. DMODE.DOC        Instructions for the DMODE program.
  123. XALL.DOC        Programmer's information about the driver 
  124.             and applicable system calls.
  125. *.bin            Miscellaneous binary files used by the driver.
  126.  
  127.  
  128. Installing the Device Driver
  129.  
  130. Copy all of the files from the distribution diskette to a single 
  131. directory on your hard drive.  By default, driver and data files are 
  132. expected to be in \DIGI.  
  133.  
  134. The device driver is invoked by placing its name and configuration 
  135. arguments into the system's CONFIG.SYS file.  All Digi-
  136. CHANNEL intelligent asynchronous serial communications boards 
  137. must be installed from a single command line, which contains 
  138. complete set-up information for each board.  The format of the 
  139. command line is:
  140.  
  141. device=\digi\xall.sys [/n:names] [/b:baud] [/d:dtype] 
  142. [/f:digipath] [/v:messagepath] /t:card /p:port /m:mem [, 
  143. /t:card /p:port /m:mem] [, ...]
  144.  
  145. Note that the path for XALL.SYS is \DIGI.  This is the default 
  146. path.  If an alternative path is specified with the /f:digipath option, 
  147. substitute that path for \DIGI.
  148.  
  149.  
  150. The above command line must appear on a single 
  151. command line in the CONFIG.SYS file.  This line 
  152. may be up to 255 characters long.
  153.  
  154.  
  155. Global Parameters
  156.  
  157. The first six parameters in the command line above are global 
  158. parameters, and affect all boards installed.  These parameters are 
  159. optional, and may be omitted.  If omitted, default values will be 
  160. used.
  161.  
  162. /n:names
  163.  
  164.     Defines the naming convention to be use for the 
  165. DigiCHANNEL ports.  names consists of an optional 
  166. "stem" followed by the starting device number.  The 
  167. new stem must be enclosed in double-quotes ("").  If 
  168. the stem is omitted, "COM" will be used.  If the 
  169. number is omitted, "3" will be assumed.  If the /n 
  170. parameter is not specified, the default name COM3 will 
  171. be assigned to the first port.
  172.  
  173. /n:"digi"0    DIGI0, DIGI1, DIGI2, ... DIGIn
  174. /n:4            COM4, COM5, COM6, ... COMn
  175. /n:"qdev"    QDEV3, QDEV4, QDEV5, ... QDEVn
  176.  
  177. /b:baud
  178.  
  179.     Sets the default baud rate to be used for all ports.  If this 
  180. parameter is not specified, all ports will be set to the 
  181. OS/2 default of 1200 baud.  Baud rates of up to 38,400 
  182. are supported.  Use the DMODE.EXE command to set 
  183. baud rates of individual ports.
  184.  
  185. /b:9600        Initializes all ports to 9600 baud.
  186.  
  187. /d:dtype
  188.  
  189.     Sets the initial data type (parity, character length and 
  190. number of stop bits).  If this parameter is omitted, the 
  191. OS/2 default data type of even parity, 7 data bits and 1 
  192. stop bit is used.  The syntax is pds, where p is E, O or N; 
  193. d is 8, 7, 6 or 5; and s is 1 or 2.  All three values must 
  194. be supplied, in the correct order.
  195.  
  196. /d:N81        No parity, 8 data bits, 1 stop bit.
  197.  
  198. /f:digipath
  199.  
  200. Defines an alternative directory path for the driver and 
  201. data files.  If this option is present, all files from the 
  202. distribution diskette must be present in this directory.
  203.  
  204. /f:d:\drvr\digi    
  205.                 All data files are in "D:\DRVR\DIGI".
  206.  
  207.  
  208.  
  209. /v:messagefile
  210.  
  211. Forces the driver to direct all verbose messages to the 
  212. file named.  If /v: is given without a filename, 
  213. messages will be placed in \XALL.MSG.  This flag 
  214. prevents any information from being displayed on the 
  215. console; useful in some situations as when the machine 
  216. is a "headless server", where calls to Standard Output 
  217. will cause problems.  Without this flag, all messages will 
  218. appear on the system console.
  219.  
  220. The message file is overwritten each time the system is 
  221. started.
  222.  
  223. /v:errmsg     Writes banner and other info to file 
  224. "\ERRMSG".
  225.  
  226. /v:            Writes banner and other info to file 
  227. "\XALL.MSG".
  228.  
  229. /a:a        Enable the alternate pin assignment of Data Carrier 
  230. Detect (DCD) for all ports (see discussion of Alt-Pin 
  231. processing on page 24).
  232.  
  233.  
  234. Per-Card Parameters
  235.  
  236. The remaining three parameters are per-card parameters, and are 
  237. used to inform the driver of the type of board and where it is to be 
  238. addressed in the host's I/O and memory buses.  These parameters 
  239. are mandatory, and must be given for each board!
  240.  
  241. The per-card parameters must be given in complete sets, and the 
  242. sets must be separated by commas.
  243.  
  244. /t:card
  245.  
  246.     Defines the card type to the driver.  Legal values for 
  247. card are:  i for the ISA C/X, e for the EISA C/X, m for 
  248. the MC C/X, p for Xem systems (PC/Xem, MC/Xem 
  249. or EISA/Xem) and x for COM/Xi boards.  This 
  250. parameter must be omitted for PC/Xe, PC/Xi and 
  251. MC/Xi boards.  The designators i, e, and m must be 
  252. followed by an additional two digits defining the 
  253. number and arrangement of DigiCHANNEL C/CON-
  254. 16 or C/CON-16e concentrators on each host adapter 
  255. channel.  If the concentrator(s) are connected to the host 
  256. adapter via a dial-up or leased line (remote 
  257. concentrators), each of the two digits must be followed 
  258. by a parameter, enclosed in parentheses, specifying the 
  259. synchronous communications mode to be used for that 
  260. line.  See the Appendix for a list of available 
  261. synchronous communications modes.
  262.  
  263. /t:i10    ISA C/X, one local concentrator on line 1 
  264.     only.
  265. /t:e11    EISA C/X, one local concentrator on each of 
  266.     lines 1 and 2.
  267. /t:m21    MC C/X, two local concentrators on line 1 
  268.     and 1 on line 2.
  269. /t:e12    EISA C/X, one local concentrator on line 1, 
  270.     and two on line 2.
  271. /t:i22    ISA C/X, two local concentrators on each of 
  272.     lines 1 and 2.
  273. /t:i2(21)3(27)    
  274.  
  275. ISA C/X, two remote concentrators on line 
  276. 1, and two remote concentrators on line 2.  
  277. The concentrators on line 1 will use mode 
  278. #21 (76,800 baud, 8-wire, external clock) to 
  279. communicate with the host adapter, and the 
  280. concentrators on line 2 will use mode #27 
  281. (614,400 baud, 8-wire, internal clock).  See 
  282. the Appendix for a list of synchronous 
  283. communications modes.
  284.  
  285. /t:x        COM/Xi (4 or 8 channels)
  286. /t:p        PC/Xem, MC/Xem or EISA Xem
  287.  
  288. /p:port        Defines the I/O port address for the card.
  289.  
  290. /p:300        Board is addressed at I/O port 300h.
  291. /p:2005        EISA board (EISA C/X or EISA/Xem 
  292.         host adapter) is in slot 2 (EISA I/O 
  293.         addresses are 4 digits-the slot number, 
  294.         followed by "005").
  295.  
  296. When plugging an ISA board (PC/Xe, ISA C/X host 
  297. adapter, etc.) into an EISA machine, the /p parameter 
  298. must contain the 3-digit I/O address as set by the DIP 
  299. switches on the board, and not the 4-digit address based 
  300. on the EISA slot number.
  301.  
  302.  
  303. /m:mem
  304.  
  305.     Dual-ported memory starting address.  This is the full 
  306. 32-bit hexadecimal address of the beginning of the 
  307. board's dual-ported memory.
  308.  
  309. /m:d0000    Sets dual-ported memory start 
  310.         address to 0D0000h (in the BIOS 
  311.         expansion area between 640K and 1 
  312.         megabyte).
  313. /m:e80000    Sets start address of E80000h (in the 
  314.         fifteenth megabyte).
  315.  
  316. EISA and ISA boards (except the COM/Xi), may all 
  317. share the same memory starting address.  COM/Xi and 
  318. all Micro Channel boards must each have unique 
  319. memory addresses.
  320.  
  321.  
  322. Examples
  323.  
  324. The following examples start out with just the minimum to install a 
  325. DigiCHANNEL board.  After locating an example for your type of 
  326. board, read the rest of the examples for optional situations that may be 
  327. appropriate to your application.  Default options will be altered by your 
  328. application program(s) when you configure the application.
  329.  
  330. Example 1:    COM/Xi
  331.  
  332. One COM/Xi at I/O port 300h, memory start address D8000h; 
  333. devices to be named COM5 COM6, etc.  All data files are in the 
  334. directory \DIGI:
  335.  
  336. device=c:\digi\xall.sys /n:5 /p:300 /m:d8000 /t:x 
  337.  
  338. (Note that the above must all appear on one line in CONFIG.SYS)
  339.  
  340.  
  341. Example 2:    PC/Xe, PC/Xi
  342. One PC/Xe (or PC/Xi) at I/O port 220h, memory address D0000h   
  343. Ports will be named COM3, COM4, etc. (default names).  All data 
  344. files are in the directory \MISC\DIGI:
  345.  
  346. device=c:\misc\digi\xall.sys /f:\misc\digi /p:220 /m:d0000 
  347.  
  348. (Note that the above must all appear on one line in CONFIG.SYS)
  349.  
  350.  
  351.  
  352. Example 3:    MC/Xi
  353.  
  354. One MC/Xi at I/O port F1F0h, memory address FC0000h.  Devices 
  355. will be named DIGI1, DIGI2, etc. and will have an initial baud rate of 
  356. 38,400.  All data files are in the default directory \DIGI:
  357.  
  358. device=c:\digi\xall.sys /n:"digi"1 /b:38400 /p:F1F0 /m:FC0000 
  359.  
  360. (Note that the above must all appear on one line in CONFIG.SYS)
  361.  
  362.  
  363. Example 4:    Two board installation with optional global 
  364.         parameters.
  365.  
  366. Two PC/Xi (or PC/Xe) boards at I/O ports 320h and 300h, with dual-
  367. ported memory of both starting at D0000h.  Ports will be named 
  368. COM0, COM1, etc., and will be initialized to 38,400 baud, no parity, 
  369. 8 data bits and 1 stop bit; messages will be contained in the file 
  370. MESSAGES.MSG located in the \DIGI directory.  All data files are in 
  371. the default directory \DIGI:
  372.  
  373. device=c:\digi\xall.sys /n:0 /b:38400 /v:\digi\messages.msg 
  374. /d:N81 /p:320 /m:D0000, /p:300 /m:D0000 
  375.  
  376.  
  377. (Note that the above must all appear on one line in CONFIG.SYS)
  378.  
  379.  
  380. Example 5:    PC/Xem
  381.  
  382. One PC/Xem at I/O port 224h, memory start address C8000h; devices 
  383. to be named COM3 COM4, etc.  All data files are in the default 
  384. directory \DIGI:
  385.  
  386. device=c:\digi\xall.sys /p:224 /m:C8000 /t:p
  387. (Note that the above must all appear on one line in CONFIG.SYS)
  388.  
  389.  
  390.  
  391.  
  392. Example 6:    ISA C/X 
  393.  
  394. One ISA C/X host adapter at I/O port 228h, memory address 
  395. D0000h, with one concentrator on line 1 and two on line 2.  Devices to 
  396. be named DCX1, DCX2, etc. and will have an initial baud rate of 
  397. 38,400.  All data files are in the default directory \DIGI:
  398.  
  399. device=c:\digi\xall.sys /n:"dcx"1 /b:38400 /p:228 /m:d0000 /t:i12 
  400.  
  401. (Note that the above must all appear on one line in CONFIG.SYS)
  402.  
  403.  
  404. Example 7:    EISA C/X with a remote concentrator via an RS-
  405.         232 synchronous modem.
  406.  
  407. One EISA C/X host adapter in slot 3, memory address D8000h, with 
  408. two local concentrators on line 1 and one remote concentrator at 9600 
  409. baud and external clocking on line 2.  Devices to be named COM5, 
  410. COM6, etc. and will have an initial baud rate of 19,200.  All data files 
  411. are in the directory \OS2\DIGI:
  412.  
  413. device=c:\os2\digi\xall.sys /n:5 /b:19200 /f:c:\os2\digi 
  414. /p:3005 /m:d8000 /t:e21(17)
  415. (Note that the above must all appear on one line in CONFIG.SYS)
  416.  
  417.  
  418.  
  419. Example 8:    MC C/X and MC/Xem
  420. One MC C/X host adapter at I/O port 228h, memory address 
  421. D8000h, with one concentrator on line 1 and one concentrator  on line 
  422. 2; one MC/Xem at I/O Port 304h, memory address D0000h.  Devices 
  423. will be named DIGI1, DIGI2, etc. and will have an initial baud rate of 
  424. 38,400, Alt-Pin enabled, no parity, 8 data bits, and 1 stop bit.  All data 
  425. files are in the default directory \DIGI:
  426.  
  427. device=c:\digi\xall.sys /n:"digi"1 /b:38400 /a:a /d:N81 /p:228 
  428. /m:d8000 /t:m11, /p:304 /m:d0000 /t:p 
  429.  
  430. (Note that the above must all appear on one line in CONFIG.SYS)
  431. (Note that for MC C/X and MC/Xem, the addresses 104 and 108 
  432. should not be used to avoid possible conflicts)
  433.  
  434.  
  435. Testing the Ports
  436.  
  437. The simplest (and probably the best) way to check the driver and 
  438. I/O connections is to connect an ASCII terminal to one of the ports 
  439. and redirect some output to that port.  If the terminal is connected to 
  440. COM3, try something like the following:
  441.  
  442. dmode com3    (this will verify that the driver can find the 
  443.         port-the port's parameters will be displayed.)
  444.  
  445. dmode com3 octs=off odsr=off
  446.         (this insures that the hardware handshaking 
  447.         signals CTS and DSR will not prevent output-
  448.         we are not concerned with flow control at this 
  449.         time.)
  450.  
  451. dir > com3    (this redirects the current directory to COM3.)
  452.  
  453. The console should simply respond by repeating the C:\> prompt, 
  454. and the current directory (in this case, C:\) will appear on the 
  455. terminal.
  456.  
  457.  
  458. Troubleshooting
  459.  
  460. If the C:\> prompt doesn't reappear, and the system seems to be 
  461. "hung", you probably used a memory start address that is being 
  462. used by some other device, or the board is not set for the address 
  463. specified in CONFIG.SYS.  Try a different address.  If it still hangs, 
  464. try a different I/O port.  If your computer has a memory cache and 
  465. the board's memory start address is above 1 megabyte, try either 
  466. disabling the cache or moving the board to a low-memory address 
  467. (D0000 is usually a good choice).
  468.  
  469. It is also possible that a conflict exists with another device driver 
  470. which has been loaded via CONFIG.SYS.  The XALL.SYS line 
  471. should be placed near the end of the CONFIG.SYS, and must not 
  472. be placed before the DEVICE=TESTCFG.SYS line.
  473. Due to potential device naming conflicts, the pair of lines
  474.  
  475.     DEVICE=\OS2\COM.SYS
  476.         and
  477.     DEVICE=\OS2\VCOM.SYS
  478.  
  479. may cause problems.  Be sure that the XALL.SYS line is placed 
  480. before these lines in CONFIG.SYS.  If the XALL.SYS driver 
  481. generates an error message, try temporarily putting "REM" in front 
  482. of the above two lines.  If this works, there is probably a naming 
  483. conflict.  You may need to add a /n: command line flag to the 
  484. XALL.SYS line to force the driver to use a different base name or 
  485. start numbering the COM devices at 5 or above.
  486.  
  487. If the C:\> prompt does reappear, but there is no output on the 
  488. terminal screen, there is probably a cabling problem.  Make sure 
  489. that all cable plugs are securely seated in receptacles, and that they 
  490. are configured correctly (see the appropriate section of the 
  491. hardware installation guide for your board).
  492.  
  493. If the terminal displays output, but the data on the screen is garbled, 
  494. the terminal is probably not set with the same baud rate and data 
  495. type as specified in CONFIG.SYS (or the defaults, if not specified).  
  496. Verify these settings.
  497.  
  498. If everything checks out and you still have problems, there could 
  499. be a problem with your board.  Contact your distributor or 
  500. DigiBoard Technical Support for further assistance.
  501.  
  502.  
  503. Error Messages
  504.  
  505. If, when the driver is loaded, it cannot find the board(s), or if they 
  506. fail to respond properly to commands, certain error messages may 
  507. be sent to the console.  These error messages are defined in the 
  508. following table:
  509.  
  510. Could not find BIOS file
  511. Could not find FEP file
  512. Could not find data file
  513.  
  514. One or more files were missing from the digipath directory.  
  515. The default digipath directory is /digi.  If you have loaded the 
  516. driver and data files into a different directory, that directory 
  517. must be specified in the xall command line with the 
  518. /f:digipath parameter.
  519.  
  520. IO Port Not Responding
  521.  
  522. I/O port address set incorrectly, or conflicting with some other 
  523. device. Verify setting, or try a different address.
  524.  
  525. DigiBoard BIOS Will Not Boot
  526. DigiBoard BIOS Will Not Respond
  527. DigiBoard FEPOS Will Not Boot
  528.  
  529. BIOS on DigiCHANNEL board will not respond to commands 
  530. from the driver.  Typically due to a memory conflict, or a 
  531. memory cache conflict.  
  532.  
  533. Driver Failed to Hook Timer
  534. System Cannot Allocate Memory
  535.  
  536. A system call to OS/2 has failed.
  537.  
  538. Invalid Command Line Arguments
  539.  
  540. Syntax error in the command line in CONFIG.SYS.  Double-
  541. check your entries.
  542.  
  543.  
  544.  
  545. DMODE I/O Port Configuration Utility
  546.  
  547. DMODE is DigiBoard's I/O channel configuration utility. DMODE 
  548. functions like the OS/2 MODE command, but is more flexible, and 
  549. provides some added features.
  550.  
  551. *    Supports communications device names other than COM1-
  552.     COM8.
  553. *    Any single parameter may be changed without causing all 
  554.     others to be reset to default values.
  555. *    Can be used to enable or disable the Alt-Pin feature on 
  556.     individual ports.
  557. *    Maintains the familiar MODE syntax.
  558.  
  559. DMODE arguments may be entered in any order, and in many cases 
  560. may be abbreviated.  For example, a baud rate of 19,200 may be 
  561. entered simply as "19", since within the context of the DMODE 
  562. command, "19" cannot be interpreted as anything else. Arguments 
  563. may be separated by spaces or commas, and unspecified 
  564. parameters are left unchanged.  DMODE returns the settings of all 
  565. parameters after any requested changes have been made. If no 
  566. parameters are given, DMODE simply returns the current settings.
  567.  
  568. The syntax of DMODE is:
  569.  
  570. dmode port_name [parameters]
  571.  
  572.  
  573. Port names and parameters are not case sensitive, so upper and 
  574. lower case letters may be freely mixed without effect on the 
  575. operation of the DMODE command.
  576.  
  577. The following parameters are accepted:
  578.  
  579. Baud Rate    Baud rates can be specified with 2 to 5 digit 
  580. designations, according to the following table:
  581.  
  582. Accepted Values            Baud Rate
  583.  
  584. 11   110                   110
  585. 15   150                   150
  586. 30   300                   300 
  587. 60   600                   600
  588. 12   120   1200            1200 
  589. 24   240   2400            2400
  590. 48   480   4800            4800
  591. 96   960   9600            9600
  592. 19   192   1920   19200    19200                    
  593. 38   384   3840   38400    38400
  594. 56   567   5670   56700    56700
  595.  
  596.  
  597.  
  598. Character Length
  599.  
  600. Characters may be 5, 6, 7 or 8 bits long.  Enter the 
  601. appropriate number in the DMODE arguments.
  602.  
  603. Parity        Enter the desired parity checking method with a single 
  604.         letter E, O, N, M or S for Even, Odd, None, Mark or 
  605.         Space, respectively.
  606.  
  607. Stop Bits    Enter the desired number of stop bits.  Recognized 
  608.         values are 1, 2 and 1.5.
  609.  
  610. Flags        DMODE supports the following flags in the same way as 
  611.         the OS/2 MODE command.  Refer to your OS/2 
  612.         documentation for explanations of the flags. To set a 
  613.         flag, enter the mnemonic for the flag, followed by an 
  614.         equals sign (=), and the desired value (ON, OFF, etc.).
  615.  
  616. Read Timeout Flag
  617. TO=ON        Read timeout in effect.
  618. TO=OFF    No timeout.
  619.  
  620. XON/XOFF Handshake Flag
  621. XON=ON    XON/XOFF handshaking enabled.
  622. XON=OFF    XON/XOFF handshaking disabled.
  623.  
  624. Input DSR Sensitivity
  625. IDSR=ON    Enables Input DSR Sensitivity.
  626. IDSR=OFF    Disables Input DSR Sensitivity.
  627.  
  628. Output DSR Sensitivity
  629. ODSR=ON    Enables Output DSR Sensitivity.
  630. ODSR=OFF    Disables Output DSR Sensitivity.
  631.  
  632.  
  633. Output Handshake on CTS
  634. OCTS=ON    Enables CTS output flow control.
  635. OCTS=OFF    Disables CTS output flow control.
  636.  
  637. DTR Signal Control
  638. DTR=ON    Sets DTR to "ON" or HIGH.
  639. DTR=OFF    Sets DTR to "OFF" or LOW.
  640. DTR=HS    DTR used for output flow control.
  641.  
  642. RTS Signal Control
  643. RTS=ON    Sets RTS to "ON" or HIGH.
  644. RTS=OFF    Sets RTS to "OFF" or LOW.
  645. RTS=HS    RTS used for output flow control.
  646. RTS=TOG    Toggles RTS from LOW to HIGH, or 
  647. from HIGH to LOW.
  648.  
  649. Alt-Pin Processing
  650. ALT=ON    Internally swaps DSR and DCD signals 
  651. (see explanation below).
  652. ALT=OFF    DSR and DCD are not swapped.
  653.  
  654. DigiCHANNEL products use 10-pin RJ-45 
  655. connectors in order to support all of the signals 
  656. normally available on a 9-wire RS-232 connection.  
  657. However, many commercially available RJ-45 
  658. connectors have only 8 pins.  8-pin RJ-45 plugs will 
  659. fit in a 10-pin jack, but the first and last pins 
  660. (numbers 1 and 10) are not connected.  DigiBoard 
  661. uses these pins for the modem control signals RI 
  662. (Ring Indicator, pin 1) and DCD (Data Carrier 
  663. Detect, pin 10). While Ring Indicator is rarely a 
  664. concern (since most modems have auto-answer 
  665. capability), Data Carrier Detect is often monitored to 
  666. insure that the modem has established, and is 
  667. maintaining, a valid connection with a remote 
  668. modem.  
  669.  
  670. To facilitate the use of 8-pin RJ-45 connectors in 
  671. modem applications, a special DMODE flag, ALT, has 
  672. been provided.  ALT instructs the device driver to 
  673. monitor pin 1 of an 8-pin RJ-45 for DCD.
  674.  
  675. See the Hardware Installation guide for your board 
  676. for cabling diagrams and pin assignment charts for 
  677. DB-25 and RJ-45 connectors.
  678.  
  679. Examples
  680.  
  681. dmode digi12    
  682. Returns the current settings of device digi12.  No changes are 
  683. made.
  684.  
  685. dmode com5 2    
  686. Configures COM5 for 2 stop bits.  All other parameters remain 
  687. unaffected.
  688.  
  689. dmode com5:38 rts=on
  690. Configures COM5 for a baud rate of 38,400 and sets RTS to "ON" 
  691. or HIGH.
  692.  
  693. dmode com5 8    
  694. Configures COM5 for 8 data bits.  No other parameters are 
  695. affected.
  696.  
  697. dmode comdv83 idsr=off, to=off e 7 12
  698. Sets COMDV83 to disable Input DSR Sensitivity, disable input 
  699. timeout, select even parity, 7 data bits and a baud rate of 1200.
  700.  
  701. dmode com5 38 alt=on
  702. Sets up COM5 for a baud rate of 38,400, and enables Alt-Pin 
  703. Processing.
  704.  
  705. dmode com5 e alt=off
  706. Sets COM5 for even parity checking and disables Alt-Pin 
  707. processing.
  708.  
  709. dmode com3 odsr=off octs=off
  710. Disables sensing of output flow control signals Clear To Send 
  711. (CTS) and Data Set Ready (DSR).
  712.  
  713.  
  714. Appendix-Synchronous Communications Modes
  715.  
  716. The DigiCHANNEL C/X host adapter communicates with attached 
  717. C/CON-16 concentrators via two RS-422 synchronous channels 
  718. (newer concentrators and host adapters also support RS-232 
  719. synchronous communication-see your hardware Installation 
  720. Guide).  The default operating mode for these channels is 1.2 
  721. megabaud, 8-wire, internally clocked.  This provides the fastest 
  722. possible communication between the host adapter and locally 
  723. connected concentrators (in this context, local indicates that 
  724. concentrators are connected directly, via a 4 or 8 wire cable, to the 
  725. host adapter; remote refers to concentrators that are connected to 
  726. the host adapter via data communications devices such as modems 
  727. or DSUs).
  728.  
  729. Local concentrators always communicate with the host adapter in 
  730. either an eight wire internally clocked mode or a four wire self-
  731. clocked mode (in the four wire modes the clock is encoded with 
  732. the data instead of being carried on separate lines as in the eight 
  733. wire modes).
  734.  
  735. Remote concentrators always use an eight wire externally clocked 
  736. mode (the clock signal is provided by the synchronous modem).
  737.  
  738. The table on the following page shows the modes that are 
  739. supported by the XALL.SYS device driver.  Note that the external 
  740. clock baud rates are approximates used to set up time-outs and 
  741. tuning parameters only.  Values do not need to be exact; select the 
  742. speed closest to the actual sped of your synchronous modem.
  743.  
  744.  
  745.  
  746. Eight-Wire               Eight-Wire              Four-Wire 
  747. Internal Clock           Enternal Clock          Self-Clocking
  748.  
  749. Mode   Baud Rate         Mode   Baud Rate        Mode   Baud Rate
  750. Mode
  751.  
  752. 0      115k              15     2400             1      250k 
  753.                          16     4800             2      460k                
  754. 3      2400              17     9600  
  755. 4      4800              18     19.2k
  756. 5      9600              19     38.4k
  757. 6      19.2k             20     57.6k
  758. 7      38.4k             21     76.8k
  759. 8      57.6k             22     115k
  760. 9      76.8k             23     230k
  761. 10     115k              24     460k
  762. 11     230k              25     920k
  763. 12     460k              26     1.2M
  764. 13     920k
  765. 14     1.2M              29     614k
  766.                          30     737k             
  767. 27     614k
  768. 28     737k
  769.  
  770.