MSP430 Java HID Demo App -- Release Notes
Welcome to the MSP430 Java HID USB Demo App! This is an
example of a host-side HID application. It's designed to use the
HID-Datapipe format (see the Programmer's Guide for more information).
However, it could also be used for any custom HID device -- that is, an
HID device not driven directly by the OS, like a mouse/keyboard.
The project is composed
of a Java GUI and C drivers. The communication between Java
and the C
drivers is Java Native Interface (JNI) based. This means
there
is an accompanying dylib in the same path as the *.jar file that contains
the native calls.
This document is divided into the following sections:
The HID
Demo App can be run with any of the HID-Datapipe examples included in
the USB Developers Package. Please refer to the Examples Guide in the
Developers Package for usage information.
The Hid
Demo App may be executed from a command line, by navigating to the
directory in
which the *.jar file is located, and typing the following command:
java
-jar -Djava.library.path=/<path_to_.dylib_file>/ HidDemo.jar
This should
bring up the HID Demo App. If it does not, check to ensure that a
Java Virtual Machine (JVM) is listed in your PC's path.
The project contains:
com |
Top Level Java and Class files |
doc |
Release Notes image files |
icons |
User interface resources |
jni |
C sources and library |
There is also a Makefile, at top level, for rebuilding the application
(*.jar
file and SO). To rebuild, please see pre-requisites.
The HID Demo App was
developed only as an example, so you're encouraged to modify and update
it.
In order to do this, you will need the following software
installed:
Modify the Makefile (in
hidDemo-mac/Makefile) to add
the location of the JDK.
If the compilers were installed correctly, the only changes that should
be needed is the JDK path.
The JDK paths should point to where your system's JDK is installed (the
JDK
directory right above bin/ that contains javah.exe).
The
final step is to open a terminal window and run "make" in the HidDemo-mac directory.
The version has been tested on a 64-bit Mac OS 10.10.1 machine.
If
the HID port connected to the device does not have read and write
permissions, the Java Hid Demo App will disapper upon connection
to the device.
This is demo code, and therefore there is no versioning.
First check the
Examples Guide and MSP430 USB API Programmer's Guide in the USB
Developers Package for more information. If you still need support,
please
visit the MSP430
E2E forum.
or e-mail us directly at msp430ware@list.ti.com.