Skip to content

Commit 88e110c

Browse files
committed
Docs: update hardware compatibility notes
1 parent c7e2042 commit 88e110c

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ No. It's a pure USB3 device due to the high bandwidth requirements.
2626

2727
Either your device is connected to an USB2-only port (see above), or you don't have permissions to access the device. On Linux, try running Protonect as root (e.g. using `sudo`). If that fixes things, place `rules/90-kinect2.rules` into `/etc/udev/rules.d/` and re-plug the device.
2828

29+
On Linux, also check `dmesg`. If there are warnings like `usb 4-1.1: Not enough bandwidth for new device state.` it means the hardware does not have the capacity for USB3 even if it claims so, or its capacity is not well supported.
30+
2931
On Mac OS X, open "System Information" from Spotlight, go to the USB section, and verify "Xbox NUI Sensor" is under "USB 3.0 SuperSpeed Bus" not "High-Speed Bus". If this is not the case, try unplugging the Kinect from power source with the USB cable connected, and plug the power again, then verify.
3032

3133
### I'm getting lots of USB transfer errors, and/or only blank windows.
@@ -37,6 +39,13 @@ USB3 as a whole is a flaky thing. If you're running Linux, try upgrading to a re
3739

3840
Probably not working:
3941
* ASMedia Technology Inc. Device 1142
42+
* ASMedia Technology Inc. ASM1042
43+
44+
Messages in `dmesg` like this means bugs in the USB driver. Updating kernel might help.
45+
```
46+
[ 509.238571] xhci_hcd 0000:03:00.0: xHCI host not responding to stop endpoint command.
47+
[ 509.238580] xhci_hcd 0000:03:00.0: Assuming host is dying, halting host.
48+
```
4049

4150
Finally, it's also possible that your executable is not actually using the patched libusb from the depends/ folder which is required at the moment. Check this using `ldd | grep libusb` (shows libusb-1.0 under `depends/`), and adjust your `LD_LIBRARY_PATH` if necessary.
4251

0 commit comments

Comments
 (0)