summaryrefslogtreecommitdiffstats
path: root/modules/input/evdev/InputHost.h
blob: 98ce26f54e1db70ff9fe839dd11c7c440e56ab3d (plain)
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
191
192
/*
 * Copyright (C) 2015 The Android Open Source Project
 *
 * 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
 *
 * 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 ANDROID_INPUT_HOST_H_
#define ANDROID_INPUT_HOST_H_

#include <memory>

#include <hardware/input.h>

namespace android {

/**
 * Classes in this file wrap the corresponding interfaces in the Input HAL. They
 * are intended to be lightweight and passed by value. It is still important not
 * to use an object after a HAL-specific method has freed the underlying
 * representation.
 *
 * See hardware/input.h for details about each of these methods.
 */

using InputBus = input_bus_t;
using InputCollectionId = input_collection_id_t;
using InputDeviceHandle = input_device_handle_t*;
using InputDeviceIdentifier = input_device_identifier_t*;
using InputUsage = input_usage_t;

class InputHostBase {
protected:
    InputHostBase(input_host_t* host, input_host_callbacks_t cb) : mHost(host), mCallbacks(cb) {}
    virtual ~InputHostBase() = default;

    input_host_t* mHost;
    input_host_callbacks_t mCallbacks;
};

class InputReport : private InputHostBase {
public:
    virtual ~InputReport() = default;

    InputReport(const InputReport& rhs) = default;
    InputReport& operator=(const InputReport& rhs) = default;
    operator input_report_t*() const { return mReport; }

    void reportEvent(InputDeviceHandle d);

private:
    friend class InputReportDefinition;

    InputReport(input_host_t* host, input_host_callbacks_t cb, input_report_t* r) :
        InputHostBase(host, cb), mReport(r) {}

    input_report_t* mReport;
};

class InputReportDefinition : private InputHostBase {
public:
    virtual ~InputReportDefinition() = default;

    InputReportDefinition(const InputReportDefinition& rhs) = default;
    InputReportDefinition& operator=(const InputReportDefinition& rhs) = default;
    operator input_report_definition_t*() { return mReportDefinition; }

    void addCollection(InputCollectionId id, int32_t arity);
    void declareUsage(InputCollectionId id, InputUsage usage, int32_t min, int32_t max,
            float resolution);
    void declareUsage(InputCollectionId id, InputUsage* usage, size_t usageCount);

    InputReport allocateReport();

private:
    friend class InputHost;

    InputReportDefinition(
            input_host_t* host, input_host_callbacks_t cb, input_report_definition_t* r) :
        InputHostBase(host, cb), mReportDefinition(r) {}

    input_report_definition_t* mReportDefinition;
};

class InputDeviceDefinition : private InputHostBase {
public:
    virtual ~InputDeviceDefinition() = default;

    InputDeviceDefinition(const InputDeviceDefinition& rhs) = default;
    InputDeviceDefinition& operator=(const InputDeviceDefinition& rhs) = default;
    operator input_device_definition_t*() { return mDeviceDefinition; }

    void addReport(InputReportDefinition r);

private:
    friend class InputHost;

    InputDeviceDefinition(
            input_host_t* host, input_host_callbacks_t cb, input_device_definition_t* d) :
        InputHostBase(host, cb), mDeviceDefinition(d) {}

    input_device_definition_t* mDeviceDefinition;
};

class InputProperty : private InputHostBase {
public:
    virtual ~InputProperty();

    operator input_property_t*() { return mProperty; }

    const char* getKey();
    const char* getValue();

    // Default move constructor transfers ownership of the input_property_t
    // pointer.
    InputProperty(InputProperty&& rhs) = default;

    // Prevent copy/assign because of the ownership of the underlying
    // input_property_t pointer.
    InputProperty(const InputProperty& rhs) = delete;
    InputProperty& operator=(const InputProperty& rhs) = delete;

private:
    friend class InputPropertyMap;

    InputProperty(
            input_host_t* host, input_host_callbacks_t cb, input_property_t* p) :
        InputHostBase(host, cb), mProperty(p) {}

    input_property_t* mProperty;
};

class InputPropertyMap : private InputHostBase {
public:
    virtual ~InputPropertyMap();

    operator input_property_map_t*() { return mMap; }

    InputProperty getDeviceProperty(const char* key);

    // Default move constructor transfers ownership of the input_property_map_t
    // pointer.
    InputPropertyMap(InputPropertyMap&& rhs) = default;

    // Prevent copy/assign because of the ownership of the underlying
    // input_property_map_t pointer.
    InputPropertyMap(const InputPropertyMap& rhs) = delete;
    InputPropertyMap& operator=(const InputPropertyMap& rhs) = delete;

private:
    friend class InputHost;

    InputPropertyMap(
            input_host_t* host, input_host_callbacks_t cb, input_property_map_t* m) :
        InputHostBase(host, cb), mMap(m) {}

    input_property_map_t* mMap;
};

class InputHost : private InputHostBase {
public:
    InputHost(input_host_t* host, input_host_callbacks_t cb) : InputHostBase(host, cb) {}
    virtual ~InputHost() = default;

    InputHost(const InputHost& rhs) = default;
    InputHost& operator=(const InputHost& rhs) = default;

    InputDeviceIdentifier createDeviceIdentifier(const char* name, int32_t productId,
            int32_t vendorId, InputBus bus, const char* uniqueId);

    InputDeviceDefinition createDeviceDefinition();
    InputReportDefinition createInputReportDefinition();
    InputReportDefinition createOutputReportDefinition();

    InputDeviceHandle registerDevice(InputDeviceIdentifier id, InputDeviceDefinition d);
    void unregisterDevice(InputDeviceHandle handle);

    InputPropertyMap getDevicePropertyMap(InputDeviceIdentifier id);
};

}  // namespace android

#endif  // ANDROID_INPUT_HOST_H_