home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_tools / pdq_comm / comm4win.bro next >
Text File  |  1991-12-23  |  8KB  |  207 lines
  1.                                 Introducing
  2.                                 
  3.                                   PDQComm
  4.                                   
  5.                                 For Windows
  6.  
  7.  
  8.                           Communications Support
  9.  
  10.                              For Visual Basic
  11.  
  12.  
  13.  
  14.  
  15. OVERVIEW
  16.  
  17. PDQComm for Windows is a comprehensive library of subroutines and functions
  18. for adding communications to programs written in Visual Basic.  It contains
  19. both high- and low-level routines for controlling the communications ports,
  20. sending and receiving text and binary data, and emulating popular terminal
  21. protocols.  All of the Assembler, C, and Visual Basic source code is included
  22. so you can see how the routines work and even modify them if you want to.
  23.  
  24.  
  25. LOW-LEVEL SERVICES
  26.  
  27. Numerous low-level routines are provided to open and close the ports, and
  28. control fully all aspects of on-line communications.  You can access Com 1
  29. through Com 4 at speeds up to 19,200 Baud, with up to two ports open at one
  30. time.  Both transmit and receive buffers are employed, so your program can
  31. send a long stream of data and resume immediately.  Likewise, data that
  32. arrives while your program is busy is stored automatically in a receive
  33. buffer.  This lets you retrieve the data later when your program is ready to
  34. handle it.
  35.  
  36. Other low-level services let you input text line by line, read the status of
  37. the hardware lines, determine if any characters have been received and how
  38. many, read the current status of any open port, and much more.  You can even
  39. change port parameters while they are open.  For instance, if your program
  40. answers the phone at 2400 baud but the caller connects using 1200, your
  41. program can determine that and change speeds automatically.
  42.  
  43. All of the subroutines and functions are modeled after their counterparts in
  44. regular compiled BASIC, letting you port existing code with as few changes as
  45. possible.  As an example, where regular BASIC uses the LOC function to report
  46. how many characters are waiting to be read, PDQComm for Windows uses a
  47. function named ComLoc.
  48.  
  49. Non-standard protocols are also supported such as 8 data bits with 2 stop
  50. bits and also odd or even parity.  The timed Line Input routine is especially
  51. valuable because it prevents the application from locking up if the sender
  52. never sends a Chr$(13) byte to end the current line.  Both hardware (RTS) and
  53. software (Xon/Xoff) handshaking are fully supported, and handled
  54. automatically by the transmit and receive routines.
  55.  
  56.  
  57.  
  58. HIGH-LEVEL ROUTINES
  59.  
  60. File transfer subroutines are provided for sending and receiving using a
  61. variety of popular protocols.  These include XModem, XModem-1K, YModem, and
  62. plain ASCII.  You simply provide the name of the file, and call the
  63. appropriate routine.  The file transfer begins immediately, and its progress
  64. is displayed on your form.  If you prefer, the status display can be
  65. disabled.  Once a transfer has begun you can switch to another Windows
  66. session, and the transfer will continue in the background.
  67.  
  68.  
  69.  
  70. THE TEXT WINDOW CONTROL
  71.  
  72. A unique text window custom control lets you simulate DOS-style output with
  73. full or partial scrolling.  The window may be sized at runtime, and it will
  74. contain the text output within the window borders.  Settable properties let
  75. you control both vertical and horizontal scrolling independently, to either
  76. scroll the screen as new text arrives or let it disappear below or to the
  77. right of the output window.  This avoids the "jitter" effect you may have
  78. seen with text output from other companies.
  79.  
  80.  
  81.  
  82. TERMINAL EMULATIONS
  83.  
  84. A complete set of standard terminal emulations are provided, including ANSI,
  85. DEC VT52 and VT100, Data General D215, and generic terminals.  The ANSI
  86. emulation lets you display text embedded with all of the color and cursor
  87. positioning codes recognized by ANSI.SYS, but without having to use that
  88. driver.  The other emulations simplify communicating with minicomputers and
  89. mainframes that use those protocols.  These emulations work in conjunction
  90. with the text window control, and different emulations can even be employed
  91. simultaneously.
  92.  
  93.  
  94.  
  95. SUBROUTINE LIST
  96.  
  97. There isn't enough room here to describe all of the features in PDQComm in
  98. detail, but the function and subroutine list that follows describes each of
  99. the low-level routines briefly.  Not listed are the high-level routines for
  100. sending and receiving data (XModem, YModem, and ASCII), or the routines that
  101. interpret the terminal emulation codes.
  102.  
  103. Functions:
  104. ==========
  105.  
  106. CheckSum returns the checksum value of a string.
  107.     
  108. ComEof reports if any characters have arrived and are waiting to be read.
  109.  
  110. ComErr is queried to see if an error has occurred.
  111.  
  112. ComInput reads a specified number of characters.
  113.  
  114. ComLineInput reads a single line of text in one operation.
  115.  
  116. ComLoc reports how many characters have been received and are pending.
  117.  
  118. CRC16 (Cyclical Redundancy Check, 16-bit method) aids error correction.
  119.  
  120. OverRun checks the receive buffer for an overflow error.
  121.  
  122. PDQExist reports if a file exists, but without requiring On Error.
  123.  
  124. PDQTimer returns the current number of system timer ticks.
  125.  
  126. ScanCodes searches a string for control characters (used by the emulators).
  127.  
  128. XOff reports if the sender has transmitted an XOff character.
  129.  
  130.  
  131. Subroutines:
  132. ============
  133.  
  134. AdjustRecBuffer sets the halt and resume points when using handshaking.
  135.  
  136. CloseCom closes the specified port.
  137.  
  138. ComPrint is used to send data through the communications ports.
  139.  
  140. ComPutBack lets you place data already read back into the receive buffer.
  141.  
  142. DTR sets the state of the hardware DTR line.
  143.  
  144. FlushBuffer resets the receive buffer and discards its contents.
  145.  
  146. FlushSendBuffer is like FlushBuffer, but works with the transmit buffer.
  147.  
  148. GetLineStatus returns the status of the CTS, DTR, and RI hardware lines.
  149.  
  150. GetPortConfig retrieves the current parameters for an open port.
  151.  
  152. OpenCom opens a port, and is equivalent to Basic's OPEN "COM" statement.
  153.  
  154. Pause halts a program for a specified period.
  155.  
  156. PDQPrint is used to send text to the TxtWnd custom control.
  157.  
  158. RTS sets the state of the hardware RTS line.
  159.  
  160. SendBreak sends a break signal for a specified period.
  161.  
  162. SetActivePort lets you specify which Com port is to be accessed.
  163.  
  164. SetCom lets you modify the parameters for a port that is already open.
  165.  
  166. SetComErr allows a Visual Basic program to set an error condition.
  167.  
  168. SetHandshaking changes the handshaking method for a port that is open.
  169.  
  170. WScroll lets you manually scroll text in the TxtWnd custom control.
  171.  
  172.  
  173.  
  174. SUPERB DOCUMENTATION
  175.  
  176. The PDQComm for Windows manual contains extensive tutorial information,
  177. including a complete overview of communications in general.  Additional
  178. tutorials explain modems, serial cables, specifying port parameters, and
  179. UARTs.  All of the important standard Hayes commands are described in detail,
  180. and each emulation includes a table of all codes that are recognized.
  181.  
  182.  
  183. WHAT'S INCLUDED
  184.  
  185. PDQComm for Windows comes with a comprehensive owner's manual, demonstrations
  186. (including a complete terminal program), and fully commented source code.
  187. PDQComm for Windows is not copy protected, and royalties are not required
  188. when the routines are added to your executable programs.  Free technical
  189. support is included.
  190.  
  191.                 ===========================================
  192.  
  193. Crescent Software publishes many other useful products for programmers using
  194. Visual Basic, QuickBASIC, and BASIC PDS.  We offer general purpose toolboxes,
  195. as well as subroutines for graphics, screen design, scientific applications,
  196. BASIC TSR utilities, and much more.  All products include complete source
  197. code, and royalties are never required.  Please call or write for more
  198. information on our entire line.
  199.  
  200.  
  201. Crescent Software, Inc.
  202. 32 Seventy Acres
  203. West Redding, CT  06896
  204.      Phone: 203-438-5300
  205.        Fax: 203-431-4626
  206. CompuServe: 72657,3070
  207.