Section 8: TSP command reference
Model 2461 Interactive SourceMeter® Instrument Reference Manual
8-14
2461-901-01 A/November 2015
buffer.make()
This function creates a user-defined reading buffer.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
bufferVar =
buffer.make(
bufferSize
)
bufferVar =
buffer.make(
bufferSize
,
style)
bufferVar
A user-supplied string that indicates the name of the buffer
bufferSize
The maximum number of readings that can be stored in
bufferVar
; minimum is
10
style
The type of reading buffer to create:
•
Store readings with reduced accuracy (6.5 digits) with no formatting information,
1 μs accurate timestamp, maximum 27,500,000 readings:
buffer.STYLE_COMPACT
•
Store readings with full accuracy with formatting, maximum 6,875,000 readings:
buffer.STYLE_STANDARD
(default)
•
Store the same information as standard, plus additional information:
buffer.STYLE_FULL
•
Store external reading buffer data:
buffer.STYLE_WRITABLE
•
Store external reading buffer data with two reading values:
buffer.STYLE_WRITABLE_FULL
Details
You cannot assign user-defined reading buffers the name
defbuffer1
or
defbuffer2
.
If you create a reading buffer that has the same name as an existing user-defined buffer, the existing
buffer is overwritten by the new buffer. Any data in the existing buffer is lost.
When you create a reading buffer, it becomes the active buffer. If you create two reading buffers, the
last one you create becomes the active buffer.
The default fill mode of a user-defined buffer is once. You can change it to continuous.
Once the buffer style is selected, it cannot be changed.
Once you store the first reading in a compact buffer, you cannot change certain measurement
settings, including range, display digits, and units; you must clear the buffer first.
Not all remote commands are compatible with the compact, writable, and full writable buffer styles.
Check the Details section of the command descriptions before using them with any of these buffer
styles.
Writable readings are used to bring external data into the instrument. You cannot assign them to
collect data from the instrument.
You can change the buffer capacity for an existing buffer through the front panel or by using the
bufferVar
.capacity
command.