File	Date	Author	Commit
.gitignore	2011-06-25	Blake Leverett	[39e76d] Now loads the settings only once, otherwise F10...
COPYING	2010-11-28	blake	[a74728] adding files
GrnLEDOff.bmp	2010-11-28	blake	[a74728] adding files
GrnLEDOn.bmp	2010-11-28	blake	[a74728] adding files
README	2012-09-12	Blake Leverett	[7facc5] Modified readme to accomodate new way of buildi...
RedLEDOff.bmp	2010-11-28	blake	[a74728] adding files
RedLEDOn.bmp	2010-11-28	blake	[a74728] adding files
about.ui	2012-09-12	Blake Leverett	[609fd2] Changes to make project work/run on widows XP w...
config.ui	2013-01-09	Blake Leverett	[89385c] Allow 1200 baud.
led.cpp	2010-11-28	blake	[a74728] adding files
led.h	2010-11-28	blake	[a74728] adding files
main.cpp	2010-11-28	blake	[a74728] adding files
mainwindow.cpp	2013-01-09	Blake Leverett	[89385c] Allow 1200 baud.
mainwindow.h	2013-01-09	Blake Leverett	[89385c] Allow 1200 baud.
mainwindow.ui	2011-05-26	Blake Leverett	[c9846e] Fixed minor bug with logging. Minor icon change.
qst-icon.png	2010-11-28	blake	[a74728] adding files
qst-logo.png	2010-11-28	blake	[a74728] adding files
qst.pro	2012-09-12	Blake Leverett	[609fd2] Changes to make project work/run on widows XP w...
qst.qrc	2010-11-28	blake	[a74728] adding files

Read Me

QST - QT Serial Terminal

Implements a terminal program using QT and the QExtSerialPort library.

This terminal program mixes the input and output into one terminal
window, unlike other terminal programs which have separate input and
output windows.  The intended use of the program is to communicate with
embedded systems over a serial port.

The program builds for both Windows XP and Linux platforms.  See other
README files for details.  There is no Mac port yet, because I don't
have access to a Mac.  Feel free to port to the Mac and send me back
the patches.

Currently the program only supports N-8-1 serial format.  It should be
simple to support E-7-1, but I don't have any embedded devices that use
that format, so it isn't implemented.

Arranging the sources:

QST depends on the QExtSerialPort library.  You must obtain the source
for QExtSerialPort from http://code.google.com/p/qextserialport/.  Do
not use the older version from SourceForge.  Either download the
Version 1.2 (or higher) or use git to clone the repository.

Place the QExtSerialPort source directory alongside the QST directory,
like this:

somedir/
   qextserialport/
   qst/

Building:

Qt Creator: Open the file qst/qst.pro.  This should open the project.
Now compile by pressing the compile button or from the Build menu on
the main menu.

Command line:  Go to the qst directory.  Type this:

qmake
make

The project should build.


Building QST on Linux

If the compile fails, it is probably a path error, where the compiler
is unable to find the qextserialport include or library files.  You
may have to edit the paths inside the qst.pro file to correct this.


Building QST on Windows XP

There has been an issue with the compiler complaining about missing
file "qwineventnotifier_p.h".  This can be remedied by getting a copy
of this file from the qt source tarball and placing it in the
qextserialport/src/ directory.  Hopefully this issue will be fixed by
the qextserialport developers soon.

To run the program outside of QTCreator, you will have to copy a bunch
of DLL files to the same directory where the qst.exe file is located.
To find out what these dll files are, you can simply try to execute
the qst.exe file, and fix each "missing dll" error by copying the
correct dll file into the same directory as the qst.exe file, or to
wherever system DLL's are expected to live in windows.

Or just download the pre-compiled installer, which includes the DLL's.