Java for UD - Windows | LabJack
 
« Close

Datasheets and User Guides

App Notes

Software & Driver

 
Table of Contents

Java for UD - Windows

Java wrappers and examples for the Windows UD library. The Windows UD library is the high-level Windows library/driver for the LabJack U3, U6 and UE9. For other LabJack devices, go to the Software page.

Warning: If you intend to create a 64-bit application please ensure you use AddRequestPtr rather than AddRequest anywhere you write or read an array of data. See our AddRequest documentation for more information.

 

Java_LJUD_2015_04_27.zip

The latest and recommended Java wrapper and examples for the Windows UD driver. Requires JNA and supports 32 and 64-bit Java and UD driver. Refer to the download's README.txt for requirements, compile/run instructions, documentation and license information.

 

Old Java_LJUD.zip

The old Java wrapper and examples which are no longer updated. Uses a JNI dll and only supports 32-bit Java and UD driver. Refer to the text file in the zip for more information.

 

UD Examples Overview (Referencable)

UD Library Overview

First read the general overview of the UD library:

https://labjack.com/support/software/api/ud/overview

The UD driver has a handful of functions, many with the same 4 to 6 parameters.

Functions

The main functions are used to build a list of requests (Add), execute the list (Go), and read the result of each request (Get).  Some functions (e.g. eGet) combine a single add/go/get into one function call.

Parameters

The parameters are described at the bottom of the Overview page.  The meaning of each parameter should be apparent (e.g. Channel is the channel number you are operating on), but when it is not the pseudocode section of the device's datasheet has the extra information needed.

  • Handle:  Always the handle.
  • IOType:  Always the IOType.
  • Channel:  If something besides a channel number the pseudocode section will tell you.
  • Value:  Always the value.
  • X1:  Usually not used, but if used the pseudocode section will tell you.
  • UserData:  Usually not used, but if used the pseudocode section will tell you.

Pseudocode

Device specific pseudocode can be found in datasheet section 4.3:

U3: https://labjack.com/support/datasheets/u3/high-level-driver/example-pseudocode
U6: https://labjack.com/support/datasheets/u6/high-level-driver/example-pseudocode
UE9: https://labjack.com/support/datasheets/ue9/high-level-driver/example-pseudocode

File Attachment: 
Java_LJUD_2015_04_27.zip
Old Java_LJUD.zip

14 comments

Submitted by SteveOll (not verified) on Sun, 11/06/2011 - 10:00

I am looking for code that will let me use the labjack with BlueJ java. Nothing too complicated like the Java code in the download above. Do you have anything that can help me as I don't have experience with using other Java IDEs or Python, thanks.

Submitted by LabJack Support (not verified) on Mon, 11/07/2011 - 14:04

If you want to use the UD driver, or any other dll, and Java in general, you will need something like we provide in the download since Java requires JNI (Java Native Interface).  Also, the UD driver this Java interface wraps is our high level driver, and is one of the easiest ways to interface with our UD devices (UE9/U3/U6).

I've never used BlueJ Java before, but is there no way to load the dll in code and add the classpath to the jar file?  An alternative to using the jar file in your project would be to extract the class files out of the jar and add them to your project.  Note to keep the directory structure of the LJUDJava classes in your project (com\labjack\labjackud).  You can extract the classes with the "jar xf LJUDJava.jar" command.

Submitted by Ianc (not verified) on Thu, 02/28/2013 - 08:52

I am running into a runtime unsatisfied link symbols error when running a Java program connecting to the U3 on 3.25 of the UD.

The call to LJUD.GetDriverVersion() is failing - it looks like the dll will not support this call anymore

it used to work ok.

Has anyone had success with Java connections recently?

 

Submitted by LabJack Support (not verified) on Thu, 02/28/2013 - 15:40

I tested with the latest UD driver 3.32 and didn't see problems. Do the examples run for you?

Note that the wrapper currently only supports 32-bit Java, so the 32-bit UD driver (labjackud.dll) needs to be installed in the "C:\Windows\System32\" directory on 32-bit Windows or "C:\Windows\SysWOW64" on 64-bit Windows. The UD installer should have taken care of that.

Submitted by Anonymous (not verified) on Fri, 10/18/2013 - 13:04

When will a 64 bit Java and UD driver be released? I have the java program working perfectly on a 32 bit system but will not work on a 64 bit system.

Submitted by LabJack Support (not verified) on Tue, 10/22/2013 - 17:37

We are currently working on this at the moment.  We are changing our Java support to use JNA which allows one set of Java code to work in both 32-bit and 64-bit environments.  We are still working on finalizing how we want things but are sending some samples to people for feedback.  If you would like more info or for some preview code please send us an email at [email protected].

Submitted by wgilster (not verified) on Thu, 01/02/2014 - 18:20

I'm interested in this as well. Just posting this so I can be notified when this is available.

Submitted by CBed (not verified) on Fri, 03/27/2015 - 14:42

Have you guys made progress on the 64 bit JNA library yet?

I have a bunch of U6 pros and code running well in 32 bit java but the programs have a lot going on and I'd like to update to 64 bit for the extra memory capacity.

Just wanted to let you know i like your products and they work well for me. If you get the 64 bit library worked out I'll be buying more.

If you wanted to do something else awesome I'd love to see a accessory board that is setup for direct measurement of Strain Gauge signals at 24 bit.

I've been wanting to make an attempt at a prototype board with the AD7710 to simplify/expand my load cell and other strain gauge measurements but never get the chance. :-)

 

Thanks,

Chris

 

Submitted by LabJack Support (not verified) on Fri, 03/27/2015 - 16:23

If you send us an email we can send the current JNA example which is 64-bit compatible. Unfortunately we haven't made much progress since our last post, but since you brought it to our attention again I can look into making a UD Java interface using JNA. It would be comparable to our LJM driver's Java interface, but will use the UD functions. Note that it will use some JNA data types for parameters which will differ than the JNI interface we currently provide. I'll post again when that's available.

If you are looking into getting additional LabJacks we do have the LabJack T7. It has cross-platform 32-bit and 64-bit Java support:

http://labjack.com/t7

http://labjack.com/support/ljm/examples/java

Submitted by LabJack Support (not verified) on Mon, 04/27/2015 - 14:49

The new Windows UD Java wrapper and examples using JNA with 32 and 64-bit support is now available for download on this page.

Submitted by WesG (not verified) on Mon, 04/27/2015 - 17:02

Thanks a ton. This works like a great on Windows 64. What would it take to get this driver ported to Linux?

Submitted by LabJack Support (not verified) on Mon, 04/27/2015 - 18:23

For the newly released Java LJUD wrapper to work on Linux would require us to port the Windows UD library/driver and update the Java wrapper. The UD library/driver is for Windows only and is closed source. Currently we have no plans to port the UD library to other operating systems. For Linux and UD devices (U3, U6 and UE9), a different Java wrapper would be needed as the UD and Exodriver (Linux/Mac OS X library) functions are different. Linux user's will need to use their own JNI or JNA (recommended way) code with the Exodriver and its functions as we currently do not provide a Linux Java wrapper.

The only cross-platform library (Windows, Linux, Mac OS X) with a Java wrapper that we provide is the LJM driver. At this time the LJM library only supports the Digit (didn't mention it in a previous comment) and T7, and will support future devices.

Submitted by WesG (not verified) on Mon, 04/27/2015 - 20:45

Yeah, I've looked at the exodriver, which is why I asked about the UD driver linux port.  :)  Although, I'm wondering if the LJM library is what I should have utilized instead of the Windows UD driver. All I'm really after is the following methods below. Out of those methods, it looks like the ePut/eGet are the only two methods that don't have direct replacements in the LJM library. Do you have some examples of how I would use the LJM library to get the equivalent functionality as the ePut/eGet methods gave me?

int OpenLabJack(int DeviceType, int ConnectionType, String Address, int FirstFound, IntByReference Handle );

int ePut(int Handle, int IOType, int Channel, double Value, int x1);

int eGet(int Handle, int IOType, int Channel, DoubleByReference pValue, int x1);

void ErrorToString(int ErrorCode, ByteByReference pString);

int ListAll(int DeviceType, int ConnectionType, IntByReference pNumFound, IntByReference pSerialNumbers, IntByReference pIDs, DoubleByReference pAddresses);

Submitted by LabJack Support (not verified) on Tue, 04/28/2015 - 10:51

For reading and writing a single value using the LJM library there are the eReadName/Address and eWriteName/Address functions. With these functions you specify the Modbus Name (a string) or address of what you want to read/write on the device. For example, these UD calls to read from AIN1 and set DAC1:

eGet(handle, LJ_ioGET_AIN, 1, &value, 0); //Read from AIN1
ePut(handle, LJ_ioPUT_DAC, 1, 2.50, 0); //Set DAC1 to 2.50 V

look like this in the LJM driver (using name functions):

LJM_eReadName(handle, "AIN1", &value); //Read from AIN1
LJM_eWriteName(handle, "DAC1", 2.50); //Set DAC1 to 2.50 V

Here are the documentation pages for the function calls with the same functionality as the functions you listed:

LJM_OpenS
LJM_eWriteName
LJM_eReadName
LJM_ErrorToString
LJM_ListAllS

Here is the LJM User's Guide with more documentation and functions:

http://labjack.com/support/ljm/users-guide

Here are the LJM examples for a variety of languages, including Java examples demonstrating LJM_eWriteName and LJM_eReadName:

http://labjack.com/support/ljm/examples

Copyright © 2001-2099 LabJack Corporation. All rights reserved. 

Privacy Policy