1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
/*
License...
*/
#include "serialportinfo.h"
#include "serialportinfo_p.h"
#include "serialport.h"
QT_USE_NAMESPACE
/*!
\class SerialPortInfo
\brief The SerialPortInfo class gives access to information about
existing serial ports.
\ingroup serial
\inmodule QSerialDevice
Use the static functions to generate a list of SerialPortInfo objects.
Each SerialPortInfo object in the list represents a single serial port
and can be queried for port name, system location, description,
manufacturer. SerialPortInfo also be used as an input parameter to
the method setPort() a class SerialPort.
Algorithm for obtaining information on the serial ports is platform
specific and very different for individual platforms. The more so that
the information about same device (serial port) obtained on the current
platform may not correspond to the information received on a different
platform. For example, names of ports and their systemic location, of
course, different for different platforms. Also such parameters as a
string description and manufacturer may vary.
So, the details of the semantics of information and its sources
for a variety of platforms is presented below.
\section1 Port name
Is the name of the device in a shorter form, which is usually represented
in the interface of the OS for human beings.
\sa SerialPort
*/
/* Public methods */
/*!
Constructs an empty SerialPortInfo object.
\sa isNull()
*/
SerialPortInfo::SerialPortInfo()
: d_ptr(new SerialPortInfoPrivate)
{
}
/*!
Constructs a copy of \a other.
*/
SerialPortInfo::SerialPortInfo(const SerialPortInfo &other)
: d_ptr(other.d_ptr ? new SerialPortInfoPrivate(*other.d_ptr) : 0)
{
}
/*!
Constructs a SerialPortInfo object from serial \a port.
*/
SerialPortInfo::SerialPortInfo(const SerialPort &port)
: d_ptr(new SerialPortInfoPrivate)
{
foreach(const SerialPortInfo &info, availablePorts()) {
if (port.portName() == info.portName()) {
*this = info;
break;
}
}
}
/*!
Constructs a SerialPortInfo object from serial port \a name.
...
*/
SerialPortInfo::SerialPortInfo(const QString &name)
: d_ptr(new SerialPortInfoPrivate)
{
foreach(const SerialPortInfo &info, availablePorts()) {
if (name == info.portName()) {
*this = info;
break;
}
}
}
/*!
Destroys the SerialPortInfo object. References to the values in the
object become invalid.
*/
SerialPortInfo::~SerialPortInfo()
{
}
/*!
Bla bla \a other
*/
void SerialPortInfo::swap(SerialPortInfo &other)
{
d_ptr.swap(other.d_ptr);
}
/*!
Bla bla \a other
*/
SerialPortInfo& SerialPortInfo::operator=(const SerialPortInfo &other)
{
SerialPortInfo(other).swap(*this);
return *this;
}
/*!
Returns the name of the serial port.
*/
QString SerialPortInfo::portName() const
{
Q_D(const SerialPortInfo);
return !d ? QString() : d->portName;
}
/*!
Returns the system location of the serial port.
*/
QString SerialPortInfo::systemLocation() const
{
Q_D(const SerialPortInfo);
return !d ? QString() : d->device;
}
/*!
Returns the description of the serial port,
if available.
*/
QString SerialPortInfo::description() const
{
Q_D(const SerialPortInfo);
return !d ? QString() : d->description;
}
/*!
Returns the manufacturer of the serial port,
if available.
*/
QString SerialPortInfo::manufacturer() const
{
Q_D(const SerialPortInfo);
return !d ? QString() : d->manufacturer;
}
/*!
\fn bool SerialPortInfo::isNull() const
Returns whether this SerialPortInfo object holds a
serial port definition.
*/
/*!
\fn bool SerialPortInfo::isBusy() const
Returns true if serial port is busy;
otherwise false.
*/
/*!
\fn bool SerialPortInfo::isValid() const
Returns true if serial port is present on system;
otherwise false.
*/
/*!
\fn QList<qint32> SerialPortInfo::standardRates() const
Returns a list of available standard baud rates supported by
the current serial port.
*/
/*!
\fn QList<SerialPortInfo> SerialPortInfo::availablePorts()
Returns a list of available serial ports on the system.
*/
|
