/* * 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, as they primarily wrap pointers to callbacks. * 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; InputHostBase(const InputHostBase& rhs) = delete; InputHostBase(InputHostBase&& rhs) = delete; input_host_t* mHost; input_host_callbacks_t mCallbacks; }; class InputReport : private InputHostBase { public: InputReport(input_host_t* host, input_host_callbacks_t cb, input_report_t* r) : InputHostBase(host, cb), mReport(r) {} virtual ~InputReport() = default; virtual void setIntUsage(InputCollectionId id, InputUsage usage, int32_t value, int32_t arityIndex); virtual void setBoolUsage(InputCollectionId id, InputUsage usage, bool value, int32_t arityIndex); virtual void reportEvent(InputDeviceHandle* d); operator input_report_t*() const { return mReport; } InputReport(const InputReport& rhs) = delete; InputReport& operator=(const InputReport& rhs) = delete; private: input_report_t* mReport; }; class InputReportDefinition : private InputHostBase { public: InputReportDefinition(input_host_t* host, input_host_callbacks_t cb, input_report_definition_t* r) : InputHostBase(host, cb), mReportDefinition(r) {} virtual ~InputReportDefinition() = default; virtual void addCollection(InputCollectionId id, int32_t arity); virtual void declareUsage(InputCollectionId id, InputUsage usage, int32_t min, int32_t max, float resolution); virtual void declareUsages(InputCollectionId id, InputUsage* usage, size_t usageCount); virtual InputReport* allocateReport(); operator input_report_definition_t*() { return mReportDefinition; } InputReportDefinition(const InputReportDefinition& rhs) = delete; InputReportDefinition& operator=(const InputReportDefinition& rhs) = delete; private: input_report_definition_t* mReportDefinition; }; class InputDeviceDefinition : private InputHostBase { public: InputDeviceDefinition(input_host_t* host, input_host_callbacks_t cb, input_device_definition_t* d) : InputHostBase(host, cb), mDeviceDefinition(d) {} virtual ~InputDeviceDefinition() = default; virtual void addReport(InputReportDefinition* r); operator input_device_definition_t*() { return mDeviceDefinition; } InputDeviceDefinition(const InputDeviceDefinition& rhs) = delete; InputDeviceDefinition& operator=(const InputDeviceDefinition& rhs) = delete; private: input_device_definition_t* mDeviceDefinition; }; class InputProperty : private InputHostBase { public: virtual ~InputProperty() = default; InputProperty(input_host_t* host, input_host_callbacks_t cb, input_property_t* p) : InputHostBase(host, cb), mProperty(p) {} virtual const char* getKey() const; virtual const char* getValue() const; operator input_property_t*() { return mProperty; } InputProperty(const InputProperty& rhs) = delete; InputProperty& operator=(const InputProperty& rhs) = delete; private: input_property_t* mProperty; }; class InputPropertyMap : private InputHostBase { public: virtual ~InputPropertyMap() = default; InputPropertyMap(input_host_t* host, input_host_callbacks_t cb, input_property_map_t* m) : InputHostBase(host, cb), mMap(m) {} virtual InputProperty* getDeviceProperty(const char* key) const; virtual void freeDeviceProperty(InputProperty* property) const; operator input_property_map_t*() { return mMap; } InputPropertyMap(const InputPropertyMap& rhs) = delete; InputPropertyMap& operator=(const InputPropertyMap& rhs) = delete; private: input_property_map_t* mMap; }; class InputHostInterface { public: virtual ~InputHostInterface() = default; virtual InputDeviceIdentifier* createDeviceIdentifier(const char* name, int32_t productId, int32_t vendorId, InputBus bus, const char* uniqueId) = 0; virtual InputDeviceDefinition* createDeviceDefinition() = 0; virtual InputReportDefinition* createInputReportDefinition() = 0; virtual InputReportDefinition* createOutputReportDefinition() = 0; virtual void freeReportDefinition(InputReportDefinition* reportDef) = 0; virtual InputDeviceHandle* registerDevice(InputDeviceIdentifier* id, InputDeviceDefinition* d) = 0; virtual void unregisterDevice(InputDeviceHandle* handle) = 0; virtual InputPropertyMap* getDevicePropertyMap(InputDeviceIdentifier* id) = 0; virtual void freeDevicePropertyMap(InputPropertyMap* propertyMap) = 0; }; class InputHost : public InputHostInterface, private InputHostBase { public: InputHost(input_host_t* host, input_host_callbacks_t cb) : InputHostBase(host, cb) {} virtual ~InputHost() = default; InputDeviceIdentifier* createDeviceIdentifier(const char* name, int32_t productId, int32_t vendorId, InputBus bus, const char* uniqueId) override; InputDeviceDefinition* createDeviceDefinition() override; InputReportDefinition* createInputReportDefinition() override; InputReportDefinition* createOutputReportDefinition() override; virtual void freeReportDefinition(InputReportDefinition* reportDef) override; InputDeviceHandle* registerDevice(InputDeviceIdentifier* id, InputDeviceDefinition* d) override; void unregisterDevice(InputDeviceHandle* handle) override; InputPropertyMap* getDevicePropertyMap(InputDeviceIdentifier* id) override; void freeDevicePropertyMap(InputPropertyMap* propertyMap) override; InputHost(const InputHost& rhs) = delete; InputHost& operator=(const InputHost& rhs) = delete; }; } // namespace android #endif // ANDROID_INPUT_HOST_H_