VTI Instruments EX1629 - Vtex1629_Get_Teds_Data

www.vtiinstruments.com
EX1629 Command Set 191
vtex1629_get_teds_data
FUNCTION PROTOTYPE
ViStatus vtex1629_get_teds_data (ViSession vi, ViInt32 channel, ViInt16 _VI_FAR tedsID[], ViInt32
maxLength, ViInt16 _VI_FAR tedsInfo[]);
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
channel = an integer input value that specifies the channel for which the tare value will be returned. Valid input
values: 0 to 47.
tedsID = a return array that will contain the TEDS ID. Each element of the array corresponds to a byte of data from
the ID register of the TEDS device. The size of this array is VTEX1629_TEDS_IDSIZE (8).
maxLength = an integer input value that specifies the maximum number of bytes to be retrieved from the TEDS
device into tedsInfo. In general, this should be equal to VTEX1629_TEDS_DATASIZE (32).
tedsInfo[] = A return array that will contain the TEDS Info. Each element of the array corresponds to a byte of data
from the ID register of the TEDS device.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns the TEDS data for a given channel. It only supports the DS2430 EEPROM. For
communicating with other TEDS EEPROM devices, the vtex1629_read_teds_URN, vtex1629_read_teds_MLAN,
and vtex1629_write_teds_MLAN functions should be used.
The tedsID element is a unique, 64-bit (8-byte) serial number assigned by the manufacturer to the 1-Wire TEDS
device. The tedsInfo element contains the data stored in the DS2430’s 32-bytes of non-volatile memory.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt16 tedsID[VTEX1629_TEDS_IDSIZE];
ViInt32 maxlen;
ViInt16 tedsinfo[VTEX1629_TEDS_DATASIZE];
…
…
status = vtex1629_get_teds_data(instrumentHandle,
47,
tedsID,
VTEX1629_TEDS_DATASIZE,
tedsinfo);