e-AR Lite Sensor Interface

e-AR Lite Sensor Interface - Installation Instructions for Application Programming

Installing onto a Windows machine

Click here to download the driver, and extract the files onto a directory (i.e. c:\temp).

Note: You may have to install the driver manually:

by going to Control Panel->System and Security->System->Device Manager
right click on the e-AR Lite under "Unknown device"
Then select "Update Driver software..." and choose "Browse my computer for driver software"
Then point to the directory where the driver is located (i.e. c:\temp).
You may see a security warning: "Windows can't verify the publisher...", and just choose "Install this driver software anyway"

Java LibUSB

In addition to the driver, you will also need to install the Java Lib USB, to enable the Java interface with the sensor via USB

Install the LibUSB (x86 [PC with Intel processor], AMD64 [PC with AMD 64-bit processor]) (updated version can be found here)
Unzip the file and then run the 'install-filter.exe' file to install the driver.

Copy the LibusbJava.dll here (64 bits version) to c:\Windows\System32\ (updated version can be found here)

Copy the Java LibUSB Jar here to %JAVAJRE%\lib\ext\ (updated version can be found here)
Note: %JAVAJRE% represents the Java JRE path, and to find the Java JRE path:
- Open Command Prompt (All Programs->Accessories->Command Prompt)
- In command prompt type: c:>echo %classpath%
- You will get something like:
```
.;c:\Program Files\Java\jre6\lib\ext\QTJava.zip
```
  and the JRE path is: c:\Program Files\Java\jre6\ext\
- Then you can copy the file to c:\Program Files\Java\jre6\
- Please make sure you restart your browser, once you have installed the Java LibUSB

More details on Java LibUSB can be found here

Java and Java Plugin

Make sure JDK is installed (link to JDK install page)
Copy the plugin.jar from the %JDK%\jre\lib\ to %JDK%\jre\lib\ext to enable JSObject (communication between Java Applet and Java Script)
(%JDK% represents the directly where JDK is installed)

Installing onto a Mac machine

Download and install the libusbjava.jnilib (Mac OS X Lion, Snow Leopard) onto the directory: Library\Java\Home\bundle\Libraries

Installing onto a Linux machine

Download and install the libusbJava.so.0.2.4.0 (Ubuntu 11.10)
- copy the file to /usr/lib/jni
> sudo cp libusbJava.so.0.2.4.0 /usr/lib/jni/.
Then create a link to that library
> sudo ln -s libusbJava.so.0.2.4.0 libusbJava.so

usb_interrupt_read/write

usb_bulk_read/write

>sudo java eARLiteInterface

To make the library on a Mac machine

Note you need to have administrative right to install the necessary software onto a Mac Machine

Download MacPorts (Lion, Snow Leopard) (for more details: http://www.macports.org/install.php)
Start the terminal program (Applications\Utilities\Terminal)
At the command prompt, type the following to update the MacPorts:

>sudo port selfupdate
To use MacPorts, you will need to install the latest version of the Xcode (You can download the XCode from Apple Developers website or Mac App Store) ( for more details..)
In addition, you will need to install the Command Line Tools manually via the Xcode->Preference...->Downloads->Command Line Tools
Use MacPorts to check the available libraries for usb:

>sudo port list| grep -i usb
If you see following warning: Warning: xcodebuild exists but failed to execute, do the following:
>sudo xcode-select -switch /Applications/Xcode.app
To install the necessary libusb library:

>sudo port install libusb-devel

>sudo port install libusb

>sudo port install libusb-compat

>sudo port install libusb-legacy

libusb-devel

>sudo port install -f libusb-devel

libusb

>sudo port uninstall libusb

libusb-devel

Download the LibUSBJava source code here (The latest version can be found in here)
Note: several modificaitons had to be made on the "build.xml" file under "mac" section in order to point the parameters to the right files, and replace the file "usb.h" with the file from "\opt\local\var\macport\software\libusb\0.1.12.1\opt\local\include\usb.h" in order to compile the library correctly)
Modifications on the build.xml file incldues:
- set the version to 0.2.4
- change the "...libusbpp.dylib" to "/opt/local/lib/libusb-legacy/libusbpp_legacy_0.1.4.4.4.dylib"
- Modify the "project.properties" file and change "/usr/..." to "/opt/..."
Compile and make the library (in the LibUSBJava directory)

>ant mac
it will then create a file libusb.java.jnilib file
Copy this file to Library/Java/home/bundle/Libraries directory

Compiling a Java Applet with JSObject on Mac

To compile a Java Applet which uses the JSObject to create an interface with a Java script using a Mac machine, you will have to do the following:

Install the Java for Mac OS X 10.7 Update via here
Copy the plugin.jar from /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home/lib/plugin.jar to Library/Java/Home/lib/ext/

To make the library on a Linux machine

To find out if e-AR lite sensor is detected

>lsusb
or for more details:
>lsusb -vv
Need to install some software first before building the Java LibUSB library
install the ant first

>sudo apt-get install ant
download the libusb-1.0.8 from sourceforge.net/projects/libusb.files and extract it to /opt/.

> cd /opt/libusb-1.0.8
> ./configure (to configure the package for the system)
> sudo make install
download the libusb-compat-0.1.3 and extract it to /opt/

> cd /opt/libusb-compat-0.1.3 > ./configure > sudo make install
download the libusb-legacy and extract it to /opt/

> cd /opt/libusb-0.1.12
> ./configure
> sudo make install
need to install Java jdk as well

> sudo apt-get install openjdk-7-jdk
find out the java update alternatives

> sudo update-java-alternatives -list
set the update alternative
> sudo update-java-alternatives -set java-1.7.0.-openjdk-i386
Modify the project.properties file:

- change the build.linux.includes3=... to build.linux.includes3=/usr/lib/jvm/java-1.7.0-openjdk-i386/include
- under linux section change \usr\lib to usr\local\lib
Compile the Java Libusb library
> ant linux
It will then create a file libusbJava.so.0.2.4.0
- copy the file to /usr/lib/jni
> sudo cp libusbJava.so.0.2.4.0 /usr/lib/jni/.
Then create a link to that library
> sudo ln -s libusbJava.so.0.2.4.0 libusbJava.so

Note: in linux the LibusbJava function call usb_interrupt_read/write does not work, so you have to use usb_bulk_read/write instead)
Note: To run the java program, you need to use sudo (ie >sudo java eARLiteInterface)