« Close

Datasheets and User Guides

App Notes

Software & Driver

 

2.5.2 - ListAll

Scans for LabJack devices, returning arrays describing the devices found. The use of "ANY"-type for DeviceType and ConnectionType allow this function to perform a broad search.

Syntax

LJM_ERROR_RETURN LJM_ListAll(
                      int DeviceType, 
                      int ConnectionType,
                      int * NumFound, 
                      int * aDeviceTypes, 
                      int * aConnectionTypes,
	              int * aSerialNumbers, 
                      int * aIPAddresses)

Parameters

DeviceType [in]
Filter device type to find. 7 for T7 devices, 200 for Digit devices, etc.  0 for ANY is allowed.
ConnectionType [in]
Filter connection type to scan. 1 for USB, 2 for TCP, 3 for Ethernet, 4 for WIFI. 0 for ANY is allowed.
NumFound [out]
A pointer that returns the number of devices found.
aDeviceTypes [out]
An array of device types, one for each of the NumFound devices. Must be preallocated to size LJM_LIST_ALL_SIZE.
aConnectionTypes [out]
An array of connection types, one for each of the NumFound devices. Must be preallocated to size LJM_LIST_ALL_SIZE.
aSerialNumbers [out]
An array of serial numbers, one for each of the NumFound devices. Must be preallocated to size LJM_LIST_ALL_SIZE.
aIPAddresses [out]
An array of IP Addresses, one for each (if applicable) of the NumFound devices. When the device is not TCP capable, IP address will be LJM_NO_IP_ADDRESS.

Returns

LJM errorcodes or 0 for no error.

Remarks

This function is useful for big programs that open multiple kinds of devices, especially when the device type and connection type are unknown. This function only shows what devices could be opened. To actually open a device, use LJM_Open or LJM_OpenS.

When the ConnectionType parameter of this function is network-based, this function will check the IP addresses listed in LJM_SPECIAL_ADDRESSES_FILE.

Examples

See examples/utilities/list_all.c, available in the LJM C++ examples.