Installation

Windows

Installation

Install libusb-win32 and test your installation using the testlibusb-win.exe test program included in the libusb-win32 distribution. If your device is listed, libusbJava will find it as well.
To make libusb-win32 recognize your device you must install a custom device driver (inf-file) for your device (see „Device Installation“).
Download the jar-file and shared library for libusbJava from the project page.

The needed files and correct locations are:

  • libusb0.dll -> windows\system32\
  • libusb0.sys -> windows\system32\drivers\
  • LibusbJava.dll -> windows\system32\
Device Installation

As mentioned above, to use libusb-win32 you need to install a device driver for your device.

Use the programm called inf-wizard.exe included in the binary distribution of libusb-win32. It will create a device driver with the device information you provide. When Windows asks for the driver for your USB device, point it to your inf-file. This will install all the necessary files and the service needed for libusb to work. It will NOT install LibusbJava.dll.

To verify successful installation you can use the testlibusb-win.exe of the libusb-win32 distribution or the UsbView Program. The devices will also show up in the Windows device manager when connected:

Linux

Libusb needs to be installed and working. Make sure you have the proper permissions to access the devices (see this post). To build the source with the included build.xml file, Ant must be installed.

Get the source (see „Binaries and Source“) and execute

# ant linux

in the LibusbJava directory. This will build a shared library named libusbJava.so.x.x.x, where x.x.x is the current version number. Create a symbolic link to that library

# ln -s libusbJava.so.x.x.x libusbJava.so

Note that the library must be on the java.library.path (see this JNI-Howto for more information) and the jar on the classpath.