74 lines
2.4 KiB
Text
74 lines
2.4 KiB
Text
|
TITLE:: HIDInfo
|
||
|
|
summary:: This class contains the basic information about an HID device to access and open it.
|
||
|
|
categories:: External Control>HID
|
||
|
|
related:: Classes/HID, Guides/Working_with_HID
|
||
|
|
|
||
|
|
DESCRIPTION::
|
||
|
|
This class contains the basic information about an HID device to access and open it.
|
||
|
|
The class is mostly used internally and rarely accessed directly by the user.
|
||
|
|
|
||
|
|
This class is populated with information read from the device, and represents some of the internal information of the device.
|
||
|
|
|
||
|
|
CLASSMETHODS::
|
||
|
|
|
||
|
|
PRIVATE:: new
|
||
|
|
|
||
|
|
INSTANCEMETHODS::
|
||
|
|
|
||
|
|
PRIVATE::printOn, setUsageAndPage
|
||
|
|
|
||
|
|
METHOD:: open
|
||
|
|
Open the device that is described by this HIDInfo
|
||
|
|
|
||
|
|
returns:: an HID - the device
|
||
|
|
|
||
|
|
METHOD:: postInfo
|
||
|
|
post the HIDInfo in a human readable way
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: path
|
||
|
|
The path of the device, this is a path defined by the operating system, and thus not the same across platforms, but essential to distinguish devices with the same vendor and product ID from each other.
|
||
|
|
|
||
|
|
METHOD:: vendorID
|
||
|
|
The vendor ID of the device, this is a number encoded by the device itself, and the same across platforms.
|
||
|
|
|
||
|
|
METHOD:: productID
|
||
|
|
The product ID of the device, this is a number encoded by the device itself, and the same across platforms.
|
||
|
|
|
||
|
|
METHOD:: vendorName
|
||
|
|
The vendor name of the device, this is a string encoded by the device itself, and the same across platforms.
|
||
|
|
|
||
|
|
METHOD:: productName
|
||
|
|
The product name of the device, this is a string encoded by the device itself, and the same across platforms.
|
||
|
|
|
||
|
|
METHOD:: serialNumber
|
||
|
|
The serial number of the device. This is dependent on the operating system, e.g. on Linux it is not set.
|
||
|
|
|
||
|
|
METHOD:: releaseNumber
|
||
|
|
The release number of the device, this is a number encoded by the device itself, and the same across platforms.
|
||
|
|
|
||
|
|
METHOD:: interfaceNumber
|
||
|
|
Type of interface of the device, can be an index standing for USB, Bluetooth, etc.
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: usage
|
||
|
|
Retrieve the usage index of this collection.
|
||
|
|
|
||
|
|
returns:: a Number - the usage index of this collection
|
||
|
|
|
||
|
|
METHOD:: usagePage
|
||
|
|
Retrieve the usage page index of this collection.
|
||
|
|
|
||
|
|
returns:: a Number- the usage page index
|
||
|
|
|
||
|
|
METHOD:: usageName
|
||
|
|
Retrieve the usage name of this collection. The name is looked up from the standardized HID usage tables using the usage page index.
|
||
|
|
|
||
|
|
returns:: a String - the usage name
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: pageName
|
||
|
|
Retrieve the page name of this collection. The name is looked up from the standardized HID usage tables using the usage page index.
|
||
|
|
|
||
|
|
returns:: a String - the usage page name
|