ListAllS [LJM User's Guide]

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. "ANY" for any T-series or Digit device, "T4" for T4 devices, "T7" for T7 devices, "T8" for T8 devices, "TSERIES" for any T-series devices, "Digit" for Digit devices.

For other LabJack devices, see What driver/library should I use with my LabJack?

ConnectionType [in]

Filter connection type to scan. "ANY" for any connection type, "USB" for USB connection, "TCP" for TCP connection, "WIFI" for WiFi connection, etc.

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.

Device Not Found?

If a device isn't properly being found, some important debugging information can be found in our Device Not Found? App Note. If a network connection needs to be debugged, read through our Setup WiFi and Ethernet App Note as well.