Dmm.makebuffer() - Keithley 3700A Series Reference Manual

Section 11: TSP command reference

dmm.makebuffer()

This function creates a user buffer for storing readings. Reading buffers are allocated dynamically.
Type TSP-Link accessible
Function Yes
Usage
bufferVar = dmm.makebuffer(bufferSize)
bufferVar
bufferSize
Details
To be able to store readings, a reading buffer needs to be created. Once created, the reading buffer
can be used to store readings from dmm.measure() command and from scanning
(scan.execute() or scan.background())
To delete a buffer, set bufferVar to nil.
Once a buffer is created, the attributes that can be accessed are:
•
bufferVar.appendmode = 1 (ON) or 0 (OFF); default is zero (0) over a bus interface, and 1 for
buffers created on the front panel.
•
bufferVar.basetimeseconds returns the seconds for reading buffer entry 1 (read-only
attribute).
•
bufferVar.basetimefractional returns the seconds and fractional seconds for reading
buffer entry 1 (read-only attribute).
•
bufferVar.capacity returns the overall buffer size.
•
bufferVar.collecttimestamps = 1 (ON) or 0 (OFF); default is 1.
•
bufferVar.collectchannels = 1 (ON) or 0 (OFF); default is 1.
•
bufferVar.n returns the number of readings currently stored in the buffer.
•
bufferVar.timestampresolution returns the resolution of the timestamping (read-only
attribute).
The following buffer bits indicate buffer statuses:
•
dmm.buffer.LIMIT1_LOW_BIT or 1
•
dmm.buffer.LIMIT1_HIGH_BIT or 2
•
dmm.buffer.LIMIT2_LOW_BIT or 4
•
dmm.buffer.LIMIT2_HIGH_BIT or 8
•
dmm.buffer.MEAS_OVERFLOW_BIT or 64
•
dmm.buffer.MEAS_CONNECT_QUESTION_BIT or 128
To see readings in buffer:
printbuffer(x, y, bufferVar)
Where x and y represent the reading numbers to be returned.
11-196
Affected by
Reset
Recall setup
The variable name for the buffer being created
Maximum number of readings that the buffer can store
Series 3700A System Switch/Multimeter Reference Manual
Where saved
Create configuration script
Save setup
3700AS-901-01 Rev. D/June 2018
Default value
None