db360642ed
Use Vendor ID, Product ID and optionally the Version to locate keymaps and configuration files for external devices. Moved virtual key definition parsing to native code so that EventHub can identify touch screens with virtual keys and load the appropriate key layout file. Cleaned up a lot of old code in EventHub. Fixed a regression in ViewRoot's fallback event handling. Fixed a minor bug in FileMap that caused it to try to munmap or close invalid handled when released if the attempt to map the file failed. Added a couple of new String8 conveniences for formatting strings. Modified Tokenizer to fall back to open+read when mmap fails since we can't mmap sysfs files as needed to open the virtual key definition files in /sys/board_properties/. Change-Id: I6ca5e5f9547619fd082ddac47e87ce185da69ee6
121 lines
3.5 KiB
C++
121 lines
3.5 KiB
C++
/*
|
|
* Copyright (C) 2010 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 _UI_KEYBOARD_H
|
|
#define _UI_KEYBOARD_H
|
|
|
|
#include <ui/Input.h>
|
|
#include <utils/Errors.h>
|
|
#include <utils/String8.h>
|
|
#include <utils/PropertyMap.h>
|
|
|
|
namespace android {
|
|
|
|
enum {
|
|
/* Device id of the built in keyboard. */
|
|
DEVICE_ID_BUILT_IN_KEYBOARD = 0,
|
|
|
|
/* Device id of a generic virtual keyboard with a full layout that can be used
|
|
* to synthesize key events. */
|
|
DEVICE_ID_VIRTUAL_KEYBOARD = -1,
|
|
};
|
|
|
|
class KeyLayoutMap;
|
|
class KeyCharacterMap;
|
|
|
|
/**
|
|
* Loads the key layout map and key character map for a keyboard device.
|
|
*/
|
|
class KeyMap {
|
|
public:
|
|
String8 keyLayoutFile;
|
|
KeyLayoutMap* keyLayoutMap;
|
|
|
|
String8 keyCharacterMapFile;
|
|
KeyCharacterMap* keyCharacterMap;
|
|
|
|
KeyMap();
|
|
~KeyMap();
|
|
|
|
status_t load(const InputDeviceIdentifier& deviceIdenfier,
|
|
const PropertyMap* deviceConfiguration);
|
|
|
|
inline bool haveKeyLayout() const {
|
|
return !keyLayoutFile.isEmpty();
|
|
}
|
|
|
|
inline bool haveKeyCharacterMap() const {
|
|
return !keyCharacterMapFile.isEmpty();
|
|
}
|
|
|
|
inline bool isComplete() const {
|
|
return haveKeyLayout() && haveKeyCharacterMap();
|
|
}
|
|
|
|
private:
|
|
bool probeKeyMap(const InputDeviceIdentifier& deviceIdentifier, const String8& name);
|
|
status_t loadKeyLayout(const InputDeviceIdentifier& deviceIdentifier, const String8& name);
|
|
status_t loadKeyCharacterMap(const InputDeviceIdentifier& deviceIdentifier,
|
|
const String8& name);
|
|
String8 getPath(const InputDeviceIdentifier& deviceIdentifier,
|
|
const String8& name, InputDeviceConfigurationFileType type);
|
|
};
|
|
|
|
/**
|
|
* Returns true if the keyboard is eligible for use as a built-in keyboard.
|
|
*/
|
|
extern bool isEligibleBuiltInKeyboard(const InputDeviceIdentifier& deviceIdentifier,
|
|
const PropertyMap* deviceConfiguration, const KeyMap* keyMap);
|
|
|
|
/**
|
|
* Sets keyboard system properties.
|
|
*/
|
|
extern void setKeyboardProperties(int32_t deviceId, const InputDeviceIdentifier& deviceIdentifier,
|
|
const String8& keyLayoutFile, const String8& keyCharacterMapFile);
|
|
|
|
/**
|
|
* Clears keyboard system properties.
|
|
*/
|
|
extern void clearKeyboardProperties(int32_t deviceId);
|
|
|
|
/**
|
|
* Gets the key character map filename for a device using inspecting system properties
|
|
* and then falling back on a default key character map if necessary.
|
|
* Returns a NAME_NOT_FOUND if none found.
|
|
*/
|
|
extern status_t getKeyCharacterMapFile(int32_t deviceId, String8& outKeyCharacterMapFile);
|
|
|
|
/**
|
|
* Gets a key code by its short form label, eg. "HOME".
|
|
* Returns 0 if unknown.
|
|
*/
|
|
extern int32_t getKeyCodeByLabel(const char* label);
|
|
|
|
/**
|
|
* Gets a key flag by its short form label, eg. "WAKE".
|
|
* Returns 0 if unknown.
|
|
*/
|
|
extern uint32_t getKeyFlagByLabel(const char* label);
|
|
|
|
/**
|
|
* Updates a meta state field when a key is pressed or released.
|
|
*/
|
|
extern int32_t updateMetaState(int32_t keyCode, bool down, int32_t oldMetaState);
|
|
|
|
} // namespace android
|
|
|
|
#endif // _UI_KEYBOARD_H
|