Section 11: TSP command reference
Series 3700A System Switch/Multimeter Reference Manual
11-196
3700AS-901-01 Rev. D/June 2018
dmm.makebuffer()
This function creates a user buffer for storing readings. Reading buffers are allocated dynamically.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Reset
Recall setup
Create configuration script
Save setup
None
Usage
bufferVar
= dmm.makebuffer(
bufferSize
)
bufferVar
The variable name for the buffer being created
bufferSize
Maximum number of readings that the buffer can store
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.
