AduHid.dll and AduHidTest software have been upgraded to V2.0 as of Jan 7,
2014. The software and DLL were upgraded to facilitate the use of the new
ADU7x series of devices that operate as Full-Speed usb devices. The
new DLL if fully backwards compatible with the old DLL.
AduHidTest is a FREE USB Device test
program used to test the connection of ADU data acquisition devices to a USB port. The
program is also a useful tool to allow programmers to become familiar with the
ADU command set.
For this tutorial we will use an ADU200 USB Relay I/O Interface to
demonstrate use of the software.
There are three steps in using a USB device in any application
software. The three steps are ,
- Obtain a handle for the USB device.
- Send commands to the USB device.
- Receive data from a USB device.
STEP 1: Obtain a handle for the USB Device (
ADU200 USB Relay I/O Interface )
A handle is a unique code that application software uses to identify
a USB device for the purpose of reading and writing to the device. A USB bus can
have up to 128 devices connected to a single host and there are three criteria that can be
used to open a handle. The three criteria are, Vendor ID, Product
ID and Serial Number. If a single device is connected to the
bus, any of the three criteria may be used. If multiple devices are connected, we
recommend using the Serial Number to open the handle ( All ADU devices
have their unique serial number printed on the top label ) The AduHidTest program main
Window is shown in Figure 1.
Figure 1: AduHidTest Main Window
The Open/Close section of the window is where the handle is
determined and there is a Show List button in the section. Click on the
Show List button to view the devices connected to the USB bus. ( Note: Only
ADU devices will be listed ) Figure 2 is the window that appears when the Show
List Button is clicked.
Figure 2: " Show List " Display
The display indicates that we have two ADU200 devices connected with
serial numbers A33764 and A33771. Select a device by clicking on the desired device. The
AduHidTest main window will now display the product ID and Serial number. Click the By
Serial # radio button and then click Open to open the handle to the
Figure 3: Connected to A33771
STEP 2: Send Commands to the USB Device (
ADU200 USB Relay I/O Interface)
Once connected, you may now send commands to the available
"pipes" on the device. Pipes are the individual connections to functional
sections of the ADU200. The Device Pipe is used to send standard ASCII
ADU commands to control the peripherals built into the ADU200
such as the relay outputs or event counter inputs. Type "sk3" (
Close relay K3 ) into the device pipe send window and click Send ADU .
Relay K3 on the ADU200 will close and the software will display a small "OK"
next to the Send ADU button indicating the command was sent.
Figure 4: Sending "sk3" Command
STEP 3: Receive Data from the USB
Device ( ADU200 USB Relay I/O Interface)
Some commands will cause a response to be sent from the ADU
device to the host computer. For example, if an "re1" ( read event counter 1 )
command is sent, the ADU200 will send back the 5 digit count. To read responsive
commands, simply click the Receive ADU button and the data will be displayed.
Figure 5: Sending "re1" and Receiving Count
The RS232 Pipe is used to send and receive ASCII strings to any
RS232 based device connected to the ADU200 auxiliary serial port. The method of
sending commands is identical to device pipe, in that you simply enter the ASCII
command string, and click the Send 232 button. Data is received, and then
displayed when the Receive 232 button is clicked.
In the following example, an "rd" ( analog array read )
command is sent to an ADR2000B Data Acquisition Interface connected
the the ADU200 auxiliary serial port. Figure 6 shows the "rd" command being sent
and Figure 7 shows the returned data displayed after the Receive 232 button is
Figure 6: Sending "rd" Command to RS232
Figure 7: Receiving Data on RS232 Pipe
Presently, there are no ADU devices available that support the
stream pipe and thus no explanation of this feature will be presented at this time.
Download AduHidTestV2.0 (
32 Bit ) now, in ZIP Format
( 184K ). ( Contains DLL Ver 2.1 )
For a 64-bit version see: 64-Bit
DLL for and AduHidTest64 for ADU Products
Back to Programming Page