OSCAR-code/3rdparty/qtserialport/dist/changes-5.2.0

QtSerialPort 5.2 introduces a few new features and improvements as well as
bugfixes over the 5.1.x series. For more details, refer to the online
documentation included in this distribution. The documentation is also available
online:

  http://qt-project.org/doc/qt-5.2/qtserialport-index.html

The QtSerialPort version 5.2 series is binary compatible with the 5.1.x series.
Applications compiled for 5.1 will continue to run with 5.2.

Some of the changes listed in this file include issue tracking numbers
corresponding to tasks in the Qt Bug Tracker:

  http://bugreports.qt-project.org/

Each of these identifiers can be entered in the bug tracker to obtain more
information about a particular change.

****************************************************************************
*                          Library                                         *
****************************************************************************

- [QTBUG-32684] VID/PID for USB Huawei 3G Modem is returned properly now.

- [QTBUG-32016] No "No such file or directory" error set after waitForReadyRead
anymore.

- [QTBUG-32017] Windows: Fixed the waitAnyEvent() method for the WAIT_FAILED
handling.

- [QTBUG-32018] The port name and product identifiers now work for more devices
and scenarios on Windows.

- [QTBUG-31964] The serial port enums are now properly tagged as Q_FLAGS and
used so.

- [QTBUG-31966] Support has been added for non-standard Qt header intallation
folder (e.g. on Red Hat).

- Added native serial port handle; it is now possible to do any custom operation
if not supported by QtSerialPort.

- [QTBUG-32680] Added API for handling the time out errors when waiting for read
or write.

- [QTBUG-33125] The generation of the forward headers now works with Qt 4 and
Necessitas.

- [QTBUG-33117] [QTBUG-33139] Fixed the compilation for Android with Qt 5. The
command line enumerator seems to work.

- Added support for BSD4 baud rates, i.e. not Unix compatible.

- Linux: sysfs support was added for serial port information as a fallback for
udev, but it is preferred to hard coded serial port node names.

- [QTBUG-32173] Rewrote the documentation to more proper English than before,
and also some change for more accurate content.

- Added a new error enumeration value called "NotOpenError". This can be used
for operation when the serial port is not open. This is also used internally
now.

- [QTBUG-33774] Document that the serial port parameters cannot be set before
opening.

- No more unnecessary syscalls (parameter settings, pinout signal query, etc) in the
backend when the port is closed. This also means no improper errors are set
accordingly.

- Removed the QtGui linkage for the command line enumerator example, so it now
links against QtCore and QtSerialPort only.

- More warnings when doing operations that require the serial port to be open,
but it is closed.

- The deprecated QtAlgorithm usage is removed.

- Some outputs in the examples are fixed to be more proper English; this
includes mostly typo, but also some comprehensive changes.

- New command line sync reader example available with screen shot and
documentation.

- New command line async reader example available with screen shot and
documentation.

- New command line sync writer example available with screen shot and
documentation.

- New command line async writer example available with screen shot and
documentation.

- [QTBUG-34329] Support added for loading udev at runtime rather than linking at
compilation time.

- The buildsystem now respects the configure run for Qt 5, i.e. packageconfig is
not used for finding udev again.

- [QTBUG-32563] Motorola IMX support was added when udev and sysfs are not
present.

- [QTBUG-34429] Mark the data error policy obsolete. End users should stop using
this feature now. It may be removed later in Qt 6.X, and there is a warning now
if it is used.

- Support has been added for the hard-coded device enumeration backend to get
information. Android uarts such as /dev/ttyHS* (High speed UART) and
/dev/ttyHSL* (Low speed UART) are supported by that backend.

- [QTBUG-34474] Replace the internal QTtyLocker with QLockFile from QtCore and a
small convenience on top of it to comply with the locking directories lockdev
also uses.

- Support has been added for the hard-coded device enumeration backend to get
information. /dev/ttyO* (native OMAP UART) is supported by that backend.

- The lock file usage has been extended to support Android as there is no direct
access to the usual Unix lock file system paths. The lock file is now placed
into /data/local/tmp.

- [QTBUG-35064] PCI support has been added to the sysfs backend on Linux to
support the enumeration of such devices.

- [QTBUG-35184] Mark the isValid() method in QSerialPortInfo deprecated because
it has no common use case.

- [QTBUG-35215] Mark the QSerialPort::Unknown* enumeration values in QSerialPort
deprecated because it has no use case, and was added mistakenly. There is no
such "standard" serial port behavior general for these as "unknown". It is an
implementation detail for error reporting, and hence not recommended anymore.