SpaceTraveler support using IOKit

[felix]

Hi there,

Nice to see your support for Mac OS X, that's really great.

I've included support for the SpaceTraveler device in our Medical Applications on OSX using the IOKit.framework and the HID functions. One thing that's left is supporting the nice blue LED. Could you please provide me with some information about the HID report buffer I've to send to enable/disable the LED.

Thanks in advance,

Felix

[flomotan]

For our SpaceNavigator, the LEDs are turned on with a HID SetReport call with the following parameters:

report type = 2 (kHIDRtOutputReport)
report ID = 4
report length = 1 byte
report data = 0x00 or 0x01 (off or on)

This is called from the kernel so the API is not what you'd need in user space. In user space with the USBLib it would be something like this (untested):

buffer[0] = 0x01;
request.bmRequestType = USBmakebmRequestType(kUSBOut, kUSBClass,
kUSBInterface);
request.bRequest = kHIDRqSetReport;
request.wValue = 0x0204; // (reportType <<8>DeviceRequest(deviceInterface, &request);

I haven't tried the HIDLib but it should have a SetReport call with similar parameters.

[felix]

Many thanks for the fast response. Unfortunately, it didn't work out for the SpaceTraveler. I'm using the following code, without an error:

Code: Select all

void
HIDSpaceTraveler::enableLED(bool trueOrFalse)
{
  IOHIDDeviceInterface122 ** hidDeviceInterface = getDeviceInterface();
  if (hidDeviceInterface != NULL) {
   
    UInt8 buffer[1] = {0};
    buffer[0] = (trueOrFalse) ? 0x01 : 0x00;
    IOReturn ret = (*hidDeviceInterface)->setReport(hidDeviceInterface, kIOHIDReportTypeOutput, 4, buffer, sizeof(buffer), 100, NULL, NULL, NULL);
    if (ret != kIOReturnSuccess) {
      std::cout << "error changing led state" << std::endl;
    }
  }
}


Any further hints would be greatly appreciated...

Felix

[jwick]

You have to send 3 bits for the SpaceTraveler, CadMan and SpaceMouse(0x07). Turning on/off these individual bits actually allows you to turn on/off every other LED. Some people have even suggested that this would make it easier for you to distinguish the individual buttons on the ST.

Jim
3Dx Software Development

[felix]

This really makes a difference, I agree with those people. Again, many thanks and have a nice weekend.

Felix