Texas Instruments

MSP430 Java HID Demo App -- Release Notes

Introduction

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:


Prerequisites

To run the app:

To re-build the app:



Running the HID Demo App

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.


Rebuilding  the HID Demo App

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.




Validation

The version has been tested on a 64-bit Mac OS 10.10.1  machine.



Known Issues

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.  



Versioning

This is demo code, and therefore there is no versioning.


Support

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.