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 #pragma once 18 19 #include "InputMapper.h" 20 21 namespace android { 22 23 class JoystickInputMapper : public InputMapper { 24 public: 25 template <class T, class... Args> 26 friend std::unique_ptr<T> createInputMapper(InputDeviceContext& deviceContext, 27 const InputReaderConfiguration& readerConfig, 28 Args... args); 29 virtual ~JoystickInputMapper(); 30 31 virtual uint32_t getSources() const override; 32 virtual void populateDeviceInfo(InputDeviceInfo& deviceInfo) override; 33 virtual void dump(std::string& dump) override; 34 [[nodiscard]] std::list<NotifyArgs> reconfigure(nsecs_t when, 35 const InputReaderConfiguration& config, 36 ConfigurationChanges changes) override; 37 [[nodiscard]] std::list<NotifyArgs> reset(nsecs_t when) override; 38 [[nodiscard]] std::list<NotifyArgs> process(const RawEvent& rawEvent) override; 39 40 private: 41 struct Axis { AxisAxis42 explicit Axis(const RawAbsoluteAxisInfo& rawAxisInfo, const AxisInfo& axisInfo, 43 bool explicitlyMapped, float scale, float offset, float highScale, 44 float highOffset, float min, float max, float flat, float fuzz, 45 float resolution, float filter) 46 : rawAxisInfo(rawAxisInfo), 47 axisInfo(axisInfo), 48 explicitlyMapped(explicitlyMapped), 49 scale(scale), 50 offset(offset), 51 highScale(highScale), 52 highOffset(highOffset), 53 min(min), 54 max(max), 55 flat(flat), 56 fuzz(fuzz), 57 resolution(resolution), 58 filter(filter) { 59 resetValue(); 60 } 61 62 RawAbsoluteAxisInfo rawAxisInfo; 63 AxisInfo axisInfo; 64 65 bool explicitlyMapped; // true if the axis was explicitly assigned an axis id 66 67 float scale; // scale factor from raw to normalized values 68 float offset; // offset to add after scaling for normalization 69 float highScale; // scale factor from raw to normalized values of high split 70 float highOffset; // offset to add after scaling for normalization of high split 71 72 float min; // normalized inclusive minimum 73 float max; // normalized inclusive maximum 74 float flat; // normalized flat region size 75 float fuzz; // normalized error tolerance 76 float resolution; // normalized resolution in units/mm 77 78 float filter; // filter out small variations of this size 79 float currentValue; // current value 80 float newValue; // most recent value 81 float highCurrentValue; // current value of high split 82 float highNewValue; // most recent value of high split 83 resetValueAxis84 void resetValue() { 85 this->currentValue = 0; 86 this->newValue = 0; 87 this->highCurrentValue = 0; 88 this->highNewValue = 0; 89 } 90 }; 91 92 explicit JoystickInputMapper(InputDeviceContext& deviceContext, 93 const InputReaderConfiguration& readerConfig); 94 95 static Axis createAxis(const AxisInfo& AxisInfo, const RawAbsoluteAxisInfo& rawAxisInfo, 96 bool explicitlyMapped); 97 98 // Axes indexed by raw ABS_* axis index. 99 std::unordered_map<int32_t, Axis> mAxes; 100 101 [[nodiscard]] std::list<NotifyArgs> sync(nsecs_t when, nsecs_t readTime, bool force); 102 103 bool haveAxis(int32_t axisId); 104 void pruneAxes(bool ignoreExplicitlyMappedAxes); 105 bool filterAxes(bool force); 106 107 static bool hasValueChangedSignificantly(float filter, float newValue, float currentValue, 108 float min, float max); 109 static bool hasMovedNearerToValueWithinFilteredRange(float filter, float newValue, 110 float currentValue, float thresholdValue); 111 112 static bool isCenteredAxis(int32_t axis); 113 static int32_t getCompatAxis(int32_t axis); 114 115 static void addMotionRange(int32_t axisId, const Axis& axis, InputDeviceInfo& info); 116 static void setPointerCoordsAxisValue(PointerCoords* pointerCoords, int32_t axis, float value); 117 }; 118 119 } // namespace android 120