www.vtiinstruments.com
EX1629 Command Set 301
vtex1629_write_teds_MLAN
FUNCTION PROTOTYPE
ViStatus vtex1629_write_teds_MLAN (ViSession vi, ViInt32 channel, ViInt32 bufferArraySize, ViInt8 _VI_FAR
buffer[]);
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.
channels = an input integer value that specifies the channel number for the TEDS device to which the MLAN buffer
should be written. Valid input values: 0 to 47.
bufferArraySize = an input integer indicating the size of the array that holds the MLAN command bytes. Its value
should be less than VTEX1629_MAX_MLAN_DATA_LEN.
buffer[] = an input array that contains the TEDS MLAN data. Its size should be less than or equal to
VTEX1629_MAX_MLAN_DATA_LEN.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function writes a variable sized block of MLAN commands and data to the TEDS EEPROM indicated by the
channel parameter. The vtex1629_read_teds_MLAN command can be used to read the response back from the
device. The commands and data in the buffer must comply with the MicroLAN specification in IEEE 1451.4-2004
Annex G.
NOTES 1) Details of the MLAN specification can be found at http://www.maxim-
ic.com/products/ibutton/applications/ and other sites.
2) The bytes returned in ‘buffer’ need to be interpreted by the application in accordance with the
MLAN specification.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt8 mlanData[VTEX1629_MAX_MLAN_DATA_LEN];
…
<prepare the command bytes in the mlanData array>
status = vtex1629_write_teds_MLAN (instrumentHandle,
15,
VTEX1629_MAX_MLAN_DATA_LEN,
mlanData);
If (status < VI_SUCCESS)
{
<inform the user the API call failed>
}