MEMory Commands (Read instrument memory)


Read ASCII data in memory


Syntax


(Query)


:MEMory:ADATa? A

(response)

B<NR1>,C<NR1>,D<NR1>,...
A = 1 to 80
B,C,D,... = 0 to 65535


Details


Reads the specified number (A) of data values from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:POINt command.
The read pointer is incremented by the number of data values (words/bytes) read. This command cannot be executed while measuring.

Refer to the :MEMory:RATIo? command description regarding conversion to physical values.


Example


:MEMory:POINt CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for storing data in memory.)

:MEMory:ADATa? 10
(Reads 10 ASCII data values from memory.)

(response)  :MEMory:ADATA 1,2,3,4,5,6,7,8,9,10  (when headers are enabled)


Note


-


Usage
Conditions


MEM, XY
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the analog channel is that specified by :MEMory:POINt,
and stored data is present.




Read stored data as binary code


Syntax


(Query)


:MEMory:BDATa? A

(response)

#0...(binary data)
A = 1 to 400


Details


Returns in binary format the specified number (A) of data words stored beginning at the location returned by the :MEMory:POINt command.
The read pointer is incremented by the specified number of data words/bytes.
The read data is structured as follows:
(1) Initially: "#0" (Indicates binary format)
(2) After "#0", the number of data words specified by A is returned.
One storage data unit is 2 bytes.



Upper byte

Lower byte

xxxx

xxxx

xxxx

xxxx

Analog data 1


Upper byte

Lower byte

xxxx

xxxx

xxxx

xxxx

Logic A

Logic B

Logic C

Logic D


(x means 0 or 1)

Refer to :MEMory:RATIo? for conversion method to the physical values of analog data.


Example


:MEMory:POINt CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the data stored in memory.)

:MEMory:BDATa? 10
(Reads 10 data words in binary format.)

(response)  :MEMORY:BDATA #0...(binary format)  (when headers are enabled)


Note


Binary data may include delimiter codes such as 0Ah or 0Dh.
If the PC software misinterprets such codes as data terminators, the PC will not handle the data correctly, so the PC software should always read the number of words specified by A.

Data cannot be written directly in binary format.


Usage
Conditions


MEM, XY
measurement is not taking place,
the memory read pointer is below the address of the stored data,
and stored data is present.




Query FFT data


Syntax


(Query)


:MEMory:FFTData?

(Response)

A<NR3>,B<NR3>
A = x-axis data
B = y-axis data


Details


Returns FFT calculation results (x- and y-axis values) from the output point specified by :MEMory:FFTPOint, as NR3 numerical values.
The output point is automatically incremented every time this command is executed.
Continuous data is available by executing this command repeatedly.


Example


:MEMory:FFTPOint 1,100
:MEMory:FFTData?
(Response)  :MEMORY:FFTDATA 500E-06,-0.0813E-03   (when headers are enabled)


Note


-


Usage
Conditions


FFT




Query FFT runningspectrum frame quantity


Syntax


(Query)


:MEMory:FFTFRame?

(Response)

A<NR1>
A =(frame number)


Details


Return the quantity of FFT runningspectrum frame.


Example


:MEMory:FFTFRame?
(Response)  :MEMORY: FFTFRAME 10   (when headers are enabled)


Note


-


Usage
Conditions


FFT




Query FFT data quantity


Syntax


(Query)


:MEMory:FFTMaxpoint? A

(Response)

A<NR1>,B<NR1>
A = 1,2(Calculation No.)
B = 0 to 10000 (data points)


Details


Returns the quantity of calculated data (B) for the calculation number specified by A.


Example


:MEMory:FFTMaxpoint? 1
(Response)  :MEMORY:FFTMAXPOINT 1,1000  (when headers are enabled)


Note


The value of B depends on the selected FFT Analysis Mode and the FFT Calculation Points.


Usage
Conditions


FFT




Query overall FFT value


Syntax


(Query)


:MEMory:FFTOver? A

(Response)

B<NR3>
A = 1,2 (Calculation No.)
B = (Overall value)


Details


Returns the overall FFT value of the calculation number specified by A.


Example


:MEMory:FFTOver? 1
(Response)  :MEMORY:FFTOVER 0.0612E-03  (when headers are enabled)


Note


NONE is returned of there is no overall value.


Usage
Conditions


FFT




Query FFT peak value data


Syntax


(Query)


:MEMory:FFTPEak? A,B

(Response)

C<NR3>,D<NR3>
A = 1,2 (Calculation No.)
B = 1 to 10 (Peak value No.)


Details


Returns the peak value for the calculation number specified by A.


Example


:MEMory:FFTPEak? 1,10
(Response)  :MEMORY:FFTPEAK 57.6E+03,-107.60E+00  (when headers are enabled)


Note


Returns NONE, if no peak value has been acquired.


Usage
Conditions


FFT




Set or query FFT data output points


Syntax


(Command)
(Query)


:MEMory:FFTPOint A,B(,C)
:MEMory:FFTPOint?

(Response)

A<NR1>,B<NR1>(,C<NR1>)
A = 1,2 (Calculation No.)
B = 0 to 9999 (Output point)
C= 1 to 200 (Runningspectrum frame)


Details


Sets the FFT data output point to the calculation number specified by A.
(For runningspectrum, C specifies the frame.)

Returns the numerical value of the current FFT data output point.
(For runningspectrum, frame (C) is also returned.)


Example


:MEMory:FFTPOint 1,100
:MEMory:FFTPOint?
(Response)  :MEMORY:FFTPOINT 1,100  (when headers are enabled)


Note


The value of B depends on the selected FFT Analysis Mode and the FFT Calculation Points.


Usage
Conditions


FFT




Capture real-time data


Syntax


(Command)


:MEMory:GETReal


Details


This command takes in and holds the value of all the channels inputted now.
Please use the following command to get the held value.
:MEMory:VREAl The value of an analog channel.
:MEMory:LREAl The value of a logic channel.
:MEMory:DVVReal The value of a DVM unit.


Example


:MEMory:GETReal


Note


-


Usage
Conditions


ALL functions
8847, MR8847: When not measuring
(MR8847A: No restrictions)




Read logic data


Syntax


(Query)


:MEMory:LDATa? A

(response)

B<NR1>,C<NR1>,D<NR1>,...
A = 1 to 160
B, C, D,... = 0 to 65535


Details


Reads the specified (A) number of data bytes from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:POINt command.
The read pointer is incremented by the number of data bytes read.

The four subchannels in each logic channel group (A to D) are encoded in the lower four bits of the NR1 data bytes, as shown in the following example.

Bit

15

14

13

12

11

10

9

8

7

6

5

4

3

2

1

0

Data

CHA4

CHA3

CHA2

CHA1

CHB4

CHB3

CHB2

CHB1

CHC4

CHC3

CHC2

CHC1

CHD4

CHD3

CHD2

CHD1


(Data values can be 0 (Low) or 1 (High)).

The decimal data value 10 = the binary value "0000000000001010".


Example


:MEMory:POINt L0,0
(Selects built-in logic channel and sets the index to 0 for the data stored in memory.)

:MEMory:LDATa? 10
(Returns 10 logic data.)

(response)  :MEMORY:LDATA 1,2,3,4,5,6,7,8,9,10  (when headers are enabled)


Note


-


Usage
Conditions


MEM
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the logic channel is specified by :MEMory:POINt
and the stored data is present.





Read real-time logic data


Syntax


(Query)


:MEMory:LREAl? A$

(response)

B<NR1>
A$ = L0 to L8
B = 0 to 65535


Details


Returns the value measured on channel CH$ after acquiring the data with the :MEMory:GETReal command.
Data is returned in the same way as for :MEMory:LDATa.


Example


:MEMory:GETReal
(Causes the instrument to acquire real-time measurement values on all channels.)

:MEMory:LREAl? L0
(response)  :MEMORY:LREAL 10  (when headers are enabled)


Note


If the :MEMory:GETReal command is not executed before this command, returned values are undetermined.


Usage
Conditions


ALL functions




Query the amount of data stored


Syntax


(Query)


:MEMory:MAXPoint?

(response)

A<NR1>
A = 0 (no data stored) to (the number of stored data bytes/words)


Details


Returns the number of data bytes/words stored in memory as a numerical value in NR1 format.


Example


:MEMory:POINt CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the data stored in the memory.)

:MEMory:MAXPoint?
(response)  :MEMORY:MAXPOINT 2501  (when headers are enabled)


Note


The number of stored data bytes/words depends on the channel specified with the :MEMory:POINt command.
Different values can therefore be obtained for different channels if Timebase 2 sampling is being used.


Usage
Conditions


MEM, REC, XY
When not measuring




Set and query the memory read pointer


Syntax


(Command)
(Query)


:MEMory:POINt CH$,A
:MEMory:POINt?

(response)

CH$,A<NR1>
CH$ = CH1 to , L0 to L8, Z1 to Z16
A = 0 to (Storage data -1)


Details


Sets the read pointer in instrument memory.
Returns the current memory read pointer location as a channel and pointer offset as an NR1 numerical value.

CH1 to   Analog Unit
L0  Standard Logic(LA to LD)
L1 to L8  Logic Unit
Z1 to Z16  Waveform calculation


Example


:MEMory:POINt CH1,100
:MEMory:POINt?
(response)  :MEMORY:POINT CH1,100  (when headers are enabled)


Note


If there is no stored data, the read pointer cannot be set.
Value that can be set to A is up to the number obtained by subtracting 1 from the value returned by the :MEMory:MAXPoint? command.
Reconfigure the setting as the set point will become invalid when the next measurement starts.
If the specified channel is the DVM unit, setting is not possible. Set the output point of the DVM unit with :MEMory:DVPOint.


Usage
Conditions


MEM, XY
When not measuring




Query the ratio and offset coefficients for converting stored data into physical values


Syntax


(Query)


:MEMory:RATIo? CH$

(response)

CH$,A<NR3>,B<NR3>
CH$ = CH1 to
A = Ratio
B = Offset


Details


Returns coefficients for converting data read with the :MEMory:ADATa?, :MEMory:BDATa?, :MEMory:DVAData? or :MEMory:RECAData? command into physical values.

The equation used to convert the data into physical values is:
(Physical value) = A * (Data) + B


Example


:MEMory:RATIo? CH1
(response)  :MEMORY:RATIO CH1,500.000000E-03,10.0000000E+03  (when headers are enabled)


Note


-


Usage
Conditions


MEM, REC, XY
Stored data is present.




Read data as ASCII code


Syntax


(Query)


:MEMory:RECAData? A

(response)

B1<NR1>,B2<NR1>,C1<NR1>,C2<NR1>,D1<NR1>,D2<NR1>,...
A = 1 to 40
B1,B2,C1,C2,D1,D2,... = 0 to 65535


Details


Reads the number of data words specified by A from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:RECPoint command.

With the Recorder function, each data object consists of two data words: the maximum and the minimum measurements during the sampling interval.
For example, in the response B1, B2, C1, C2, the B1 and B2 words comprise the first data object, in which B1 is the maximum value and B2 is the minimum value measured during the sampling interval.
Similarly, C1 and C2 comprise the maximum and minimum values, respectively, measured during the sampling interval of the second data object.
This command cannot be executed during startup.

Refer to the :MEMory:RATIo? command description regarding conversion to physical values.


Example


:MEMory:RECPoint CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for stored data in the memory.)

:MEMory:RECAData? 2
(Reads two objects (four data words) of storage data.)

(response)  :MEMORY:RECADATA 20,10,50,30  (when headers are enabled)


Note


In recorder function DVM unit (MR8990) resolution decreases to from 24 bit to 16 bits.


Usage
Conditions


REC
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the analog channel is that specified by :MEMory:RECPoint,
and stored data is present.




Read stored data as binary code


Syntax


(Query)


:MEMory:RECBData? A

(response)

#0...(binary data)
A = 1 to 200


Details


Returns in binary format the specified number (A) of data words stored beginning at the read pointer (channel and pointer offset) returned by :MEMory:RECPoint.
The read pointer is incremented by the number of data words.
Refer to the MEMory:BDATa command description for details about the returned data.

With the Recorder function, each data object consists of two words: the maximum and the minimum measurements during the sampling interval.
The data sequence is identical to that of the :RECAData command: maximum and minimum values during the first sampling interval, followed by maximum and minimum values during the second sampling interval, and so on.


Example


:MEMory:RECPoint CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the stored data.)

:MEMory:RECBData? 10
(Reads 10 samples (20 data words) of storage data.)

(response)  :MEMORY:RECBDATA #0...(Binary data)  (when headers are enabled)


Note


In recorder function DVM unit (MR8990) resolution decreases to from 24 bit to 16 bits.


Usage
Conditions


REC
Measurement is not taking place.
Providing that the stored data is present.
The memory read pointer is below the address of the stored data.




Read logic data


Syntax


(Query)


:MEMory:RECLData? A

(response)

B1<NR1>,B2<NR1>,C1<NR1>,C2<NR1>,D1<NR1>,D2<NR1>,...
A = 1 to 80
B1, B2, C1, C2, D1, D2,.... = 0 to 65535


Details


Reads the specified number (A) of data objects from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:RECPoint command.

With the Recorder function, each data object consists of two data words: the maximum and the minimum measurements during the sampling interval.
For example, in the response B1, B2, C1, C2, the B1 and B2 words comprise the first data object, in which B1 is the maximum value and B2 is the minimum value measured during the sampling interval.
Similarly, C1 and C2 comprise the maximum and minimum values, respectively, measured during the sampling interval of the second data object.
The maximum value will be 1 if there is any data point with a value of 1 during the measurement time for 1 point. The maximum value will be 0 if all data points have the value of 0 during the measurement time for 1 point.
The minimum value will be 0 if there is any data point with a value of 0 during the measurement time for 1 point. The minimum value will be 1 if all data points have the value of 1 during the measurement time for 1 point.

Refer to the :MEMory:LDATa? command description for details about logic data storage.


Example


:MEMory:RECPoint L0,0
(Selects logic channel L0 and sets the pointer offset to 0 for the stored data in the memory.)

:MEMory:RECLData? 2
(Reads two data objects (four data bytes) from memory.)

(response)  :MEMORY:RECLDATA 10,2,13,5  (when headers are enabled)


Note


-


Usage
Conditions


REC
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the logic channel is selected by :MEMory:RECPoint
and the stored data is present.




Set and query the memory read pointer


Syntax


(Command)
(Query)


:MEMory:RECPoint CH$,A
:MEMory:RECPoint?

(response)

CH$,A<NR1>
CH$ = CH1 to , L0 to L8
A = 0 to (storaage data)


Details


Sets the read pointer in instrument memory.
Returns the current memory read pointer location as a channel and pointer offset as an NR1 numerical value.


Example


:MEMory:RECPoint CH1,100
:MEMory:RECPoint?
(response)  :MEMORY:RECPOINT CH1,100  (when headers are enabled)


Note


If there is no stored data, the read pointer cannot be set.
Argument A can be set only to a value less than that returned by the :MEMory:MAXPoint? command.


Usage
Conditions


REC
When not measuring




Read stored data (measured values)


Syntax


(Query)


:MEMory:RECVData? A

(response)

B1<NR3>,B2<NR3>,C1<NR3>,C2<NR3>,...
A = 1 to 40
B1, B2, C1, C2,... = Physical values


Details


Reads the number of data objects (A) from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:RECPoint command.

With the Recorder function, each data object consist of two words: the maximum and the minimum measurements during the sampling interval.
For example, in the response B1, B2, C1, C2: the B1 and B2 values comprise the first data object, in which B1 is the maximum value and B2 is the minimum value measured during the first sampling interval.
Similarly, C1 and C2 comprise the maximum and minimum values, respectively, measured during the second sampling interval. This command cannot be executed during startup.
* Scaled values are returned when scaling is enabled.


Example


:MEMory:RECPoint CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the stored data.)

:MEMory:RECVData? 2
(Reads two samples (four data words) of storage data.)

(response)  :MEMORY:RECVDATA 5.10000E-03,3.20000E-03,12.3000E-03,5.00000E-03  (when headers are enabled)


Note


In recorder function DVM unit (MR8990) resolution decreases to from 24 bit to 16 bits.


Usage
Conditions


REC
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the analog channel is selected by :MEMory:RECPoint
and the stored data is present.




Read stored data (measured values)


Syntax


(Query)


:MEMory:VDATa? A

(response)

B<NR3>,C<NR3>,D<NR3>,...
A = 1 to 80
B, C, D,... = Physical values


Details


Reads the number of data objects specified by A from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:POINt command.
The read pointer is incremented by the number of data words read.
This command cannot be executed while measuring.

Scaled values are written and read when scaling is enabled.


Example


:MEMory:POINt CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the stored data.)

:MEMory:VDATa? 2
(Reads two data words from memory.)

(response)  :MEMORY:VDATA 5.67800E-03,4.32100E-03  (when headers are enabled)


Note


-


Usage
Conditions


MEM, XY
measurement is not taking place.
the memory read pointer is below the address of the stored data,
the analog channel is selected by :MEMory:POINt




Read real-time data (measured values)


Syntax


(Query)


:MEMory:VREAl? CH$

(response)

A<NR3>
A = Physical values.
CH$ = CH1 to


Details


Returns the physical value measured on channel CH$ after acquiring data with the :MEMory:GETReal command.
The data obtained is the same as that for the :MEMory:VDATa command.


Example


:MEMory:GETReal
(Causes the instrument to acquire real-time measurement values on all channels.)

:MEMory:VREAl? CH1
(response)  :MEMORY:VREAL 1.23000E-02  (when headers are enabled)


Note


If the :MEMory:GETReal command is not executed before this command, returned values are undetermined.


Usage
Conditions


ALL functions




Query the storage data count for the DVM unit


Syntax


(Query)


:MEMory:DVMAxpoint?

(response)

A<NR1>
A = 0 (no data stored) to (the number of stored data bytes/words)


Details


Returns the number of data bytes/words stored in memory as a numerical value in NR1 format.


Example


:MEMory:DVPOINt CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the data stored in the memory.)

:MEMory:DVMAxpoint?
(response)  :MEMORY:MAXPOINT 2501  (when headers are enabled)


Note


The number of stored data bytes/words depends on the channel specified with the :MEMory:DVPOint command.


Usage
Conditions


MEM
When not measuring
The specified channel must be for the DVM unit




Set and query the output point for the storage data of the DVM unit


Syntax


(Command)
(Query)


:MEMory:DVPOint CH$,A
:MEMory:DVPOint?

(response)

CH$,A<NR1>
CH$ = CH1 to CH32
A = 0 to (Strage data)


Details


Sets the read pointer in instrument memory.
Returns the current memory read pointer location as a channel and pointer offset as an NR1 numerical value.

For the DVM unit, the data count per division is 50 points.
(For other units, the data count per division is 100 points.)


Example


:MEMory:DVPOint CH1,100
:MEMory:DVPOint?
(response)  :MEMORY:DVPOINT CH1,100  (when headers are enabled)


Note


If there is no stored data, the read pointer cannot be set.
Argument A can be set only to a value less than that returned by the :MEMory:DVMAxpoint? command. The specified channel must be for the DVM unit.


Usage
Conditions


MEM
When not measuring




Read ASCII data of the DVM unit in memory


Syntax


(Query)


:MEMory:DVAData? A

(response)

B<NR1>,C<NR1>,D<NR1>,...
A = 1 to 80
B,C,D,... = 0 to 16777215


Details


Reads the specified number (A) of data values from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:DVPOint command.
The read pointer is incremented by the number of data values (words/bytes) read. This command cannot be executed while measuring.

Refer to the :MEMory:RATIo? command description regarding conversion to physical values.


Example


:MEMory:DVPOint CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for storing data in memory.)

:MEMory:DVAData? 10
(Reads 10 ASCII data values from memory.)

(response)  :MEMORY:DVADATA 1,2,3,4,5,6,7,8,9,10  (when headers are enabled)


Note


-


Usage
Conditions


MEM
Measurement is not taking place,
The memory read pointer is below the address of the stored data,
The DVM unit channe is that specified by :MEMory:DVPOint,
and stored data is present.




Read stored data of the DVM unit (measured values)


Syntax


(Query)


:MEMory:DVVData? A

(response)

B<NR3>,C<NR3>,D<NR3>,...
A = 1 to 80
B, C, D,... = Physical values


Details


Reads the number of data objects specified by A from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:DVPOint command.
The read pointer is incremented by the number of data words read.
This command cannot be executed while measuring.

Scaled values are written and read when scaling is enabled.


Example


:MEMory:DVPOint CH1,0
(Selects channel CH1 and sets the pointer offset to 0 for the stored data.)

:MEMory:DVVData? 2
(Reads two data words from memory.)

(response)  :MEMORY:DVVDATA -1.043727E+01,-1.043771E+01  (when headers are enabled)


Note


-


Usage
Conditions


MEM
measurement is not taking place.
the memory read pointer is below the address of the stored data,
the DVM unit channel is selected by :MEMory:DVPOint.




Read real-time data of the DVM unit (measured values)


Syntax


(Query)


:MEMory:DVVReal? CH$

(response)

A<NR3>
A = Physical values.
CH$ = CH1 to


Details


Returns the physical value measured on channel CH$ after acquiring data with the :MEMory:GETReal command.
The data obtained is the same as that for the :MEMory:DVVData command.


Example


:MEMory:GETReal
(Causes the instrument to acquire real-time measurement values on all channels.)

:MEMory:DVVReal? CH1
(response)  :MEMORY:DVVREAL 1.23000E-02  (when headers are enabled)


Note


If the :MEMory:GETReal command is not executed before this command, returned values are undetermined.


Usage
Conditions


ALL functions