Phone:(705) 671-2652
    Fax:(705) 671-6127
   Email: tom@ontrak.net
Home Products Programming Applications Custom Designs Ordering News
    
adulogo.jpg (1752 bytes) Using AduHidTest USB Device Test SoftwarE V2.0      
   

Note: The 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.

ADU200

Getting Started:

There are three steps in using a USB device in any application software. The three steps are ,

  1. Obtain a handle for the USB device.
  2. Send commands to the USB device.
  3. 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 selected ADU200.

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 Data

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 clicked.

Figure 6:  Sending "rd"  Command to RS232 Pipe

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

 
    
Contact Information
Address Telephone Electronic Mail
Ontrak Control Systems Inc.
764 Notre Dame Ave., Unit #1
Tel: (705) 671-2652 General Information Sales or Support
Sudbury,Ontario Fax:(705) 671-6127 tom@ontrak.net
CANADA P3A 2T2    
              
Next-Day shipping anywhere in Continental U.S. via Fed-Ex
Copyright 2012 ONTRAK CONTROL SYSTEMS 764 Notre Dame Ave, Unit #1 , Sudbury, Ontario, CANADA P3A 2T2  
"Quality serial Data Acquisition Interfaces"           PH. (705) 671-2652 FAX (705) 671-6127