home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / sync400.zip / readme.txt next >
Text File  |  1999-01-29  |  8KB  |  200 lines
  1. Quatech Syncdrive Release 4.00 for MPA-series adapters
  2. Copyright (c) 1999 Quatech, Incorporated
  3.  
  4. January 29, 1999
  5.  
  6.  
  7. What's New in Release 4.00?
  8. ---------------------------
  9.  
  10.    Release 4.00 is a major revision of the Syncdrive software.  The
  11. changes made to the product since Release 3.30 are summarized here.
  12. Detailed change descriptions can be found later in this document.
  13.  
  14.  *  New platform --- Windows 95/98 is now natively supported
  15.   
  16.  *  Improvement --- DMA buffer allocation under OS/2 greatly improved
  17.  
  18.  *  Printed manual update
  19.  
  20.  
  21.  
  22. Bug notice
  23. ----------
  24.  
  25.    There is a bug in the example programs that results in an incorrect display
  26. of total bytes allocated for DMA buffers when the compiled DOS or Windows 3.1
  27. examples are executed.  This can be corrected by applying a typecast to ULONG
  28. to the multiplication in the last variable of the printf() function call.  
  29.    This bug does not seem to affect operation of the example program.  It was
  30. discovered too late to be updated on the distribution disks for this release.
  31.  
  32.  
  33.  
  34. Distribution diskette layout
  35. ----------------------------
  36.  
  37. Disk 1:
  38.  
  39.    \                    --- this file
  40.  
  41.    \dos                 --- DOS libraries
  42.                               Large model for Borland and Microsoft C compilers
  43.                               (Borland C++ 3.1, Microsoft C 6.0)
  44.  
  45.    \examples            --- C source code for example programs
  46.  
  47.    \include             --- include files needed for Syncdrive applications
  48.  
  49.    \os2                 --- OS/2 DLL, import library, device driver
  50.  
  51.    \win31               --- Windows 3.1 DLL, import library, device driver
  52.    
  53.    \win95               --- Windows 95/98 DLL, import libraries, device driver
  54.                               (SYNCDRIV.LIB for Borland C++ 5.02,
  55.                                SYNCMSVC.LIB for Microsoft Visual C 6.0)
  56.  
  57. Disk 2:
  58.  
  59.    \examples\dos        --- makefiles for DOS example programs
  60.                               Borland C++ 3.1 and Microsoft C 6.0 compilers 
  61.                               (command line MAKE/NMAKE)
  62.  
  63.    \examples\dos\exe    --- DOS executables of example programs
  64.                               Compiled using Borland C++ 3.1 for DOS
  65.  
  66.    \examples\win31      --- project file for example programs
  67.                               Borland C++ 4.5 for Windows (IDE)
  68.  
  69.    \examples\win31\exe  --- Windows 3.1 executables of example programs
  70.                               "QuickWin" programs compiled using Borland C++ 4.5
  71.  
  72.  
  73. Disk 3:
  74.  
  75.    \examples\os2        --- makefile for OS/2 example programs
  76.                               IBM VAC++ 3.0 compiler (command line make)
  77.  
  78.    \examples\os2\exe    --- OS/2 executables of example programs
  79.                               Text mode programs compiled using IBM VAC++ 3.0
  80.  
  81.    \examples\win95      --- project file for example programs
  82.                               Borland C++ 5.02 for Windows (IDE)
  83.  
  84.    \examples\win95\exe  --- Windows 95/98 executables of example programs
  85.                               Console programs compiled using Borland C++ 5.02
  86.  
  87.  
  88.  
  89. Installing Syncdrive
  90. --------------------
  91.  
  92.    See the printed documentation for details on how to install Windows or OS/2
  93. device drivers and for how to build Syncdrive applications.
  94.  
  95.  
  96.  
  97. Supported adapters
  98. ------------------
  99.  
  100.    Syncdrive Release 4.00 supports the following adapters:
  101.  
  102.    MPA-100        single channel, RS-232,     ISA
  103.    MPA-200/300    single channel, RS-422/485, ISA
  104.    MPA-102        dual channel,   RS-232,     ISA
  105.    MPAP-100       single channel, RS-232,     PCMCIA
  106.    MPAP-200       single channel, RS-422/485, PCMCIA
  107.  
  108.  
  109.    Due to sagging market demand, the Micro Channel products are no
  110. longer being supported by new releases of Syncdrive.  The last release
  111. of Syncdrive for the MPA-2000/3000 Micro Channel adapter is Release 2.21.
  112.  
  113.  
  114.  
  115. Printed Documentation
  116. ---------------------
  117.  
  118.    The printed documentation has been updated for Release 4.00.  The
  119. current revision of the Syncdrive User's Manual is January 1999, Quatech part
  120. number 940-0057-750.  The part number and date can be found on the outside
  121. back cover of Quatech manuals.
  122.    Any future updates to the manual will be available from the Quatech
  123. Technical Support or Sales departments, the Quatech BBS, or the Quatech
  124. World Wide Web site on the Internet.
  125.  
  126.  
  127.  
  128. DETAILS of What's New in Release 4.00
  129. -------------------------------------
  130.  
  131.  * New platform --- Windows 95/98 is now natively supported
  132.  
  133.       A DLL and VxD for Windows 95 and Windows 98 is provided with Syncdrive
  134.    Release 4.00.  The Windows 95/98 version of Syncdrive supports only native
  135.    32-bit Windows applications.
  136.       The Windows 3.1 version of Syncdrive has been updated to support 
  137.    operation under Windows 95/98.  This may be useful for customers having
  138.    existing 16-bit Windows Syncdrive applications who wish to run them on
  139.    Windows 95/98.
  140.  
  141.  
  142.  * Improvement --- DMA buffer allocation under OS/2 greatly improved
  143.  
  144.       The method for allocating DMA buffers in the OS/2 version of Syncdrive
  145.    has been overhauled.  The performance of the sync_alloc_dma_buffer() API
  146.    had become very poor with OS/2 Warp 4.0.  The newly reworked API performs
  147.    much better.  In testing, computers running Warp 4 that could only allocate
  148.    a few (less than 10) 1 kB DMA buffers with Syncdrive 3.30 can now allocate
  149.    several hundred of those buffers with Syncdrive 4.00.  Results indicate that
  150.    up to several megabytes of memory may be available for DMA buffers with
  151.    Syncdrive 4.00.
  152.    
  153.  * Bug fix --- sync_alloc_dma_buffer() error recovery
  154.  
  155.       In previous releases, once this function failed the application would
  156.    usually be unable to allocate any more DMA buffers even after calling
  157.    sync_free_dma_buffers() to release all the previously allocated buffers.
  158.    This operation has now been corrected.
  159.    
  160.  
  161.  
  162. (New from Syncdrive Release 3.30)
  163. ---------------------------------
  164.  
  165.  * New feature --- Block Mode Byte Streaming  
  166.  
  167.       Byte Streaming allows a continuous "stream" of data to be transparently 
  168.    transmitted or received in Syncdrive's byte sync block mode.  Rather than 
  169.    terminating a frame when the buffer_length value is reached, Syncdrive will
  170.    wrap back to the first location of the comm_buffer array and continue 
  171.    transmitting or receiving data.  
  172.    
  173.       It is up to the application to track the progress of a frame running
  174.    in byte streaming mode.  This can be done by monitoring the buffer_pointer
  175.    field in the com_block structure.  The buffer_pointer will revert to zero
  176.    and count up again as the comm_buffer is recycled. 
  177.  
  178.       Frames started in byte streaming mode must be stopped manually.  For
  179.    transmit frames, the sync_abort_message() function should be used.  For
  180.    receive frames, the sync_command(HaltReceiver) function should be used.  
  181.    The receiver does not look for block_term characters.
  182.    
  183.       To accommodate byte streaming, the ByteTMsgBuf and ByteRMsgBuf com_block
  184.    structures in SYNCDRIV.H now include a "misc_options" field replacing one
  185.    of the previous "reserved_char_x" fields (reserved_char_1 in ByteTMsgBuf,
  186.    reserved_char_2 in ByteRMsgBuf).  The names of the remaining reserved_char 
  187.    field(s) have been adjusted accordingly. 
  188.  
  189.       Byte Streaming is enabled by setting bit zero of the misc_options
  190.    field of the respective com_block to one.
  191.  
  192.  
  193. Feedback
  194. --------
  195.  
  196.    Quatech welcomes your comments and suggestions about the features and
  197. performance of this software.  Please contact our Technical Support department
  198. to make your comments.
  199.  
  200.