2600AS-901-01 Rev. B / September 2008
Return to
19-95
Series 2600A System SourceMeter® Instruments Reference Manual
Section 19: Remote Commands
printbuffer and printnumber
These functions are used to print data and numbers.
printbuffer
Function
Prints data from tables and reading buffer sub-tables.
TSP-Link
accessibility
This function cannot be accessed from a remote TSP-Link node.
Usage
There are multiple ways to use this function, the use depends on the number of tables or reading
buffer subtables that are specified:
printbuffer(start_index, end_index, st_1)
printbuffer(start_index, end_index, st_1, st_2)
printbuffer(start_index, end_index, st_1, st_2, ..., st_n)
start_index
Starting index of values to print.
end_index
Ending index of values to print.
st_1, st_2, … st_n
Tables or reading buffer subtables from which to print.
Remarks
• Correct usage when there are no outstanding overlapped commands to acquire data:
• 1 <= start_index <= end_index <= n
• Where
n
refers to the index of the last entry in the tables to be printed.
• If
end_index < start_index
or
n < start_index
, no data will be printed. If
start_index < 1,
1 will be used as the first index. If
n < end_index
, n will be used as the
last index.
• When any of the given reading buffers are being used in overlapped commands that have not
yet completed at least to the desired index, this function will return data as it becomes available.
• When there are outstanding overlapped commands to acquire data,
n
refers to the index that the
last entry in the table will have after all the measurements have completed.
• If you do not specify a subtable in a reading buffer, default subtables are automatically used. The
readings
subtable is the default for the Series 2600A reading buffers.
• At least one table or subtable must be specified.
• This command generates a single response message that contains all data. The response
message is stored in the output queue.
• The
format.data
attribute controls the format of the response message.
Also see
Example
This example prints all time stamps and readings in one buffer and all readings from another buffer,
where n is 4:
format.data = format.ASCII
printbuffer(1, rb1.n, rb1.timestamps, rb1, rb2)
Example of returned data (timestamps, rb1.readings, rb2.readings):
1.02345E-04, 8.76542E-04, 5.29372E-01, 1.02445E-04, 8.66543E-04,
5.24242E-01, 1.02545E-04, 8.56547E-04, 5.19756E-01, 1.02645E-04,
8.44546E-04, 5.14346E-01
