Question

How do I detect a button press on a USB gamepad on OSX 10.5 and higher?

I can’t wrap my head around the ridiculously complex HID Manager (even though apparently it was simplified with 10.5), and the code samples at Apple have thousands of lines of code that would take days to understand and isolate what I need, so I’d appreciate if someone posts a simple, and fully coded solution for this isolated problem.

---

EDIT: so far all answers are links to source code or semi obscure libraries for all kinds of HID devices, which will require more research time than what I’d like to invest on this. I am starting a bounty to get an actual snippet of code that solves this simple problem (using an external library or not).

---

EDIT POS BOUNTY: thanks to all for you help; but unfortunately the answer that has been automatically selected by the system is not working for me, can’t figure out why; and the author has not yet replied to my comments. Any insight would be appreciated, but until a fix is found, anyone looking for resources on this topic should take this answer with a pinch of salt.

Answer 1

Peter’s suggestion of the DDHidLib framework is exactly what you are looking for. The library is well designed and the sample code that comes with the library is pretty self-explanatory.

An implementation of an object that gets all the joysticks/gamepads attached to the system and watches for button presses using DDHidLib would look something like this:

#import <Cocoa/Cocoa.h>
#import <DDHidLib/DDHidLib.h>

@interface JoyStickWatcher : NSObject
{
    NSArray* joySticks;
}
- (void)startWatchingJoysticks;
@end


@implementation JoyStickWatcher
- (void)startWatchingJoysticks
{
    //get an array of all joystick objects
    joySticks = [[DDHidJoystick allJoysticks] retain];

    //become the delegate of all available joystick objects
    [joySticks makeObjectsPerformSelector:@selector(setDelegate:) withObject:self];
}

- (void)dealloc
{
    [joySticks release];
    [super dealloc];
}

//these are the DDHidLib joystick delegate methods related to buttons

- (void)ddhidJoystick:(DDHidJoystick *)joystick buttonDown:(unsigned)buttonNumber
{
    NSLog(@"button number %ld of joystick %p went down",joystick,buttonNumber);
}

- (void)ddhidJoystick:(DDHidJoystick *)joystick buttonUp:(unsigned)buttonNumber
{
    NSLog(@"button number %ld of joystick %p went up",joystick,buttonNumber);
}

@end