dnsDeviceGet

dnsDeviceGet — retrieves a device configuration from the dnscan device list.

Synopsis

(dnsDeviceGet card_id DeviceMacId)
	

Parameters

card_id
The target card ID (0..3).
DeviceMacId
The device MAC ID.

Returns

If successful:

(dnsDeviceGet card_id deviceMacId deviceVendorId deviceType
 deviceProductCode outputSize inputSize outputOffset inputOffset msgSize
connectionType connectionTypeString)

or, if an error is detected, then one of:

(error "dnsDeviceGet DR_ERR_CARD_INVALID (time) invalid card: card_id")
(error "dnsDeviceGet DR_ERR_NO_CARD (time) card not available")
(error "dnsDeviceGet DVN_ERR_CMD_TIMEOUT (time) Cmd failed (timeout)")

Description

Retrieves a device configuration from the device list. The deviceVendorId, deviceType and deviceProductCode information is obtained from the device by the card when the device is added to the device list. The inputOffset and outputOffset values provide the offset of the device's data block (the length of inputSize and outputSize respectively) relative to the beginning of the data buffers, and can be used to compute the address of the user's data points. The connectionType is the same as the connectionType parameter of the dnsDeviceAdd command, and connectionTypeString is a human-readable string representation of the connectionType.