« Close

Datasheets and User Guides

App Notes

Software & Driver

 

2.5.3 - ListAllS

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

Syntax

LJM_ERROR_RETURN LJM_ListAllS(
                      const char * DeviceType, 
                      const char * ConnectionType,
                      int * NumFound, 
                      int * aDeviceTypes, 
                      int * aConnectionTypes,
                      int * aSerialNumbers, 
                      int * aIPAddresses)

Parameters

DeviceType [in]
Filter device type to find. "T7" for T7 devices, "Digit" for Digit devices, etc. "ANY" is allowed.
ConnectionType [in]
Filter connection type to scan. "USB" for USB connection, "TCP" for TCP connection, etc. "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.