├── Resources
    ├── shot.jpg
    ├── shot.png
    └── download.jpg
├── SerialOscillograph_by_QT
    ├── Resources
    │   └── logo.png
    ├── resource.qrc
    ├── main.cpp
    ├── dataprocess.h
    ├── SerialOscillograph_by_QT.pro
    ├── mainwindow.h
    ├── dataprocess.cpp
    ├── mainwindow.ui
    └── mainwindow.cpp
├── STM32Lib
    ├── qtso.h
    └── qtso.c
├── .gitignore
├── README.md
└── LICENSE


/Resources/shot.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ws1336/SerialOscillograph/HEAD/Resources/shot.jpg


--------------------------------------------------------------------------------
/Resources/shot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ws1336/SerialOscillograph/HEAD/Resources/shot.png


--------------------------------------------------------------------------------
/Resources/download.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ws1336/SerialOscillograph/HEAD/Resources/download.jpg


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/Resources/logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ws1336/SerialOscillograph/HEAD/SerialOscillograph_by_QT/Resources/logo.png


--------------------------------------------------------------------------------
/STM32Lib/qtso.h:
--------------------------------------------------------------------------------
1 | #ifndef __QTSO_H__ 
2 | #define __QTSO_H__
3 | 
4 | #include "stm32f10x.h"
5 | 
6 | u8 QTSO_Send(u32 size,float * dat);
7 | 
8 | #endif
9 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/resource.qrc:
--------------------------------------------------------------------------------
1 | <RCC>
2 |     <qresource prefix="/">
3 |         <file>Resources/logo.png</file>
4 |     </qresource>
5 | </RCC>
6 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/main.cpp:
--------------------------------------------------------------------------------
 1 | #include "mainwindow.h"
 2 | #include <QApplication>
 3 | 
 4 | int main(int argc, char *argv[])
 5 | {
 6 |     QApplication a(argc, argv);
 7 |     MainWindow w;
 8 |     w.show();
 9 | 
10 |     return a.exec();
11 | }
12 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/dataprocess.h:
--------------------------------------------------------------------------------
 1 | #ifndef DATAPROCESS_H
 2 | #define DATAPROCESS_H
 3 | #include <QDebug>
 4 | #include <QByteArray>
 5 | class DataProcess
 6 | {
 7 | public:
 8 |     DataProcess();
 9 |     void add(QByteArray &input);
10 |     void clear();
11 |     bool process(char* output);
12 |     int getFullsize() const;
13 |     void setFullsize(int value);
14 | private:
15 |     int isStart();
16 |     int isEnd();
17 |     bool isFull();
18 | private:
19 |     bool startFlag;
20 |     int loc;
21 |     int fullsize;
22 |     QByteArray data;
23 | };
24 | 
25 | #endif // DATAPROCESS_H
26 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # C++ objects and libs
 2 | *.slo
 3 | *.lo
 4 | *.o
 5 | *.a
 6 | *.la
 7 | *.lai
 8 | *.so
 9 | *.dll
10 | *.dylib
11 | 
12 | # Qt-es
13 | object_script.*.Release
14 | object_script.*.Debug
15 | *_plugin_import.cpp
16 | /.qmake.cache
17 | /.qmake.stash
18 | *.pro.user
19 | *.pro.user.*
20 | *.qbs.user
21 | *.qbs.user.*
22 | *.moc
23 | moc_*.cpp
24 | moc_*.h
25 | qrc_*.cpp
26 | ui_*.h
27 | *.qmlc
28 | *.jsc
29 | Makefile*
30 | *build-*
31 | 
32 | # Qt unit tests
33 | target_wrapper.*
34 | 
35 | # QtCreator
36 | *.autosave
37 | 
38 | # QtCreator Qml
39 | *.qmlproject.user
40 | *.qmlproject.user.*
41 | 
42 | # QtCreator CMake
43 | CMakeLists.txt.user*
44 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # SerialOscillograph
 2 | 这是一个使用Qt5开发的串口示波器上位机。
 3 | 
 4 | 串口通讯使用了QSerialPort，波形绘制使用了QChart。
 5 | 
 6 | 项目包含了QT上位机源码，和与之配合的STM32单片机头文件。
 7 | 
 8 | 通讯数据二进制形式（区别于字符型），数据类型为32位float，通讯效率较高，详见代码。
 9 | 
10 | 数据保存格式为csv格式，读取数据使用了SACsvStream中部分代码。
11 | 
12 | 合作或意见反馈请联系ws1336@qq.com
13 | 
14 | ## 获取windows版本可执行程序
15 | 
16 | [![baidu](https://github.com/ws1336/SerialOscillograph/raw/master/Resources/download.jpg "下载地址")](https://github.com/ws1336/SerialOscillograph/releases)
17 | 
18 | ## 软件运行示意图Ubuntu
19 | 
20 | ![baidu](https://github.com/ws1336/SerialOscillograph/raw/master/Resources/shot.png "软件运行示意图Ubuntu")
21 | 
22 | ## 软件运行示意图Windows7
23 | 
24 | ![baidu](https://github.com/ws1336/SerialOscillograph/raw/master/Resources/shot.jpg "软件运行示意图Windows7")
25 | 


--------------------------------------------------------------------------------
/STM32Lib/qtso.c:
--------------------------------------------------------------------------------
 1 | #include "qtso.h"
 2 | 
 3 | #define QTSO_DATA_MAX 10
 4 | 
 5 | struct QTSO_DATA
 6 | {
 7 | 	char head[4];
 8 | 	u32 size;
 9 | 	float data[QTSO_DATA_MAX];
10 | 	u8 uCRC;
11 | }static QTSO_DAT={'Q','T','S','O',0};
12 | 
13 | u8 QTSO_SetDAT(u32 size,float * dat)
14 | {
15 | 	int i=0;
16 | 	if(size == 0 || size>10)
17 | 		return 0;
18 | 	//设置数据的SIZE
19 | 	QTSO_DAT.size=size*4;
20 | 	//添加数据
21 | 	for(i=0;i<size;i++)
22 | 	{
23 | 		QTSO_DAT.data[i]=dat[i];
24 | 	}
25 | 	//计算校验值
26 | 	QTSO_DAT.uCRC=0;
27 | 	for(i=8;i<8+QTSO_DAT.size;i++)
28 | 	{
29 | 		QTSO_DAT.uCRC^=((u8 *)(&QTSO_DAT))[i];
30 | 	}
31 | 	return 1;
32 | }
33 | 
34 | u8 QTSO_Send(u32 size,float * dat)
35 | {
36 | 	int i;
37 | 	if(QTSO_SetDAT(size,dat)==0)
38 | 		return 0;
39 | 	//发送包头和数据
40 | 	for(i=0;i<8+QTSO_DAT.size;i++)
41 | 	{
42 | 		while((USART1->SR&0X40)==0);//循环发送,直到发送完毕   
43 | 			USART1->DR =((u8 *)(&QTSO_DAT))[i];
44 | 	}
45 | 	//发送校验值
46 | 	while((USART1->SR&0X40)==0);//循环发送,直到发送完毕   
47 | 			USART1->DR =QTSO_DAT.uCRC;
48 | 	return 1;
49 | }
50 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/SerialOscillograph_by_QT.pro:
--------------------------------------------------------------------------------
 1 | #-------------------------------------------------
 2 | #
 3 | # Project created by QtCreator 2018-11-29T19:57:48
 4 | #
 5 | #-------------------------------------------------
 6 | 
 7 | QT       += core gui serialport charts
 8 | 
 9 | greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
10 | 
11 | TARGET = SerialOscillograph_by_QT
12 | TEMPLATE = app
13 | 
14 | # The following define makes your compiler emit warnings if you use
15 | # any feature of Qt which has been marked as deprecated (the exact warnings
16 | # depend on your compiler). Please consult the documentation of the
17 | # deprecated API in order to know how to port your code away from it.
18 | DEFINES += QT_DEPRECATED_WARNINGS
19 | 
20 | # You can also make your code fail to compile if you use deprecated APIs.
21 | # In order to do so, uncomment the following line.
22 | # You can also select to disable deprecated APIs only up to a certain version of Qt.
23 | #DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0
24 | 
25 | 
26 | SOURCES += \
27 |         main.cpp \
28 |         mainwindow.cpp \
29 |     dataprocess.cpp
30 | 
31 | HEADERS += \
32 |         mainwindow.h \
33 |     dataprocess.h
34 | 
35 | FORMS += \
36 |         mainwindow.ui
37 | 
38 | RC_ICONS = logo.ico
39 | 
40 | RESOURCES += \
41 |     resource.qrc
42 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/mainwindow.h:
--------------------------------------------------------------------------------
 1 | #ifndef MAINWINDOW_H
 2 | #define MAINWINDOW_H
 3 | 
 4 | #include <QMainWindow>
 5 | #include <QMessageBox>
 6 | #include <QSerialPort>
 7 | #include <QSerialPortInfo>
 8 | 
 9 | #include <QFile>
10 | #include <QFileDialog>
11 | 
12 | #include "QtCharts/QChart"
13 | #include "QLineSeries"
14 | #include "QValueAxis"
15 | #include "QTimer"
16 | #include "QTime"
17 | #include "QList"
18 | #include "qmath.h"
19 | #include "QPointF"
20 | #include "QDebug"
21 | #include "QChartView"
22 | #include "dataprocess.h"
23 | 
24 | QT_CHARTS_USE_NAMESPACE
25 | 
26 | namespace Ui {
27 | class MainWindow;
28 | }
29 | 
30 | #define Channel_number 10
31 | 
32 | 
33 | 
34 | class MainWindow : public QMainWindow
35 | {
36 |     Q_OBJECT
37 | 
38 | public:
39 |     explicit MainWindow(QWidget *parent = 0);
40 |     ~MainWindow();
41 | private slots:
42 |     void readData();
43 | 
44 |     void on_btn_OpenSerial_clicked();
45 | 
46 |     void on_btn_help_clicked();
47 | 
48 |     void on_btn_StopDis_clicked();
49 | 
50 |     void on_action_save_triggered();
51 | 
52 |     void on_action_load_triggered();
53 | 
54 |     void on_btn_ClearSeries_clicked();
55 | 
56 |     void on_btn_SetXSize_clicked();
57 | 
58 | private:
59 |     QString writeDataToCSV();
60 |     void readDataFromCSV(QTextStream &sDataStream);
61 | private:
62 |     bool SerialSta;
63 |     DataProcess processor;
64 |     bool chartSta;
65 |     QSerialPort *port;
66 |     Ui::MainWindow *ui;
67 |     QLabel *lb_StatusBar_SerialStatus;
68 |     QLabel *lb_StatusBar_DataRecNum;
69 | 
70 |     QChart *m_chart;
71 |     QLineSeries m_series[Channel_number];
72 |     QVector<QPointF> points[Channel_number];
73 |     QValueAxis *axisX;
74 |     QValueAxis *axisY;
75 | 
76 |     unsigned long int dataRecNum=0;
77 |     int XSize = 200;
78 |     int timeId;
79 |     int Xmin=0;
80 |     int Xmax=0;
81 |     float Ymin=3.4028235e38f;
82 |     float Ymax=1.4e-45f;
83 | };
84 | 
85 | #endif // MAINWINDOW_H
86 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/dataprocess.cpp:
--------------------------------------------------------------------------------
  1 | #include "dataprocess.h"
  2 | 
  3 | DataProcess::DataProcess()
  4 | {
  5 |     fullsize = 4096;
  6 |     startFlag = false;
  7 |     loc = 0;
  8 | }
  9 | 
 10 | bool DataProcess::process(char *output)
 11 | {
 12 |     if(startFlag || isStart()!=0xffffffff)//如果收到包头标志，开始处理
 13 |     {
 14 |         //预处理
 15 |         if(startFlag==false)
 16 |         {
 17 |             startFlag=true;
 18 |             data=data.mid(isStart());
 19 |             loc=0;
 20 |         }
 21 |         //如果接收完成，正式处理
 22 |         loc=isEnd();
 23 |         if(loc)
 24 |         {
 25 |             for(int i=4;i<loc-1;i++)
 26 |                 output[i-4]=data.at(i);
 27 |             data=data.mid(loc);
 28 |             startFlag=false;
 29 |             return true;
 30 |         }
 31 |         else
 32 |         {
 33 |             return false;
 34 |         }
 35 |     }
 36 |     return false;
 37 | }
 38 | 
 39 | int DataProcess::isStart()
 40 | {
 41 |     if(data.size()<8)
 42 |         return 0xffffffff;
 43 |     for(int i=0;i<data.size()-4;i++)
 44 |     {
 45 |         if(data.at(i)=='Q')
 46 |             if(data.at(i+1)=='T')
 47 |                 if(data.at(i+2)=='S')
 48 |                     if(data.at(i+3)=='O')
 49 |                     {
 50 |                         return i;
 51 |                     }
 52 |     }
 53 |     return 0xffffffff;
 54 | }
 55 | 
 56 | int DataProcess::isEnd()
 57 | {
 58 |     if(data.size()<=13)
 59 |         return 0;
 60 |     int num;
 61 |     ((char*)(&num))[0]=data.at(4);
 62 |     ((char*)(&num))[1]=data.at(5);
 63 |     ((char*)(&num))[2]=data.at(6);
 64 |     ((char*)(&num))[3]=data.at(7);
 65 |     if(data.size()>=8+num+1)
 66 |     {
 67 |         unsigned char uCRC=0;
 68 |         for(int i=8;i<8+num;i++)
 69 |         {
 70 |             uCRC^=data.at(i);
 71 |         }
 72 |         if(uCRC==(unsigned char)data.at(8+num))
 73 |             return 8+num+1;
 74 |         else
 75 |         {
 76 |             qDebug()<<"校验错误";
 77 |             data=data.mid(4);
 78 |             startFlag=false;
 79 |             return 0;
 80 |         }
 81 |     }
 82 |     return 0;
 83 | }
 84 | 
 85 | bool DataProcess::isFull()
 86 | {
 87 |     if(data.size()>=fullsize)
 88 |         return true;
 89 |     return false;
 90 | }
 91 | 
 92 | int DataProcess::getFullsize() const
 93 | {
 94 |     return fullsize;
 95 | }
 96 | 
 97 | void DataProcess::setFullsize(int value)
 98 | {
 99 |     fullsize = value;
100 | }
101 | 
102 | void DataProcess::add(QByteArray &input)
103 | {
104 |     data.append(input);
105 |     //判断是否接受超量
106 |     if(isFull())
107 |     {
108 |         startFlag=false;
109 |         loc=0;
110 |         data=data.mid(input.size());
111 |     }
112 |     
113 | }
114 | 
115 | void DataProcess::clear()
116 | {
117 |     data.clear();
118 |     startFlag=false;
119 |     loc=0;
120 | }
121 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/mainwindow.ui:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <ui version="4.0">
  3 |  <class>MainWindow</class>
  4 |  <widget class="QMainWindow" name="MainWindow">
  5 |   <property name="geometry">
  6 |    <rect>
  7 |     <x>0</x>
  8 |     <y>0</y>
  9 |     <width>1000</width>
 10 |     <height>450</height>
 11 |    </rect>
 12 |   </property>
 13 |   <property name="windowTitle">
 14 |    <string>串口示波器</string>
 15 |   </property>
 16 |   <property name="windowIcon">
 17 |    <iconset resource="resource.qrc">
 18 |     <normaloff>:/Resources/logo.png</normaloff>:/Resources/logo.png</iconset>
 19 |   </property>
 20 |   <widget class="QWidget" name="centralWidget">
 21 |    <layout class="QVBoxLayout" name="verticalLayout" stretch="10,0">
 22 |     <property name="spacing">
 23 |      <number>0</number>
 24 |     </property>
 25 |     <property name="leftMargin">
 26 |      <number>0</number>
 27 |     </property>
 28 |     <property name="topMargin">
 29 |      <number>0</number>
 30 |     </property>
 31 |     <property name="rightMargin">
 32 |      <number>0</number>
 33 |     </property>
 34 |     <property name="bottomMargin">
 35 |      <number>0</number>
 36 |     </property>
 37 |     <item>
 38 |      <widget class="QtCharts::QChartView" name="chartView"/>
 39 |     </item>
 40 |     <item>
 41 |      <layout class="QHBoxLayout" name="horizontalLayout" stretch="1,2,1,2,2,2,2,2,1,1,1,10,2">
 42 |       <property name="leftMargin">
 43 |        <number>10</number>
 44 |       </property>
 45 |       <property name="rightMargin">
 46 |        <number>10</number>
 47 |       </property>
 48 |       <item>
 49 |        <widget class="QLabel" name="label">
 50 |         <property name="text">
 51 |          <string>串口号</string>
 52 |         </property>
 53 |        </widget>
 54 |       </item>
 55 |       <item>
 56 |        <widget class="QComboBox" name="cb_SerialPort">
 57 |         <property name="sizePolicy">
 58 |          <sizepolicy hsizetype="Preferred" vsizetype="Minimum">
 59 |           <horstretch>0</horstretch>
 60 |           <verstretch>0</verstretch>
 61 |          </sizepolicy>
 62 |         </property>
 63 |        </widget>
 64 |       </item>
 65 |       <item>
 66 |        <widget class="QLabel" name="label_2">
 67 |         <property name="text">
 68 |          <string>波特率</string>
 69 |         </property>
 70 |        </widget>
 71 |       </item>
 72 |       <item>
 73 |        <widget class="QComboBox" name="cb_baudRate">
 74 |         <property name="sizePolicy">
 75 |          <sizepolicy hsizetype="Preferred" vsizetype="Minimum">
 76 |           <horstretch>0</horstretch>
 77 |           <verstretch>0</verstretch>
 78 |          </sizepolicy>
 79 |         </property>
 80 |         <property name="editable">
 81 |          <bool>true</bool>
 82 |         </property>
 83 |         <property name="currentIndex">
 84 |          <number>10</number>
 85 |         </property>
 86 |         <item>
 87 |          <property name="text">
 88 |           <string>2400</string>
 89 |          </property>
 90 |         </item>
 91 |         <item>
 92 |          <property name="text">
 93 |           <string>4800</string>
 94 |          </property>
 95 |         </item>
 96 |         <item>
 97 |          <property name="text">
 98 |           <string>9600</string>
 99 |          </property>
100 |         </item>
101 |         <item>
102 |          <property name="text">
103 |           <string>19200</string>
104 |          </property>
105 |         </item>
106 |         <item>
107 |          <property name="text">
108 |           <string>38400</string>
109 |          </property>
110 |         </item>
111 |         <item>
112 |          <property name="text">
113 |           <string>57600</string>
114 |          </property>
115 |         </item>
116 |         <item>
117 |          <property name="text">
118 |           <string>76800</string>
119 |          </property>
120 |         </item>
121 |         <item>
122 |          <property name="text">
123 |           <string>115200</string>
124 |          </property>
125 |         </item>
126 |         <item>
127 |          <property name="text">
128 |           <string>153600</string>
129 |          </property>
130 |         </item>
131 |         <item>
132 |          <property name="text">
133 |           <string>230400</string>
134 |          </property>
135 |         </item>
136 |         <item>
137 |          <property name="text">
138 |           <string>460800</string>
139 |          </property>
140 |         </item>
141 |         <item>
142 |          <property name="text">
143 |           <string>921600</string>
144 |          </property>
145 |         </item>
146 |        </widget>
147 |       </item>
148 |       <item>
149 |        <widget class="QPushButton" name="btn_OpenSerial">
150 |         <property name="sizePolicy">
151 |          <sizepolicy hsizetype="Minimum" vsizetype="Minimum">
152 |           <horstretch>0</horstretch>
153 |           <verstretch>0</verstretch>
154 |          </sizepolicy>
155 |         </property>
156 |         <property name="text">
157 |          <string>打开串口</string>
158 |         </property>
159 |        </widget>
160 |       </item>
161 |       <item>
162 |        <widget class="QPushButton" name="btn_StopDis">
163 |         <property name="sizePolicy">
164 |          <sizepolicy hsizetype="Minimum" vsizetype="Minimum">
165 |           <horstretch>0</horstretch>
166 |           <verstretch>0</verstretch>
167 |          </sizepolicy>
168 |         </property>
169 |         <property name="text">
170 |          <string>开始更新</string>
171 |         </property>
172 |        </widget>
173 |       </item>
174 |       <item>
175 |        <widget class="QPushButton" name="btn_ClearSeries">
176 |         <property name="text">
177 |          <string>清除曲线</string>
178 |         </property>
179 |        </widget>
180 |       </item>
181 |       <item>
182 |        <widget class="QPushButton" name="btn_SetXSize">
183 |         <property name="text">
184 |          <string>设置X范围</string>
185 |         </property>
186 |        </widget>
187 |       </item>
188 |       <item>
189 |        <widget class="QLineEdit" name="leXSize">
190 |         <property name="text">
191 |          <string>200</string>
192 |         </property>
193 |         <property name="maxLength">
194 |          <number>5</number>
195 |         </property>
196 |         <property name="frame">
197 |          <bool>true</bool>
198 |         </property>
199 |         <property name="cursorMoveStyle">
200 |          <enum>Qt::LogicalMoveStyle</enum>
201 |         </property>
202 |         <property name="clearButtonEnabled">
203 |          <bool>false</bool>
204 |         </property>
205 |        </widget>
206 |       </item>
207 |       <item>
208 |        <widget class="QCheckBox" name="checkBoxXAuto">
209 |         <property name="text">
210 |          <string>X自动</string>
211 |         </property>
212 |         <property name="checked">
213 |          <bool>true</bool>
214 |         </property>
215 |        </widget>
216 |       </item>
217 |       <item>
218 |        <widget class="QCheckBox" name="checkBoxYAuto">
219 |         <property name="text">
220 |          <string>Y自动</string>
221 |         </property>
222 |         <property name="checked">
223 |          <bool>true</bool>
224 |         </property>
225 |        </widget>
226 |       </item>
227 |       <item>
228 |        <spacer name="horizontalSpacer">
229 |         <property name="orientation">
230 |          <enum>Qt::Horizontal</enum>
231 |         </property>
232 |         <property name="sizeHint" stdset="0">
233 |          <size>
234 |           <width>40</width>
235 |           <height>20</height>
236 |          </size>
237 |         </property>
238 |        </spacer>
239 |       </item>
240 |       <item>
241 |        <widget class="QPushButton" name="btn_help">
242 |         <property name="text">
243 |          <string>帮助</string>
244 |         </property>
245 |        </widget>
246 |       </item>
247 |      </layout>
248 |     </item>
249 |    </layout>
250 |   </widget>
251 |   <widget class="QMenuBar" name="menuBar">
252 |    <property name="geometry">
253 |     <rect>
254 |      <x>0</x>
255 |      <y>0</y>
256 |      <width>1000</width>
257 |      <height>26</height>
258 |     </rect>
259 |    </property>
260 |    <widget class="QMenu" name="menu">
261 |     <property name="title">
262 |      <string>菜单</string>
263 |     </property>
264 |     <addaction name="action_save"/>
265 |     <addaction name="action_load"/>
266 |    </widget>
267 |    <addaction name="menu"/>
268 |   </widget>
269 |   <widget class="QStatusBar" name="statusBar"/>
270 |   <action name="action_save">
271 |    <property name="text">
272 |     <string>保存数据</string>
273 |    </property>
274 |   </action>
275 |   <action name="action_load">
276 |    <property name="text">
277 |     <string>载入数据</string>
278 |    </property>
279 |   </action>
280 |  </widget>
281 |  <layoutdefault spacing="6" margin="11"/>
282 |  <customwidgets>
283 |   <customwidget>
284 |    <class>QtCharts::QChartView</class>
285 |    <extends>QGraphicsView</extends>
286 |    <header>qchartview.h</header>
287 |   </customwidget>
288 |  </customwidgets>
289 |  <resources>
290 |   <include location="resource.qrc"/>
291 |  </resources>
292 |  <connections/>
293 | </ui>
294 | 


--------------------------------------------------------------------------------
/SerialOscillograph_by_QT/mainwindow.cpp:
--------------------------------------------------------------------------------
  1 | #include "mainwindow.h"
  2 | #include "ui_mainwindow.h"
  3 | /*曲线颜色*/
  4 | //调整次序
  5 | const int color[10]={
  6 |     0xff0000,0xffff00,0x00ff00,0x0000ff,0xff00ff,
  7 |     0xff8000,0xc0ff00,0x00ffff,0x8000ff,0x000001,
  8 | };
  9 | /*const int color[10]={
 10 |     0xff0000,0xff8000,0xffff00,0xc0ff00,0x00ff00,
 11 |     0x00ffff,0x0000ff,0x8000ff,0xff00ff,0x000001,
 12 | };*/
 13 | MainWindow::MainWindow(QWidget *parent) :
 14 |     QMainWindow(parent),
 15 |     ui(new Ui::MainWindow)
 16 | {
 17 |     ui->setupUi(this);
 18 | 
 19 |     SerialSta=false;
 20 |     port=new QSerialPort;
 21 |     connect(port,SIGNAL(readyRead()),this,SLOT(readData()));
 22 |     QList<QSerialPortInfo> strlist=QSerialPortInfo::availablePorts();
 23 |     QList<QSerialPortInfo>::const_iterator iter;
 24 |     for(iter=strlist.constBegin();iter!=strlist.constEnd();++iter)
 25 |     {
 26 |         ui->cb_SerialPort->addItem((*iter).portName());
 27 |     }
 28 | 
 29 |     chartSta=false;
 30 |     m_chart = new QChart;
 31 |     ui->chartView->setChart(m_chart);
 32 |     ui->chartView->setRubberBand(QChartView::RectangleRubberBand);
 33 |     ui->chartView->setRenderHint(QPainter::Antialiasing);
 34 | 
 35 |     //设置坐标系
 36 |     axisX = new QValueAxis;
 37 |     axisX->setRange(Xmin,Xmax);
 38 |     axisX->setLabelFormat("%g");
 39 |     axisX->setTickCount(11);
 40 |     //axisX->setTitleText("X轴");
 41 |     axisY = new QValueAxis;
 42 |     axisY->setRange(Ymin,Ymax);
 43 |     axisY->setTickCount(11);
 44 |     //axisY->setTitleText("Y轴");
 45 | 
 46 |     for(int i=0;i<Channel_number;++i)
 47 |     {
 48 |         m_series[i].setPen(QPen(QBrush(color[i]), 2));//设置线条颜色和粗细
 49 |         m_series[i].setName(QString("CH")+QString::number(i));
 50 |         m_chart->addSeries(&m_series[i]);
 51 |         m_chart->setAxisX(axisX,&m_series[i]);
 52 |         m_chart->setAxisY(axisY,&m_series[i]);
 53 |         m_series[i].setUseOpenGL(true);//openGl 加速
 54 |     }
 55 | 
 56 |     m_chart->legend()->setLabelColor(QColor(0,0,0));
 57 |     m_chart->legend()->setAlignment(Qt::AlignRight);
 58 |     m_chart->legend()->setContentsMargins(0,0,0,0);
 59 |     m_chart->legend()->setMarkerShape(QLegend::MarkerShapeCircle);
 60 |     //m_chart->legend()->hide();
 61 |     //m_chart->setTitle("串口示波器--基于QT");
 62 | 
 63 |     ui->statusBar->setContentsMargins(8,0,0,0);
 64 | 
 65 |     lb_StatusBar_SerialStatus = new QLabel;
 66 |     lb_StatusBar_SerialStatus->setText("串口状态：已关闭");
 67 |     ui->statusBar->insertWidget(0,lb_StatusBar_SerialStatus,1);
 68 | 
 69 |     lb_StatusBar_DataRecNum = new QLabel;
 70 |     lb_StatusBar_DataRecNum->setText(QString("已接收字节：%1").arg(dataRecNum));//修改状态栏
 71 |     ui->statusBar->insertWidget(1,lb_StatusBar_DataRecNum,1);
 72 | 
 73 |     ui->leXSize->setValidator(new QIntValidator(0, 99999, this));
 74 | 
 75 | }
 76 | 
 77 | MainWindow::~MainWindow()
 78 | {
 79 |     delete ui;
 80 | }
 81 | 
 82 | void MainWindow::readData()
 83 | {
 84 |     QByteArray arr= port->readAll();
 85 |     dataRecNum+=arr.size();
 86 |     lb_StatusBar_DataRecNum->setText(QString("已接收字节：%1").arg(dataRecNum));//修改状态栏
 87 | 
 88 |     bool changed=false;//是否变动了points
 89 |     float rec_data[11];
 90 |     processor.add(arr);//通讯协议processor添加数据
 91 | 
 92 |     //通讯成功&正在更新，持续添加点直至所有数据被添加到曲线
 93 |     while(processor.process((char *)rec_data)&&chartSta==true)
 94 |     {
 95 |         Xmax++;
 96 |         if(Xmax>XSize)//调节X轴（窗口）显示范围
 97 |             Xmin=Xmax-XSize;
 98 | 
 99 |         for(int i=0;i<((int *)rec_data)[0]/4;i++)//接收到的数据为float型，每个数据4字节故/4
100 |         {
101 |            m_series[i].append(QPointF(Xmax,rec_data[i+1]));
102 |         }
103 |         changed = true;
104 |     }
105 |     if(changed)//变动了points，重新计算曲线最大最小值
106 |     {
107 |         Ymin=3.4028235e38f;
108 |         Ymax=1.4e-45f;
109 |         for(int i=0;i<Channel_number;i++)
110 |         {
111 |            //数据量超过窗口长度
112 |            int pointssize=m_series[i].pointsVector().size();
113 |            if(pointssize>XSize)
114 |            {
115 |                for(int j=pointssize-XSize;j<pointssize;j++)
116 |                {
117 |                    if(m_series[i].pointsVector().at(j).y()>Ymax)
118 |                        Ymax=m_series[i].pointsVector().at(j).y();
119 |                    if(m_series[i].pointsVector().at(j).y()<Ymin)
120 |                        Ymin=m_series[i].pointsVector().at(j).y();
121 |                }
122 |            }
123 |            else//数据量不足窗口长度
124 |            {
125 |                for(int j=0;j<pointssize;j++)
126 |                {
127 |                    if(m_series[i].pointsVector().at(j).y()>Ymax)
128 |                        Ymax=m_series[i].pointsVector().at(j).y();
129 |                    if(m_series[i].pointsVector().at(j).y()<Ymin)
130 |                        Ymin=m_series[i].pointsVector().at(j).y();
131 |                }
132 |            }
133 |         }
134 |         //重新设置坐标轴（窗口）显示范围
135 |         if(ui->checkBoxXAuto->isChecked())
136 |             axisX->setRange(Xmin,Xmax);
137 |         if(ui->checkBoxYAuto->isChecked())
138 |             axisY->setRange(Ymin,Ymax);
139 |     }
140 | }
141 | 
142 | void MainWindow::on_btn_OpenSerial_clicked()
143 | {
144 |     if(SerialSta)
145 |     {
146 |         port->close();
147 |         lb_StatusBar_SerialStatus->setText("串口状态：已关闭");
148 |         ui->btn_OpenSerial->setText("打开串口");
149 |         //ui->labelstatu->setStyleSheet("border-image: url(:/new/img/red.png);");
150 |         SerialSta=false;
151 |     }
152 |     else
153 |     {
154 | #ifdef Q_OS_WIN
155 |         port->setPortName(ui->cb_SerialPort->currentText());
156 | #else
157 |         port->setPortName("/dev/"+ui->cb_SerialPort->currentText());
158 | #endif
159 |         port->setBaudRate(ui->cb_baudRate->currentText().toInt());
160 |         port->setDataBits(QSerialPort::Data8);
161 |         if(port->open(QIODevice::ReadWrite))
162 |         {
163 |             processor.clear();
164 |             lb_StatusBar_SerialStatus->setText("串口状态：已开启");
165 |             ui->btn_OpenSerial->setText("关闭串口");
166 |             //ui->labelstatu->setStyleSheet("border-image: url(:/new/img/lv.png);");
167 |             SerialSta=true;
168 |         }
169 |         else
170 |         {
171 |             SerialSta=false;
172 |             QMessageBox::information(this,"提示","串口打开失败",QMessageBox::Ok);
173 |             //ui->labelstatu->setStyleSheet("border-image: url(:/new/img/red.png);");
174 |         }
175 |     }
176 | }
177 | 
178 | void MainWindow::on_btn_help_clicked()
179 | {
180 |     QString strtext="1.串口通讯格式：1起始位，1停止位，8数据位，无校验位。\n"
181 |                     "2.数据组织形式：\"QTSO\"+通道数(int32)+各通道数据(float)\n"
182 |                     "   参考本项目代码以及提供的STM32单片机配套代码。\n"
183 |                     "3.缩放方式：按下左键选中区域放大，右键单击区域缩小。\n"
184 |                     "4.数据保存格式：***.csv\n"
185 |                     "5.Linux系统非root用户会无法打开串口，解决方案如下：\n"
186 |                     "   打开串口前在终端输入：sudo chmod 666 /dev/*\n"
187 |                     "   *号为串口号，回车后输入计算机用户密码，再回车。\n";
188 |     QMessageBox::information(this, "帮助信息", strtext, QMessageBox::Ok);
189 | }
190 | 
191 | void MainWindow::on_btn_StopDis_clicked()
192 | {
193 |     if(chartSta==false)
194 |     {
195 |         processor.clear();
196 |         chartSta=true;
197 |         ui->btn_StopDis->setText("暂停更新");
198 |     }
199 |     else
200 |     {
201 |         chartSta=false;
202 |         ui->btn_StopDis->setText("开始更新");
203 |     }
204 | }
205 | 
206 | void MainWindow::on_action_save_triggered()
207 | {
208 |     QString filename;
209 |     filename = QFileDialog::getSaveFileName(this,tr("保存文件"),"",tr("text(*.csv)"));
210 |     if(filename.isEmpty())
211 |         return;
212 |     QFile file(filename);
213 |     if(!file.open(QFile::WriteOnly|QFile::Text))
214 |     {
215 |         QMessageBox::warning(this,tr("Error"),tr("Read file error:%1!").arg(file.errorString()));
216 |         return ;
217 |     }
218 | 
219 |     QTextStream write(&file);
220 |     write<<writeDataToCSV();
221 |     file.close();
222 | 
223 | }
224 | 
225 | void MainWindow::on_action_load_triggered()
226 | {
227 |     QString filename;
228 |     filename = QFileDialog::getOpenFileName(this,tr("载入文件"),"",tr("text(*.csv)"));
229 |     if(filename.isEmpty())
230 |         return;
231 |     QFile file(filename);
232 |     if(!file.open(QFile::ReadOnly|QFile::Text))
233 |     {
234 |         QMessageBox::warning(this,tr("Error"),tr("Read file error:%1!").arg(file.errorString()));
235 |         return ;
236 |     }
237 | 
238 |     QTextStream read(&file);
239 |     readDataFromCSV(read);
240 |     file.close();
241 | }
242 | 
243 | QString MainWindow::writeDataToCSV()
244 | {
245 |     for(int i=0;i<Channel_number;i++)//得到当前曲线points
246 |     {
247 |        points[i] = m_series[i].pointsVector();
248 |     }
249 |     QString sDataStr;
250 |     for(int i=0;i<Channel_number;i++)//得到当前曲线points
251 |     {
252 |        sDataStr.append(QString("CH%1:").arg(i));
253 |        QVector<QPointF>::iterator iter;
254 |        for(iter=points[i].begin();iter!=points[i].end();iter++)
255 |        {
256 |          sDataStr.append(QString(",%1").arg(iter->y()));
257 |        }
258 |        sDataStr.append("\n");
259 |     }
260 | 
261 |     return sDataStr;
262 | }
263 | //此函数代码来自SACsvStream
264 | int advplain(const QString &s, QString &fld, int i)
265 | {
266 |     int j;
267 |     j = s.indexOf(',', i); // 查找,
268 |     if (j < 0) // 没找到
269 |         j = s.length();
270 |     fld = s.mid (i,j-i);//提取内容
271 |     return j;
272 | }
273 | //此函数中部分代码来自SACsvStream
274 | void MainWindow::readDataFromCSV(QTextStream &sDataStream)
275 | {
276 | 
277 |     QString sline[10];
278 |     QString tempValue;
279 |     int mmax=0;
280 |     float ymin=3.4028235e38f;
281 |     float ymax=1.4e-45f;
282 |     for(int i=0;i<Channel_number;i++)//得到当前曲线points
283 |     {
284 |         int xmax=0;
285 |         points[i].clear();
286 |         sline[i]=sDataStream.readLine();
287 |         if(sline[i].size()<6)
288 |             continue;
289 |         sline[i]=sline[i].mid(5);
290 |         int k=0, j=0;
291 |         do {
292 |             j = advplain(sline[i], tempValue, k);
293 |             points[i].append(QPointF(xmax++,tempValue.toDouble()));
294 |             if(tempValue.toFloat()>ymax)
295 |                 ymax=tempValue.toFloat();
296 |             if(tempValue.toFloat()<ymin)
297 |                 ymin=tempValue.toFloat();
298 |             tempValue.clear();
299 |             k = j + 1;
300 |         } while (j < sline[i].length());
301 |         if(xmax>mmax)
302 |             mmax=xmax;
303 |     }
304 |     for(int i=0;i<Channel_number;i++)
305 |     {
306 |        m_series[i].replace(points[i]);
307 |     }
308 |     Xmax=mmax;
309 |     if(mmax>200)
310 |         Xmin=mmax-200;
311 |     else
312 |         Xmin=0;
313 |     axisX->setRange(0,mmax);
314 |     axisY->setRange(ymin,ymax);
315 | }
316 | 
317 | void MainWindow::on_btn_ClearSeries_clicked()
318 | {
319 |     for(int i=0;i<Channel_number;i++)
320 |     {
321 |        points[i].clear();
322 |        m_series[i].replace(points[i]);
323 |     }
324 |     Xmin=0;
325 |     Xmax=0;
326 |     Ymin=3.4028235e38f;
327 |     Ymax=1.4e-45f;
328 |     axisX->setRange(0,1);
329 |     axisY->setRange(0,1);
330 | }
331 | 
332 | void MainWindow::on_btn_SetXSize_clicked()
333 | {
334 |     int xsize=0;
335 |     XSize=ui->leXSize->text().toInt();
336 | 
337 | }
338 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                     GNU GENERAL PUBLIC LICENSE
  2 |                        Version 2, June 1991
  3 | 
  4 |  Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
  5 |  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  6 |  Everyone is permitted to copy and distribute verbatim copies
  7 |  of this license document, but changing it is not allowed.
  8 | 
  9 |                             Preamble
 10 | 
 11 |   The licenses for most software are designed to take away your
 12 | freedom to share and change it.  By contrast, the GNU General Public
 13 | License is intended to guarantee your freedom to share and change free
 14 | software--to make sure the software is free for all its users.  This
 15 | General Public License applies to most of the Free Software
 16 | Foundation's software and to any other program whose authors commit to
 17 | using it.  (Some other Free Software Foundation software is covered by
 18 | the GNU Lesser General Public License instead.)  You can apply it to
 19 | your programs, too.
 20 | 
 21 |   When we speak of free software, we are referring to freedom, not
 22 | price.  Our General Public Licenses are designed to make sure that you
 23 | have the freedom to distribute copies of free software (and charge for
 24 | this service if you wish), that you receive source code or can get it
 25 | if you want it, that you can change the software or use pieces of it
 26 | in new free programs; and that you know you can do these things.
 27 | 
 28 |   To protect your rights, we need to make restrictions that forbid
 29 | anyone to deny you these rights or to ask you to surrender the rights.
 30 | These restrictions translate to certain responsibilities for you if you
 31 | distribute copies of the software, or if you modify it.
 32 | 
 33 |   For example, if you distribute copies of such a program, whether
 34 | gratis or for a fee, you must give the recipients all the rights that
 35 | you have.  You must make sure that they, too, receive or can get the
 36 | source code.  And you must show them these terms so they know their
 37 | rights.
 38 | 
 39 |   We protect your rights with two steps: (1) copyright the software, and
 40 | (2) offer you this license which gives you legal permission to copy,
 41 | distribute and/or modify the software.
 42 | 
 43 |   Also, for each author's protection and ours, we want to make certain
 44 | that everyone understands that there is no warranty for this free
 45 | software.  If the software is modified by someone else and passed on, we
 46 | want its recipients to know that what they have is not the original, so
 47 | that any problems introduced by others will not reflect on the original
 48 | authors' reputations.
 49 | 
 50 |   Finally, any free program is threatened constantly by software
 51 | patents.  We wish to avoid the danger that redistributors of a free
 52 | program will individually obtain patent licenses, in effect making the
 53 | program proprietary.  To prevent this, we have made it clear that any
 54 | patent must be licensed for everyone's free use or not licensed at all.
 55 | 
 56 |   The precise terms and conditions for copying, distribution and
 57 | modification follow.
 58 | 
 59 |                     GNU GENERAL PUBLIC LICENSE
 60 |    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
 61 | 
 62 |   0. This License applies to any program or other work which contains
 63 | a notice placed by the copyright holder saying it may be distributed
 64 | under the terms of this General Public License.  The "Program", below,
 65 | refers to any such program or work, and a "work based on the Program"
 66 | means either the Program or any derivative work under copyright law:
 67 | that is to say, a work containing the Program or a portion of it,
 68 | either verbatim or with modifications and/or translated into another
 69 | language.  (Hereinafter, translation is included without limitation in
 70 | the term "modification".)  Each licensee is addressed as "you".
 71 | 
 72 | Activities other than copying, distribution and modification are not
 73 | covered by this License; they are outside its scope.  The act of
 74 | running the Program is not restricted, and the output from the Program
 75 | is covered only if its contents constitute a work based on the
 76 | Program (independent of having been made by running the Program).
 77 | Whether that is true depends on what the Program does.
 78 | 
 79 |   1. You may copy and distribute verbatim copies of the Program's
 80 | source code as you receive it, in any medium, provided that you
 81 | conspicuously and appropriately publish on each copy an appropriate
 82 | copyright notice and disclaimer of warranty; keep intact all the
 83 | notices that refer to this License and to the absence of any warranty;
 84 | and give any other recipients of the Program a copy of this License
 85 | along with the Program.
 86 | 
 87 | You may charge a fee for the physical act of transferring a copy, and
 88 | you may at your option offer warranty protection in exchange for a fee.
 89 | 
 90 |   2. You may modify your copy or copies of the Program or any portion
 91 | of it, thus forming a work based on the Program, and copy and
 92 | distribute such modifications or work under the terms of Section 1
 93 | above, provided that you also meet all of these conditions:
 94 | 
 95 |     a) You must cause the modified files to carry prominent notices
 96 |     stating that you changed the files and the date of any change.
 97 | 
 98 |     b) You must cause any work that you distribute or publish, that in
 99 |     whole or in part contains or is derived from the Program or any
100 |     part thereof, to be licensed as a whole at no charge to all third
101 |     parties under the terms of this License.
102 | 
103 |     c) If the modified program normally reads commands interactively
104 |     when run, you must cause it, when started running for such
105 |     interactive use in the most ordinary way, to print or display an
106 |     announcement including an appropriate copyright notice and a
107 |     notice that there is no warranty (or else, saying that you provide
108 |     a warranty) and that users may redistribute the program under
109 |     these conditions, and telling the user how to view a copy of this
110 |     License.  (Exception: if the Program itself is interactive but
111 |     does not normally print such an announcement, your work based on
112 |     the Program is not required to print an announcement.)
113 | 
114 | These requirements apply to the modified work as a whole.  If
115 | identifiable sections of that work are not derived from the Program,
116 | and can be reasonably considered independent and separate works in
117 | themselves, then this License, and its terms, do not apply to those
118 | sections when you distribute them as separate works.  But when you
119 | distribute the same sections as part of a whole which is a work based
120 | on the Program, the distribution of the whole must be on the terms of
121 | this License, whose permissions for other licensees extend to the
122 | entire whole, and thus to each and every part regardless of who wrote it.
123 | 
124 | Thus, it is not the intent of this section to claim rights or contest
125 | your rights to work written entirely by you; rather, the intent is to
126 | exercise the right to control the distribution of derivative or
127 | collective works based on the Program.
128 | 
129 | In addition, mere aggregation of another work not based on the Program
130 | with the Program (or with a work based on the Program) on a volume of
131 | a storage or distribution medium does not bring the other work under
132 | the scope of this License.
133 | 
134 |   3. You may copy and distribute the Program (or a work based on it,
135 | under Section 2) in object code or executable form under the terms of
136 | Sections 1 and 2 above provided that you also do one of the following:
137 | 
138 |     a) Accompany it with the complete corresponding machine-readable
139 |     source code, which must be distributed under the terms of Sections
140 |     1 and 2 above on a medium customarily used for software interchange; or,
141 | 
142 |     b) Accompany it with a written offer, valid for at least three
143 |     years, to give any third party, for a charge no more than your
144 |     cost of physically performing source distribution, a complete
145 |     machine-readable copy of the corresponding source code, to be
146 |     distributed under the terms of Sections 1 and 2 above on a medium
147 |     customarily used for software interchange; or,
148 | 
149 |     c) Accompany it with the information you received as to the offer
150 |     to distribute corresponding source code.  (This alternative is
151 |     allowed only for noncommercial distribution and only if you
152 |     received the program in object code or executable form with such
153 |     an offer, in accord with Subsection b above.)
154 | 
155 | The source code for a work means the preferred form of the work for
156 | making modifications to it.  For an executable work, complete source
157 | code means all the source code for all modules it contains, plus any
158 | associated interface definition files, plus the scripts used to
159 | control compilation and installation of the executable.  However, as a
160 | special exception, the source code distributed need not include
161 | anything that is normally distributed (in either source or binary
162 | form) with the major components (compiler, kernel, and so on) of the
163 | operating system on which the executable runs, unless that component
164 | itself accompanies the executable.
165 | 
166 | If distribution of executable or object code is made by offering
167 | access to copy from a designated place, then offering equivalent
168 | access to copy the source code from the same place counts as
169 | distribution of the source code, even though third parties are not
170 | compelled to copy the source along with the object code.
171 | 
172 |   4. You may not copy, modify, sublicense, or distribute the Program
173 | except as expressly provided under this License.  Any attempt
174 | otherwise to copy, modify, sublicense or distribute the Program is
175 | void, and will automatically terminate your rights under this License.
176 | However, parties who have received copies, or rights, from you under
177 | this License will not have their licenses terminated so long as such
178 | parties remain in full compliance.
179 | 
180 |   5. You are not required to accept this License, since you have not
181 | signed it.  However, nothing else grants you permission to modify or
182 | distribute the Program or its derivative works.  These actions are
183 | prohibited by law if you do not accept this License.  Therefore, by
184 | modifying or distributing the Program (or any work based on the
185 | Program), you indicate your acceptance of this License to do so, and
186 | all its terms and conditions for copying, distributing or modifying
187 | the Program or works based on it.
188 | 
189 |   6. Each time you redistribute the Program (or any work based on the
190 | Program), the recipient automatically receives a license from the
191 | original licensor to copy, distribute or modify the Program subject to
192 | these terms and conditions.  You may not impose any further
193 | restrictions on the recipients' exercise of the rights granted herein.
194 | You are not responsible for enforcing compliance by third parties to
195 | this License.
196 | 
197 |   7. If, as a consequence of a court judgment or allegation of patent
198 | infringement or for any other reason (not limited to patent issues),
199 | conditions are imposed on you (whether by court order, agreement or
200 | otherwise) that contradict the conditions of this License, they do not
201 | excuse you from the conditions of this License.  If you cannot
202 | distribute so as to satisfy simultaneously your obligations under this
203 | License and any other pertinent obligations, then as a consequence you
204 | may not distribute the Program at all.  For example, if a patent
205 | license would not permit royalty-free redistribution of the Program by
206 | all those who receive copies directly or indirectly through you, then
207 | the only way you could satisfy both it and this License would be to
208 | refrain entirely from distribution of the Program.
209 | 
210 | If any portion of this section is held invalid or unenforceable under
211 | any particular circumstance, the balance of the section is intended to
212 | apply and the section as a whole is intended to apply in other
213 | circumstances.
214 | 
215 | It is not the purpose of this section to induce you to infringe any
216 | patents or other property right claims or to contest validity of any
217 | such claims; this section has the sole purpose of protecting the
218 | integrity of the free software distribution system, which is
219 | implemented by public license practices.  Many people have made
220 | generous contributions to the wide range of software distributed
221 | through that system in reliance on consistent application of that
222 | system; it is up to the author/donor to decide if he or she is willing
223 | to distribute software through any other system and a licensee cannot
224 | impose that choice.
225 | 
226 | This section is intended to make thoroughly clear what is believed to
227 | be a consequence of the rest of this License.
228 | 
229 |   8. If the distribution and/or use of the Program is restricted in
230 | certain countries either by patents or by copyrighted interfaces, the
231 | original copyright holder who places the Program under this License
232 | may add an explicit geographical distribution limitation excluding
233 | those countries, so that distribution is permitted only in or among
234 | countries not thus excluded.  In such case, this License incorporates
235 | the limitation as if written in the body of this License.
236 | 
237 |   9. The Free Software Foundation may publish revised and/or new versions
238 | of the General Public License from time to time.  Such new versions will
239 | be similar in spirit to the present version, but may differ in detail to
240 | address new problems or concerns.
241 | 
242 | Each version is given a distinguishing version number.  If the Program
243 | specifies a version number of this License which applies to it and "any
244 | later version", you have the option of following the terms and conditions
245 | either of that version or of any later version published by the Free
246 | Software Foundation.  If the Program does not specify a version number of
247 | this License, you may choose any version ever published by the Free Software
248 | Foundation.
249 | 
250 |   10. If you wish to incorporate parts of the Program into other free
251 | programs whose distribution conditions are different, write to the author
252 | to ask for permission.  For software which is copyrighted by the Free
253 | Software Foundation, write to the Free Software Foundation; we sometimes
254 | make exceptions for this.  Our decision will be guided by the two goals
255 | of preserving the free status of all derivatives of our free software and
256 | of promoting the sharing and reuse of software generally.
257 | 
258 |                             NO WARRANTY
259 | 
260 |   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
261 | FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
262 | OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
263 | PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
264 | OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
265 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
266 | TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
267 | PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
268 | REPAIR OR CORRECTION.
269 | 
270 |   12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
271 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
272 | REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
273 | INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
274 | OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
275 | TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
276 | YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
277 | PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
278 | POSSIBILITY OF SUCH DAMAGES.
279 | 
280 |                      END OF TERMS AND CONDITIONS
281 | 
282 |             How to Apply These Terms to Your New Programs
283 | 
284 |   If you develop a new program, and you want it to be of the greatest
285 | possible use to the public, the best way to achieve this is to make it
286 | free software which everyone can redistribute and change under these terms.
287 | 
288 |   To do so, attach the following notices to the program.  It is safest
289 | to attach them to the start of each source file to most effectively
290 | convey the exclusion of warranty; and each file should have at least
291 | the "copyright" line and a pointer to where the full notice is found.
292 | 
293 |     <one line to give the program's name and a brief idea of what it does.>
294 |     Copyright (C) <year>  <name of author>
295 | 
296 |     This program is free software; you can redistribute it and/or modify
297 |     it under the terms of the GNU General Public License as published by
298 |     the Free Software Foundation; either version 2 of the License, or
299 |     (at your option) any later version.
300 | 
301 |     This program is distributed in the hope that it will be useful,
302 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
303 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
304 |     GNU General Public License for more details.
305 | 
306 |     You should have received a copy of the GNU General Public License along
307 |     with this program; if not, write to the Free Software Foundation, Inc.,
308 |     51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
309 | 
310 | Also add information on how to contact you by electronic and paper mail.
311 | 
312 | If the program is interactive, make it output a short notice like this
313 | when it starts in an interactive mode:
314 | 
315 |     Gnomovision version 69, Copyright (C) year name of author
316 |     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
317 |     This is free software, and you are welcome to redistribute it
318 |     under certain conditions; type `show c' for details.
319 | 
320 | The hypothetical commands `show w' and `show c' should show the appropriate
321 | parts of the General Public License.  Of course, the commands you use may
322 | be called something other than `show w' and `show c'; they could even be
323 | mouse-clicks or menu items--whatever suits your program.
324 | 
325 | You should also get your employer (if you work as a programmer) or your
326 | school, if any, to sign a "copyright disclaimer" for the program, if
327 | necessary.  Here is a sample; alter the names:
328 | 
329 |   Yoyodyne, Inc., hereby disclaims all copyright interest in the program
330 |   `Gnomovision' (which makes passes at compilers) written by James Hacker.
331 | 
332 |   <signature of Ty Coon>, 1 April 1989
333 |   Ty Coon, President of Vice
334 | 
335 | This General Public License does not permit incorporating your program into
336 | proprietary programs.  If your program is a subroutine library, you may
337 | consider it more useful to permit linking proprietary applications with the
338 | library.  If this is what you want to do, use the GNU Lesser General
339 | Public License instead of this License.
340 | 


--------------------------------------------------------------------------------