PsychError PsychHIDReceiveReportsCleanup(void)
{
// Release all report linked lists, memory buffers etc.:
PsychHIDReleaseAllReportMemory();
return 0;
}
/* PsychInitializePsychHID()
*
* Master init routine - Called at module load time / first time init.
*
*/
void PsychInitializePsychHID(void)
{
int i;
// Initialize the generic USB tracker to "all off" state:
for (i = 0; i < PSYCH_HID_MAX_GENERIC_USB_DEVICES; i++) {
usbDeviceRecordBank[i].valid = 0;
}
// Setup event ringbuffers:
for (i = 0; i < PSYCH_HID_MAX_KEYBOARD_DEVICES; i++) {
hidEventBuffer[i] = NULL;
hidEventBufferCapacity[i] = 10000; // Initial capacity of event buffer.
hidEventBufferReadPos[i] = 0;
hidEventBufferWritePos[i] = 0;
}
#if (PSYCH_SYSTEM == PSYCH_OSX) && defined(__LP64__)
for (i = 0; i < MAXDEVICEINDEXS; i++)
deviceInterfaces[i] = NULL;
#endif
// Initialize OS specific interfaces and routines:
PsychHIDInitializeHIDStandardInterfaces();
// This sets up data structures for HID report reception inside PsychHIDReceiveReports.c:
PsychHIDReleaseAllReportMemory();
return;
}
/* PsychInitializePsychHID()
*
* Master init routine - Called at module load time / first time init.
*
*/
void PsychInitializePsychHID(void)
{
int i;
// Initialize the generic USB tracker to "all off" state:
for (i = 0; i < PSYCH_HID_MAX_GENERIC_USB_DEVICES; i++) {
usbDeviceRecordBank[i].valid = 0;
}
// Setup event ringbuffers:
for (i = 0; i < PSYCH_HID_MAX_DEVICES; i++) {
hidEventBuffer[i] = NULL;
hidEventBufferCapacity[i] = 10000; // Initial capacity of event buffer.
hidEventBufferReadPos[i] = 0;
hidEventBufferWritePos[i] = 0;
}
#if PSYCH_SYSTEM == PSYCH_OSX
for (i = 0; i < MAXDEVICEINDEXS; i++) deviceInterfaces[i] = NULL;
// Try to load all bundles from Psychtoolbox/PsychHardware/
// This loads the HID_Utilities.framework bundle if it is present. The whole point of it is
// to allow our statically compiled-in version of the library to find the location of
// the XML file with the database of (vendorId, productId) -> (VendorName, ProductName) and
// (usagePage, usage) -> (usageName) mappings.
//
// In practice, the XML file only serves as a fallback, and one that doesn't contain much
// useful info for mainstream products, only for a few niche products. Given its limited
// value, i think we can refrain from shipping the framework as part of Psychtoolbox and
// just provide the option to use it (== its XML file) if users decide to install it themselves.
char tmpString[1024];
sprintf(tmpString, "%sPsychHardware/", PsychRuntimeGetPsychtoolboxRoot(FALSE));
CFStringRef urlString = CFStringCreateWithCString(kCFAllocatorDefault, tmpString, kCFStringEncodingASCII);
CFURLRef directoryURL = CFURLCreateWithFileSystemPath(kCFAllocatorDefault, urlString, kCFURLPOSIXPathStyle, false);
CFRelease(urlString);
CFArrayRef bundleArray = CFBundleCreateBundlesFromDirectory(kCFAllocatorDefault, directoryURL, NULL);
CFRelease(directoryURL);
CFRelease(bundleArray);
#endif
// Initialize OS specific interfaces and routines:
PsychHIDInitializeHIDStandardInterfaces();
// This sets up data structures for HID report reception inside PsychHIDReceiveReports.c:
PsychHIDReleaseAllReportMemory();
return;
}
/* PsychHIDReceiveReportsCleanup(void) -- Called at PsychHID shutdown time:
1. one must call CFRunLoopSourceInvalidate to kill the callback established by setInterruptReportHandlerCallback
before calling HIDReleaseDeviceList.
2. after calling setInterruptReportHandlerCallback to enable the callback and CFRunLoopSourceInvalidate to disable
it, it is then impossible to re-enable the callback with that source. To later re-enable, simply remove the source, instead of
invalidating it. Once i've called CFRunLoopSourceInvalidate it appears that my only option is to release the interface by calling
HIDReleaseDeviceList and start over.
*/
PsychError PsychHIDReceiveReportsCleanup(void)
{
int deviceIndex;
//printf("Clean up before PsychHID is flushed.\n");
for(deviceIndex=0;deviceIndex<MAXDEVICEINDEXS;deviceIndex++) if(source[deviceIndex]!=NULL) {
CheckRunLoopSource(deviceIndex,"PsychHIDReceiveReportsCleanup",__LINE__);
CFRunLoopRemoveSource(CFRunLoopGetCurrent(),source[deviceIndex],myRunLoopMode);// kCFRunLoopDefaultMode
if (optionsPrintCrashers) printf("%d: CFRunLoopSourceInvalidate\n",deviceIndex);
CFRunLoopSourceInvalidate(source[deviceIndex]);
if(optionsPrintCrashers) printf("%d: source %4.4lx validity %d, CFRunLoopContainsSource is %d.\n",deviceIndex,(unsigned long)source[deviceIndex]
,CFRunLoopSourceIsValid(source[deviceIndex])
,CFRunLoopContainsSource(CFRunLoopGetCurrent(),source[deviceIndex],myRunLoopMode));
ready[deviceIndex]=0;
CheckRunLoopSource(deviceIndex,"PsychHIDReceiveReportsCleanup",__LINE__);
source[deviceIndex]=NULL;
}
// Release all report linked lists, memory buffers etc.:
PsychHIDReleaseAllReportMemory();
return 0;
}
