2021-04-16 23:21:06 +08:00
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
# pyglet
|
|
|
|
# Copyright (c) 2006-2008 Alex Holkner
|
2022-04-30 13:56:57 +08:00
|
|
|
# Copyright (c) 2008-2022 pyglet contributors
|
2021-04-16 23:21:06 +08:00
|
|
|
# All rights reserved.
|
|
|
|
#
|
|
|
|
# Redistribution and use in source and binary forms, with or without
|
|
|
|
# modification, are permitted provided that the following conditions
|
|
|
|
# are met:
|
|
|
|
#
|
|
|
|
# * Redistributions of source code must retain the above copyright
|
|
|
|
# notice, this list of conditions and the following disclaimer.
|
|
|
|
# * Redistributions in binary form must reproduce the above copyright
|
|
|
|
# notice, this list of conditions and the following disclaimer in
|
|
|
|
# the documentation and/or other materials provided with the
|
|
|
|
# distribution.
|
|
|
|
# * Neither the name of pyglet nor the names of its
|
|
|
|
# contributors may be used to endorse or promote products
|
|
|
|
# derived from this software without specific prior written
|
|
|
|
# permission.
|
|
|
|
#
|
|
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
|
|
# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
|
|
# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
|
|
# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
|
|
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
|
|
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
|
|
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
# POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
import sys
|
|
|
|
|
|
|
|
from ctypes import CFUNCTYPE, byref, c_void_p, c_int, c_ubyte, c_bool, c_uint32, c_uint64
|
|
|
|
|
2022-03-05 23:10:18 +08:00
|
|
|
from .controller import get_mapping
|
2021-04-16 23:21:06 +08:00
|
|
|
from .base import Device, AbsoluteAxis, RelativeAxis, Button
|
2022-03-05 23:10:18 +08:00
|
|
|
from .base import Joystick, Controller, AppleRemote
|
2021-04-16 23:21:06 +08:00
|
|
|
|
|
|
|
from pyglet.libs.darwin.cocoapy import CFSTR, CFIndex, CFTypeID, known_cftypes
|
|
|
|
from pyglet.libs.darwin.cocoapy import kCFRunLoopDefaultMode, CFAllocatorRef, cf
|
|
|
|
from pyglet.libs.darwin.cocoapy import cfset_to_set, cftype_to_value, cfarray_to_list
|
|
|
|
from pyglet.lib import load_library
|
|
|
|
|
|
|
|
|
|
|
|
__LP64__ = (sys.maxsize > 2 ** 32)
|
|
|
|
|
|
|
|
# Uses the HID API introduced in Mac OS X version 10.5
|
|
|
|
# http://developer.apple.com/library/mac/#technotes/tn2007/tn2187.html
|
|
|
|
iokit = load_library(framework='IOKit')
|
|
|
|
|
|
|
|
# IOKit constants from
|
|
|
|
# /System/Library/Frameworks/IOKit.framework/Headers/hid/IOHIDKeys.h
|
|
|
|
kIOHIDOptionsTypeNone = 0x00
|
|
|
|
kIOHIDOptionsTypeSeizeDevice = 0x01
|
|
|
|
|
|
|
|
kIOHIDElementTypeInput_Misc = 1
|
|
|
|
kIOHIDElementTypeInput_Button = 2
|
|
|
|
kIOHIDElementTypeInput_Axis = 3
|
|
|
|
kIOHIDElementTypeInput_ScanCodes = 4
|
|
|
|
kIOHIDElementTypeOutput = 129
|
|
|
|
kIOHIDElementTypeFeature = 257
|
|
|
|
kIOHIDElementTypeCollection = 513
|
|
|
|
|
|
|
|
# /System/Library/Frameworks/IOKit.framework/Headers/hid/IOHIDUsageTables.h
|
|
|
|
kHIDPage_GenericDesktop = 0x01
|
|
|
|
kHIDPage_Consumer = 0x0C
|
|
|
|
kHIDUsage_GD_SystemSleep = 0x82
|
|
|
|
kHIDUsage_GD_SystemWakeUp = 0x83
|
|
|
|
kHIDUsage_GD_SystemAppMenu = 0x86
|
|
|
|
kHIDUsage_GD_SystemMenu = 0x89
|
|
|
|
kHIDUsage_GD_SystemMenuRight = 0x8A
|
|
|
|
kHIDUsage_GD_SystemMenuLeft = 0x8B
|
|
|
|
kHIDUsage_GD_SystemMenuUp = 0x8C
|
|
|
|
kHIDUsage_GD_SystemMenuDown = 0x8D
|
|
|
|
kHIDUsage_Csmr_Menu = 0x40
|
|
|
|
kHIDUsage_Csmr_FastForward = 0xB3
|
|
|
|
kHIDUsage_Csmr_Rewind = 0xB4
|
|
|
|
kHIDUsage_Csmr_Eject = 0xB8
|
2021-09-23 06:34:23 +08:00
|
|
|
kHIDUsage_Csmr_Mute = 0xE2
|
2021-04-16 23:21:06 +08:00
|
|
|
kHIDUsage_Csmr_VolumeIncrement = 0xE9
|
|
|
|
kHIDUsage_Csmr_VolumeDecrement = 0xEA
|
|
|
|
|
|
|
|
IOReturn = c_int # IOReturn.h
|
|
|
|
IOOptionBits = c_uint32 # IOTypes.h
|
|
|
|
|
|
|
|
# IOHIDKeys.h
|
|
|
|
IOHIDElementType = c_int
|
|
|
|
IOHIDElementCollectionType = c_int
|
|
|
|
if __LP64__:
|
|
|
|
IOHIDElementCookie = c_uint32
|
|
|
|
else:
|
|
|
|
IOHIDElementCookie = c_void_p
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceClose.restype = IOReturn
|
|
|
|
iokit.IOHIDDeviceClose.argtypes = [c_void_p, IOOptionBits]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceConformsTo.restype = c_ubyte
|
|
|
|
iokit.IOHIDDeviceConformsTo.argtypes = [c_void_p, c_uint32, c_uint32]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceCopyMatchingElements.restype = c_void_p
|
|
|
|
iokit.IOHIDDeviceCopyMatchingElements.argtypes = [c_void_p, c_void_p, IOOptionBits]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceGetProperty.restype = c_void_p
|
|
|
|
iokit.IOHIDDeviceGetProperty.argtypes = [c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceGetTypeID.restype = CFTypeID
|
|
|
|
iokit.IOHIDDeviceGetTypeID.argtypes = []
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceGetValue.restype = IOReturn
|
|
|
|
iokit.IOHIDDeviceGetValue.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceOpen.restype = IOReturn
|
|
|
|
iokit.IOHIDDeviceOpen.argtypes = [c_void_p, IOOptionBits]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceRegisterInputValueCallback.restype = None
|
|
|
|
iokit.IOHIDDeviceRegisterInputValueCallback.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceRegisterRemovalCallback.restype = None
|
|
|
|
iokit.IOHIDDeviceRegisterRemovalCallback.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceScheduleWithRunLoop.restype = None
|
|
|
|
iokit.IOHIDDeviceScheduleWithRunLoop.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDDeviceUnscheduleFromRunLoop.restype = None
|
|
|
|
iokit.IOHIDDeviceUnscheduleFromRunLoop.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetCollectionType.restype = IOHIDElementCollectionType
|
|
|
|
iokit.IOHIDElementGetCollectionType.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetCookie.restype = IOHIDElementCookie
|
|
|
|
iokit.IOHIDElementGetCookie.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetLogicalMax.restype = CFIndex
|
|
|
|
iokit.IOHIDElementGetLogicalMax.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetLogicalMin.restype = CFIndex
|
|
|
|
iokit.IOHIDElementGetLogicalMin.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetName.restype = c_void_p
|
|
|
|
iokit.IOHIDElementGetName.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetPhysicalMax.restype = CFIndex
|
|
|
|
iokit.IOHIDElementGetPhysicalMax.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetPhysicalMin.restype = CFIndex
|
|
|
|
iokit.IOHIDElementGetPhysicalMin.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetReportCount.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetReportCount.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetReportID.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetReportID.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetReportSize.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetReportSize.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetType.restype = IOHIDElementType
|
|
|
|
iokit.IOHIDElementGetType.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetTypeID.restype = CFTypeID
|
|
|
|
iokit.IOHIDElementGetTypeID.argtypes = []
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetUnit.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetUnit.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetUnitExponent.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetUnitExponent.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetUsage.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetUsage.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementGetUsagePage.restype = c_uint32
|
|
|
|
iokit.IOHIDElementGetUsagePage.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementHasNullState.restype = c_bool
|
|
|
|
iokit.IOHIDElementHasNullState.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementHasPreferredState.restype = c_bool
|
|
|
|
iokit.IOHIDElementHasPreferredState.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementIsArray.restype = c_bool
|
|
|
|
iokit.IOHIDElementIsArray.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementIsNonLinear.restype = c_bool
|
|
|
|
iokit.IOHIDElementIsNonLinear.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementIsRelative.restype = c_bool
|
|
|
|
iokit.IOHIDElementIsRelative.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementIsVirtual.restype = c_bool
|
|
|
|
iokit.IOHIDElementIsVirtual.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDElementIsWrapping.restype = c_bool
|
|
|
|
iokit.IOHIDElementIsWrapping.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDManagerCreate.restype = c_void_p
|
|
|
|
iokit.IOHIDManagerCreate.argtypes = [CFAllocatorRef, IOOptionBits]
|
|
|
|
|
|
|
|
iokit.IOHIDManagerCopyDevices.restype = c_void_p
|
|
|
|
iokit.IOHIDManagerCopyDevices.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDManagerGetTypeID.restype = CFTypeID
|
|
|
|
iokit.IOHIDManagerGetTypeID.argtypes = []
|
|
|
|
|
|
|
|
iokit.IOHIDManagerRegisterDeviceMatchingCallback.restype = None
|
|
|
|
iokit.IOHIDManagerRegisterDeviceMatchingCallback.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDManagerScheduleWithRunLoop.restype = c_void_p
|
|
|
|
iokit.IOHIDManagerScheduleWithRunLoop.argtypes = [c_void_p, c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDManagerSetDeviceMatching.restype = None
|
|
|
|
iokit.IOHIDManagerSetDeviceMatching.argtypes = [c_void_p, c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDValueGetElement.restype = c_void_p
|
|
|
|
iokit.IOHIDValueGetElement.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDValueGetIntegerValue.restype = CFIndex
|
|
|
|
iokit.IOHIDValueGetIntegerValue.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDValueGetLength.restype = CFIndex
|
|
|
|
iokit.IOHIDValueGetLength.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDValueGetTimeStamp.restype = c_uint64
|
|
|
|
iokit.IOHIDValueGetTimeStamp.argtypes = [c_void_p]
|
|
|
|
|
|
|
|
iokit.IOHIDValueGetTypeID.restype = CFTypeID
|
|
|
|
iokit.IOHIDValueGetTypeID.argtypes = []
|
|
|
|
|
|
|
|
# Callback function types
|
|
|
|
HIDManagerCallback = CFUNCTYPE(None, c_void_p, c_int, c_void_p, c_void_p)
|
|
|
|
HIDDeviceCallback = CFUNCTYPE(None, c_void_p, c_int, c_void_p)
|
|
|
|
HIDDeviceValueCallback = CFUNCTYPE(None, c_void_p, c_int, c_void_p, c_void_p)
|
|
|
|
|
|
|
|
######################################################################
|
|
|
|
# HID Class Wrappers
|
|
|
|
|
|
|
|
# Lookup tables cache python objects for the devices and elements so that
|
|
|
|
# we can avoid creating multiple wrapper objects for the same device.
|
|
|
|
_device_lookup = {} # IOHIDDeviceRef to python HIDDevice object
|
|
|
|
_element_lookup = {} # IOHIDElementRef to python HIDDeviceElement object
|
|
|
|
|
|
|
|
|
|
|
|
class HIDValue:
|
|
|
|
def __init__(self, valueRef):
|
|
|
|
# Check that this is a valid IOHIDValue.
|
|
|
|
assert valueRef
|
|
|
|
assert cf.CFGetTypeID(valueRef) == iokit.IOHIDValueGetTypeID()
|
|
|
|
self.valueRef = valueRef
|
|
|
|
self.timestamp = iokit.IOHIDValueGetTimeStamp(valueRef)
|
|
|
|
self.length = iokit.IOHIDValueGetLength(valueRef)
|
|
|
|
if self.length <= 4:
|
|
|
|
self.intvalue = iokit.IOHIDValueGetIntegerValue(valueRef)
|
|
|
|
else:
|
|
|
|
# Values may be byte data rather than integers.
|
|
|
|
# e.g. the PS3 controller has a 39-byte HIDValue element.
|
|
|
|
# We currently do not try to handle these cases.
|
|
|
|
self.intvalue = None
|
|
|
|
elementRef = c_void_p(iokit.IOHIDValueGetElement(valueRef))
|
|
|
|
self.element = HIDDeviceElement.get_element(elementRef)
|
|
|
|
|
|
|
|
|
|
|
|
class HIDDevice:
|
|
|
|
@classmethod
|
|
|
|
def get_device(cls, deviceRef):
|
|
|
|
# deviceRef is a c_void_p pointing to an IOHIDDeviceRef
|
|
|
|
if deviceRef.value in _device_lookup:
|
|
|
|
return _device_lookup[deviceRef.value]
|
|
|
|
else:
|
|
|
|
device = HIDDevice(deviceRef)
|
|
|
|
return device
|
|
|
|
|
|
|
|
def __init__(self, deviceRef):
|
|
|
|
# Check that we've got a valid IOHIDDevice.
|
|
|
|
assert deviceRef
|
|
|
|
assert cf.CFGetTypeID(deviceRef) == iokit.IOHIDDeviceGetTypeID()
|
|
|
|
_device_lookup[deviceRef.value] = self
|
|
|
|
self.deviceRef = deviceRef
|
|
|
|
# Set attributes from device properties.
|
|
|
|
self.transport = self.get_property("Transport")
|
|
|
|
self.vendorID = self.get_property("VendorID")
|
|
|
|
self.vendorIDSource = self.get_property("VendorIDSource")
|
|
|
|
self.productID = self.get_property("ProductID")
|
|
|
|
self.versionNumber = self.get_property("VersionNumber")
|
|
|
|
self.manufacturer = self.get_property("Manufacturer")
|
|
|
|
self.product = self.get_property("Product")
|
|
|
|
self.serialNumber = self.get_property("SerialNumber") # always returns None; apple bug?
|
|
|
|
self.locationID = self.get_property("LocationID")
|
|
|
|
self.primaryUsage = self.get_property("PrimaryUsage")
|
|
|
|
self.primaryUsagePage = self.get_property("PrimaryUsagePage")
|
|
|
|
# Populate self.elements with our device elements.
|
|
|
|
self.elements = self._get_elements()
|
|
|
|
# Set up callback functions.
|
|
|
|
self.value_observers = set()
|
|
|
|
self.removal_observers = set()
|
|
|
|
self.removal_callback = self._register_removal_callback()
|
|
|
|
self.value_callback = self._register_input_value_callback()
|
|
|
|
|
|
|
|
def dump_info(self):
|
|
|
|
for x in ('manufacturer', 'product', 'transport', 'vendorID', 'vendorIDSource', 'productID',
|
|
|
|
'versionNumber', 'serialNumber', 'locationID', 'primaryUsage', 'primaryUsagePage'):
|
|
|
|
value = getattr(self, x)
|
|
|
|
print(x + ":", value)
|
|
|
|
|
|
|
|
def unique_identifier(self):
|
|
|
|
# Since we can't rely on the serial number, create our own identifier.
|
|
|
|
# Can use this to find devices when they are plugged back in.
|
|
|
|
return (self.manufacturer, self.product, self.vendorID, self.productID,
|
|
|
|
self.versionNumber, self.primaryUsage, self.primaryUsagePage)
|
|
|
|
|
|
|
|
def get_property(self, name):
|
|
|
|
cfname = CFSTR(name)
|
|
|
|
cfvalue = c_void_p(iokit.IOHIDDeviceGetProperty(self.deviceRef, cfname))
|
|
|
|
cf.CFRelease(cfname)
|
|
|
|
return cftype_to_value(cfvalue)
|
|
|
|
|
|
|
|
def open(self, exclusive_mode=False):
|
|
|
|
if exclusive_mode:
|
|
|
|
options = kIOHIDOptionsTypeSeizeDevice
|
|
|
|
else:
|
|
|
|
options = kIOHIDOptionsTypeNone
|
|
|
|
return bool(iokit.IOHIDDeviceOpen(self.deviceRef, options))
|
|
|
|
|
|
|
|
def close(self):
|
|
|
|
return bool(iokit.IOHIDDeviceClose(self.deviceRef, kIOHIDOptionsTypeNone))
|
|
|
|
|
|
|
|
def schedule_with_run_loop(self):
|
|
|
|
iokit.IOHIDDeviceScheduleWithRunLoop(
|
|
|
|
self.deviceRef,
|
|
|
|
c_void_p(cf.CFRunLoopGetCurrent()),
|
|
|
|
kCFRunLoopDefaultMode)
|
|
|
|
|
|
|
|
def unschedule_from_run_loop(self):
|
|
|
|
iokit.IOHIDDeviceUnscheduleFromRunLoop(
|
|
|
|
self.deviceRef,
|
|
|
|
c_void_p(cf.CFRunLoopGetCurrent()),
|
|
|
|
kCFRunLoopDefaultMode)
|
|
|
|
|
|
|
|
def _get_elements(self):
|
|
|
|
cfarray = c_void_p(iokit.IOHIDDeviceCopyMatchingElements(self.deviceRef, None, 0))
|
|
|
|
if not cfarray:
|
|
|
|
# requires "Security & Privacy / Input Monitoring", see #95
|
|
|
|
return []
|
|
|
|
elements = cfarray_to_list(cfarray)
|
|
|
|
cf.CFRelease(cfarray)
|
|
|
|
return elements
|
|
|
|
|
|
|
|
# Page and usage IDs are from the HID usage tables located at
|
|
|
|
# http://www.usb.org/developers/devclass_docs/Hut1_12.pdf
|
|
|
|
def conforms_to(self, page, usage):
|
|
|
|
return bool(iokit.IOHIDDeviceConformsTo(self.deviceRef, page, usage))
|
|
|
|
|
|
|
|
def is_pointer(self):
|
|
|
|
return self.conforms_to(0x01, 0x01)
|
|
|
|
|
|
|
|
def is_mouse(self):
|
|
|
|
return self.conforms_to(0x01, 0x02)
|
|
|
|
|
|
|
|
def is_joystick(self):
|
|
|
|
return self.conforms_to(0x01, 0x04)
|
|
|
|
|
|
|
|
def is_gamepad(self):
|
|
|
|
return self.conforms_to(0x01, 0x05)
|
|
|
|
|
|
|
|
def is_keyboard(self):
|
|
|
|
return self.conforms_to(0x01, 0x06)
|
|
|
|
|
|
|
|
def is_keypad(self):
|
|
|
|
return self.conforms_to(0x01, 0x07)
|
|
|
|
|
|
|
|
def is_multi_axis(self):
|
|
|
|
return self.conforms_to(0x01, 0x08)
|
|
|
|
|
|
|
|
def py_removal_callback(self, context, result, sender):
|
|
|
|
self = _device_lookup[sender] # avoid wonky python context issues
|
|
|
|
# Dispatch removal message to all observers.
|
|
|
|
for x in self.removal_observers:
|
|
|
|
if hasattr(x, 'device_removed'):
|
|
|
|
x.device_removed(self)
|
|
|
|
# Remove self from device lookup table.
|
|
|
|
del _device_lookup[sender]
|
|
|
|
# Remove device elements from lookup table.
|
|
|
|
to_remove = [k for k, v in _element_lookup.items() if v in self.elements]
|
|
|
|
for key in to_remove:
|
|
|
|
del _element_lookup[key]
|
|
|
|
|
|
|
|
def _register_removal_callback(self):
|
|
|
|
removal_callback = HIDDeviceCallback(self.py_removal_callback)
|
|
|
|
iokit.IOHIDDeviceRegisterRemovalCallback(self.deviceRef, removal_callback, None)
|
|
|
|
return removal_callback
|
|
|
|
|
|
|
|
def add_removal_observer(self, observer):
|
|
|
|
self.removal_observers.add(observer)
|
|
|
|
|
|
|
|
def py_value_callback(self, context, result, sender, value):
|
|
|
|
v = HIDValue(c_void_p(value))
|
|
|
|
# Dispatch value changed message to all observers.
|
|
|
|
for x in self.value_observers:
|
|
|
|
if hasattr(x, 'device_value_changed'):
|
|
|
|
x.device_value_changed(self, v)
|
|
|
|
|
|
|
|
def _register_input_value_callback(self):
|
|
|
|
value_callback = HIDDeviceValueCallback(self.py_value_callback)
|
|
|
|
iokit.IOHIDDeviceRegisterInputValueCallback(self.deviceRef, value_callback, None)
|
|
|
|
return value_callback
|
|
|
|
|
|
|
|
def add_value_observer(self, observer):
|
|
|
|
self.value_observers.add(observer)
|
|
|
|
|
|
|
|
def get_value(self, element):
|
|
|
|
# If the device is not open, then returns None
|
|
|
|
valueRef = c_void_p()
|
|
|
|
iokit.IOHIDDeviceGetValue(self.deviceRef, element.elementRef, byref(valueRef))
|
|
|
|
if valueRef:
|
|
|
|
return HIDValue(valueRef)
|
|
|
|
else:
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
|
|
class HIDDeviceElement:
|
|
|
|
@classmethod
|
|
|
|
def get_element(cls, elementRef):
|
|
|
|
# elementRef is a c_void_p pointing to an IOHIDDeviceElementRef
|
|
|
|
if elementRef.value in _element_lookup:
|
|
|
|
return _element_lookup[elementRef.value]
|
|
|
|
else:
|
|
|
|
element = HIDDeviceElement(elementRef)
|
|
|
|
return element
|
|
|
|
|
|
|
|
def __init__(self, elementRef):
|
|
|
|
# Check that we've been passed a valid IOHIDElement.
|
|
|
|
assert elementRef
|
|
|
|
assert cf.CFGetTypeID(elementRef) == iokit.IOHIDElementGetTypeID()
|
|
|
|
_element_lookup[elementRef.value] = self
|
|
|
|
self.elementRef = elementRef
|
|
|
|
# Set element properties as attributes.
|
|
|
|
self.cookie = iokit.IOHIDElementGetCookie(elementRef)
|
|
|
|
self.type = iokit.IOHIDElementGetType(elementRef)
|
|
|
|
if self.type == kIOHIDElementTypeCollection:
|
|
|
|
self.collectionType = iokit.IOHIDElementGetCollectionType(elementRef)
|
|
|
|
else:
|
|
|
|
self.collectionType = None
|
|
|
|
self.usagePage = iokit.IOHIDElementGetUsagePage(elementRef)
|
|
|
|
self.usage = iokit.IOHIDElementGetUsage(elementRef)
|
|
|
|
self.isVirtual = bool(iokit.IOHIDElementIsVirtual(elementRef))
|
|
|
|
self.isRelative = bool(iokit.IOHIDElementIsRelative(elementRef))
|
|
|
|
self.isWrapping = bool(iokit.IOHIDElementIsWrapping(elementRef))
|
|
|
|
self.isArray = bool(iokit.IOHIDElementIsArray(elementRef))
|
|
|
|
self.isNonLinear = bool(iokit.IOHIDElementIsNonLinear(elementRef))
|
|
|
|
self.hasPreferredState = bool(iokit.IOHIDElementHasPreferredState(elementRef))
|
|
|
|
self.hasNullState = bool(iokit.IOHIDElementHasNullState(elementRef))
|
|
|
|
self.name = cftype_to_value(iokit.IOHIDElementGetName(elementRef))
|
|
|
|
self.reportID = iokit.IOHIDElementGetReportID(elementRef)
|
|
|
|
self.reportSize = iokit.IOHIDElementGetReportSize(elementRef)
|
|
|
|
self.reportCount = iokit.IOHIDElementGetReportCount(elementRef)
|
|
|
|
self.unit = iokit.IOHIDElementGetUnit(elementRef)
|
|
|
|
self.unitExponent = iokit.IOHIDElementGetUnitExponent(elementRef)
|
|
|
|
self.logicalMin = iokit.IOHIDElementGetLogicalMin(elementRef)
|
|
|
|
self.logicalMax = iokit.IOHIDElementGetLogicalMax(elementRef)
|
|
|
|
self.physicalMin = iokit.IOHIDElementGetPhysicalMin(elementRef)
|
|
|
|
self.physicalMax = iokit.IOHIDElementGetPhysicalMax(elementRef)
|
|
|
|
|
|
|
|
|
|
|
|
class HIDManager:
|
|
|
|
def __init__(self):
|
|
|
|
# Create the HID Manager.
|
|
|
|
self.managerRef = c_void_p(iokit.IOHIDManagerCreate(None, kIOHIDOptionsTypeNone))
|
|
|
|
assert self.managerRef
|
|
|
|
assert cf.CFGetTypeID(self.managerRef) == iokit.IOHIDManagerGetTypeID()
|
|
|
|
self.schedule_with_run_loop()
|
|
|
|
self.matching_observers = set()
|
|
|
|
self.matching_callback = self._register_matching_callback()
|
|
|
|
self.devices = self._get_devices()
|
|
|
|
|
|
|
|
def _get_devices(self):
|
|
|
|
try:
|
|
|
|
# Tell manager that we are willing to match *any* device.
|
|
|
|
# (Alternatively, we could restrict by device usage, or usage page.)
|
|
|
|
iokit.IOHIDManagerSetDeviceMatching(self.managerRef, None)
|
|
|
|
# Copy the device set and convert it to python.
|
|
|
|
cfset = c_void_p(iokit.IOHIDManagerCopyDevices(self.managerRef))
|
|
|
|
devices = cfset_to_set(cfset)
|
|
|
|
cf.CFRelease(cfset)
|
|
|
|
except:
|
|
|
|
return set()
|
|
|
|
return devices
|
|
|
|
|
|
|
|
def open(self):
|
|
|
|
iokit.IOHIDManagerOpen(self.managerRef, kIOHIDOptionsTypeNone)
|
|
|
|
|
|
|
|
def close(self):
|
|
|
|
iokit.IOHIDManagerClose(self.managerRef, kIOHIDOptionsTypeNone)
|
|
|
|
|
|
|
|
def schedule_with_run_loop(self):
|
|
|
|
iokit.IOHIDManagerScheduleWithRunLoop(
|
|
|
|
self.managerRef,
|
|
|
|
c_void_p(cf.CFRunLoopGetCurrent()),
|
|
|
|
kCFRunLoopDefaultMode)
|
|
|
|
|
|
|
|
def unschedule_from_run_loop(self):
|
|
|
|
iokit.IOHIDManagerUnscheduleFromRunLoop(
|
|
|
|
self.managerRef,
|
|
|
|
c_void_p(cf.CFRunLoopGetCurrent()),
|
|
|
|
kCFRunLoopDefaultMode)
|
|
|
|
|
|
|
|
def _py_matching_callback(self, context, result, sender, device):
|
|
|
|
d = HIDDevice.get_device(c_void_p(device))
|
|
|
|
if d not in self.devices:
|
|
|
|
self.devices.add(d)
|
|
|
|
for x in self.matching_observers:
|
|
|
|
if hasattr(x, 'device_discovered'):
|
|
|
|
x.device_discovered(d)
|
|
|
|
|
|
|
|
def _register_matching_callback(self):
|
|
|
|
matching_callback = HIDManagerCallback(self._py_matching_callback)
|
|
|
|
iokit.IOHIDManagerRegisterDeviceMatchingCallback(self.managerRef, matching_callback, None)
|
|
|
|
return matching_callback
|
|
|
|
|
|
|
|
|
|
|
|
######################################################################
|
|
|
|
# Add conversion methods for IOHIDDevices and IOHIDDeviceElements
|
|
|
|
# to the list of known types used by cftype_to_value.
|
|
|
|
known_cftypes[iokit.IOHIDDeviceGetTypeID()] = HIDDevice.get_device
|
|
|
|
known_cftypes[iokit.IOHIDElementGetTypeID()] = HIDDeviceElement.get_element
|
|
|
|
######################################################################
|
|
|
|
|
|
|
|
# Pyglet interface to HID
|
|
|
|
|
|
|
|
|
|
|
|
_axis_names = {
|
|
|
|
(0x01, 0x30): 'x',
|
|
|
|
(0x01, 0x31): 'y',
|
|
|
|
(0x01, 0x32): 'z',
|
|
|
|
(0x01, 0x33): 'rx',
|
|
|
|
(0x01, 0x34): 'ry',
|
|
|
|
(0x01, 0x35): 'rz',
|
|
|
|
(0x01, 0x38): 'wheel',
|
|
|
|
(0x01, 0x39): 'hat',
|
|
|
|
}
|
|
|
|
|
2021-09-23 06:34:23 +08:00
|
|
|
|
2021-04-16 23:21:06 +08:00
|
|
|
_button_names = {
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemSleep): 'sleep',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemWakeUp): 'wakeup',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemAppMenu): 'menu',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemMenu): 'select',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemMenuRight): 'right',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemMenuLeft): 'left',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemMenuUp): 'up',
|
|
|
|
(kHIDPage_GenericDesktop, kHIDUsage_GD_SystemMenuDown): 'down',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_FastForward): 'right_hold',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_Rewind): 'left_hold',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_Menu): 'menu_hold',
|
|
|
|
(0xff01, 0x23): 'select_hold',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_Eject): 'eject',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_Mute): 'mute',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_VolumeIncrement): 'volume_up',
|
|
|
|
(kHIDPage_Consumer, kHIDUsage_Csmr_VolumeDecrement): 'volume_down'
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
class PygletDevice(Device):
|
|
|
|
def __init__(self, display, device, manager):
|
2021-09-23 06:34:23 +08:00
|
|
|
super(PygletDevice, self).__init__(display=display, name=device.product)
|
2021-04-16 23:21:06 +08:00
|
|
|
self.device = device
|
|
|
|
self.device_identifier = self.device.unique_identifier()
|
|
|
|
self.device.add_value_observer(self)
|
|
|
|
self.device.add_removal_observer(self)
|
|
|
|
manager.matching_observers.add(self)
|
|
|
|
self._create_controls()
|
|
|
|
self._is_open = False
|
|
|
|
self._is_exclusive = False
|
|
|
|
|
|
|
|
def open(self, window=None, exclusive=False):
|
|
|
|
super(PygletDevice, self).open(window, exclusive)
|
|
|
|
self.device.open(exclusive)
|
|
|
|
self.device.schedule_with_run_loop()
|
|
|
|
self._is_open = True
|
|
|
|
self._is_exclusive = exclusive
|
|
|
|
self._set_initial_control_values()
|
|
|
|
|
|
|
|
def close(self):
|
|
|
|
super(PygletDevice, self).close()
|
|
|
|
self.device.close()
|
|
|
|
self._is_open = False
|
|
|
|
|
|
|
|
def get_controls(self):
|
|
|
|
return list(self._controls.values())
|
|
|
|
|
2021-09-23 06:34:23 +08:00
|
|
|
def get_guid(self):
|
|
|
|
"""Generate an SDL2 style GUID from the product guid."""
|
|
|
|
|
|
|
|
if self.device.transport == 'USB':
|
|
|
|
bustype = 0x03
|
|
|
|
vendor, product, version = self.device_identifier[2:5]
|
|
|
|
# Byte swap (ABCD --> CDAB):
|
|
|
|
bustype = ((bustype << 8) | (bustype >> 8)) & 0xFFFF
|
|
|
|
vendor = ((vendor << 8) | (vendor >> 8)) & 0xFFFF
|
|
|
|
product = ((product << 8) | (product >> 8)) & 0xFFFF
|
|
|
|
version = ((version << 8) | (version >> 8)) & 0xFFFF
|
|
|
|
return "{:04x}0000{:04x}0000{:04x}0000{:04x}0000".format(bustype, vendor, product, version)
|
|
|
|
|
|
|
|
elif self.device.transport == 'BLUETOOTH':
|
|
|
|
bustype = 0x05
|
|
|
|
# Byte swap (ABCD --> CDAB):
|
|
|
|
bustype = ((bustype << 8) | (bustype >> 8)) & 0xFFFF
|
|
|
|
|
|
|
|
# TODO: test fallback to vendor id if no product name:
|
|
|
|
name = self.device.product or str(self.device.vendorID)
|
|
|
|
name = name.encode().hex()
|
|
|
|
return "{:04x}0000{:0<24}".format(bustype, name)
|
|
|
|
|
2021-04-16 23:21:06 +08:00
|
|
|
def device_removed(self, hid_device):
|
|
|
|
# Called by device when it is unplugged.
|
|
|
|
# Set device to None, but Keep self._controls around
|
|
|
|
# in case device is plugged back in.
|
|
|
|
self.device = None
|
|
|
|
|
|
|
|
def device_discovered(self, hid_device):
|
|
|
|
# Called by HID manager when new device is found.
|
|
|
|
# If our device was disconnected, reconnect when it is plugged back in.
|
|
|
|
if not self.device and self.device_identifier == hid_device.unique_identifier():
|
|
|
|
self.device = hid_device
|
|
|
|
self.device.add_value_observer(self)
|
|
|
|
self.device.add_removal_observer(self)
|
|
|
|
# Don't need to recreate controls since this is same device.
|
|
|
|
# They are indexed by cookie, which is constant.
|
|
|
|
if self._is_open:
|
|
|
|
self.device.open(self._is_exclusive)
|
|
|
|
self.device.schedule_with_run_loop()
|
|
|
|
|
|
|
|
def device_value_changed(self, hid_device, hid_value):
|
|
|
|
# Called by device when input value changes.
|
|
|
|
control = self._controls[hid_value.element.cookie]
|
|
|
|
control.value = hid_value.intvalue
|
|
|
|
|
|
|
|
def _create_controls(self):
|
|
|
|
self._controls = {}
|
|
|
|
for element in self.device.elements:
|
|
|
|
raw_name = element.name or '0x%x:%x' % (element.usagePage, element.usage)
|
|
|
|
if element.type in (kIOHIDElementTypeInput_Misc, kIOHIDElementTypeInput_Axis):
|
|
|
|
name = _axis_names.get((element.usagePage, element.usage))
|
|
|
|
if element.isRelative:
|
|
|
|
control = RelativeAxis(name, raw_name)
|
|
|
|
else:
|
|
|
|
control = AbsoluteAxis(name, element.logicalMin, element.logicalMax, raw_name)
|
|
|
|
elif element.type == kIOHIDElementTypeInput_Button:
|
|
|
|
name = _button_names.get((element.usagePage, element.usage))
|
|
|
|
control = Button(name, raw_name)
|
|
|
|
else:
|
|
|
|
continue
|
|
|
|
|
|
|
|
control._cookie = element.cookie
|
|
|
|
|
|
|
|
self._controls[control._cookie] = control
|
|
|
|
|
|
|
|
def _set_initial_control_values(self):
|
|
|
|
# Must be called AFTER the device has been opened.
|
|
|
|
for element in self.device.elements:
|
|
|
|
if element.cookie in self._controls:
|
|
|
|
control = self._controls[element.cookie]
|
|
|
|
hid_value = self.device.get_value(element)
|
|
|
|
if hid_value:
|
|
|
|
control.value = hid_value.intvalue
|
|
|
|
|
|
|
|
|
|
|
|
######################################################################
|
|
|
|
|
2021-09-23 06:34:23 +08:00
|
|
|
|
2021-04-16 23:21:06 +08:00
|
|
|
_manager = HIDManager()
|
|
|
|
|
|
|
|
|
|
|
|
def get_devices(display=None):
|
|
|
|
return [PygletDevice(display, device, _manager) for device in _manager.devices]
|
|
|
|
|
|
|
|
|
|
|
|
def get_joysticks(display=None):
|
|
|
|
return [Joystick(PygletDevice(display, device, _manager)) for device in _manager.devices
|
|
|
|
if device.is_joystick() or device.is_gamepad() or device.is_multi_axis()]
|
|
|
|
|
|
|
|
|
|
|
|
def get_apple_remote(display=None):
|
|
|
|
for device in _manager.devices:
|
|
|
|
if device.product == 'Apple IR':
|
|
|
|
return AppleRemote(PygletDevice(display, device, _manager))
|
2021-09-23 06:34:23 +08:00
|
|
|
|
|
|
|
|
2022-03-05 23:10:18 +08:00
|
|
|
def _create_controller(device, display):
|
|
|
|
mapping = get_mapping(device.get_guid())
|
|
|
|
if not mapping:
|
|
|
|
return
|
|
|
|
return Controller(PygletDevice(display, device, _manager), mapping)
|
|
|
|
|
|
|
|
|
|
|
|
def get_controllers(display=None):
|
|
|
|
return [controller for controller in
|
|
|
|
[_create_controller(device, display) for device in _manager.devices]
|
|
|
|
if controller is not None]
|