Skip to content

Commit

Permalink
Merge branch 'dev'
Browse files Browse the repository at this point in the history
  • Loading branch information
Eriobis committed Aug 2, 2018
2 parents 2c191c6 + 97db015 commit 4cb34dc
Show file tree
Hide file tree
Showing 330 changed files with 91,068 additions and 16,828 deletions.
72 changes: 60 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@

This is a Windows application that displays real time data from serial port. The application is 32-bit and built with Qt and QCustomPlot library.

# Features
## Features

- No axes limit: An unknown/new channel data create a new graph and uses it (palette of 14 cyclic colors)
- No data point limit: All received data is kept so user can explore old data
- No baud rate limit: Tested up to 912600 bps
Expand All @@ -13,24 +14,27 @@ This is a Windows application that displays real time data from serial port. The
- Supports positive and negative integers and floats
- Exports to PNG
- Exports to CSV
- Autoscale to visible graph

# Screenshot
## Screenshot

![Serial Port Plotter screenshot](res/screen_0.png)

# How to use the application
## How to use the application

Just send your integer data over the serial port. The application expects certain format so it can differentiate between values. Each message you send must start with '$' and end with ';' (semi-colon) and the integers inside need to be space-separated. The Help button displays comprehensive instructions.

Use the mouse wheel over controls to change its values and use it over plot area to zoom.

When stopped/paused, plot area can be dragged and file saving can be enabled.

To enable the file saving, click on the document button before starting the plot
To enable the file saving, click on the document button before starting the plot.

Double click on a channel in the Graph Control panel to hide/show a specific channel.

![File Save Button](res/screen_1.png)

# Send data over the serial port
## Send data over the serial port

```c
/* Example: Plot two values */
Expand All @@ -41,41 +45,77 @@ Depending on how much data you want to display, you can adjust the number of dat
The software supports integer and decimal numbers ( float/double )
# Source
## Source
Source and .pro file of the Qt Project are available. A standalone .exe is included for the people who do not want to build the source. Search for it at [releases](https://github.com/CieNTi/serial_port_plotter/releases)
# Credits
## Credits
- [Serial Port Plotter at mbed forums](https://developer.mbed.org/users/borislav/notebook/serial-port-plotter/) by [Borislav K](https://developer.mbed.org/users/borislav/)
- [Line Icon Set](http://www.flaticon.com/packs/line-icon-set) by [Situ Herrera](http://www.flaticon.com/authors/situ-herrera) icon pack
- [Lynny](http://www.1001freedownloads.com/free-vector/lynny-icons-full) icon pack
- [Changelog](http://keepachangelog.com/)
- Base of this software by [CieNTi](https://github.com/CieNTi)
- CSV export by [HackInventOrg](https://github.com/HackInventOrg)
# Changelog
## Changelog
All notable changes to this project will be documented below this line.
This project adheres to [Semantic Versioning](http://semver.org/).
## [1.3.0] - 2018-08-01
### Info
- Built with QT 5.11.1
- QT libraries updated and new plot features implemented
- Beginning of version 1.3
### Added
- COM port refresh button to update the list
- Channel visibility control added to turn off unwanted channel
- Autoscale button for Y axis will autoscale to the highest value + 10%
- Save to CSV support
### Changed
- qDarkStyle updated to 2.5.4
- qCustomplot updated 2.0.1
### Bugfix
- Axis rename dialog gets focus when popup occurs
## [1.2.2] - 2018-07-26
### Info
- Project forked from HackInvent since 1.2.1
### Added
- UART debug textBox
- Textbox control ( toggle visible and toggle data filter )
## [1.2.1] - 2017-09-24
### Fixed
- Support for float/double has been added
- Linux build fails because no `serial_port_plotter_res.o` file was found (Issue #4)
## [1.2.0] - 2016-08-28
### Added
- Negative numbers support ([cap we](https://developer.mbed.org/users/capwe/) FIX at [mbed forums](https://developer.mbed.org/comments/perm/22672/))
- Support for high baud rates (tested up to 912600 bps)
## [1.1.0] - 2016-08-28
### Added
- Original qdarkstyle resources (icons are working now)
- Manifest and all Windows related/recommended configs
- *Line Icon Set* icons in 3 colors
Expand All @@ -84,26 +124,34 @@ This project adheres to [Semantic Versioning](http://semver.org/).
- Play/Pause/Stop, Clear and Help toolbar buttons
### Changed
- Resources structure
- Updated qcustomplot to v1.3.2
- Menubar is replaced by icon toolbar for usability
- [WiP] mainwindow.cpp doxygen friendly comments
### Removed
- Control over number of points
- Delete previous graph data
- *Connect* and *Start/Stop plot* buttons
## [1.0.0] - 2014-08-31
### Added
- Original [Borislav Kereziev](mailto:[email protected]) work commit [source](https://developer.mbed.org/users/borislav/notebook/serial-port-plotter/)
[1.2.0]: https://github.com/CieNTi/serial_port_plotter/releases/tag/v1.2.0
[1.1.0]: https://github.com/CieNTi/serial_port_plotter/releases/tag/v1.1.0
[1.0.0]: https://github.com/CieNTi/serial_port_plotter/releases/tag/v1.0.0
# To-Do
## To-Do
- Port list refresh
- Fill baud automatically and allow custom by textbox (when COM ui)
- PNG *WITH* transparency
- Separate `receive_data` from `process_data` to allow non-throttled operations
[1.3.0]: https://github.com/Eriobis/serial_port_plotter/releases/tag/v1.3.0
[1.2.2]: https://github.com/Eriobis/serial_port_plotter/releases/tag/v1.2.2
[1.2.0]: https://github.com/CieNTi/serial_port_plotter/releases/tag/v1.2.0
[1.1.0]: https://github.com/CieNTi/serial_port_plotter/releases/tag/v1.1.0
[1.0.0]: https://github.com/CieNTi/serial_port_plotter/releases/tag/v1.0.0
10 changes: 5 additions & 5 deletions SerialPortPlotter.pro
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ RESOURCES += \
# The following line compiles on Release but not on Debug, so this workaroung is used:
RC_FILE = res/serial_port_plotter.rc
# Call the resource compiler
win32:mkver_rc.target = serial_port_plotter_res.o
win32:mkver_rc.commands = windres --use-temp-file -i ../res/serial_port_plotter.rc -o serial_port_plotter_res.o --include-dir=../res -DVERSION_H_INTERN $(DEFINES)
win32:QMAKE_EXTRA_TARGETS += mkver_rc
win32:PRE_TARGETDEPS += serial_port_plotter_res.o
win32:LIBS += serial_port_plotter_res.o
#win32:mkver_rc.target = serial_port_plotter_res.o
#win32:mkver_rc.commands = windres --use-temp-file -i serial_port_plotter.rc -o serial_port_plotter_res.o --include-dir=../res -DVERSION_H_INTERN $(DEFINES)
#win32:QMAKE_EXTRA_TARGETS += mkver_rc
#win32:PRE_TARGETDEPS += serial_port_plotter_res.o
#win32:LIBS += serial_port_plotter_res.o
2 changes: 1 addition & 1 deletion main.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ int main(int argc, char *argv[])
MainWindow w;
QIcon appIcon(":/serial_port_plotter/icons/serial_port_icon.icns");
w.setWindowIcon(appIcon);
w.setWindowTitle("Serial Port Plotter v1.2.2");
w.setWindowTitle("Serial Port Plotter v1.3.0");
w.show();

return a.exec();
Expand Down
Loading

0 comments on commit 4cb34dc

Please sign in to comment.