home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / 594m.doc < prev    next >
Text File  |  1994-07-18  |  12KB  |  259 lines
  1.  
  2. Software Manual DigiBoard PC/Xe and MC/Xe 
  3. Intelligent Asynchronous Serial Communications Boards 
  4.  
  5. OS/2 Introduction 
  6.  
  7. The DigiWARE device driver for the OS/2 operating system supports the entire 
  8. line of DigiBoard intelligent serial communications boards. The OS/2 device
  9. driver takes all of its configuration information from the DEVICE= command
  10. line in CONFIG.SYS, and all DigiBoard intelligent products in a system are
  11. configured from a single command line. In addition to the device driver, the
  12. configuration utility, DMODE.EXE is provided to change communication parameters
  13. for individual ports without rebooting. DMODE.EXE is similar to the OS/2 MODE
  14. command, but has some added features, and supports communications devices
  15. beyond OS/2's range of COM1 to COM8. 
  16.  
  17. The OS/2 device driver for DigiBoard intelligent boards 
  18. supports OS/2 applications only.  The device driver cannot 
  19. be accessed from a virtual DOS window.
  20.  
  21. OS/2 provides two native Com device drivers for communication with non 
  22. intelligent serial ports (e.g. COM1 and COM2).  These drivers are COM.SYS, the 
  23. OS/2 native Com port driver, and VCOM.SYS, the virtual DOS window Com port 
  24. driver.  These drivers cannot control intelligent serial devices. 
  25.  
  26. Software Installation 
  27. The OS2 directory of the device driver diskette contains all of the files and 
  28. documentation needed to install the OS/2 driver in your system. A list of 
  29. these files follows: 
  30.  
  31. XALL.SYS      The installable device driver. 
  32. DMODE.EXE     A MODE work-alike program for configuring serial ports
  33. DMODE.DOC     Instructions for the DMODE program. 
  34. DMODE.C       Source code for the DMODE program. 
  35. INSTALL.DOC   Complete OS/2 installation doc (this file is a subset of it)
  36. RELNOTES.DOC  Release notes. 
  37. XALL.DOC      Programmer's infor about the driver and applicable system calls. 
  38. *.BIN          Miscellaneous binary files used by the driver. 
  39.  
  40. Copy all of the files from the \OS2 directory of the distribution diskette to
  41. a single directory on your hard drive.  By default, driver and data files are
  42. expected to be in \DIGI.   
  43.  
  44. Loading the Device Driver 
  45.  
  46. The device driver is invoked by placing its name and configuration arguments
  47. into the system's CONFIG.SYS file.  All DigiBoard intelligent serial boards
  48. must be installed from a single command line, which contains complete set-up
  49. information for each board.  The general format of the command line is shown
  50. in the box at right. The only required parameters are the board's I/O port
  51. address and memory start address (see Examples 1 and 2).   
  52.  
  53. Command Line Examples 
  54. General Format: 
  55. DEVICE=\DIGI\XALL.SYS [/N:names] [/F:digipath] [/B:baud] [/D:data_type] [/A:A] 
  56. [/V:message_file] /P:port /M:mem [, /P:port /M:mem] [, ...] 
  57.  
  58. Example 1: Single PC/Xe or MC/Xe board, basic installation 
  59. DEVICE=\DIGI\XALL.SYS /P:320 /M:D0000 
  60.  
  61. Example 2: Two boards, basic installation 
  62. DEVICE=\DIGI\XALL.SYS /P:320 /M:D0000, /P:300 /M:D0000 
  63.  
  64. Example 4: Single board, ports named digi1, digi2, etc.  
  65. DEVICE=\DIGI\XALL.SYS /N:"DIGI"1 /P:320 /M:D0000 
  66.  
  67. Example 5: Single board, ports named com5, com6, etc.  
  68. DEVICE=\DIGI\XALL.SYS /N:5 /P:320 /M:D0000 
  69.  
  70. The command line must appear on a single line in the CONFIG.SYS file.
  71. This line may be up to 255 characters long.
  72.  
  73. Global Parameters 
  74. The first six parameters in the command line are global parameters, and affect
  75. all boards installed.  These parameters are optional, and may be omitted. If
  76. omitted, default values will be used. 
  77.  
  78. /N:names 
  79. Defines the naming convention to be use for the DigiBoard ports.  names 
  80. consists of an optional "stem" followed by the starting device number.  The 
  81. new stem must be enclosed in double-quotes ("").  If the stem is omitted, 
  82. "COM" will be used.  If the number is omitted, "3" will be assumed.  If the /N 
  83. parameter is not specified, the default name COM3 will be assigned to the first 
  84. port. 
  85.   /N:"DIGI"0 
  86.   DIGI0, DIGI1, ... DIGIn 
  87.   /N:4 
  88.   COM4, COM5, ... COMn 
  89.   /N:"QDEV" 
  90.   QDEV3, QDEV4, ... QDEVn 
  91.  
  92. /F:digipath 
  93. Defines an alternative directory for the location of the binary files (*.BIN),
  94. if different from the location of the driver file, XALL.SYS. 
  95.  
  96. /B:baud 
  97. Sets the default baud rate to be used for all ports.  If this parameter is not 
  98. specified, all ports will be set to the OS/2 default of 1200 baud.  Since most 
  99. OS/2 applications initialize the ports each time they are run, this parameter
  100. is usually not necessary. 
  101.   /B:9600 
  102.   Initializes all ports to 9600 baud. 
  103.  
  104. /D:data_type 
  105. Initializes all ports to the specified data type (parity, character length and 
  106. number of stop bits).  If this parameter is omitted, the OS/2 default data type
  107. of even parity, 7 data bits and 1 stop bit will be used.  The syntax is pds,
  108. where p is E (even parity), O (odd parity) or N (no parity), d is 8, 7, 6 or
  109. 5, and s is 1 or 2. All three values must be specified, in the correct order.
  110. Since most OS/2 applications initialize the ports each time they are run, this
  111. parameter is usually not necessary. 
  112.   /D:N81 
  113.   Initializes all ports to no parity, 8 data bits and 1 stop bit. 
  114.  
  115. /A:A 
  116. Initializes all ports to use alternating wiring for the DCD (Data Carrier
  117. Detect) signal.  This swaps the functions of DCD (Data Carrier Detect) and
  118. DSR (Data Set Ready) to make DCD available on an 8-pin RJ-45 connector. This
  119. parameter is necessary only when connecting modems to RJ-45 equipped DigiBoard
  120. products.  See the Connecting Peripherals section of the Installation Guide
  121. for your board for more details. 
  122.  
  123. /V:message_path 
  124. Forces banner and all verbose messages to be written to the specified file 
  125. instead of the screen.  If /V: is given without a filename, messages will be 
  126. written to \XALL.MSG.  Without this flag, all messages will appear on the 
  127. system console.  The message file is overwritten each time the system is 
  128. started. 
  129.   /V:\ERRMSG 
  130.   Banner and all messages are written to the file \ERRMSG. 
  131.   /V: 
  132.   Banner and all messages are written to the file /XALL.MSG. 
  133.  
  134. Per-Card Parameters 
  135. The remaining two parameters are per-card parameters, and are used to inform
  136. the driver of the type of board and where it is to be addressed in the host's
  137. I/O and memory buses. These parameters are mandatory, and must be given for
  138. each board! The per-card parameters must be given in complete sets, and the
  139. sets must be separated by commas. 
  140.  
  141. /P:port 
  142. Defines the I/O port address for the card. 
  143. /P:300 
  144. Board is addressed at I/O port 300h. 
  145.  
  146. /M:mem 
  147. Dual-ported memory starting address.  This is the full 32-bit hexadecimal 
  148. address of the beginning of the board's dual-ported memory. 
  149. /M:D0000     
  150. Sets dual-ported memory start address to 0D0000h (in the BIOS 
  151. expansion area between 640K and 1 megabyte). 
  152. /M:E80000 
  153. Sets start address of E80000h (in the fifteenth megabyte). 
  154. PC/Xe and PC/Xi boards may all share the same memory starting address.  
  155. MC/Xi, MC/Xe and COM/Xi boards must each have unique memory ad-
  156. dresses. 
  157.  
  158. Testing the Ports 
  159. The simplest (and probably the best) way to check the driver and I/O conn-
  160. ections is to connect an ASCII terminal to one of the ports and redirect some
  161. output to that port. If the terminal is connected to COM3, try something like
  162. the following: 
  163.  
  164. DMODE COM3 
  165. This will verify that the driver can find the port_the port's parameters will
  166. be displayed. 
  167.  
  168. DMODE COM3 OCTS=OFF ODSR=OFF 
  169. This insures that the hardware handshaking signals CTS and DSR will not prevent
  170. output_ we are not concerned with flow control at this time. 
  171.  
  172. DIR > COM3 
  173. This redirects the current directory to COM3. 
  174. The console should simply respond by repeating the C:\> prompt, and the current 
  175. directory (in this case, C:\) will appear on the terminal. 
  176.  
  177. User Diagnostics 
  178. The OS2 directory of the DigiWARE distribution diskette contains a serial port
  179. test utility, DGOS2UD.EXE, which can be used to test any OS/2 serial device 
  180. supported by a Physical Device Driver.  Documentation for DGOS2UD.EXE can 
  181. be found in the file DGUDREAD.ME, in the same directory. 
  182.  
  183. Troubleshooting 
  184.  
  185. Be sure to run the Memory Map utility to find the required amount of available
  186. address space, and the User Diagnostics (UD-CISC.EXE) to verify that the board
  187. is working correctly.  See the Installation Tips section of the Installation
  188. Guide for your board for details.
  189.  
  190. If the C:\> prompt doesn't reappear, and the system seems to be "hung", you 
  191. probably used a memory start address that is being used by some other device,
  192. or the board is not set for the address specified in CONFIG.SYS. Try a diff-
  193. erent address. If it still hangs, try a different I/O port. If your computer
  194. has a memory cache and the board's memory start address is above 1 megabyte,
  195. try either dis- abling the cache or moving the board to a low-memory address
  196. (D0000 is usually a good choice). 
  197.  
  198. It is also possible that a conflict exists with another device driver which
  199. has been loaded via CONFIG.SYS. The XALL.SYS line should be placed near the
  200. end of CONFIG.SYS, and must not be placed before the DEVICE=TESTCFG.SYS line. 
  201.  
  202. Due to potential device naming conflicts, the pair of lines 
  203. DEVICE=\OS2\COM.SYS 
  204.     and 
  205. DEVICE=\OS2\VCOM.SYS 
  206. may cause problems. Be sure that the XALL.SYS line is placed before these lines 
  207. in CONFIG.SYS.  If the XALL.SYS driver generates an error message, try 
  208. temporarily putting "REM" in front of the above two lines. If this works, there
  209. is probably a naming conflict.  You may need to add a /N:name command line flag 
  210. to the XALL.SYS line to force the driver to use a different base name or start
  211. numbering the COM devices at 5 or above. 
  212.  
  213. If the C:\> prompt does reappear, but there is no output on the terminal
  214. screen, there is probably a cabling problem.  Make sure that all cable plugs
  215. are securely seated in their receptacles, and that they are configured
  216. correctly (see the Connecting Peripherals section in the Installation Guide
  217. for your board). If the terminal displays output, but the data on the screen
  218. is garbled, the terminal is probably not set with the same baud rate and data
  219. type as specified in CONFIG.SYS (or the defaults, if not specified). Verify
  220. these settings. If everything checks out and you still have problems, there
  221. could be a problem with your board.  Contact your distributor or DigiBoard
  222. Technical Support for further assistance. 
  223.  
  224. Error Messages 
  225. If, when the driver is loaded, it cannot find the board(s), or if they fail to
  226. respond properly to commands, certain error messages may be sent to the console
  227. .These error messages are defined below: 
  228.  
  229. Could not find BIOS file 
  230. Could not find FEP file 
  231. Could not find data file 
  232. One or more files were missing from the digipath directory.  The default 
  233. digipath directory is the directory containing XALL.SYS.  If you have loaded 
  234. the driver and data files into different directories, that directory containing
  235. the data files (*.BIN) must be specified in the XALL command line with the 
  236. /F:digipath parameter. 
  237.  
  238. IO Port Not Responding 
  239. I/O port address set incorrectly, or conflicting with some other device. Verify 
  240. setting, or try a different address. 
  241.  
  242. DigiBoard BIOS Will Not Boot 
  243. DigiBoard BIOS Will Not Respond 
  244. DigiBoard FEPOS Will Not Boot 
  245. BIOS on board will not respond to commands from the driver.  Typically due 
  246. to a memory conflict, or a memory cache conflict.   
  247.  
  248. Driver Failed to Hook Timer 
  249. System Cannot Allocate Memory 
  250. A system call to OS/2 has failed. 
  251.  
  252. Invalid Command Line Arguments 
  253. Syntax error in the command line in CONFIG.SYS.  Double-check your entries. 
  254.  
  255. Programming Information 
  256. The \OS2\PROGINFO directory on the device driver diskette contains programming
  257. examples and information on how to obtain OS/2 programming manuals from IBM. 
  258.  
  259.