# SerialPlot

Small and simple software for plotting data from serial port.

![SerialPlot v0.4 Screenshot](http://i.imgur.com/Wb53LRt.png)

## Features
* Reading data from serial port
* Binary data formats (u)int8, (u)int16, (u)int32, float
* ASCII input (Comma Separated Values)
* Synchronized multi channel plotting
* Define and send commands to the device in ASCII or binary format
* Take snapshots of the current waveform and save to CSV file

## Installation

You can obtain installation packages from
[downloads](https://bitbucket.org/hyOzd/serialplot/downloads). As of
moment there are only Debian and Windows 64 bits packages.

## Dependencies
- Qt 5, including SerialPort module
- Qwt 6.1

## Building

### Obtain Dependencies

- Qt5 development packages
- Qt5 SerialPort module
- CMake
- Mercurial

Under Ubuntu/Debian:
```sudo apt-get install qtbase5-dev libqt5serialport5-dev cmake mercurial```

### Download and Install Qwt

[Qwt](http://qwt.sourceforge.net) is the library that provides
plotting widgets for SerialPlot. You have 3 different options for Qwt.

* Leave it to serialplot build scripts. Qwt will be downloaded over
  SVN and built for you.

* If your linux distribution has `libqwt-qt5-dev` or `qwt-qt5-devel`
  package, install it and set `BUILD_QWT` cmake option to `false`.

* Download Qwt 6 [here](http://sourceforge.net/projects/qwt/files/)
  and build it yourself per these
  [instructions](http://qwt.sourceforge.net/qwtinstall.html#qwtinstall-unix). Make
  sure you use Qt5 (not Qt4) to build it. And set `BUILD_QWT` cmake
  option to `false`.

### Download and Build SerialPlot

You can use Mercurial to download SerialPlot source code. Or you can
download it from here:
https://bitbucket.org/hyOzd/serialplot/downloads

    hg clone https://hyOzd@bitbucket.org/hyOzd/serialplot
    cd serialplot
    mkdir build && cd build
    cmake ..
    make

You can also build with QtCreator IDE using `serialplot.pro` file.

## Known Issues
- Port error 13 happens when closing. This is a Qt issue. It's known
  to not happen with Qt 5.4.1 . Not fatal.

## License
This software is licensed under GPLv3. See file COPYING for details.