1 /* 2 * Copyright (C) 2019 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef _UI_INPUTREADER_INPUT_MAPPER_H 18 #define _UI_INPUTREADER_INPUT_MAPPER_H 19 20 #include "EventHub.h" 21 #include "InputDevice.h" 22 #include "InputListener.h" 23 #include "InputReaderContext.h" 24 #include "StylusState.h" 25 #include "VibrationElement.h" 26 27 namespace android { 28 29 /* An input mapper transforms raw input events into cooked event data. 30 * A single input device can have multiple associated input mappers in order to interpret 31 * different classes of events. 32 * 33 * InputMapper lifecycle: 34 * - create 35 * - configure with 0 changes 36 * - reset 37 * - process, process, process (may occasionally reconfigure with non-zero changes or reset) 38 * - reset 39 * - destroy 40 */ 41 class InputMapper { 42 public: 43 explicit InputMapper(InputDeviceContext& deviceContext); 44 virtual ~InputMapper(); 45 getDeviceId()46 inline int32_t getDeviceId() { return mDeviceContext.getId(); } getDeviceContext()47 inline InputDeviceContext& getDeviceContext() { return mDeviceContext; } getDeviceName()48 inline const std::string getDeviceName() { return mDeviceContext.getName(); } getContext()49 inline InputReaderContext* getContext() { return mDeviceContext.getContext(); } getPolicy()50 inline InputReaderPolicyInterface* getPolicy() { return getContext()->getPolicy(); } getListener()51 inline InputListenerInterface* getListener() { return getContext()->getListener(); } 52 53 virtual uint32_t getSources() = 0; 54 virtual void populateDeviceInfo(InputDeviceInfo* deviceInfo); 55 virtual void dump(std::string& dump); 56 virtual void configure(nsecs_t when, const InputReaderConfiguration* config, uint32_t changes); 57 virtual void reset(nsecs_t when); 58 virtual void process(const RawEvent* rawEvent) = 0; 59 virtual void timeoutExpired(nsecs_t when); 60 61 virtual int32_t getKeyCodeState(uint32_t sourceMask, int32_t keyCode); 62 virtual int32_t getScanCodeState(uint32_t sourceMask, int32_t scanCode); 63 virtual int32_t getSwitchState(uint32_t sourceMask, int32_t switchCode); 64 virtual bool markSupportedKeyCodes(uint32_t sourceMask, size_t numCodes, 65 const int32_t* keyCodes, uint8_t* outFlags); 66 virtual void vibrate(const VibrationSequence& sequence, ssize_t repeat, int32_t token); 67 virtual void cancelVibrate(int32_t token); 68 virtual bool isVibrating(); 69 virtual std::vector<int32_t> getVibratorIds(); 70 virtual void cancelTouch(nsecs_t when, nsecs_t readTime); 71 virtual bool enableSensor(InputDeviceSensorType sensorType, 72 std::chrono::microseconds samplingPeriod, 73 std::chrono::microseconds maxBatchReportLatency); 74 virtual void disableSensor(InputDeviceSensorType sensorType); 75 virtual void flushSensor(InputDeviceSensorType sensorType); 76 getBatteryCapacity()77 virtual std::optional<int32_t> getBatteryCapacity() { return std::nullopt; } getBatteryStatus()78 virtual std::optional<int32_t> getBatteryStatus() { return std::nullopt; } 79 setLightColor(int32_t lightId,int32_t color)80 virtual bool setLightColor(int32_t lightId, int32_t color) { return true; } setLightPlayerId(int32_t lightId,int32_t playerId)81 virtual bool setLightPlayerId(int32_t lightId, int32_t playerId) { return true; } getLightColor(int32_t lightId)82 virtual std::optional<int32_t> getLightColor(int32_t lightId) { return std::nullopt; } getLightPlayerId(int32_t lightId)83 virtual std::optional<int32_t> getLightPlayerId(int32_t lightId) { return std::nullopt; } 84 85 virtual int32_t getMetaState(); 86 virtual void updateMetaState(int32_t keyCode); 87 88 virtual void updateExternalStylusState(const StylusState& state); 89 getAssociatedDisplayId()90 virtual std::optional<int32_t> getAssociatedDisplayId() { return std::nullopt; } updateLedState(bool reset)91 virtual void updateLedState(bool reset) {} 92 93 protected: 94 InputDeviceContext& mDeviceContext; 95 96 status_t getAbsoluteAxisInfo(int32_t axis, RawAbsoluteAxisInfo* axisInfo); 97 void bumpGeneration(); 98 99 static void dumpRawAbsoluteAxisInfo(std::string& dump, const RawAbsoluteAxisInfo& axis, 100 const char* name); 101 static void dumpStylusState(std::string& dump, const StylusState& state); 102 }; 103 104 } // namespace android 105 106 #endif // _UI_INPUTREADER_INPUT_MAPPER_H 107