OSCAR-code/3rdparty/qextserialport/ChangeLog

Change history for QextSerialPort (formerly QwSerialPort):
(Lines beginning with + represent new functionality, * represent changed or
fixed functionality, - represent removed or deprecated functionality)

Version 1.2 rc (2012 Debao Zhang)
  * Build-system refactor
  * Issue 145 : Custom baud support for MacOS
  * Issue 36  : Fix Devices Notification for Vista
  * Issue 54 and Issue 108 : Try detect more ports for windows
  * Issue 139 : Adjust the name of generated library
  - QextWinEventNotifier has been removed

Version 1.2 beta2 (2012 Debao Zhang)
  * Issue 124 : implement canReadLine
  * Issue 122 : make Dtr default to TRUE under Windows.
  * Issue 127 : fix QObject::MoveToThread brokes SerialPort on Windows
  * Issue 129 : Add custom baud support for Windows.
  * Issue 131 : Make sure portName returned by QextSerialEnumerator can be used by QextSerialPort
  * Issue 134 : Make "make install" really works
  * Issue 2: device discovery / removal notification on linux (read config_example.pri to figure out how to enable it.)

Version 1.2 beta1 (2012 Debao Zhang)
  * D-pointer and Q_PRIVATE_SLOT are used to moving private members from QextSerialPort to QextSerialPortPrivate
  * qdoc3 instead of doxygen is used for generating documents
  * MIT license header add to all sources files
  + add a helper class QextWinEventNotifier for windows user, when user's SDK doesnot contain Qt's private files, this class will be auto selected.

Version 1.2win-alpha (2007 Michal Policht)
  + Added QextSerialEnumerator pre-alpha. Works under W2k and later versions of Windows.
  + Event driven mechanism (alternative to polling) is now available on Windows.
  - Removed default (=0) parameter from open() functions.
  * Fixed bug #1714917 in Win_QextSerialPort::close() method (by Kurt).
  * Fixed problem with lack of proper blocking in readData() on win32 (by Brandon Fosdick).
  * Removed QT_THREAD_SUPPORT option. Now QextSerialPort must be always compiled with threads support.
  * Mutexes are not static.
  * setTimeout() now accepts only one parameter.
  * bytesAvailable() on POSIX now shows 0 bytes instead of -1 when no bytes are available.
  * bytesAvailable() is const.
  * native POSIX file descriptors instead of QFile->handle() calls
  + POSIX: Save and restore original termios when opening and closing the device
  * POSIX: Only disable special characters on systems that support it
  * POSIX: Use cfmakeraw(3) to get a non-canonical termios
  + POSIX: Call close(2) in close() to actually close the device

Version 1.1 (official release)

Version 1.0.1
  * Minor changes (mostly in test application)

Version 1.0.0e (by Micha? Policht)
  * Fixed bytesAvailable(). Includes buffered bytes to the result.
  + Added isSequential() method.
  + Provided test application

Version 1.0.0d ( changes by Micha? Policht )
  - Removed isOpen() overriden declaration/implementation from qextserialport's classes. isOpen() relies on QIODevice now.
  - Removed bool portOpen variable. Replaced by internal QIODevice.openMode.
  - Removed getChar(), putChar() overriden declaration/implementation. QIODevice can handle this.
  * Calling open() with specified OpenMode invokes QIODevice::open() which result in proper openMode setting.
  * readData(), writeData() are protected as in QIODevice declaration.
  * QIODevice:: read() and write() function are working now (use them instead of readData() writeData()).
  * readData(), writeData() don't check if port is open any more (read() and write() assures that). The same behaviour can be found in QFile for example.
  * Fixed readLine().

  * Fixed randomly crash on deletion bug on Windows ( by Stuart Nixon )
  http://lists.trolltech.com/qt-interest/2007-02/thread00340-0.html#msg00351

Version 0.9 (March 3, 2005) Stefan Sander <stefan-sander@users.sf.net>:
  + Added a new precompiler constant, _TTY_FREEBSD_
    to support FreeBSD port names.
  + Added _TTY_WIN_ constant in qextserialport.pro win32:DEFINES
    to have Windows port names as default when compiling on it.
  - Removed construct() call from QextSerialBase constructors,
    it is called indirectly through Win_QextSerialPort::construct()
    and Posix_QextSerialPort::construct().
  + Added construct() call to Win_QextSerialPort constructors.
  + Added setTimeout(0, 500) call to Win_QextSerialPort::construct().
  - Removed setTimeout(0, 500) call from Win_QextSerialPort(const char* name).
  * Fixed Posix_QextSerialPort::open(int) control flow, now the port settings
    are only applied if the associated file could be opened.
  * Fixed masking CR to NL, in Posix_CommConfig.c_iflag 

Version 0.8 (, 2003) (Alpha release):
  * Added code to set the port timeouts in Win_QextSerialPort's default 
    constructor.
  * Fixed Posix_QextSerialPort::construct() to set up the port correctly.
  * Fixed syntax errors in 2 ioctl() calls in posix_QextSerialPort.
  * lastError is now initialized to E_NO_ERROR in the QextSerialBase 
    constructor.    
  * The select() call in posix_QextSerialPort::bytesWaiting() is now 
    properly coded.  Previously it would always time out.
  * Fixed runtime errors in the ioctl() calls for 
    Posix_QextSerialPort::setDtr() and Posix_QextSerialPort::setRts().
    Thanks to Marc Pignat.
    
Version 0.7 (June 15, 2002) <Bugfix release>:
  (0.61 - unofficial release)
  * Fixed a small bug in the initializations of the static members when 
    QT_THREAD_SUPPORT was defined.
  * Fixed a  bug that caused Borland's compiler to choke on Windows platforms
    (which perversely actually stemmed from a shortcoming of Visual C++ that 
    Borland doesn't have).
    
  (0.62 - unofficial release)
  * Fixed a bug that gave Q_LONG the wrong typedef for QT versions prior to 
    3.0. 
    
  (0.63 - unofficial release)       
  * Fixed 2 incorrect references to Posix_Comm_Config.
  * Fixed scoping of Posix_QextSerialPort::operator=().
  * Posix_QextSerialPort::construct should now be coded correctly.
  * Fixed return type for Posix_QextSerialPort::size().
  
  (0.64 - unofficial release)
  * Fixed all the port settings functions to work properly when opening the 
    port for the first time - previously none of the settings were being 
    applied when the port was opened.
  * Fixed an oversight in Win_QextSerialPort::open() that caused the setting
    of port parameters to fail on NT and 2000 systems.
    
  (0.7 - official release)
  * Fixed some calls to QextSerialBase constructors that no longer exist on 
    the POSIX side.
  * Fixed the bad memcpy()'s in the POSIX copy constructor.
  * Fixed the Offset scoping problem under gcc 2.95.
  * The CBAUD flag has been deprecated on some POSIX systems.  Fixed 
    Posix_QextSerialPort::setBaudRate() to reflect this.
  * Added construct() calls to all of the Posix_QextSerialPort constructors.
  * Fixed double (and conflicting) typedefs of Offset when using QT versions 
    prior to 3.0
  * Changed the call to CreateFile() to CreateFileA() in 
    Win_QextSerialPort.cpp.  This should get rid of problems for those using
    Unicode or other multibyte character sets for their string literals.
  * A few tweaks to the documentation.
    
  - Removed the protected Posix_Handle variable from Posix_QextSerialPort.
  
Version 0.6 (March 11, 2002) <Bugfix release>:
  + Added a new precompiler constant, QTVER_PRE_30.  QT3 changed the return
    types of some QIODevice functions. Therefore, if compiling on versions
    of QT prior to 3.0, you should always define QTVER_PRE_30 in your project.
    Also had to add some preprocessor blocks to support both 3.0 and earlier 
    versions of QT.
  + Added implementations of 2 of the new constructors added in 0.5 to both 
    Win_QextSerialPort and Posix_QextSerialPort.

  * The scoping of the enums used in the PortSettings struct has been fixed.
  * QObject inheritance has been removed.  This should not affect the 
    functionality of the classes.
  * Replaced a few stray references to mutex->unlock() with UNLOCK_MUTEX() in 
    the Windows code.
  * Fixed several runtime errors caused by calling nonexistent members of 
    QextSerialBase.
  * Fixed a whole bunch of little things that were causing MSVC to choke when
    compiling for Windows.

Version 0.5 (February 15, 2002):
  + There are 4 new macros (LOCK_MUTEX, UNLOCK_MUTEX, TTY_WARNING, and 
    TTY_PORTABILITY_WARNING) that replace most of those ugly #ifdef blocks in
    the code.  
  + In place of the old namingConvention stuff, there is a new function, 
    setName().  It is used to set the name of the device to be associated with
    the object.  The new name() function can be used to retrieve the device 
    name, which is stored in the new member variable portName.
  + There is a new version of open() that takes a const char* as a parameter.
    It can be used to specify the name of the device when it is opened rather
    than at construction time.

  * 3 constructors have been removed and 3 more added.  There is now a copy
    constructor (and operator=()) as well as a constructor that takes a
    PortSettings structure as a parameter, and another that takes both a
    device name and a PortSettings structure.  As a result of these changes
    the PortSettings structure declaration is no longer local to the
    QextSerialBase class.  All of the removed constructors had to do with
    the setNamingConvention() system.
  * The static mutex member should now be reference-counted and only deleted 
    when it is no longer referenced.  
  * Most of the object construction duties have been pushed back into
    QextSerialBase
  * Fixed a couple resource leaks, mostly to do with unlocking the mutex
    properly

  - Removed the setNamingConvention() nonsense.  
  - Removed all QStrings and calls to sprintf() for thread compatibility.
  - Removed setNumber() functions as well as the portNumber member variable,
    as they were only necessary under the setNamingConvention() system.

  I am grateful to Jorg Preiss (Preisz?  Sorry, American keyboards don't have
  an ess-tset character ;)) for his invaluable input on most of the changes
  that went into this version.

Version 0.4 (March 20, 2001):
  + All of the classes now derive from QObject as well as QIODevice.  This
    is pretty much useless at the moment - signals and slots may be used
    to implement asynchronous communications in a future version
  + Added configurable timeouts via the setTimeout() function.  The default
    timeout for read and write operations is now 500 milliseconds
  + There is now a functional .pro file for the library (thanks to
    Gunnstein Lye)
  + The prefixes for all of the classes have changed from Qw to Qext, in
    compliance with the qt-addons project standard

  * Fixed a bug that caused port settings to be restored incorrectly when
    switching ports with setNumber()
  * Minor changes to QextSerialBase::setNumber().  Functionality should now
    reflect the documentation, which has also been updated to reflect the
    changes that went in on version 0.3.
  * Some fixes to the documentation.  The Posix_QextSerialPort and
    Win_QextSerialPort classes should no longer have any unnecessary
    references to inapplicable platforms, and the documentation for open() has
    been updated.
  * Should now compile without QT_THREAD_SUPPORT defined (ie, in single-
    threaded environments), although it will require slight changes to the
    makefile (tmake "CONFIG-=thread" should work)
  * Fixed a few compilation issues, especially on the POSIX side (should
    compile under Linux now :))
  * POSIX code is a little cleaner and more efficient
  * Various small fixes to the documentation
  * Constants now follow a consistent naming convention, with underscores at
    the beginning and end of each.  For example TTY_POSIX has become
    _TTY_POSIX_
    
Version 0.3 (Feb. 14, 2001):
  + Added a warning that appears when QwSerialPort is compiled on a POSIX
    platform that does not implement 76800 baud operation.  In this situation
    QwSerialPort will also switch to 57600 baud.
  + Major code reorganization - there are now 4 classes instead of 1.  This
    should remove a lot of the #ifdef...#else...#endif constructs and
    hopefully make the code easier to read.  Including the class in your
    project is still done by including QwSerialPort.h and instantiating a
    QwSerialPort object.

  * The serial port associated with a QwSerialPort object is no longer
    opened on construction, or upon calling the setNumber() function.  You
    must now explicitly call open() to open the port.

Version 0.2 (Jan. 3, 2001):
  + Added lastError() function with rudimentary error codes
  + Better documentation
  + Added ability to examine the empty/not empty state of a port's input
    buffer with atEnd()
  + Added ability to retrieve the number of bytes in a port's input buffer
    with size() (thanks to Olivier Tubach)
  + Added ability to turn off portability warnings by defining
    TTY_NOWARN_PORT in your project
  + Added ability to turn off all warning messages by defining TTY_NOWARN
    in your project
  + Added ability to select POSIX serial functions in Windows NT/2000 by
    defining TTY_POSIX in your project (untested)
  + Added control over RTS and DTR lines with setRts() and setDtr()
    respectively
  + Added ability to query line status using lineStatus().
  + Added readLine() functionality (thanks to Olivier Tubach)
  + Added bytesWaiting(), a non-const/thread-safe version of size()
  + The class should now be thread-safe through the use of a recursive
    QMutex (untested)

  * Fixed a bug that could cause hardware flow control not to work on some
    POSIX systems
  * Put in a few missing fileno() calls in the POSIX code
  * Fixed a few syntax errors that caused compilation to fail on POSIX systems

  - BAUD0 is no longer a valid baud rate setting - to drop the DTR line,
    call setDtr(FALSE)

Version 0.1 (Dec. 11, 2000):
  Initial public release.