ListAll [LJM User's Guide]
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. LJM_dtANY
(0
) for any T-series or Digit device, LJM_dtT4
(4
) for T4 devices, LJM_dtT7
(7
) for T7 devices, LJM_dtT8
(8
) for T8 devices, LJM_dtTSERIES
(84
) for any T-series device, LJM_dtDIGIT
(200
) for Digit devices.
For other LabJack devices, see What driver/library should I use with my LabJack?
ConnectionType [in]
Filter connection type to scan. LJM_ctANY
(0
) for any connection type, LJM_ctUSB
(1
) for USB connection, LJM_ctTCP
(2
) for TCP connection, LJM_ctWIFI
(4
) 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 Specific IPs.
Examples
See examples/utilities/list_all.c
available in the LJM C++ examples.