« Close

Datasheets and User Guides

App Notes

Software & Driver

 

2.5.4 - ListAllExtended

Advanced version of LJM_ListAll that performs an additional query of arbitrary registers on the device.

Syntax

LJM_ERROR_RETURN LJM_ListAllExtended(
                      int DeviceType,
                      int ConnectionType,
                      int NumAddresses,
                      const int * aAddresses,
                      const int * aNumRegs,
                      int MaxNumFound,
                      int * NumFound,
                      int * aDeviceTypes,
                      int * aConnectionTypes,
                      int * aSerialNumbers,
                      int * aIPAddresses,
                      unsigned char * aBytes)

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.
NumAddresses [in]
The number of addresses to query. Also the size of aAddresses and aNumRegs.
aAddresses [in]
The addresses to query for each device that is found.
aNumRegs [in]
The addresses to query for each device that is found. Each aNumRegs[i] corresponds to aAddresses[i].
MaxNumFound [in]
The maximum number of devices to find. Also the size of aDeviceTypes, aConnectionTypes, aSerialNumbers, and aIPAddresses.
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 MaxNumFound.
aConnectionTypes [out]
An array of connection types, one for each of the NumFound devices. Must be preallocated to size MaxNumFound.
aSerialNumbers [out]
An array of serial numbers, one for each of the NumFound devices. Must be preallocated to size MaxNumFound.
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.
aBytes [out]
An array that must be preallocated to size:
MaxNumFound * <the sum of aNumRegs> * LJM_BYTES_PER_REGISTER,
which will contain the query bytes sequentially. A device
represented by index i would have an aBytes index of:
(i * <the sum of aNumRegs> * LJM_BYTES_PER_REGISTER).

Returns

LJM errorcodes or 0 for no error.

Remarks

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_extended.c, available in the LJM C++ examples.