/
alssensor_i.h
119 lines (98 loc) · 3.16 KB
/
alssensor_i.h
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
/**
@file alssensor_i.h
@brief Interface for ALSSensor
<p>
Copyright (C) 2009-2010 Nokia Corporation
@author Timo Rongas <ext-timo.2.rongas@nokia.com>
@author Antti Virtanen <antti.i.virtanen@nokia.com>
This file is part of Sensord.
Sensord is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License
version 2.1 as published by the Free Software Foundation.
Sensord is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with Sensord. If not, see <http://www.gnu.org/licenses/>.
</p>
*/
#ifndef ALSSENSOR_I_H
#define ALSSENSOR_I_H
#include <QtDBus/QtDBus>
#include "datatypes/unsigned.h"
#include "abstractsensor_i.h"
/**
* Client interface for accessing ambient light sensor.
* Provides signal on change of measured ambient light intensity level.
* Previous measured intensity level can be queried any time. Provided
* values are in \e lux.
*/
class ALSSensorChannelInterface : public AbstractSensorChannelInterface
{
Q_OBJECT
Q_DISABLE_COPY(ALSSensorChannelInterface)
Q_PROPERTY(Unsigned lux READ lux)
public:
/**
* Name of the D-Bus interface for this class.
*/
static const char* staticInterfaceName;
/**
* Create new instance of the class.
*
* @param id Sensor ID.
* @param sessionId Session ID.
* @return Pointer to new instance of the class.
*/
static AbstractSensorChannelInterface* factoryMethod(const QString& id, int sessionId);
/**
* Get latest ambient light reading from sensor daemon.
*
* @return ambient light reading.
*/
Unsigned lux();
/**
* Constructor.
*
* @param path path.
* @param sessionId session ID.
*/
ALSSensorChannelInterface(const QString& path, int sessionId);
/**
* Request a listening interface to the sensor.
*
* @param id sensor ID.
* @return Pointer to interface, or NULL on failure.
* @deprecated use interface(const QString&) instead.
*/
static const ALSSensorChannelInterface* listenInterface(const QString& id);
/**
* Request a control interface to the sensor.
*
* @param id sensor ID.
* @return Pointer to interface, or NULL on failure.
* @deprecated use interface(const QString&) instead.
*/
static ALSSensorChannelInterface* controlInterface(const QString& id);
/**
* Request an interface to the sensor.
*
* @param id sensor ID.
* @return Pointer to interface, or NULL on failure.
*/
static ALSSensorChannelInterface* interface(const QString& id);
protected:
virtual bool dataReceivedImpl();
Q_SIGNALS:
/**
* Sent when measured ambient light intensity has changed.
*
* @param value ambient light reading.
*/
void ALSChanged(const Unsigned& value);
};
namespace local {
typedef ::ALSSensorChannelInterface ALSSensor;
}
#endif