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
|
/*
Q Light Controller
hiddevice.h
Copyright (c) Heikki Junnila
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0.txt
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
#ifndef HIDDEVICE_H
#define HIDDEVICE_H
#include <QThread>
#include <QFile>
class HIDPlugin;
/*****************************************************************************
* HIDDevice
*****************************************************************************/
class HIDDevice : public QThread
{
Q_OBJECT
public:
HIDDevice(HIDPlugin* parent, quint32 line, const QString& name, const QString& path);
virtual ~HIDDevice();
/*************************************************************************
* File operations
*************************************************************************/
public:
/**
* Check if the device offers a built-in merger mode.
*
* Merger mode means that all DMX data from the device's input port is
* copied to its output port and - if output from QLC+ is enabled -
* merged with this output in a HTP manner on the device itself.
*
* @return true if the device offers a merger mode, false otherwise
*/
virtual bool hasMergerMode();
/**
* Check if device's built-in merger mode is enabled.
*
* @return true if the device's merger mode is enabled, false otherwise
*/
virtual bool isMergerModeEnabled();
/**
* Enable or disable the built-in merger mode.
*/
virtual void enableMergerMode(bool mergerModeEnabled);
/**
* Attempt to open the HID device as input in RW mode and fall back
* to RO if that fails.
*
* @return true if the file was opened RW/RO
*/
virtual bool openInput();
/**
* Close the HID device's input
*/
virtual void closeInput();
/**
* Open HID device as output
*
*/
virtual bool openOutput();
/**
* Close the HID device's output
*/
virtual void closeOutput();
/**
* Get the full path of this HID device
*/
virtual QString path() const;
/**
* Get the device's file descriptor
*/
virtual int handle() const;
/**
* Read one event and emit it.
*/
virtual bool readEvent() = 0;
protected:
QString m_filename;
QFile m_file;
/*************************************************************************
* Line
*************************************************************************/
public:
quint32 line() const {
return m_line;
}
virtual bool hasInput() { return false; }
virtual bool hasOutput() { return false; }
protected:
quint32 m_line;
int m_capabilities;
/*************************************************************************
* Device info
*************************************************************************/
public:
/**
* Get HID device information string to be used in plugin manager
*/
virtual QString infoText();
/**
* Get the device's name
*/
virtual QString name();
protected:
QString m_name;
/*************************************************************************
* Input data
*************************************************************************/
signals:
/**
* Signal that is emitted when an input channel's value is changed
*
* @param universe The universe where the event happened
* @param line The input line that received the signal
* @param channel The channel whose value has changed
* @param value The changed value
*/
void valueChanged(quint32 universe, quint32 line, quint32 channel, uchar value);
public:
/**
* Send an input value back the HID device to move motorized sliders
* and such.
*/
virtual void feedBack(quint32 channel, uchar value);
protected:
bool m_running;
private:
/** Input data thread worker method */
virtual void run();
/*************************************************************************
* Output data
*************************************************************************/
public:
/** Output data, which is a DMX universe */
virtual void outputDMX(const QByteArray &data, bool forceWrite = false);
};
#endif
|
