/*
     File:       HID.h
 
     Contains:   Definition of the interfaces to the HIDLib shared library and
 
     Version:    Technology: HID 1.0
                 Release:    Universal Interfaces 3.4
 
     Copyright:  © 1999-2001 by Apple Computer, Inc., all rights reserved.
 
     Bugs?:      For bug reports, consult the following page on
                 the World Wide Web:
 
                     http://developer.apple.com/bugreporter/
 
*/
#ifndef __HID__
#define __HID__

#ifndef __MACTYPES__
#include <MacTypes.h>
#endif

#ifndef __MACERRORS__
#include <MacErrors.h>
#endif




#if PRAGMA_ONCE
#pragma once
#endif

#ifdef __cplusplus
extern "C" {
#endif

#if PRAGMA_IMPORT
#pragma import on
#endif

#if PRAGMA_STRUCT_ALIGN
    #pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
    #pragma pack(2)
#endif

/*
   
    Interfaces for HIDLib
*/

/* types of HID reports (input, output, feature)*/
enum {
  kHIDInputReport               = 1,
  kHIDOutputReport              = 2,
  kHIDFeatureReport             = 3,
  kHIDUnknownReport             = 255
};

/* constants used in HIDButtonCapabilities and HIDValueCapabilities structures*/
enum {
                                        /* While HIDButtonCaps and HIDValueCaps have no version #, they can be*/
                                        /* thought of as version 1 of HIDButtonCapabilities and HIDValueCapabilities.*/
  kHIDCurrentCapabilitiesPBVersion = 2
};

/* flags passed to HIDOpenReportDescriptor*/
enum {
  kHIDFlag_StrictErrorChecking  = 0x00000001
};

typedef UInt32                          HIDReportType;
typedef UInt32                          HIDUsage;
typedef struct OpaqueHIDPreparsedDataRef*  HIDPreparsedDataRef;
struct HIDUsageAndPage {
  HIDUsage            usage;
  HIDUsage            usagePage;
};
typedef struct HIDUsageAndPage          HIDUsageAndPage;
typedef HIDUsageAndPage *               HIDUsageAndPagePtr;
struct HIDCaps {
  HIDUsage            usage;
  HIDUsage            usagePage;
  ByteCount           inputReportByteLength;
  ByteCount           outputReportByteLength;
  ByteCount           featureReportByteLength;
  UInt32              numberCollectionNodes;
  UInt32              numberInputButtonCaps;
  UInt32              numberInputValueCaps;
  UInt32              numberOutputButtonCaps;
  UInt32              numberOutputValueCaps;
  UInt32              numberFeatureButtonCaps;
  UInt32              numberFeatureValueCaps;
};
typedef struct HIDCaps                  HIDCaps;
typedef HIDCaps *                       HIDCapsPtr;
struct HIDCapabilities {
  HIDUsage            usage;
  HIDUsage            usagePage;
  ByteCount           inputReportByteLength;
  ByteCount           outputReportByteLength;
  ByteCount           featureReportByteLength;
  UInt32              numberCollectionNodes;
  UInt32              numberInputButtonCaps;
  UInt32              numberInputValueCaps;
  UInt32              numberOutputButtonCaps;
  UInt32              numberOutputValueCaps;
  UInt32              numberFeatureButtonCaps;
  UInt32              numberFeatureValueCaps;
};
typedef struct HIDCapabilities          HIDCapabilities;
typedef HIDCapabilities *               HIDCapabilitiesPtr;
struct HIDCollectionNode {
  HIDUsage            collectionUsage;
  HIDUsage            collectionUsagePage;
  UInt32              parent;
  UInt32              numberOfChildren;
  UInt32              nextSibling;
  UInt32              firstChild;
};
typedef struct HIDCollectionNode        HIDCollectionNode;
typedef HIDCollectionNode *             HIDCollectionNodePtr;
struct HIDButtonCaps {
  HIDUsage            usagePage;
  UInt32              reportID;
  UInt32              bitField;
  UInt32              collection;
  HIDUsage            collectionUsage;
  HIDUsage            collectionUsagePage;
  Boolean             isRange;
  Boolean             isStringRange;
  Boolean             isDesignatorRange;
  Boolean             isAbsolute;

  union {
    struct {
      HIDUsage            usageMin;
      HIDUsage            usageMax;
      UInt32              stringMin;
      UInt32              stringMax;
      UInt32              designatorMin;
      UInt32              designatorMax;
    }                       range;
    struct {
      HIDUsage            usage;
      HIDUsage            reserved1;
      UInt32              stringIndex;
      UInt32              reserved2;
      UInt32              designatorIndex;
      UInt32              reserved3;
    }                       notRange;
  }                       u;
};
typedef struct HIDButtonCaps            HIDButtonCaps;
typedef HIDButtonCaps *                 HIDButtonCapsPtr;
struct HIDButtonCapabilities {
  HIDUsage            usagePage;
  UInt32              reportID;
  UInt32              bitField;
  UInt32              collection;
  HIDUsage            collectionUsage;
  HIDUsage            collectionUsagePage;

  Boolean             isRange;
  Boolean             isStringRange;
  Boolean             isDesignatorRange;
  Boolean             isAbsolute;

  SInt32              unitExponent;
  SInt32              units;
  UInt32              reserved;
  UInt32              pbVersion;

  union {
    struct {
      HIDUsage            usageMin;
      HIDUsage            usageMax;
      UInt32              stringMin;
      UInt32              stringMax;
      UInt32              designatorMin;
      UInt32              designatorMax;
    }                       range;
    struct {
      HIDUsage            usage;
      HIDUsage            reserved1;
      UInt32              stringIndex;
      UInt32              reserved2;
      UInt32              designatorIndex;
      UInt32              reserved3;
    }                       notRange;
  }                       u;
};
typedef struct HIDButtonCapabilities    HIDButtonCapabilities;
typedef HIDButtonCapabilities *         HIDButtonCapabilitiesPtr;
struct HIDValueCaps {
  HIDUsage            usagePage;
  UInt32              reportID;
  UInt32              bitField;
  UInt32              collection;
  HIDUsage            collectionUsage;
  HIDUsage            collectionUsagePage;

  Boolean             isRange;
  Boolean             isStringRange;
  Boolean             isDesignatorRange;
  Boolean             isAbsolute;

  UInt32              bitSize;
  UInt32              reportCount;

  SInt32              logicalMin;
  SInt32              logicalMax;
  SInt32              physicalMin;
  SInt32              physicalMax;

  union {
    struct {
      HIDUsage            usageMin;
      HIDUsage            usageMax;
      UInt32              stringMin;
      UInt32              stringMax;
      UInt32              designatorMin;
      UInt32              designatorMax;
    }                       range;
    struct {
      HIDUsage            usage;
      HIDUsage            reserved1;
      UInt32              stringIndex;
      UInt32              reserved2;
      UInt32              designatorIndex;
      UInt32              reserved3;
    }                       notRange;
  }                       u;
};
typedef struct HIDValueCaps             HIDValueCaps;
typedef HIDValueCaps *                  HIDValueCapsPtr;
struct HIDValueCapabilities {
  HIDUsage            usagePage;
  UInt32              reportID;
  UInt32              bitField;
  UInt32              collection;
  HIDUsage            collectionUsage;
  HIDUsage            collectionUsagePage;

  Boolean             isRange;
  Boolean             isStringRange;
  Boolean             isDesignatorRange;
  Boolean             isAbsolute;

  UInt32              bitSize;
  UInt32              reportCount;

  SInt32              logicalMin;
  SInt32              logicalMax;
  SInt32              physicalMin;
  SInt32              physicalMax;

  SInt32              unitExponent;
  SInt32              units;
  UInt32              reserved;
  UInt32              pbVersion;

  union {
    struct {
      HIDUsage            usageMin;
      HIDUsage            usageMax;
      UInt32              stringMin;
      UInt32              stringMax;
      UInt32              designatorMin;
      UInt32              designatorMax;
    }                       range;
    struct {
      HIDUsage            usage;
      HIDUsage            reserved1;
      UInt32              stringIndex;
      UInt32              reserved2;
      UInt32              designatorIndex;
      UInt32              reserved3;
    }                       notRange;
  }                       u;
};
typedef struct HIDValueCapabilities     HIDValueCapabilities;
typedef HIDValueCapabilities *          HIDValueCapabilitiesPtr;
#if CALL_NOT_IN_CARBON
/*
 *  HIDGetHIDLibVersion()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4.3 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( UInt32 )
HIDGetHIDLibVersion(void);


/*
 *  HIDOpenReportDescriptor()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDOpenReportDescriptor(
  void *                 hidReportDescriptor,
  ByteCount              descriptorLength,
  HIDPreparsedDataRef *  preparsedDataRef,
  UInt32                 flags);


/*
 *  HIDCloseReportDescriptor()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDCloseReportDescriptor(HIDPreparsedDataRef preparsedDataRef);



/*
 *  HIDGetCaps()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetCaps(
  HIDPreparsedDataRef   preparsedDataRef,
  HIDCapsPtr            capabilities);


/*
 *  HIDGetCapabilities()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4.3 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetCapabilities(
  HIDPreparsedDataRef   preparsedDataRef,
  HIDCapabilitiesPtr    capabilities);


/*
 *  HIDGetCollectionNodes()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetCollectionNodes(
  HIDCollectionNodePtr   collectionNodes,
  UInt32 *               collectionNodesSize,
  HIDPreparsedDataRef    preparsedDataRef);


/*
 *  HIDGetButtonCaps()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetButtonCaps(
  HIDReportType         reportType,
  HIDButtonCapsPtr      buttonCaps,
  UInt32 *              buttonCapsSize,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDGetButtonCapabilities()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4.3 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetButtonCapabilities(
  HIDReportType              reportType,
  HIDButtonCapabilitiesPtr   buttonCaps,
  UInt32 *                   buttonCapsSize,
  HIDPreparsedDataRef        preparsedDataRef);


/*
 *  HIDGetValueCaps()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetValueCaps(
  HIDReportType         reportType,
  HIDValueCapsPtr       valueCaps,
  UInt32 *              valueCapsSize,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDGetValueCapabilities()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4.3 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetValueCapabilities(
  HIDReportType             reportType,
  HIDValueCapabilitiesPtr   valueCaps,
  UInt32 *                  valueCapsSize,
  HIDPreparsedDataRef       preparsedDataRef);


/*
 *  HIDGetSpecificButtonCaps()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetSpecificButtonCaps(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  HIDButtonCapsPtr      buttonCaps,
  UInt32 *              buttonCapsSize,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDGetSpecificButtonCapabilities()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4.3 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetSpecificButtonCapabilities(
  HIDReportType              reportType,
  HIDUsage                   usagePage,
  UInt32                     collection,
  HIDUsage                   usage,
  HIDButtonCapabilitiesPtr   buttonCaps,
  UInt32 *                   buttonCapsSize,
  HIDPreparsedDataRef        preparsedDataRef);


/*
 *  HIDGetSpecificValueCaps()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetSpecificValueCaps(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  HIDValueCapsPtr       valueCaps,
  UInt32 *              valueCapsSize,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDGetSpecificValueCapabilities()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4.3 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetSpecificValueCapabilities(
  HIDReportType             reportType,
  HIDUsage                  usagePage,
  UInt32                    collection,
  HIDUsage                  usage,
  HIDValueCapabilitiesPtr   valueCaps,
  UInt32 *                  valueCapsSize,
  HIDPreparsedDataRef       preparsedDataRef);


/*
 *  HIDGetNextButtonInfo()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetNextButtonInfo(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  HIDUsage              usage,
  UInt32 *              collection,
  UInt8 *               reportID,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDGetNextUsageValueInfo()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetNextUsageValueInfo(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  HIDUsage              usage,
  UInt32 *              collection,
  UInt8 *               reportID,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDMaxUsageListLength()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( UInt32 )
HIDMaxUsageListLength(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDGetReportLength()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetReportLength(
  HIDReportType         reportType,
  UInt8                 reportID,
  ByteCount *           reportLength,
  HIDPreparsedDataRef   preparsedDataRef);


/*
 *  HIDInitReport()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.4 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDInitReport(
  HIDReportType         reportType,
  UInt8                 reportID,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);



/*
 *  HIDGetButtons()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetButtons(
  HIDReportType         reportType,
  UInt32                collection,
  HIDUsageAndPagePtr    usageList,
  UInt32 *              usageListSize,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDGetButtonsOnPage()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetButtonsOnPage(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage *            usageList,
  UInt32 *              usageListSize,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDGetScaledUsageValue()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetScaledUsageValue(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  SInt32 *              usageValue,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDGetUsageValue()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetUsageValue(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  SInt32 *              usageValue,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDGetUsageValueArray()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDGetUsageValueArray(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  Byte *                usageValueBuffer,
  ByteCount             usageValueBufferSize,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);



/*
 *  HIDSetButton()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDSetButton(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDSetButtons()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDSetButtons(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage *            usageList,
  UInt32 *              usageListSize,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDSetScaledUsageValue()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDSetScaledUsageValue(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  SInt32                usageValue,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDSetUsageValue()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDSetUsageValue(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  SInt32                usageValue,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDSetUsageValueArray()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDSetUsageValueArray(
  HIDReportType         reportType,
  HIDUsage              usagePage,
  UInt32                collection,
  HIDUsage              usage,
  Byte *                usageValueBuffer,
  ByteCount             usageValueBufferLength,
  HIDPreparsedDataRef   preparsedDataRef,
  void *                report,
  ByteCount             reportLength);


/*
 *  HIDUsageListDifference()
 *  
 *  Availability:
 *    Non-Carbon CFM:   in HIDLib 1.0 and later
 *    CarbonLib:        not available
 *    Mac OS X:         not available
 */
EXTERN_API_C( OSStatus )
HIDUsageListDifference(
  HIDUsage *  previousUsageList,
  HIDUsage *  currentUsageList,
  HIDUsage *  breakUsageList,
  HIDUsage *  makeUsageList,
  UInt32      usageListsSize);


/*
   
    Interfaces for a HID device driver
*/

/* these are the constants to be passed to HIDGetDeviceInfo*/
#endif  /* CALL_NOT_IN_CARBON */

enum {
  kHIDGetInfo_VendorID          = 1,
  kHIDGetInfo_ProductID         = 2,
  kHIDGetInfo_VersionNumber     = 3,
  kHIDGetInfo_InterfaceRef      = 4,
  kHIDGetInfo_MaxReportSize     = 0x10,
  kHIDGetInfo_GetManufacturerString = 0x0100,
  kHIDGetInfo_GetProductString  = 0x0101,
  kHIDGetInfo_GetSerialNumberString = 0x0102,
  kHIDGetInfo_VendorSpecificStart = 0x00010000
};

/* these are the valid permissions to pass to HIDOpenDevice*/
enum {
  kHIDPerm_ReadOnly             = 0x0001,
  kHIDPerm_ReadWriteShared      = 0x0003,
  kHIDPerm_ReadWriteExclusive   = 0x0013
};

/* these are flags used in HIDInstallReportHandler*/
enum {
  kHIDFlag_CallbackIsResident   = 0x0001
};


/* these are the constants to be passed to HIDControlDevice*/
enum {
  kHIDVendorSpecificControlStart = 0x00010000
};

/* these constant versions are used in the HIDDeviceDispatchTable structure*/
enum {
  kHIDCurrentDispatchTableVersion = 3,
  kHIDOldestCompatableDispatchTableVersion = 1,
  kHIDDispatchTableVersion1     = 1,
  kHIDDispatchTableVersion2     = 2,
  kHIDDispatchTableVersion1OldestCompatible = 1
};

typedef struct OpaqueHIDDeviceConnectionRef*  HIDDeviceConnectionRef;
/* HIDGetDeviceInfo is used to get specific information about a HID Device*/
typedef CALLBACK_API_C( OSStatus , HIDGetDeviceInfoProcPtr )(UInt32 inInfoSelector, void *outInfo, ByteCount *ioSize);
/* HIDGetHIDDescriptor is used to get a specific HID descriptor from a HID device (such as a report descriptor)*/
typedef CALLBACK_API_C( OSStatus , HIDGetHIDDescriptorProcPtr )(UInt32 inDescriptorType, UInt32 inDescriptorIndex, void *outDescriptor, UInt32 *ioBufferSize);
/* You must first 'open' a device before using it*/
typedef CALLBACK_API_C( OSStatus , HIDOpenDeviceProcPtr )(HIDDeviceConnectionRef *outConnectionRef, UInt32 permissions, UInt32 reserved);
/* When finished, 'close' a device*/
typedef CALLBACK_API_C( OSStatus , HIDCloseDeviceProcPtr )(HIDDeviceConnectionRef inConnectionRef);
/* User provided ProcPtr to be called when HID report is received*/
typedef CALLBACK_API_C( void , HIDReportHandlerProcPtr )(void *inHIDReport, UInt32 inHIDReportLength, UInt32 inRefcon);
/* User provided ProcPtr to be called when indexed string is received*/
typedef CALLBACK_API_C( void , HIDStringHandlerProcPtr )(void *inHIDReport, UInt32 inHIDReportLength, UInt32 inRefcon, OSStatus inStatus);
/*
   When installed, a report handler is called at defered task time (unless kHIDFlag_CallbackIsResident is passed) 
   whenever an interrupt packet is recieved on the first interrupt in pipe. The supplied refcon is also passed thru.
*/
typedef CALLBACK_API_C( OSStatus , HIDInstallReportHandlerProcPtr )(HIDDeviceConnectionRef inConnectionRef, UInt32 flags, HIDReportHandlerProcPtr inReportHandlerProc, UInt32 inRefcon);
/* When finished, remove the report handler.*/
typedef CALLBACK_API_C( OSStatus , HIDRemoveReportHandlerProcPtr )(HIDDeviceConnectionRef inConnectionRef);
/* If there was a HIDReportHandler installed previous to the one from this connection, pass that one this report*/
typedef CALLBACK_API_C( OSStatus , HIDCallPreviousReportHandlerProcPtr )(HIDDeviceConnectionRef inConnectionRef, void *inHIDReport, UInt32 inHIDReportLength);
/*
   HIDGetReport is used to get a report (of type input, output, or feature) directly from a HID device
   the HIDReportHandler will be called with the report when it is received.
*/
typedef CALLBACK_API_C( OSStatus , HIDGetReportProcPtr )(HIDDeviceConnectionRef inConnectionRef, UInt32 inReportType, UInt32 inReportID, HIDReportHandlerProcPtr inReportHandlerProc, UInt32 inRefcon);
/* HIDGetSizedReport is used like HIDGetReport, but for devices that require exact size to return report.*/
typedef CALLBACK_API_C( OSStatus , HIDGetSizedReportProcPtr )(HIDDeviceConnectionRef inConnectionRef, UInt32 inReportType, UInt32 inReportID, ByteCount inSize, HIDReportHandlerProcPtr inReportHandlerProc, UInt32 inRefcon);
/* HIDSetReport is used to send a report (of type input, output, or feature) directly to a HID device*/
typedef CALLBACK_API_C( OSStatus , HIDSetReportProcPtr )(HIDDeviceConnectionRef inConnectionRef, UInt32 inReportType, UInt32 inReportID, void *inInfo, ByteCount inSize);
/* HIDControlDevice is used to send misc control messages to a device*/
typedef CALLBACK_API_C( OSStatus , HIDControlDeviceProcPtr )(HIDDeviceConnectionRef inConnectionRef, UInt32 inControlSelector, void *ioControlData);
/*
   HIDGetIndexedString is used to get a string directly from a HID device.
   The HIDStringHandler will be called with the string when it is received or nil string if completed with an error.
*/
typedef CALLBACK_API_C( OSStatus , HIDGetIndexedStringProcPtr )(HIDDeviceConnectionRef inConnectionRef, UInt32 inStringIndex, UInt32 inStringLanguage, HIDStringHandlerProcPtr inStringHandlerProc, UInt32 inRefcon);
/*
   dispatchTableCurrentVersion is kHIDCurrentDispatchTableVersion
   dispatchTableOldestVersion is kHIDOldestCompatableDispatchTableVersion
        (the oldest built client using this API that this HID device driver will work with)
   vendorID is who wrote this HID device driver (hi word of 0 and USB vendorID is valid)
*/
struct HIDDeviceDispatchTable {
  UInt32              dispatchTableCurrentVersion;
  UInt32              dispatchTableOldestVersion;
  UInt32              vendorID;
  UInt32              vendorSpecific;
  UInt32              reserved;

  HIDGetDeviceInfoProcPtr  pHIDGetDeviceInfo;
  HIDGetHIDDescriptorProcPtr  pHIDGetHIDDescriptor;
  HIDOpenDeviceProcPtr  pHIDOpenDevice;
  HIDCloseDeviceProcPtr  pHIDCloseDevice;
  HIDInstallReportHandlerProcPtr  pHIDInstallReportHandler;
  HIDRemoveReportHandlerProcPtr  pHIDRemoveReportHandler;
  HIDCallPreviousReportHandlerProcPtr  pHIDCallPreviousReportHandler;
  HIDGetReportProcPtr  pHIDGetReport;         /* new for vers 2, was reserved in version 1*/
  HIDSetReportProcPtr  pHIDSetReport;         /* new for vers 2, was reserved in version 1*/
  HIDControlDeviceProcPtr  pHIDControlDevice;
  HIDGetIndexedStringProcPtr  pHIDGetIndexedString; /* new for vers 3*/
  HIDGetSizedReportProcPtr  pHIDGetSizedReport; /* new for vers 3*/
};
typedef struct HIDDeviceDispatchTable   HIDDeviceDispatchTable;
typedef HIDDeviceDispatchTable *        HIDDeviceDispatchTablePtr;
/* A USB HIDDevice driver should export a HIDDeviceDispatchTable symbol */
/* in it's PEF container, with the name "\pTheHIDDeviceDispatchTable" */


/* ****************************************************************************************** */
/* HID Usage Tables                                                                           */
/*                                                                                            */
/* The following constants are from the USB 'HID Usage Tables' specification, revision 1.1rc3 */
/* ****************************************************************************************** */

/* Usage Pages */
enum {
  kHIDPage_Undefined            = 0x00,
  kHIDPage_GenericDesktop       = 0x01,
  kHIDPage_Simulation           = 0x02,
  kHIDPage_VR                   = 0x03,
  kHIDPage_Sport                = 0x04,
  kHIDPage_Game                 = 0x05, /* Reserved 0x06 */
  kHIDPage_KeyboardOrKeypad     = 0x07, /* USB Device Class Definition for Human Interface Devices (HID). Note: the usage type for all key codes is Selector (Sel). */
  kHIDPage_LEDs                 = 0x08,
  kHIDPage_Button               = 0x09,
  kHIDPage_Ordinal              = 0x0A,
  kHIDPage_Telephony            = 0x0B,
  kHIDPage_Consumer             = 0x0C,
  kHIDPage_Digitizer            = 0x0D, /* Reserved 0x0E */
  kHIDPage_PID                  = 0x0F, /* USB Physical Interface Device definitions for force feedback and related devices. */
  kHIDPage_Unicode              = 0x10, /* Reserved 0x11 - 0x13 */
  kHIDPage_AlphanumericDisplay  = 0x14, /* Reserved 0x15 - 0x7F */
                                        /* Monitor 0x80 - 0x83     USB Device Class Definition for Monitor Devices */
                                        /* Power 0x84 - 0x87   USB Device Class Definition for Power Devices */
                                        /* Reserved 0x88 - 0x8B */
  kHIDPage_BarCodeScanner       = 0x8C, /* (Point of Sale) USB Device Class Definition for Bar Code Scanner Devices */
  kHIDPage_Scale                = 0x8D, /* (Point of Sale) USB Device Class Definition for Scale Devices */
                                        /* ReservedPointofSalepages 0x8E - 0x8F */
  kHIDPage_CameraControl        = 0x90, /* USB Device Class Definition for Image Class Devices */
  kHIDPage_Arcade               = 0x91, /* OAAF Definitions for arcade and coinop related Devices */
                                        /* Reserved 0x92 - 0xFEFF */
                                        /* VendorDefined 0xFF00 - 0xFFFF */
  kHIDPage_VendorDefinedStart   = 0xFF00
};

/* Undefined Usage for all usage pages */
enum {
  kHIDUsage_Undefined           = 0x00
};

/* GenericDesktop Page (0x01) */
enum {
  kHIDUsage_GD_Pointer          = 0x01, /* Physical Collection */
  kHIDUsage_GD_Mouse            = 0x02, /* Application Collection */
                                        /* 0x03 Reserved */
  kHIDUsage_GD_Joystick         = 0x04, /* Application Collection */
  kHIDUsage_GD_GamePad          = 0x05, /* Application Collection */
  kHIDUsage_GD_Keyboard         = 0x06, /* Application Collection */
  kHIDUsage_GD_Keypad           = 0x07, /* Application Collection */
  kHIDUsage_GD_MultiAxisController = 0x08, /* Application Collection */
                                        /* 0x09 - 0x2F Reserved */
  kHIDUsage_GD_X                = 0x30, /* Dynamic Value */
  kHIDUsage_GD_Y                = 0x31, /* Dynamic Value */
  kHIDUsage_GD_Z                = 0x32, /* Dynamic Value */
  kHIDUsage_GD_Rx               = 0x33, /* Dynamic Value */
  kHIDUsage_GD_Ry               = 0x34, /* Dynamic Value */
  kHIDUsage_GD_Rz               = 0x35, /* Dynamic Value */
  kHIDUsage_GD_Slider           = 0x36, /* Dynamic Value */
  kHIDUsage_GD_Dial             = 0x37, /* Dynamic Value */
  kHIDUsage_GD_Wheel            = 0x38, /* Dynamic Value */
  kHIDUsage_GD_Hatswitch        = 0x39, /* Dynamic Value */
  kHIDUsage_GD_CountedBuffer    = 0x3A, /* Logical Collection */
  kHIDUsage_GD_ByteCount        = 0x3B, /* Dynamic Value */
  kHIDUsage_GD_MotionWakeup     = 0x3C, /* One-Shot Control */
  kHIDUsage_GD_Start            = 0x3D, /* On/Off Control */
  kHIDUsage_GD_Select           = 0x3E, /* On/Off Control */
                                        /* 0x3F Reserved */
  kHIDUsage_GD_Vx               = 0x40, /* Dynamic Value */
  kHIDUsage_GD_Vy               = 0x41, /* Dynamic Value */
  kHIDUsage_GD_Vz               = 0x42, /* Dynamic Value */
  kHIDUsage_GD_Vbrx             = 0x43, /* Dynamic Value */
  kHIDUsage_GD_Vbry             = 0x44, /* Dynamic Value */
  kHIDUsage_GD_Vbrz             = 0x45, /* Dynamic Value */
  kHIDUsage_GD_Vno              = 0x46, /* Dynamic Value */
                                        /* 0x47 - 0x7F Reserved */
  kHIDUsage_GD_SystemControl    = 0x80, /* Application Collection */
  kHIDUsage_GD_SystemPowerDown  = 0x81, /* One-Shot Control */
  kHIDUsage_GD_SystemSleep      = 0x82, /* One-Shot Control */
  kHIDUsage_GD_SystemWakeUp     = 0x83, /* One-Shot Control */
  kHIDUsage_GD_SystemContextMenu = 0x84, /* One-Shot Control */
  kHIDUsage_GD_SystemMainMenu   = 0x85, /* One-Shot Control */
  kHIDUsage_GD_SystemAppMenu    = 0x86, /* One-Shot Control */
  kHIDUsage_GD_SystemMenuHelp   = 0x87, /* One-Shot Control */
  kHIDUsage_GD_SystemMenuExit   = 0x88, /* One-Shot Control */
  kHIDUsage_GD_SystemMenu       = 0x89, /* Selector */
  kHIDUsage_GD_SystemMenuRight  = 0x8A, /* Re-Trigger Control */
  kHIDUsage_GD_SystemMenuLeft   = 0x8B, /* Re-Trigger Control */
  kHIDUsage_GD_SystemMenuUp     = 0x8C, /* Re-Trigger Control */
  kHIDUsage_GD_SystemMenuDown   = 0x8D, /* Re-Trigger Control */
                                        /* 0x8E - 0x8F Reserved */
  kHIDUsage_GD_DPadUp           = 0x90, /* On/Off Control */
  kHIDUsage_GD_DPadDown         = 0x91, /* On/Off Control */
  kHIDUsage_GD_DPadRight        = 0x92, /* On/Off Control */
  kHIDUsage_GD_DPadLeft         = 0x93, /* On/Off Control */
                                        /* 0x94 - 0xFFFF Reserved */
  kHIDUsage_GD_Reserved         = 0xFFFF
};

/* Simulation Page (0x02) */
/* This section provides detailed descriptions of the usages employed by simulation devices. */
enum {
  kHIDUsage_Sim_FlightSimulationDevice = 0x01, /* Application Collection */
  kHIDUsage_Sim_AutomobileSimulationDevice = 0x02, /* Application Collection */
  kHIDUsage_Sim_TankSimulationDevice = 0x03, /* Application Collection */
  kHIDUsage_Sim_SpaceshipSimulationDevice = 0x04, /* Application Collection */
  kHIDUsage_Sim_SubmarineSimulationDevice = 0x05, /* Application Collection */
  kHIDUsage_Sim_SailingSimulationDevice = 0x06, /* Application Collection */
  kHIDUsage_Sim_MotorcycleSimulationDevice = 0x07, /* Application Collection */
  kHIDUsage_Sim_SportsSimulationDevice = 0x08, /* Application Collection */
  kHIDUsage_Sim_AirplaneSimulationDevice = 0x09, /* Application Collection */
  kHIDUsage_Sim_HelicopterSimulationDevice = 0x0A, /* Application Collection */
  kHIDUsage_Sim_MagicCarpetSimulationDevice = 0x0B, /* Application Collection */
  kHIDUsage_Sim_BicycleSimulationDevice = 0x0C, /* Application Collection */
                                        /* 0x0D - 0x1F Reserved */
  kHIDUsage_Sim_FlightControlStick = 0x20, /* Application Collection */
  kHIDUsage_Sim_FlightStick     = 0x21, /* Application Collection */
  kHIDUsage_Sim_CyclicControl   = 0x22, /* Physical Collection */
  kHIDUsage_Sim_CyclicTrim      = 0x23, /* Physical Collection */
  kHIDUsage_Sim_FlightYoke      = 0x24, /* Application Collection */
  kHIDUsage_Sim_TrackControl    = 0x25, /* Physical Collection */
                                        /* 0x26 - 0xAF Reserved */
  kHIDUsage_Sim_Aileron         = 0xB0, /* Dynamic Value */
  kHIDUsage_Sim_AileronTrim     = 0xB1, /* Dynamic Value */
  kHIDUsage_Sim_AntiTorqueControl = 0xB2, /* Dynamic Value */
  kHIDUsage_Sim_AutopilotEnable = 0xB3, /* On/Off Control */
  kHIDUsage_Sim_ChaffRelease    = 0xB4, /* One-Shot Control */
  kHIDUsage_Sim_CollectiveControl = 0xB5, /* Dynamic Value */
  kHIDUsage_Sim_DiveBrake       = 0xB6, /* Dynamic Value */
  kHIDUsage_Sim_ElectronicCountermeasures = 0xB7, /* On/Off Control */
  kHIDUsage_Sim_Elevator        = 0xB8, /* Dynamic Value */
  kHIDUsage_Sim_ElevatorTrim    = 0xB9, /* Dynamic Value */
  kHIDUsage_Sim_Rudder          = 0xBA, /* Dynamic Value */
  kHIDUsage_Sim_Throttle        = 0xBB, /* Dynamic Value */
  kHIDUsage_Sim_FlightCommunications = 0xBC, /* On/Off Control */
  kHIDUsage_Sim_FlareRelease    = 0xBD, /* One-Shot Control */
  kHIDUsage_Sim_LandingGear     = 0xBE, /* On/Off Control */
  kHIDUsage_Sim_ToeBrake        = 0xBF, /* Dynamic Value */
  kHIDUsage_Sim_Trigger         = 0xC0, /* Momentary Control */
  kHIDUsage_Sim_WeaponsArm      = 0xC1, /* On/Off Control */
  kHIDUsage_Sim_Weapons         = 0xC2, /* Selector */
  kHIDUsage_Sim_WingFlaps       = 0xC3, /* Dynamic Value */
  kHIDUsage_Sim_Accelerator     = 0xC4, /* Dynamic Value */
  kHIDUsage_Sim_Brake           = 0xC5, /* Dynamic Value */
  kHIDUsage_Sim_Clutch          = 0xC6, /* Dynamic Value */
  kHIDUsage_Sim_Shifter         = 0xC7, /* Dynamic Value */
  kHIDUsage_Sim_Steering        = 0xC8, /* Dynamic Value */
  kHIDUsage_Sim_TurretDirection = 0xC9, /* Dynamic Value */
  kHIDUsage_Sim_BarrelElevation = 0xCA, /* Dynamic Value */
  kHIDUsage_Sim_DivePlane       = 0xCB, /* Dynamic Value */
  kHIDUsage_Sim_Ballast         = 0xCC, /* Dynamic Value */
  kHIDUsage_Sim_BicycleCrank    = 0xCD, /* Dynamic Value */
  kHIDUsage_Sim_HandleBars      = 0xCE, /* Dynamic Value */
  kHIDUsage_Sim_FrontBrake      = 0xCF, /* Dynamic Value */
  kHIDUsage_Sim_RearBrake       = 0xD0, /* Dynamic Value */
                                        /* 0xD1 - 0xFFFF Reserved */
  kHIDUsage_Sim_Reserved        = 0xFFFF
};

/* VR Page (0x03) */
/* Virtual Reality controls depend on designators to identify the individual controls. Most of the following are */
/* usages are applied to the collections of entities that comprise the actual device. */
enum {
  kHIDUsage_VR_Belt             = 0x01, /* Application Collection */
  kHIDUsage_VR_BodySuit         = 0x02, /* Application Collection */
  kHIDUsage_VR_Flexor           = 0x03, /* Physical Collection */
  kHIDUsage_VR_Glove            = 0x04, /* Application Collection */
  kHIDUsage_VR_HeadTracker      = 0x05, /* Physical Collection */
  kHIDUsage_VR_HeadMountedDisplay = 0x06, /* Application Collection */
  kHIDUsage_VR_HandTracker      = 0x07, /* Application Collection */
  kHIDUsage_VR_Oculometer       = 0x08, /* Application Collection */
  kHIDUsage_VR_Vest             = 0x09, /* Application Collection */
  kHIDUsage_VR_AnimatronicDevice = 0x0A, /* Application Collection */
                                        /* 0x0B - 0x1F Reserved */
  kHIDUsage_VR_StereoEnable     = 0x20, /* On/Off Control */
  kHIDUsage_VR_DisplayEnable    = 0x21, /* On/Off Control */
                                        /* 0x22 - 0xFFFF Reserved */
  kHIDUsage_VR_Reserved         = 0xFFFF
};

/* Sport Page (0x04) */
enum {
  kHIDUsage_Sprt_BaseballBat    = 0x01, /* Application Collection */
  kHIDUsage_Sprt_GolfClub       = 0x02, /* Application Collection */
  kHIDUsage_Sprt_RowingMachine  = 0x03, /* Application Collection */
  kHIDUsage_Sprt_Treadmill      = 0x04, /* Application Collection */
                                        /* 0x05 - 0x2F Reserved */
  kHIDUsage_Sprt_Oar            = 0x30, /* Dynamic Value */
  kHIDUsage_Sprt_Slope          = 0x31, /* Dynamic Value */
  kHIDUsage_Sprt_Rate           = 0x32, /* Dynamic Value */
  kHIDUsage_Sprt_StickSpeed     = 0x33, /* Dynamic Value */
  kHIDUsage_Sprt_StickFaceAngle = 0x34, /* Dynamic Value */
  kHIDUsage_Sprt_StickHeelOrToe = 0x35, /* Dynamic Value */
  kHIDUsage_Sprt_StickFollowThrough = 0x36, /* Dynamic Value */
  kHIDUsage_Sprt_StickTempo     = 0x37, /* Dynamic Value */
  kHIDUsage_Sprt_StickType      = 0x38, /* Named Array */
  kHIDUsage_Sprt_StickHeight    = 0x39, /* Dynamic Value */
                                        /* 0x3A - 0x4F Reserved */
  kHIDUsage_Sprt_Putter         = 0x50, /* Selector */
  kHIDUsage_Sprt_1Iron          = 0x51, /* Selector */
  kHIDUsage_Sprt_2Iron          = 0x52, /* Selector */
  kHIDUsage_Sprt_3Iron          = 0x53, /* Selector */
  kHIDUsage_Sprt_4Iron          = 0x54, /* Selector */
  kHIDUsage_Sprt_5Iron          = 0x55, /* Selector */
  kHIDUsage_Sprt_6Iron          = 0x56, /* Selector */
  kHIDUsage_Sprt_7Iron          = 0x57, /* Selector */
  kHIDUsage_Sprt_8Iron          = 0x58, /* Selector */
  kHIDUsage_Sprt_9Iron          = 0x59, /* Selector */
  kHIDUsage_Sprt_10Iron         = 0x5A, /* Selector */
  kHIDUsage_Sprt_11Iron         = 0x5B, /* Selector */
  kHIDUsage_Sprt_SandWedge      = 0x5C, /* Selector */
  kHIDUsage_Sprt_LoftWedge      = 0x5D, /* Selector */
  kHIDUsage_Sprt_PowerWedge     = 0x5E, /* Selector */
  kHIDUsage_Sprt_1Wood          = 0x5F, /* Selector */
  kHIDUsage_Sprt_3Wood          = 0x60, /* Selector */
  kHIDUsage_Sprt_5Wood          = 0x61, /* Selector */
  kHIDUsage_Sprt_7Wood          = 0x62, /* Selector */
  kHIDUsage_Sprt_9Wood          = 0x63, /* Selector */
                                        /* 0x64 - 0xFFFF Reserved */
  kHIDUsage_Sprt_Reserved       = 0xFFFF
};

/* Game Page (0x05) */
enum {
  kHIDUsage_Game_3DGameController = 0x01, /* Application Collection */
  kHIDUsage_Game_PinballDevice  = 0x02, /* Application Collection */
  kHIDUsage_Game_GunDevice      = 0x03, /* Application Collection */
                                        /* 0x04 - 0x1F Reserved */
  kHIDUsage_Game_PointofView    = 0x20, /* Physical Collection */
  kHIDUsage_Game_TurnRightOrLeft = 0x21, /* Dynamic Value */
  kHIDUsage_Game_PitchUpOrDown  = 0x22, /* Dynamic Value */
  kHIDUsage_Game_RollRightOrLeft = 0x23, /* Dynamic Value */
  kHIDUsage_Game_MoveRightOrLeft = 0x24, /* Dynamic Value */
  kHIDUsage_Game_MoveForwardOrBackward = 0x25, /* Dynamic Value */
  kHIDUsage_Game_MoveUpOrDown   = 0x26, /* Dynamic Value */
  kHIDUsage_Game_LeanRightOrLeft = 0x27, /* Dynamic Value */
  kHIDUsage_Game_LeanForwardOrBackward = 0x28, /* Dynamic Value */
  kHIDUsage_Game_HeightOfPOV    = 0x29, /* Dynamic Value */
  kHIDUsage_Game_Flipper        = 0x2A, /* Momentary Control */
  kHIDUsage_Game_SecondaryFlipper = 0x2B, /* Momentary Control */
  kHIDUsage_Game_Bump           = 0x2C, /* Momentary Control */
  kHIDUsage_Game_NewGame        = 0x2D, /* One-Shot Control */
  kHIDUsage_Game_ShootBall      = 0x2E, /* One-Shot Control */
  kHIDUsage_Game_Player         = 0x2F, /* One-Shot Control */
  kHIDUsage_Game_GunBolt        = 0x30, /* On/Off Control */
  kHIDUsage_Game_GunClip        = 0x31, /* On/Off Control */
  kHIDUsage_Game_Gun            = 0x32, /* Selector */
  kHIDUsage_Game_GunSingleShot  = 0x33, /* Selector */
  kHIDUsage_Game_GunBurst       = 0x34, /* Selector */
  kHIDUsage_Game_GunAutomatic   = 0x35, /* Selector */
  kHIDUsage_Game_GunSafety      = 0x36, /* On/Off Control */
  kHIDUsage_Game_GamepadFireOrJump = 0x37, /* Logical Collection */
  kHIDUsage_Game_GamepadTrigger = 0x39, /* Logical Collection */
                                        /* 0x3A - 0xFFFF Reserved */
  kHIDUsage_Game_Reserved       = 0xFFFF
};

/* KeyboardOrKeypad Page (0x07) */
/* This section is the Usage Page for key codes to be used in implementing a USB keyboard.  */
/* A Boot Keyboard (84-, 101- or 104-key) should at a minimum support all associated usage codes as */
/* indicated in the ÒBootÓ column below. */
/* The usage type of all key codes is Selectors (Sel), except for the modifier keys Keyboard Left Control (0x224) */
/* to Keyboard Right GUI (0x231) which are Dynamic Flags (DV). */
/* Note: A general note on Usages and languages: */
/* Due to the variation of keyboards from language to language, it is not feasible to specify exact key mappings */
/* for every language. Where this list is not specific for a key function in a language, the closest equivalent key */
/* position should be used, so that a keyboard may be modified for a different language by simply printing different */
/* keycaps. One example is the Y key on a North American keyboard. In Germany this is typically Z. Rather than changing */
/* the keyboard firmware to put the Z Usage into that place in the descriptor list, the vendor should use the Y Usage on */
/* both the North American and German keyboards. This continues to be the existing practice in the industry, in order to */
/* minimize the number of changes to the electronics to accommodate otherlanguages. */
enum {
  kHIDUsage_KeyboardErrorRollOver = 0x01, /* ErrorRollOver */
  kHIDUsage_KeyboardPOSTFail    = 0x02, /* POSTFail */
  kHIDUsage_KeyboardErrorUndefined = 0x03, /* ErrorUndefined */
  kHIDUsage_KeyboardA           = 0x04, /* a or A */
  kHIDUsage_KeyboardB           = 0x05, /* b or B */
  kHIDUsage_KeyboardC           = 0x06, /* c or C */
  kHIDUsage_KeyboardD           = 0x07, /* d or D */
  kHIDUsage_KeyboardE           = 0x08, /* e or E */
  kHIDUsage_KeyboardF           = 0x09, /* f or F */
  kHIDUsage_KeyboardG           = 0x0A, /* g or G */
  kHIDUsage_KeyboardH           = 0x0B, /* h or H */
  kHIDUsage_KeyboardI           = 0x0C, /* i or I */
  kHIDUsage_KeyboardJ           = 0x0D, /* j or J */
  kHIDUsage_KeyboardK           = 0x0E, /* k or K */
  kHIDUsage_KeyboardL           = 0x0F, /* l or L */
  kHIDUsage_KeyboardM           = 0x10, /* m or M */
  kHIDUsage_KeyboardN           = 0x11, /* n or N */
  kHIDUsage_KeyboardO           = 0x12, /* o or O */
  kHIDUsage_KeyboardP           = 0x13, /* p or P */
  kHIDUsage_KeyboardQ           = 0x14, /* q or Q */
  kHIDUsage_KeyboardR           = 0x15, /* r or R */
  kHIDUsage_KeyboardS           = 0x16, /* s or S */
  kHIDUsage_KeyboardT           = 0x17, /* t or T */
  kHIDUsage_KeyboardU           = 0x18, /* u or U */
  kHIDUsage_KeyboardV           = 0x19, /* v or V */
  kHIDUsage_KeyboardW           = 0x1A, /* w or W */
  kHIDUsage_KeyboardX           = 0x1B, /* x or X */
  kHIDUsage_KeyboardY           = 0x1C, /* y or Y */
  kHIDUsage_KeyboardZ           = 0x1D, /* z or Z */
  kHIDUsage_Keyboard1           = 0x1E, /* 1 or ! */
  kHIDUsage_Keyboard2           = 0x1F, /* 2 or @ */
  kHIDUsage_Keyboard3           = 0x20, /* 3 or # */
  kHIDUsage_Keyboard4           = 0x21, /* 4 or $ */
  kHIDUsage_Keyboard5           = 0x22, /* 5 or % */
  kHIDUsage_Keyboard6           = 0x23, /* 6 or ^ */
  kHIDUsage_Keyboard7           = 0x24, /* 7 or & */
  kHIDUsage_Keyboard8           = 0x25, /* 8 or * */
  kHIDUsage_Keyboard9           = 0x26, /* 9 or ( */
  kHIDUsage_Keyboard0           = 0x27, /* 0 or ) */
  kHIDUsage_KeyboardReturnOrEnter = 0x28, /* Return (Enter) */
  kHIDUsage_KeyboardEscape      = 0x29, /* Escape */
  kHIDUsage_KeyboardDeleteOrBackspace = 0x2A, /* Delete (Backspace) */
  kHIDUsage_KeyboardTab         = 0x2B, /* Tab */
  kHIDUsage_KeyboardSpacebar    = 0x2C, /* Spacebar */
  kHIDUsage_KeyboardHyphen      = 0x2D, /* - or _ */
  kHIDUsage_KeyboardEqualSign   = 0x2E, /* = or + */
  kHIDUsage_KeyboardOpenBracket = 0x2F, /* [ or { */
  kHIDUsage_KeyboardCloseBracket = 0x30, /* ] or } */
  kHIDUsage_KeyboardBackslash   = 0x31, /* \ or | */
  kHIDUsage_KeyboardNonUSPound  = 0x32, /* Non-US # or _ */
  kHIDUsage_KeyboardSemicolon   = 0x33, /* ; or : */
  kHIDUsage_KeyboardQuote       = 0x34, /* ' or " */
  kHIDUsage_KeyboardGraveAccentAndTilde = 0x35, /* Grave Accent and Tilde */
  kHIDUsage_KeyboardComma       = 0x36, /* , or < */
  kHIDUsage_KeyboardPeriod      = 0x37, /* . or > */
  kHIDUsage_KeyboardSlash       = 0x38, /* / or ? */
  kHIDUsage_KeyboardCapsLock    = 0x39, /* Caps Lock */
  kHIDUsage_KeyboardF1          = 0x3A, /* F1 */
  kHIDUsage_KeyboardF2          = 0x3B, /* F2 */
  kHIDUsage_KeyboardF3          = 0x3C, /* F3 */
  kHIDUsage_KeyboardF4          = 0x3D, /* F4 */
  kHIDUsage_KeyboardF5          = 0x3E, /* F5 */
  kHIDUsage_KeyboardF6          = 0x3F, /* F6 */
  kHIDUsage_KeyboardF7          = 0x40, /* F7 */
  kHIDUsage_KeyboardF8          = 0x41, /* F8 */
  kHIDUsage_KeyboardF9          = 0x42, /* F9 */
  kHIDUsage_KeyboardF10         = 0x43, /* F10 */
  kHIDUsage_KeyboardF11         = 0x44, /* F11 */
  kHIDUsage_KeyboardF12         = 0x45, /* F12 */
  kHIDUsage_KeyboardPrintScreen = 0x46, /* Print Screen */
  kHIDUsage_KeyboardScrollLock  = 0x47, /* Scroll Lock */
  kHIDUsage_KeyboardPause       = 0x48, /* Pause */
  kHIDUsage_KeyboardInsert      = 0x49, /* Insert */
  kHIDUsage_KeyboardHome        = 0x4A, /* Home */
  kHIDUsage_KeyboardPageUp      = 0x4B, /* Page Up */
  kHIDUsage_KeyboardDeleteForward = 0x4C, /* Delete Forward */
  kHIDUsage_KeyboardEnd         = 0x4D, /* End */
  kHIDUsage_KeyboardPageDown    = 0x4E, /* Page Down */
  kHIDUsage_KeyboardRightArrow  = 0x4F, /* Right Arrow */
  kHIDUsage_KeyboardLeftArrow   = 0x50, /* Left Arrow */
  kHIDUsage_KeyboardDownArrow   = 0x51, /* Down Arrow */
  kHIDUsage_KeyboardUpArrow     = 0x52, /* Up Arrow */
  kHIDUsage_KeypadNumLock       = 0x53, /* Keypad NumLock or Clear */
  kHIDUsage_KeypadSlash         = 0x54, /* Keypad / */
  kHIDUsage_KeypadAsterisk      = 0x55, /* Keypad * */
  kHIDUsage_KeypadHyphen        = 0x56, /* Keypad - */
  kHIDUsage_KeypadPlus          = 0x57, /* Keypad + */
  kHIDUsage_KeypadEnter         = 0x58, /* Keypad Enter */
  kHIDUsage_Keypad1             = 0x59, /* Keypad 1 or End */
  kHIDUsage_Keypad2             = 0x5A, /* Keypad 2 or Down Arrow */
  kHIDUsage_Keypad3             = 0x5B, /* Keypad 3 or Page Down */
  kHIDUsage_Keypad4             = 0x5C, /* Keypad 4 or Left Arrow */
  kHIDUsage_Keypad5             = 0x5D, /* Keypad 5 */
  kHIDUsage_Keypad6             = 0x5E, /* Keypad 6 or Right Arrow */
  kHIDUsage_Keypad7             = 0x5F, /* Keypad 7 or Home */
  kHIDUsage_Keypad8             = 0x60, /* Keypad 8 or Up Arrow */
  kHIDUsage_Keypad9             = 0x61, /* Keypad 9 or Page Up */
  kHIDUsage_Keypad0             = 0x62, /* Keypad 0 or Insert */
  kHIDUsage_KeypadPeriod        = 0x63, /* Keypad . or Delete */
  kHIDUsage_KeyboardNonUSBackslash = 0x64, /* Non-US \ or | */
  kHIDUsage_KeyboardApplication = 0x65, /* Application */
  kHIDUsage_KeyboardPower       = 0x66, /* Power */
  kHIDUsage_KeypadEqualSign     = 0x67, /* Keypad = */
  kHIDUsage_KeyboardF13         = 0x68, /* F13 */
  kHIDUsage_KeyboardF14         = 0x69, /* F14 */
  kHIDUsage_KeyboardF15         = 0x6A, /* F15 */
  kHIDUsage_KeyboardF16         = 0x6B, /* F16 */
  kHIDUsage_KeyboardF17         = 0x6C, /* F17 */
  kHIDUsage_KeyboardF18         = 0x6D, /* F18 */
  kHIDUsage_KeyboardF19         = 0x6E, /* F19 */
  kHIDUsage_KeyboardF20         = 0x6F, /* F20 */
  kHIDUsage_KeyboardF21         = 0x70, /* F21 */
  kHIDUsage_KeyboardF22         = 0x71, /* F22 */
  kHIDUsage_KeyboardF23         = 0x72, /* F23 */
  kHIDUsage_KeyboardF24         = 0x73, /* F24 */
  kHIDUsage_KeyboardExecute     = 0x74, /* Execute */
  kHIDUsage_KeyboardHelp        = 0x75, /* Help */
  kHIDUsage_KeyboardMenu        = 0x76, /* Menu */
  kHIDUsage_KeyboardSelect      = 0x77, /* Select */
  kHIDUsage_KeyboardStop        = 0x78, /* Stop */
  kHIDUsage_KeyboardAgain       = 0x79, /* Again */
  kHIDUsage_KeyboardUndo        = 0x7A, /* Undo */
  kHIDUsage_KeyboardCut         = 0x7B, /* Cut */
  kHIDUsage_KeyboardCopy        = 0x7C, /* Copy */
  kHIDUsage_KeyboardPaste       = 0x7D, /* Paste */
  kHIDUsage_KeyboardFind        = 0x7E, /* Find */
  kHIDUsage_KeyboardMute        = 0x7F, /* Mute */
  kHIDUsage_KeyboardVolumeUp    = 0x80, /* Volume Up */
  kHIDUsage_KeyboardVolumeDown  = 0x81, /* Volume Down */
  kHIDUsage_KeyboardLockingCapsLock = 0x82, /* Locking Caps Lock */
  kHIDUsage_KeyboardLockingNumLock = 0x83, /* Locking Num Lock */
  kHIDUsage_KeyboardLockingScrollLock = 0x84, /* Locking Scroll Lock */
  kHIDUsage_KeypadComma         = 0x85, /* Keypad Comma */
  kHIDUsage_KeypadEqualSignAS400 = 0x86, /* Keypad Equal Sign for AS/400 */
  kHIDUsage_KeyboardInternational1 = 0x87, /* International1 */
  kHIDUsage_KeyboardInternational2 = 0x88, /* International2 */
  kHIDUsage_KeyboardInternational3 = 0x89, /* International3 */
  kHIDUsage_KeyboardInternational4 = 0x8A, /* International4 */
  kHIDUsage_KeyboardInternational5 = 0x8B, /* International5 */
  kHIDUsage_KeyboardInternational6 = 0x8C, /* International6 */
  kHIDUsage_KeyboardInternational7 = 0x8D, /* International7 */
  kHIDUsage_KeyboardInternational8 = 0x8E, /* International8 */
  kHIDUsage_KeyboardInternational9 = 0x8F, /* International9 */
  kHIDUsage_KeyboardLANG1       = 0x90, /* LANG1 */
  kHIDUsage_KeyboardLANG2       = 0x91, /* LANG2 */
  kHIDUsage_KeyboardLANG3       = 0x92, /* LANG3 */
  kHIDUsage_KeyboardLANG4       = 0x93, /* LANG4 */
  kHIDUsage_KeyboardLANG5       = 0x94, /* LANG5 */
  kHIDUsage_KeyboardLANG6       = 0x95, /* LANG6 */
  kHIDUsage_KeyboardLANG7       = 0x96, /* LANG7 */
  kHIDUsage_KeyboardLANG8       = 0x97, /* LANG8 */
  kHIDUsage_KeyboardLANG9       = 0x98, /* LANG9 */
  kHIDUsage_KeyboardAlternateErase = 0x99, /* AlternateErase */
  kHIDUsage_KeyboardSysReqOrAttention = 0x9A, /* SysReq/Attention */
  kHIDUsage_KeyboardCancel      = 0x9B, /* Cancel */
  kHIDUsage_KeyboardClear       = 0x9C, /* Clear */
  kHIDUsage_KeyboardPrior       = 0x9D, /* Prior */
  kHIDUsage_KeyboardReturn      = 0x9E, /* Return */
  kHIDUsage_KeyboardSeparator   = 0x9F, /* Separator */
  kHIDUsage_KeyboardOut         = 0xA0, /* Out */
  kHIDUsage_KeyboardOper        = 0xA1, /* Oper */
  kHIDUsage_KeyboardClearOrAgain = 0xA2, /* Clear/Again */
  kHIDUsage_KeyboardCrSelOrProps = 0xA3, /* CrSel/Props */
  kHIDUsage_KeyboardExSel       = 0xA4, /* ExSel */
                                        /* 0xA5-0xDF Reserved */
  kHIDUsage_KeyboardLeftControl = 0xE0, /* Left Control */
  kHIDUsage_KeyboardLeftShift   = 0xE1, /* Left Shift */
  kHIDUsage_KeyboardLeftAlt     = 0xE2, /* Left Alt */
  kHIDUsage_KeyboardLeftGUI     = 0xE3, /* Left GUI */
  kHIDUsage_KeyboardRightControl = 0xE4, /* Right Control */
  kHIDUsage_KeyboardRightShift  = 0xE5, /* Right Shift */
  kHIDUsage_KeyboardRightAlt    = 0xE6, /* Right Alt */
  kHIDUsage_KeyboardRightGUI    = 0xE7, /* Right GUI */
                                        /* 0xE8-0xFFFF Reserved */
  kHIDUsage_Keyboard_Reserved   = 0xFFFF
};

/* LEDs Page (0x08) */
/* An LED or indicator is implemented as an On/Off Control (OOF) using the ÒSingle button toggleÓ mode, 
|* where a value of 1 will turn on the indicator, and a value of 0 will turn it off. The exceptions are described below. */
enum {
  kHIDUsage_LED_NumLock         = 0x01, /* On/Off Control */
  kHIDUsage_LED_CapsLock        = 0x02, /* On/Off Control */
  kHIDUsage_LED_ScrollLock      = 0x03, /* On/Off Control */
  kHIDUsage_LED_Compose         = 0x04, /* On/Off Control */
  kHIDUsage_LED_Kana            = 0x05, /* On/Off Control */
  kHIDUsage_LED_Power           = 0x06, /* On/Off Control */
  kHIDUsage_LED_Shift           = 0x07, /* On/Off Control */
  kHIDUsage_LED_DoNotDisturb    = 0x08, /* On/Off Control */
  kHIDUsage_LED_Mute            = 0x09, /* On/Off Control */
  kHIDUsage_LED_ToneEnable      = 0x0A, /* On/Off Control */
  kHIDUsage_LED_HighCutFilter   = 0x0B, /* On/Off Control */
  kHIDUsage_LED_LowCutFilter    = 0x0C, /* On/Off Control */
  kHIDUsage_LED_EqualizerEnable = 0x0D, /* On/Off Control */
  kHIDUsage_LED_SoundFieldOn    = 0x0E, /* On/Off Control */
  kHIDUsage_LED_SurroundOn      = 0x0F, /* On/Off Control */
  kHIDUsage_LED_Repeat          = 0x10, /* On/Off Control */
  kHIDUsage_LED_Stereo          = 0x11, /* On/Off Control */
  kHIDUsage_LED_SamplingRateDetect = 0x12, /* On/Off Control */
  kHIDUsage_LED_Spinning        = 0x13, /* On/Off Control */
  kHIDUsage_LED_CAV             = 0x14, /* On/Off Control */
  kHIDUsage_LED_CLV             = 0x15, /* On/Off Control */
  kHIDUsage_LED_RecordingFormatDetect = 0x16, /* On/Off Control */
  kHIDUsage_LED_OffHook         = 0x17, /* On/Off Control */
  kHIDUsage_LED_Ring            = 0x18, /* On/Off Control */
  kHIDUsage_LED_MessageWaiting  = 0x19, /* On/Off Control */
  kHIDUsage_LED_DataMode        = 0x1A, /* On/Off Control */
  kHIDUsage_LED_BatteryOperation = 0x1B, /* On/Off Control */
  kHIDUsage_LED_BatteryOK       = 0x1C, /* On/Off Control */
  kHIDUsage_LED_BatteryLow      = 0x1D, /* On/Off Control */
  kHIDUsage_LED_Speaker         = 0x1E, /* On/Off Control */
  kHIDUsage_LED_HeadSet         = 0x1F, /* On/Off Control */
  kHIDUsage_LED_Hold            = 0x20, /* On/Off Control */
  kHIDUsage_LED_Microphone      = 0x21, /* On/Off Control */
  kHIDUsage_LED_Coverage        = 0x22, /* On/Off Control */
  kHIDUsage_LED_NightMode       = 0x23, /* On/Off Control */
  kHIDUsage_LED_SendCalls       = 0x24, /* On/Off Control */
  kHIDUsage_LED_CallPickup      = 0x25, /* On/Off Control */
  kHIDUsage_LED_Conference      = 0x26, /* On/Off Control */
  kHIDUsage_LED_StandBy         = 0x27, /* On/Off Control */
  kHIDUsage_LED_CameraOn        = 0x28, /* On/Off Control */
  kHIDUsage_LED_CameraOff       = 0x29, /* On/Off Control */
  kHIDUsage_LED_OnLine          = 0x2A, /* On/Off Control */
  kHIDUsage_LED_OffLine         = 0x2B, /* On/Off Control */
  kHIDUsage_LED_Busy            = 0x2C, /* On/Off Control */
  kHIDUsage_LED_Ready           = 0x2D, /* On/Off Control */
  kHIDUsage_LED_PaperOut        = 0x2E, /* On/Off Control */
  kHIDUsage_LED_PaperJam        = 0x2F, /* On/Off Control */
  kHIDUsage_LED_Remote          = 0x30, /* On/Off Control */
  kHIDUsage_LED_Forward         = 0x31, /* On/Off Control */
  kHIDUsage_LED_Reverse         = 0x32, /* On/Off Control */
  kHIDUsage_LED_Stop            = 0x33, /* On/Off Control */
  kHIDUsage_LED_Rewind          = 0x34, /* On/Off Control */
  kHIDUsage_LED_FastForward     = 0x35, /* On/Off Control */
  kHIDUsage_LED_Play            = 0x36, /* On/Off Control */
  kHIDUsage_LED_Pause           = 0x37, /* On/Off Control */
  kHIDUsage_LED_Record          = 0x38, /* On/Off Control */
  kHIDUsage_LED_Error           = 0x39, /* On/Off Control */
  kHIDUsage_LED_Usage           = 0x3A, /* Selector */
  kHIDUsage_LED_UsageInUseIndicator = 0x3B, /* Usage Switch */
  kHIDUsage_LED_UsageMultiModeIndicator = 0x3C, /* Usage Modifier */
  kHIDUsage_LED_IndicatorOn     = 0x3D, /* Selector */
  kHIDUsage_LED_IndicatorFlash  = 0x3E, /* Selector */
  kHIDUsage_LED_IndicatorSlowBlink = 0x3F, /* Selector */
  kHIDUsage_LED_IndicatorFastBlink = 0x40, /* Selector */
  kHIDUsage_LED_IndicatorOff    = 0x41, /* Selector */
  kHIDUsage_LED_FlashOnTime     = 0x42, /* Dynamic Value */
  kHIDUsage_LED_SlowBlinkOnTime = 0x43, /* Dynamic Value */
  kHIDUsage_LED_SlowBlinkOffTime = 0x44, /* Dynamic Value */
  kHIDUsage_LED_FastBlinkOnTime = 0x45, /* Dynamic Value */
  kHIDUsage_LED_FastBlinkOffTime = 0x46, /* Dynamic Value */
  kHIDUsage_LED_UsageIndicatorColor = 0x47, /* Usage Modifier */
  kHIDUsage_LED_IndicatorRed    = 0x48, /* Selector */
  kHIDUsage_LED_IndicatorGreen  = 0x49, /* Selector */
  kHIDUsage_LED_IndicatorAmber  = 0x4A, /* Selector */
  kHIDUsage_LED_GenericIndicator = 0x4B, /* On/Off Control */
  kHIDUsage_LED_SystemSuspend   = 0x4C, /* On/Off Control */
  kHIDUsage_LED_ExternalPowerConnected = 0x4D, /* On/Off Control */
                                        /* 0x4E - 0xFFFF Reserved */
  kHIDUsage_LED_Reserved        = 0xFFFF
};

/* Button Page (0x09) */
/* The Button page is the first place an application should look for user selection controls. System graphical user */
/* interfaces typically employ a pointer and a set of hierarchical selectors to select, move and otherwise manipulate */
/* their environment. For these purposes the following assignment of significance can be applied to the Button usages: */
/* ¥ Button 1, Primary Button. Used for object selecting, dragging, and double click activation. On MacOS, this is the 
|*   only button. Microsoft operating systems call this a logical left button, because it */
/*   is not necessarily physically located on the left of the pointing device. */
/* ¥ Button 2, Secondary Button. Used by newer graphical user interfaces to browse object properties. Exposed by systems */
/*   to applications that typically assign application-specific functionality. */
/* ¥ Button 3, Tertiary Button. Optional control. Exposed to applications, but seldom assigned functionality due to prevalence */
/*   of two- and one-button devices. */
/* ¥ Buttons 4 -55. As the button number increases, its significance as a selector decreases. */
/* In many ways the assignment of button numbers is similar to the assignment of Effort in Physical descriptors. */
/* Button 1 would be used to define the button a finger rests on when the hand is in the Òat restÓ position, that is, virtually */
/* no effort is required by the user to activate the button. Button values increment as the finger has to stretch to reach a */
/* control. See Section 6.2.3, ÒPhysical Descriptors,Ó in the HID Specification for methods of further qualifying buttons. */
enum {
  kHIDUsage_Button_1            = 0x01, /* (primary/trigger) */
  kHIDUsage_Button_2            = 0x02, /* (secondary) */
  kHIDUsage_Button_3            = 0x03, /* (tertiary) */
  kHIDUsage_Button_4            = 0x04, /* 4th button */
                                        /* ... */
  kHIDUsage_Button_65535        = 0xFFFF
};

/* Ordinal Page (0x0A) */
/* The Ordinal page allows multiple instances of a control or sets of controls to be declared without requiring individual */
/* enumeration in the native usage page. For example, it is not necessary to declare usages of Pointer 1, Pointer 2, and so */
/* forth on the Generic Desktop page. When parsed, the ordinal instance number is, in essence, concatenated to the usages */
/* attached to the encompassing collection to create Pointer 1, Pointer 2, and so forth. */
/* For an example, see Section A.5, ÒMultiple Instances of a Control,Ó in Appendix A, ÒUsage Examples.Ó By convention, */
/* an Ordinal collection is placed inside the collection for which it is declaring multiple instances. */
/* Instances do not have to be identical. */
enum {
                                        /* 0x00 Reserved */
  kHIDUsage_Ord_Instance1       = 0x01, /* Usage Modifier */
  kHIDUsage_Ord_Instance2       = 0x02, /* Usage Modifier */
  kHIDUsage_Ord_Instance3       = 0x03, /* Usage Modifier */
  kHIDUsage_Ord_Instance4       = 0x04, /* Usage Modifier */
  kHIDUsage_Ord_Instance65535   = 0xFFFF /* Usage Modifier */
};

/* Telephony Page (0x0B) */
/* This usage page defines the keytop and control usages for telephony devices. */
/* Indicators on a phone are handled by wrapping them in LED: Usage In Use Indicator and LED: Usage Selected Indicator */
/* usages. For example, a message-indicator LED would be identified by a Telephony: Message usage declared as a Feature */
/* or Output in a LED: Usage In Use Indicator collection. */
/* See Section 14, ÒConsumer Page (0x0C),Ó for audio volume and tone controls. */
enum {
  kHIDUsage_Tfon_Phone          = 0x01, /* Application Collection */
  kHIDUsage_Tfon_AnsweringMachine = 0x02, /* Application Collection */
  kHIDUsage_Tfon_MessageControls = 0x03, /* Logical Collection */
  kHIDUsage_Tfon_Handset        = 0x04, /* Logical Collection */
  kHIDUsage_Tfon_Headset        = 0x05, /* Logical Collection */
  kHIDUsage_Tfon_TelephonyKeyPad = 0x06, /* Named Array */
  kHIDUsage_Tfon_ProgrammableButton = 0x07, /* Named Array */
                                        /* 0x08 - 0x1F Reserved */
  kHIDUsage_Tfon_HookSwitch     = 0x20, /* On/Off Control */
  kHIDUsage_Tfon_Flash          = 0x21, /* Momentary Control */
  kHIDUsage_Tfon_Feature        = 0x22, /* One-Shot Control */
  kHIDUsage_Tfon_Hold           = 0x23, /* On/Off Control */
  kHIDUsage_Tfon_Redial         = 0x24, /* One-Shot Control */
  kHIDUsage_Tfon_Transfer       = 0x25, /* One-Shot Control */
  kHIDUsage_Tfon_Drop           = 0x26, /* One-Shot Control */
  kHIDUsage_Tfon_Park           = 0x27, /* On/Off Control */
  kHIDUsage_Tfon_ForwardCalls   = 0x28, /* On/Off Control */
  kHIDUsage_Tfon_AlternateFunction = 0x29, /* Momentary Control */
  kHIDUsage_Tfon_Line           = 0x2A, /* One-Shot Control */
  kHIDUsage_Tfon_SpeakerPhone   = 0x2B, /* On/Off Control */
  kHIDUsage_Tfon_Conference     = 0x2C, /* On/Off Control */
  kHIDUsage_Tfon_RingEnable     = 0x2D, /* On/Off Control */
  kHIDUsage_Tfon_Ring           = 0x2E, /* Selector */
  kHIDUsage_Tfon_PhoneMute      = 0x2F, /* On/Off Control */
  kHIDUsage_Tfon_CallerID       = 0x30, /* Momentary Control */
                                        /* 0x31 - 0x4F Reserved */
  kHIDUsage_Tfon_SpeedDial      = 0x50, /* One-Shot Control */
  kHIDUsage_Tfon_StoreNumber    = 0x51, /* One-Shot Control */
  kHIDUsage_Tfon_RecallNumber   = 0x52, /* One-Shot Control */
  kHIDUsage_Tfon_PhoneDirectory = 0x53, /* On/Off Control */
                                        /* 0x54 - 0x6F Reserved */
  kHIDUsage_Tfon_VoiceMail      = 0x70, /* On/Off Control */
  kHIDUsage_Tfon_ScreenCalls    = 0x71, /* On/Off Control */
  kHIDUsage_Tfon_DoNotDisturb   = 0x72, /* On/Off Control */
  kHIDUsage_Tfon_Message        = 0x73, /* One-Shot Control */
  kHIDUsage_Tfon_AnswerOnOrOff  = 0x74, /* On/Off Control */
                                        /* 0x75 - 0x8F Reserved */
  kHIDUsage_Tfon_InsideDialTone = 0x90, /* Momentary Control */
  kHIDUsage_Tfon_OutsideDialTone = 0x91, /* Momentary Control */
  kHIDUsage_Tfon_InsideRingTone = 0x92, /* Momentary Control */
  kHIDUsage_Tfon_OutsideRingTone = 0x93, /* Momentary Control */
  kHIDUsage_Tfon_PriorityRingTone = 0x94, /* Momentary Control */
  kHIDUsage_Tfon_InsideRingback = 0x95, /* Momentary Control */
  kHIDUsage_Tfon_PriorityRingback = 0x96, /* Momentary Control */
  kHIDUsage_Tfon_LineBusyTone   = 0x97, /* Momentary Control */
  kHIDUsage_Tfon_ReorderTone    = 0x98, /* Momentary Control */
  kHIDUsage_Tfon_CallWaitingTone = 0x99, /* Momentary Control */
  kHIDUsage_Tfon_ConfirmationTone1 = 0x9A, /* Momentary Control */
  kHIDUsage_Tfon_ConfirmationTone2 = 0x9B, /* Momentary Control */
  kHIDUsage_Tfon_TonesOff       = 0x9C, /* On/Off Control */
  kHIDUsage_Tfon_OutsideRingback = 0x9D, /* Momentary Control */
                                        /* 0x9E - 0xAF Reserved */
  kHIDUsage_Tfon_PhoneKey0      = 0xB0, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey1      = 0xB1, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey2      = 0xB2, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey3      = 0xB3, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey4      = 0xB4, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey5      = 0xB5, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey6      = 0xB6, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey7      = 0xB7, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey8      = 0xB8, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKey9      = 0xB9, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKeyStar   = 0xBA, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKeyPound  = 0xBB, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKeyA      = 0xBC, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKeyB      = 0xBD, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKeyC      = 0xBE, /* Selector/One-Shot Control */
  kHIDUsage_Tfon_PhoneKeyD      = 0xBF, /* Selector/One-Shot Control */
                                        /* 0xC0 - 0xFFFF Reserved */
  kHIDUsage_TFon_Reserved       = 0xFFFF
};

/* Consumer Page (0x0C) */
/* All controls on the Consumer page are application-specific. That is, they affect a specific device, not the system as a whole. */
enum {
  kHIDUsage_Csmr_ConsumerControl = 0x01, /* Application Collection */
  kHIDUsage_Csmr_NumericKeyPad  = 0x02, /* Named Array */
  kHIDUsage_Csmr_ProgrammableButtons = 0x03, /* Named Array */
                                        /* 0x03 - 0x1F Reserved */
  kHIDUsage_Csmr_Plus10         = 0x20, /* One-Shot Control */
  kHIDUsage_Csmr_Plus100        = 0x21, /* One-Shot Control */
  kHIDUsage_Csmr_AMOrPM         = 0x22, /* One-Shot Control */
                                        /* 0x23 - 0x3F Reserved */
  kHIDUsage_Csmr_Power          = 0x30, /* On/Off Control */
  kHIDUsage_Csmr_Reset          = 0x31, /* One-Shot Control */
  kHIDUsage_Csmr_Sleep          = 0x32, /* One-Shot Control */
  kHIDUsage_Csmr_SleepAfter     = 0x33, /* One-Shot Control */
  kHIDUsage_Csmr_SleepMode      = 0x34, /* Re-Trigger Control */
  kHIDUsage_Csmr_Illumination   = 0x35, /* On/Off Control */
  kHIDUsage_Csmr_FunctionButtons = 0x36, /* Named Array */
                                        /* 0x37 - 0x3F Reserved */
  kHIDUsage_Csmr_Menu           = 0x40, /* On/Off Control */
  kHIDUsage_Csmr_MenuPick       = 0x41, /* One-Shot Control */
  kHIDUsage_Csmr_MenuUp         = 0x42, /* One-Shot Control */
  kHIDUsage_Csmr_MenuDown       = 0x43, /* One-Shot Control */
  kHIDUsage_Csmr_MenuLeft       = 0x44, /* One-Shot Control */
  kHIDUsage_Csmr_MenuRight      = 0x45, /* One-Shot Control */
  kHIDUsage_Csmr_MenuEscape     = 0x46, /* One-Shot Control */
  kHIDUsage_Csmr_MenuValueIncrease = 0x47, /* One-Shot Control */
  kHIDUsage_Csmr_MenuValueDecrease = 0x48, /* One-Shot Control */
                                        /* 0x49 - 0x5F Reserved */
  kHIDUsage_Csmr_DataOnScreen   = 0x60, /* On/Off Control */
  kHIDUsage_Csmr_ClosedCaption  = 0x61, /* On/Off Control */
  kHIDUsage_Csmr_ClosedCaptionSelect = 0x62, /* Selector */
  kHIDUsage_Csmr_VCROrTV        = 0x63, /* On/Off Control */
  kHIDUsage_Csmr_BroadcastMode  = 0x64, /* One-Shot Control */
  kHIDUsage_Csmr_Snapshot       = 0x65, /* One-Shot Control */
  kHIDUsage_Csmr_Still          = 0x66, /* One-Shot Control */
                                        /* 0x67 - 0x7F Reserved */
  kHIDUsage_Csmr_Selection      = 0x80, /* Named Array */
  kHIDUsage_Csmr_Assign         = 0x81, /* Selector */
  kHIDUsage_Csmr_ModeStep       = 0x82, /* One-Shot Control */
  kHIDUsage_Csmr_RecallLast     = 0x83, /* One-Shot Control */
  kHIDUsage_Csmr_EnterChannel   = 0x84, /* One-Shot Control */
  kHIDUsage_Csmr_OrderMovie     = 0x85, /* One-Shot Control */
  kHIDUsage_Csmr_Channel        = 0x86, /* Linear Control */
  kHIDUsage_Csmr_MediaSelection = 0x87, /* Selector */
  kHIDUsage_Csmr_MediaSelectComputer = 0x88, /* Selector */
  kHIDUsage_Csmr_MediaSelectTV  = 0x89, /* Selector */
  kHIDUsage_Csmr_MediaSelectWWW = 0x8A, /* Selector */
  kHIDUsage_Csmr_MediaSelectDVD = 0x8B, /* Selector */
  kHIDUsage_Csmr_MediaSelectTelephone = 0x8C, /* Selector */
  kHIDUsage_Csmr_MediaSelectProgramGuide = 0x8D, /* Selector */
  kHIDUsage_Csmr_MediaSelectVideoPhone = 0x8E, /* Selector */
  kHIDUsage_Csmr_MediaSelectGames = 0x8F, /* Selector */
  kHIDUsage_Csmr_MediaSelectMessages = 0x90, /* Selector */
  kHIDUsage_Csmr_MediaSelectCD  = 0x91, /* Selector */
  kHIDUsage_Csmr_MediaSelectVCR = 0x92, /* Selector */
  kHIDUsage_Csmr_MediaSelectTuner = 0x93, /* Selector */
  kHIDUsage_Csmr_Quit           = 0x94, /* One-Shot Control */
  kHIDUsage_Csmr_Help           = 0x95, /* On/Off Control */
  kHIDUsage_Csmr_MediaSelectTape = 0x96, /* Selector */
  kHIDUsage_Csmr_MediaSelectCable = 0x97, /* Selector */
  kHIDUsage_Csmr_MediaSelectSatellite = 0x98, /* Selector */
  kHIDUsage_Csmr_MediaSelectSecurity = 0x99, /* Selector */
  kHIDUsage_Csmr_MediaSelectHome = 0x9A, /* Selector */
  kHIDUsage_Csmr_MediaSelectCall = 0x9B, /* Selector */
  kHIDUsage_Csmr_ChannelIncrement = 0x9C, /* One-Shot Control */
  kHIDUsage_Csmr_ChannelDecrement = 0x9D, /* One-Shot Control */
  kHIDUsage_Csmr_Media          = 0x9E, /* Selector */
                                        /* 0x9F Reserved */
  kHIDUsage_Csmr_VCRPlus        = 0xA0, /* One-Shot Control */
  kHIDUsage_Csmr_Once           = 0xA1, /* One-Shot Control */
  kHIDUsage_Csmr_Daily          = 0xA2, /* One-Shot Control */
  kHIDUsage_Csmr_Weekly         = 0xA3, /* One-Shot Control */
  kHIDUsage_Csmr_Monthly        = 0xA4, /* One-Shot Control */
                                        /* 0xA5 - 0xAF Reserved */
  kHIDUsage_Csmr_Play           = 0xB0, /* On/Off Control */
  kHIDUsage_Csmr_Pause          = 0xB1, /* On/Off Control */
  kHIDUsage_Csmr_Record         = 0xB2, /* On/Off Control */
  kHIDUsage_Csmr_FastForward    = 0xB3, /* On/Off Control */
  kHIDUsage_Csmr_Rewind         = 0xB4, /* On/Off Control */
  kHIDUsage_Csmr_ScanNextTrack  = 0xB5, /* One-Shot Control */
  kHIDUsage_Csmr_ScanPreviousTrack = 0xB6, /* One-Shot Control */
  kHIDUsage_Csmr_Stop           = 0xB7, /* One-Shot Control */
  kHIDUsage_Csmr_Eject          = 0xB8, /* One-Shot Control */
  kHIDUsage_Csmr_RandomPlay     = 0xB9, /* On/Off Control */
  kHIDUsage_Csmr_SelectDisc     = 0xBA, /* Named Array */
  kHIDUsage_Csmr_EnterDisc      = 0xBB, /* Momentary Control */
  kHIDUsage_Csmr_Repeat         = 0xBC, /* One-Shot Control */
  kHIDUsage_Csmr_Tracking       = 0xBD, /* Linear Control */
  kHIDUsage_Csmr_TrackNormal    = 0xBE, /* One-Shot Control */
  kHIDUsage_Csmr_SlowTracking   = 0xBF, /* Linear Control */
  kHIDUsage_Csmr_FrameForward   = 0xC0, /* Re-Trigger Control */
  kHIDUsage_Csmr_FrameBack      = 0xC1, /* Re-Trigger Control */
  kHIDUsage_Csmr_Mark           = 0xC2, /* One-Shot Control */
  kHIDUsage_Csmr_ClearMark      = 0xC3, /* One-Shot Control */
  kHIDUsage_Csmr_RepeatFromMark = 0xC4, /* On/Off Control */
  kHIDUsage_Csmr_ReturnToMark   = 0xC5, /* One-Shot Control */
  kHIDUsage_Csmr_SearchMarkForward = 0xC6, /* One-Shot Control */
  kHIDUsage_Csmr_SearchMarkBackwards = 0xC7, /* One-Shot Control */
  kHIDUsage_Csmr_CounterReset   = 0xC8, /* One-Shot Control */
  kHIDUsage_Csmr_ShowCounter    = 0xC9, /* One-Shot Control */
  kHIDUsage_Csmr_TrackingIncrement = 0xCA, /* Re-Trigger Control */
  kHIDUsage_Csmr_TrackingDecrement = 0xCB, /* Re-Trigger Control */
  kHIDUsage_Csmr_StopOrEject    = 0xCC, /* One-Shot Control */
  kHIDUsage_Csmr_PlayOrPause    = 0xCD, /* One-Shot Control */
  kHIDUsage_Csmr_PlayOrSkip     = 0xCE, /* One-Shot Control */
                                        /* 0xCF - 0xDF Reserved */
  kHIDUsage_Csmr_Volume         = 0xE0, /* Linear Control */
  kHIDUsage_Csmr_Balance        = 0xE1, /* Linear Control */
  kHIDUsage_Csmr_Mute           = 0xE2, /* On/Off Control */
  kHIDUsage_Csmr_Bass           = 0xE3, /* Linear Control */
  kHIDUsage_Csmr_Treble         = 0xE4, /* Linear Control */
  kHIDUsage_Csmr_BassBoost      = 0xE5, /* On/Off Control */
  kHIDUsage_Csmr_SurroundMode   = 0xE6, /* One-Shot Control */
  kHIDUsage_Csmr_Loudness       = 0xE7, /* On/Off Control */
  kHIDUsage_Csmr_MPX            = 0xE8, /* On/Off Control */
  kHIDUsage_Csmr_VolumeIncrement = 0xE9, /* Re-Trigger Control */
  kHIDUsage_Csmr_VolumeDecrement = 0xEA, /* Re-Trigger Control */
                                        /* 0xEB - 0xEF Reserved */
  kHIDUsage_Csmr_Speed          = 0xF0, /* Selector */
  kHIDUsage_Csmr_PlaybackSpeed  = 0xF1, /* Named Array */
  kHIDUsage_Csmr_StandardPlay   = 0xF2, /* Selector */
  kHIDUsage_Csmr_LongPlay       = 0xF3, /* Selector */
  kHIDUsage_Csmr_ExtendedPlay   = 0xF4, /* Selector */
  kHIDUsage_Csmr_Slow           = 0xF5, /* One-Shot Control */
                                        /* 0xF6 - 0xFF Reserved */
  kHIDUsage_Csmr_FanEnable      = 0x0100, /* On/Off Control */
  kHIDUsage_Csmr_FanSpeed       = 0x0101, /* Linear Control */
  kHIDUsage_Csmr_LightEnable    = 0x0102, /* On/Off Control */
  kHIDUsage_Csmr_LightIlluminationLevel = 0x0103, /* Linear Control */
  kHIDUsage_Csmr_ClimateControlEnable = 0x0104, /* On/Off Control */
  kHIDUsage_Csmr_RoomTemperature = 0x0105, /* Linear Control */
  kHIDUsage_Csmr_SecurityEnable = 0x0106, /* On/Off Control */
  kHIDUsage_Csmr_FireAlarm      = 0x0107, /* One-Shot Control */
  kHIDUsage_Csmr_PoliceAlarm    = 0x0108, /* One-Shot Control */
                                        /* 0x109 - 0x14F Reserved */
  kHIDUsage_Csmr_BalanceRight   = 0x0150, /* Re-Trigger Control */
  kHIDUsage_Csmr_BalanceLeft    = 0x0151, /* Re-Trigger Control */
  kHIDUsage_Csmr_BassIncrement  = 0x0152, /* Re-Trigger Control */
  kHIDUsage_Csmr_BassDecrement  = 0x0153, /* Re-Trigger Control */
  kHIDUsage_Csmr_TrebleIncrement = 0x0154, /* Re-Trigger Control */
  kHIDUsage_Csmr_TrebleDecrement = 0x0155, /* Re-Trigger Control */
                                        /* 0x156 - 0x15F Reserved */
  kHIDUsage_Csmr_SpeakerSystem  = 0x0160, /* Logical Collection */
  kHIDUsage_Csmr_ChannelLeft    = 0x0161, /* Logical Collection */
  kHIDUsage_Csmr_ChannelRight   = 0x0162, /* Logical Collection */
  kHIDUsage_Csmr_ChannelCenter  = 0x0163, /* Logical Collection */
  kHIDUsage_Csmr_ChannelFront   = 0x0164, /* Logical Collection */
  kHIDUsage_Csmr_ChannelCenterFront = 0x0165, /* Logical Collection */
  kHIDUsage_Csmr_ChannelSide    = 0x0166, /* Logical Collection */
  kHIDUsage_Csmr_ChannelSurround = 0x0167, /* Logical Collection */
  kHIDUsage_Csmr_ChannelLowFrequencyEnhancement = 0x0168, /* Logical Collection */
  kHIDUsage_Csmr_ChannelTop     = 0x0169, /* Logical Collection */
  kHIDUsage_Csmr_ChannelUnknown = 0x016A, /* Logical Collection */
                                        /* 0x16B - 0x16F Reserved */
  kHIDUsage_Csmr_SubChannel     = 0x0170, /* Linear Control */
  kHIDUsage_Csmr_SubChannelIncrement = 0x0171, /* One-Shot Control */
  kHIDUsage_Csmr_SubChannelDecrement = 0x0172, /* One-Shot Control */
  kHIDUsage_Csmr_AlternateAudioIncrement = 0x0173, /* One-Shot Control */
  kHIDUsage_Csmr_AlternateAudioDecrement = 0x0174, /* One-Shot Control */
                                        /* 0x175 - 0x17F Reserved */
  kHIDUsage_Csmr_ApplicationLaunchButtons = 0x0180, /* Named Array */
  kHIDUsage_Csmr_ALLaunchButtonConfigurationTool = 0x0181, /* Selector */
  kHIDUsage_Csmr_ALProgrammableButtonConfiguration = 0x0182, /* Selector */
  kHIDUsage_Csmr_ALConsumerControlConfiguration = 0x0183, /* Selector */
  kHIDUsage_Csmr_ALWordProcessor = 0x0184, /* Selector */
  kHIDUsage_Csmr_ALTextEditor   = 0x0185, /* Selector */
  kHIDUsage_Csmr_ALSpreadsheet  = 0x0186, /* Selector */
  kHIDUsage_Csmr_ALGraphicsEditor = 0x0187, /* Selector */
  kHIDUsage_Csmr_ALPresentationApp = 0x0188, /* Selector */
  kHIDUsage_Csmr_ALDatabaseApp  = 0x0189, /* Selector */
  kHIDUsage_Csmr_ALEmailReader  = 0x018A, /* Selector */
  kHIDUsage_Csmr_ALNewsreader   = 0x018B, /* Selector */
  kHIDUsage_Csmr_ALVoicemail    = 0x018C, /* Selector */
  kHIDUsage_Csmr_ALContactsOrAddressBook = 0x018D, /* Selector */
  kHIDUsage_Csmr_ALCalendarOrSchedule = 0x018E, /* Selector */
  kHIDUsage_Csmr_ALTaskOrProjectManager = 0x018F, /* Selector */
  kHIDUsage_Csmr_ALLogOrJournalOrTimecard = 0x0190, /* Selector */
  kHIDUsage_Csmr_ALCheckbookOrFinance = 0x0191, /* Selector */
  kHIDUsage_Csmr_ALCalculator   = 0x0192, /* Selector */
  kHIDUsage_Csmr_ALAOrVCaptureOrPlayback = 0x0193, /* Selector */
  kHIDUsage_Csmr_ALLocalMachineBrowser = 0x0194, /* Selector */
  kHIDUsage_Csmr_ALLANOrWANBrowser = 0x0195, /* Selector */
  kHIDUsage_Csmr_ALInternetBrowser = 0x0196, /* Selector */
  kHIDUsage_Csmr_ALRemoteNetworkingOrISPConnect = 0x0197, /* Selector */
  kHIDUsage_Csmr_ALNetworkConference = 0x0198, /* Selector */
  kHIDUsage_Csmr_ALNetworkChat  = 0x0199, /* Selector */
  kHIDUsage_Csmr_ALTelephonyOrDialer = 0x019A, /* Selector */
  kHIDUsage_Csmr_ALLogon        = 0x019B, /* Selector */
  kHIDUsage_Csmr_ALLogoff       = 0x019C, /* Selector */
  kHIDUsage_Csmr_ALLogonOrLogoff = 0x019D, /* Selector */
  kHIDUsage_Csmr_ALTerminalLockOrScreensaver = 0x019E, /* Selector */
  kHIDUsage_Csmr_ALControlPanel = 0x019F, /* Selector */
  kHIDUsage_Csmr_ALCommandLineProcessorOrRun = 0x01A0, /* Selector */
  kHIDUsage_Csmr_ALProcessOrTaskManager = 0x01A1, /* Selector */
  kHIDUsage_Csmr_AL             = 0x01A2, /* Selector */
  kHIDUsage_Csmr_ALNextTaskOrApplication = 0x0143, /* Selector */
  kHIDUsage_Csmr_ALPreviousTaskOrApplication = 0x01A4, /* Selector */
  kHIDUsage_Csmr_ALPreemptiveHaltTaskOrApplication = 0x01A5, /* Selector */
                                        /* 0x1A6 - 0x1FF Reserved */
  kHIDUsage_Csmr_GenericGUIApplicationControls = 0x0200, /* Named Array */
  kHIDUsage_Csmr_ACNew          = 0x0201, /* Selector */
  kHIDUsage_Csmr_ACOpen         = 0x0202, /* Selector */
  kHIDUsage_Csmr_ACClose        = 0x0203, /* Selector */
  kHIDUsage_Csmr_ACExit         = 0x0204, /* Selector */
  kHIDUsage_Csmr_ACMaximize     = 0x0205, /* Selector */
  kHIDUsage_Csmr_ACMinimize     = 0x0206, /* Selector */
  kHIDUsage_Csmr_ACSave         = 0x0207, /* Selector */
  kHIDUsage_Csmr_ACPrint        = 0x0208, /* Selector */
  kHIDUsage_Csmr_ACProperties   = 0x0209, /* Selector */
  kHIDUsage_Csmr_ACUndo         = 0x021A, /* Selector */
  kHIDUsage_Csmr_ACCopy         = 0x021B, /* Selector */
  kHIDUsage_Csmr_ACCut          = 0x021C, /* Selector */
  kHIDUsage_Csmr_ACPaste        = 0x021D, /* Selector */
  kHIDUsage_Csmr_AC             = 0x021E, /* Selector */
  kHIDUsage_Csmr_ACFind         = 0x021F, /* Selector */
  kHIDUsage_Csmr_ACFindandReplace = 0x0220, /* Selector */
  kHIDUsage_Csmr_ACSearch       = 0x0221, /* Selector */
  kHIDUsage_Csmr_ACGoTo         = 0x0222, /* Selector */
  kHIDUsage_Csmr_ACHome         = 0x0223, /* Selector */
  kHIDUsage_Csmr_ACBack         = 0x0224, /* Selector */
  kHIDUsage_Csmr_ACForward      = 0x0225, /* Selector */
  kHIDUsage_Csmr_ACStop         = 0x0226, /* Selector */
  kHIDUsage_Csmr_ACRefresh      = 0x0227, /* Selector */
  kHIDUsage_Csmr_ACPreviousLink = 0x0228, /* Selector */
  kHIDUsage_Csmr_ACNextLink     = 0x0229, /* Selector */
  kHIDUsage_Csmr_ACBookmarks    = 0x022A, /* Selector */
  kHIDUsage_Csmr_ACHistory      = 0x022B, /* Selector */
  kHIDUsage_Csmr_ACSubscriptions = 0x022C, /* Selector */
  kHIDUsage_Csmr_ACZoomIn       = 0x022D, /* Selector */
  kHIDUsage_Csmr_ACZoomOut      = 0x022E, /* Selector */
  kHIDUsage_Csmr_ACZoom         = 0x022F, /* Selector */
  kHIDUsage_Csmr_ACFullScreenView = 0x0230, /* Selector */
  kHIDUsage_Csmr_ACNormalView   = 0x0231, /* Selector */
  kHIDUsage_Csmr_ACViewToggle   = 0x0232, /* Selector */
  kHIDUsage_Csmr_ACScrollUp     = 0x0233, /* Selector */
  kHIDUsage_Csmr_ACScrollDown   = 0x0234, /* Selector */
  kHIDUsage_Csmr_ACScroll       = 0x0235, /* Selector */
  kHIDUsage_Csmr_ACPanLeft      = 0x0236, /* Selector */
  kHIDUsage_Csmr_ACPanRight     = 0x0237, /* Selector */
  kHIDUsage_Csmr_ACPan          = 0x0238, /* Selector */
  kHIDUsage_Csmr_ACNewWindow    = 0x0239, /* Selector */
  kHIDUsage_Csmr_ACTileHorizontally = 0x023A, /* Selector */
  kHIDUsage_Csmr_ACTileVertically = 0x023B, /* Selector */
  kHIDUsage_Csmr_ACFormat       = 0x023C, /* Selector */
                                        /* 0x23D - 0xFFFF Reserved */
  kHIDUsage_Csmr_Reserved       = 0xFFFF
};

/* Digitizer Page (0x0D) */
/* This section provides detailed descriptions of the usages employed by Digitizer Devices. */
enum {
  kHIDUsage_Dig_Digitizer       = 0x01, /* Application Collection */
  kHIDUsage_Dig_Pen             = 0x02, /* Application Collection */
  kHIDUsage_Dig_LightPen        = 0x03, /* Application Collection */
  kHIDUsage_Dig_TouchScreen     = 0x04, /* Application Collection */
  kHIDUsage_Dig_TouchPad        = 0x05, /* Application Collection */
  kHIDUsage_Dig_WhiteBoard      = 0x06, /* Application Collection */
  kHIDUsage_Dig_CoordinateMeasuringMachine = 0x07, /* Application Collection */
  kHIDUsage_Dig_3DDigitizer     = 0x08, /* Application Collection */
  kHIDUsage_Dig_StereoPlotter   = 0x09, /* Application Collection */
  kHIDUsage_Dig_ArticulatedArm  = 0x0A, /* Application Collection */
  kHIDUsage_Dig_Armature        = 0x0B, /* Application Collection */
  kHIDUsage_Dig_MultiplePointDigitizer = 0x0C, /* Application Collection */
  kHIDUsage_Dig_FreeSpaceWand   = 0x0D, /* Application Collection */
                                        /* 0x0E - 0x1F Reserved */
  kHIDUsage_Dig_Stylus          = 0x20, /* Logical Collection */
  kHIDUsage_Dig_Puck            = 0x21, /* Logical Collection */
  kHIDUsage_Dig_Finger          = 0x22, /* Logical Collection */
                                        /* 0x23 - 0x2F Reserved */
  kHIDUsage_Dig_TipPressure     = 0x30, /* Dynamic Value */
  kHIDUsage_Dig_BarrelPressure  = 0x31, /* Dynamic Value */
  kHIDUsage_Dig_InRange         = 0x32, /* Momentary Control */
  kHIDUsage_Dig_Touch           = 0x33, /* Momentary Control */
  kHIDUsage_Dig_Untouch         = 0x34, /* One-Shot Control */
  kHIDUsage_Dig_Tap             = 0x35, /* One-Shot Control */
  kHIDUsage_Dig_Quality         = 0x36, /* Dynamic Value */
  kHIDUsage_Dig_DataValid       = 0x37, /* Momentary Control */
  kHIDUsage_Dig_TransducerIndex = 0x38, /* Dynamic Value */
  kHIDUsage_Dig_TabletFunctionKeys = 0x39, /* Logical Collection */
  kHIDUsage_Dig_ProgramChangeKeys = 0x3A, /* Logical Collection */
  kHIDUsage_Dig_BatteryStrength = 0x3B, /* Dynamic Value */
  kHIDUsage_Dig_Invert          = 0x3C, /* Momentary Control */
  kHIDUsage_Dig_XTilt           = 0x3D, /* Dynamic Value */
  kHIDUsage_Dig_YTilt           = 0x3E, /* Dynamic Value */
  kHIDUsage_Dig_Azimuth         = 0x3F, /* Dynamic Value */
  kHIDUsage_Dig_Altitude        = 0x40, /* Dynamic Value */
  kHIDUsage_Dig_Twist           = 0x41, /* Dynamic Value */
  kHIDUsage_Dig_TipSwitch       = 0x42, /* Momentary Control */
  kHIDUsage_Dig_SecondaryTipSwitch = 0x43, /* Momentary Control */
  kHIDUsage_Dig_BarrelSwitch    = 0x44, /* Momentary Control */
  kHIDUsage_Dig_Eraser          = 0x45, /* Momentary Control */
  kHIDUsage_Dig_TabletPick      = 0x46, /* Momentary Control */
                                        /* 0x47 - 0xFFFF Reserved */
  kHIDUsage_Dig_Reserved        = 0xFFFF
};

/* AlphanumericDisplay Page (0x14) */
/* The Alphanumeric Display page is intended for use by simple alphanumeric displays that are used on consumer devices. */
enum {
  kHIDUsage_AD_AlphanumericDisplay = 0x01, /* Application Collection */
                                        /* 0x02 - 0x1F Reserved */
  kHIDUsage_AD_DisplayAttributesReport = 0x20, /* Logical Collection */
  kHIDUsage_AD_ASCIICharacterSet = 0x21, /* Static Flag */
  kHIDUsage_AD_DataReadBack     = 0x22, /* Static Flag */
  kHIDUsage_AD_FontReadBack     = 0x23, /* Static Flag */
  kHIDUsage_AD_DisplayControlReport = 0x24, /* Logical Collection */
  kHIDUsage_AD_ClearDisplay     = 0x25, /* Dynamic Flag */
  kHIDUsage_AD_DisplayEnable    = 0x26, /* Dynamic Flag */
  kHIDUsage_AD_ScreenSaverDelay = 0x27, /* Static Value */
  kHIDUsage_AD_ScreenSaverEnable = 0x28, /* Dynamic Flag */
  kHIDUsage_AD_VerticalScroll   = 0x29, /* Static Flag */
  kHIDUsage_AD_HorizontalScroll = 0x2A, /* Static Flag */
  kHIDUsage_AD_CharacterReport  = 0x2B, /* Logical Collection */
  kHIDUsage_AD_DisplayData      = 0x2C, /* Dynamic Value */
  kHIDUsage_AD_DisplayStatus    = 0x2D, /* Logical Collection */
  kHIDUsage_AD_StatNotReady     = 0x2E, /* Selector */
  kHIDUsage_AD_StatReady        = 0x2F, /* Selector */
  kHIDUsage_AD_ErrNotaloadablecharacter = 0x30, /* Selector */
  kHIDUsage_AD_ErrFontdatacannotberead = 0x31, /* Selector */
  kHIDUsage_AD_CursorPositionReport = 0x32, /* Logical Collection */
  kHIDUsage_AD_Row              = 0x33, /* Dynamic Value */
  kHIDUsage_AD_Column           = 0x34, /* Dynamic Value */
  kHIDUsage_AD_Rows             = 0x35, /* Static Value */
  kHIDUsage_AD_Columns          = 0x36, /* Static Value */
  kHIDUsage_AD_CursorPixelPositioning = 0x37, /* Static Flag */
  kHIDUsage_AD_CursorMode       = 0x38, /* Dynamic Flag */
  kHIDUsage_AD_CursorEnable     = 0x39, /* Dynamic Flag */
  kHIDUsage_AD_CursorBlink      = 0x3A, /* Dynamic Flag */
  kHIDUsage_AD_FontReport       = 0x3B, /* Logical Collection */
  kHIDUsage_AD_FontData         = 0x3C, /* Buffered Byte */
  kHIDUsage_AD_CharacterWidth   = 0x3D, /* Static Value */
  kHIDUsage_AD_CharacterHeight  = 0x3E, /* Static Value */
  kHIDUsage_AD_CharacterSpacingHorizontal = 0x3F, /* Static Value */
  kHIDUsage_AD_CharacterSpacingVertical = 0x40, /* Static Value */
  kHIDUsage_AD_UnicodeCharacterSet = 0x41, /* Static Flag */
                                        /* 0x42 - 0xFFFF Reserved */
  kHIDUsage_AD_Reserved         = 0xFFFF
};


#if PRAGMA_STRUCT_ALIGN
    #pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
    #pragma pack()
#endif

#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif

#ifdef __cplusplus
}
#endif

#endif /* __HID__ */

