File: PsychHIDGetElements.c

package info (click to toggle)
psychtoolbox-3 3.0.19.14.dfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 86,796 kB
  • sloc: ansic: 176,245; cpp: 20,103; objc: 5,393; sh: 2,753; python: 1,397; php: 384; makefile: 193; java: 113
file content (110 lines) | stat: -rw-r--r-- 6,314 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
/*
  PsychToolbox3/Source/Common/PsychHID/PsychHIDGetElements.c		
  
  PROJECTS: PsychHID
  
  PLATFORMS:  OSX  
  
  AUTHORS:
  Allen.Ingling@nyu.edu		awi 
      
  HISTORY:
  4/29/03  awi		Created.
  
  TO DO:
  

*/

#include "PsychHID.h"

#if PSYCH_SYSTEM == PSYCH_OSX

static char useString[]= "elements=PsychHID('Elements',deviceNumber)";
static char synopsisString[] = 
        "Return a struct array describing each element of a connected USB HID device.";
static char seeAlsoString[] = "";


PsychError PSYCHHIDGetElements(void) 
{
    pRecDevice 			specDevice=NULL;
    UInt32              numDeviceElements;
    
    const char 			*elementFieldNames[]={"typeMaskName", "name", "deviceIndex", "elementIndex", "typeValue", "typeName", "usagePageValue", "usageValue", 							"usageName", "dataSize", "rangeMin", "rangeMax", "scaledRangeMin", "scaledRangeMax", "relative", 
                                                        "wrapping", "nonLinear", "preferredState", "nullState", "calMin", "calMax", "scalingMin", "scalingMax"};
    int 			numElementStructElements, numElementStructFieldNames=23, elementIndex, deviceIndex;
    PsychGenericScriptType	*elementStruct;	
    pRecElement     currentElement, lastElement = NULL;
    char			elementTypeName[PSYCH_HID_MAX_DEVICE_ELEMENT_TYPE_NAME_LENGTH];	
    char			usageName[PSYCH_HID_MAX_DEVICE_ELEMENT_USAGE_NAME_LENGTH];
    char            tmpName[1024];
    char			*typeMaskName;
    HIDElementTypeMask		typeMask;
    	 
    //all subfunctions should have these two lines
    PsychPushHelp(useString, synopsisString, seeAlsoString);
    if(PsychIsGiveHelp()){PsychGiveHelp();return(PsychError_none);};

    PsychErrorExit(PsychCapNumOutputArgs(1));
    PsychErrorExit(PsychCapNumInputArgs(1));
    
    PsychCopyInIntegerArg(1, TRUE, &deviceIndex);
    PsychHIDVerifyInit();
    specDevice= PsychHIDGetDeviceRecordPtrFromIndex(deviceIndex);
    PsychHIDVerifyOpenDeviceInterfaceFromDeviceIndex(deviceIndex);
    numDeviceElements= HIDCountDeviceElements(specDevice, kHIDElementTypeIO);
    numElementStructElements = (int)numDeviceElements;
    PsychAllocOutStructArray(1, FALSE, numElementStructElements, numElementStructFieldNames, elementFieldNames, &elementStruct);
    elementIndex=0;
    for(currentElement=HIDGetFirstDeviceElement(specDevice,kHIDElementTypeIO); 
        (currentElement != NULL) && (currentElement != lastElement);
        currentElement=HIDGetNextDeviceElement(currentElement, kHIDElementTypeIO)) {
        lastElement = currentElement;

        // Skip this entry if it isn't a valid element:
        if (!HIDIsValidElement(currentElement)) continue;

        IOHIDElementType type = IOHIDElementGetType(currentElement);
        typeMask = HIDConvertElementTypeToMask(type);
        PsychHIDGetTypeMaskStringFromTypeMask(typeMask, &typeMaskName);
        PsychSetStructArrayStringElement("typeMaskName",	elementIndex, 	typeMaskName,	 	elementStruct);
        tmpName[0] = 0;
        CFStringRef cfString = IOHIDElementGetName(currentElement);
        if (cfString) {
            CFStringGetCString(cfString, tmpName, sizeof(tmpName), kCFStringEncodingASCII);
            CFRelease(cfString);
        }
        PsychSetStructArrayStringElement("name",            elementIndex, 	tmpName,	 		elementStruct);
        PsychSetStructArrayDoubleElement("deviceIndex",		elementIndex, 	(double)deviceIndex, 			elementStruct);
        PsychSetStructArrayDoubleElement("elementIndex",	elementIndex, 	(double)elementIndex+1, 		elementStruct);
        
        PsychSetStructArrayDoubleElement("typeValue",		elementIndex, 	(double) type, 		elementStruct);
        HIDGetTypeName(type, elementTypeName);
        PsychSetStructArrayStringElement("typeName",		elementIndex, 	elementTypeName,	elementStruct);
        PsychSetStructArrayDoubleElement("usagePageValue",	elementIndex, 	(double)IOHIDElementGetUsagePage(currentElement), 	elementStruct);
        PsychSetStructArrayDoubleElement("usageValue",		elementIndex, 	(double)IOHIDElementGetUsage(currentElement), 		elementStruct);
        HIDGetUsageName(IOHIDElementGetUsagePage(currentElement), IOHIDElementGetUsage(currentElement), usageName);
        PsychSetStructArrayStringElement("usageName",		elementIndex, 	usageName,	 		elementStruct);

        PsychSetStructArrayDoubleElement("dataSize",		elementIndex, 	(double)IOHIDElementGetReportSize(currentElement), 	elementStruct);
        PsychSetStructArrayDoubleElement("rangeMin",		elementIndex, 	(double)IOHIDElementGetLogicalMin(currentElement), 	elementStruct);
        PsychSetStructArrayDoubleElement("rangeMax",		elementIndex, 	(double)IOHIDElementGetLogicalMax(currentElement), 	elementStruct);
        PsychSetStructArrayDoubleElement("scaledRangeMin",	elementIndex, 	(double)IOHIDElementGetPhysicalMin(currentElement), 	elementStruct);
        PsychSetStructArrayDoubleElement("scaledRangeMax",	elementIndex, 	(double)IOHIDElementGetPhysicalMax(currentElement),	elementStruct);
        PsychSetStructArrayDoubleElement("relative",		elementIndex, 	(double)IOHIDElementIsRelative(currentElement),	elementStruct);	//psych_bool flag
        PsychSetStructArrayDoubleElement("wrapping",		elementIndex, 	(double)IOHIDElementIsWrapping(currentElement),	elementStruct);	//psych_bool flag	
        PsychSetStructArrayDoubleElement("nonLinear",		elementIndex, 	(double)IOHIDElementIsNonLinear(currentElement),	elementStruct);	//psych_bool flag
        PsychSetStructArrayDoubleElement("preferredState",	elementIndex, 	(double)IOHIDElementHasPreferredState(currentElement),	elementStruct);	//psych_bool flag
        PsychSetStructArrayDoubleElement("nullState",		elementIndex, 	(double)IOHIDElementHasNullState(currentElement),	elementStruct);	//psych_bool flag
        PsychSetStructArrayDoubleElement("calMin",          elementIndex, 	(double)IOHIDElement_GetCalibrationMin(currentElement),	elementStruct);
        PsychSetStructArrayDoubleElement("calMax",          elementIndex, 	(double)IOHIDElement_GetCalibrationMax(currentElement),	elementStruct);
        PsychSetStructArrayDoubleElement("scalingMin",		elementIndex, 	(double) 0,     elementStruct);
        PsychSetStructArrayDoubleElement("scalingMax",		elementIndex, 	(double) 255,	elementStruct);
        ++elementIndex; 
    }

    return(PsychError_none);	
}

#endif