home *** CD-ROM | disk | FTP | other *** search
/ D!Zone (Collector's Edition) / D_ZONE_CD.ISO / programs / editors / comw220 / comw.txt < prev    next >
Text File  |  1994-12-06  |  11KB  |  308 lines
  1.                                 COMW v2.20
  2.                             Communications Wait
  3.                               by John Ericson
  4. INTRODUCTION
  5.  
  6. I  originally  intended COMW to connect to my friend's system  due  to  the
  7. number  of  errors  we were having using SERSETUP.  I completed  this  task
  8. after a few evenings.  Then I thought that this would be a good opportunity
  9. to  transfer COMW updates and/or WAD files and added a streaming mode  file
  10. transfer.  By this time I had found the source for SERSETUP on  a  BBS.   I
  11. felt I could modify the protocol to make the communications faster and more
  12. reliable.   After a few more days of programming and many days  of  testing
  13. and playing, I arrived at what you see now.
  14.  
  15. OPERATIONS
  16.  
  17. Start COMW from the command line using the syntax of
  18.  
  19.      COMW SECTION1 SECTION2 SECTION3 ...
  20.  
  21. You  may  specify  one or more section names for COMW to execute  from  the
  22. COMW.INI file.  If you do not specify any section names, COMW will use  the
  23. DEFAULT section name.  Please note:  the section COMMON is always executed.
  24.  
  25. COMW.INI FORMAT
  26.  
  27. The COMW.INI file uses the following format:
  28.  
  29. [section name] comment
  30. keyword=data
  31. keyword=data
  32. keyword=data
  33. keyword=data
  34. keyword=data
  35. keyword=data
  36. [section name] comment
  37. keyword=data
  38. keyword=data
  39. keyword=data
  40. keyword=data
  41.  
  42. Section  names and keywords are not case sensitive.  You may not  have  any
  43. spaces  before the `=`.  You may use section names more than  once.   Blank
  44. lines  and  lines with invalid keywords are ignored.  COMW will not  report
  45. invalid  keywords or invalid keyword data.  COMW will process all  selected
  46. sections  twice.  The first pass is to configure all the parameters  before
  47. COMW  opens the communications port.  The second pass is for all activities
  48. using the open port.
  49.  
  50. KEYWORDS
  51.                                 First pass
  52.  
  53. com=n
  54. Default: 1
  55. Valid values: 1, 2, 3, or 4
  56.  
  57. This keyword specifies the communications port.  COMW only uses COM1, COM2,
  58. COM3, and COM4 at the standard address and hardware interrupts.
  59.  
  60. port=n
  61. Default: none
  62. Valid values: not validated
  63.  
  64. This  keyword specifies the nonstandard communications port address in  hex
  65. (i.e.  COM1 is 3f8, COM2 is 2f8).  When this keyword is specified you  must
  66. specify a IRQ setting.  An invalid address can crash your system.
  67.  
  68. irq=n
  69. Default: none
  70. Valid values: not validated
  71.  
  72. This   keyword  specifies  the  nonstandard  communications  port  hardward
  73. interrupt (I.E. COM1 is 4, COM2 is 3).  When this keyword is specified  you
  74. must  specify a PORT setting.  An invalid interrupt can crash your  system.
  75. IRQ settings of 3 through 15 are supported.
  76.  
  77. baud=n
  78. Default: 2400
  79. Valid values: speeds supported by the 8250 or 16550 UARTs
  80.  
  81. This  keyword  specifies  the communications speed for  the  communications
  82. port.   I have tested the assembler communications driver routine a  speeds
  83. from 300 to 115200 with RTS/CTS and XON/XOFF flow control.
  84.  
  85. buffer=n
  86. default: 2048
  87. Valid values: 1024-8192
  88.  
  89. This keyword specifies the number of bytes for the input and output buffers
  90. each.
  91.  
  92. flow=string
  93. Default: rdy
  94. Valid values: none, xon, rdy
  95.  
  96. This  keyword specifies the bi-directional flow control COMW uses with  the
  97. communications  port.  `none' means no flow control.  `xon' means  XON/XOFF
  98. flow control.  `rdy' means RTS/CTS or Ready/Busy flow control.
  99.  
  100. color=n
  101. Default: 112 (black on white)
  102. Valid values: 0-255
  103.  
  104. This  keyword  specifies the normal screen colors COMW uses  in  the  popup
  105. display.  The color values use the standard CGA color scheme (i.e.  1=blue,
  106. 2=green,  3=cyan,  4=red, 5=magenta, 6=yellow, 7=white, 8=high  intensity).
  107. Multiply the color by 16 to get the background colors.  Example: 1(blue)  *
  108. 16  + 8(high intensity) + 7(white) = 31.  Note: COMW enables high intensity
  109. background colors (blinking is disabled).
  110.  
  111. bcolor=n
  112. Default: 240 (black on high intensity white)
  113. Valid values: 0-255
  114.  
  115. This  keyword  specifies  the boarder color used  by  COMW  for  the  popup
  116. display.
  117.  
  118. scolor=n
  119. Default: 128 (black on high intensity black[dark gray])
  120. Valid values: 0-255
  121.  
  122. This keyword specifies the shadow color used by COMW for the popup display.
  123.  
  124. dsr=string
  125. Default: off
  126. Valid values: on, off
  127.  
  128. This  keyword  specifies whether COMW will wait for the  modem  for  remote
  129. computer to assert the DSR signal before processing keywords on the  second
  130. pass.
  131.  
  132. meblock=n
  133. Default: 1012
  134. Valid values: 128-8192
  135.  
  136. This  keyword specifies the MEMODEM file transfer block size.   Each  block
  137. has a 12 byte header including a crc32 checksum.
  138.  
  139. mestream=string
  140. Default: off
  141. Valid values: on, off
  142.  
  143. This  keyword specifies the MEMODEM files transfer mode.  MEMODEM  supports
  144. paced and streaming modes.
  145.  
  146. merestart=string
  147. Default: off
  148. Valid values: on, off
  149.  
  150. This  keyword specifies the MEMODEM receive restart mode.  MEMODEM supports
  151. restarting at the beginning (off) or after the last valid block (on).
  152.  
  153. meblkdelay=n
  154. Default: 0
  155. Valid values: not validated
  156.  
  157. This  keyword  specifies the MEMODEM delay (in 100th  of  a  second)  place
  158. between blocks.
  159.  
  160. medown=string
  161. Default: current
  162.  
  163. Valid  values:  any  existing DOS directory path (not checked)This  keyword
  164. specifies the default DOS directory for incoming MEMODEM file transfers.
  165.  
  166. meup=string
  167. Default: current
  168. Valid  values:  any  existing DOS directory path (not checked)This  keyword
  169. specifies the default DOS directory for outgoing MEMODEM file transfers.
  170.  
  171.                                 Second Pass
  172.  
  173. flush
  174.  
  175. This keyword instructs COMW to wait for the output buffer to empty.
  176.  
  177. fifo=n
  178. Default: 16
  179. Valid values: 0, 1, 4, 8, 16
  180.  
  181. This keyword instructs COMW to set the fifo mode of a 16550 UART.
  182.  
  183. leave
  184.  
  185. This keyword instructs COMW to leave DTR and RTS on when the program exits.
  186. Normally these are turned off when COMW closes the communications port.
  187.  
  188. delay=n
  189. Default: 0
  190. Valid Values: not validated
  191.  
  192. This  keyword  instructs  COMW  to leave delay  (in  milliseconds)  between
  193. characters  transmitted.   This  options  allow  you  to  slow   down   the
  194. transmissions for modems in command mode.  This delay should be  set  to  0
  195. after the modems connect.
  196.  
  197. out=string
  198.  
  199. This keyword instructs COMW to transmit the characters of the string.   The
  200. contents   of  the  string  wil  be  explained  later.   Note:   characters
  201. transmitted will not be echoed to the popup display.
  202.  
  203. echo=string
  204.  
  205. This  keyword  instructs COMW to send the characters of the string  to  the
  206. popup display.
  207.  
  208. wait=string
  209.  
  210. This  keyword  instructs COMW to wait for a string from the  communications
  211. port (i.e. `ok' or `connect').  COMW compares only the number of characters
  212. in  the  string.   This allows for generic modem responses (i.e.  `connect'
  213. matches `connect 9600' or `connect 9600/ARQ').
  214.  
  215. exit
  216.  
  217. This  keyword instructs COMW to exit back to DOS with an errorlevel  of  0.
  218. COMW closes the communications port and restores the screen under the popup
  219. display.
  220.  
  221. mesendf=string
  222.  
  223. This keyword instructs COMW to start a MEMODEM file transfer send using the
  224. string  as  a  DOS path for a file.  Note: MEMODEM transfer  requests  only
  225. contain  the  DOS  file name, not the complete path.  COMW  on  the  remote
  226. system uses the `medown' keyword to determine where to place the file.
  227.  
  228. megetf=string
  229.  
  230. This keyword instructs COMW to start a MEMODEM file transfer get using  the
  231. string  as  a  DOS path for a file.  Note: MEMODEM transfer  requests  only
  232. contain  the  DOS  file name, not the complete path.  COMW  on  the  remote
  233. system  uses  the `meup' keyword to determine where to place look  for  the
  234. file.
  235.  
  236. doom=string
  237.  
  238. This  keyword  instructs COMW to start ID's DOOM v1.2 using the  string  as
  239. command  line parameters for the game.  COMW will allow you any  speed  and
  240. modem  settings you like.  This will allow you to experiment.  The  buffers
  241. size used by the communications routine is set to 528 bytes and can not  be
  242. changed.  I have obtained the best performance using the maximum speed  the
  243. modems  will  connect using no compression or block protocol (i.e.  MNP  or
  244. V.32b