MEMory Commands (Read instrument memory)


Read ASCII data in memory.


Syntax


(Query)


:MEMory:ADATa? A

(Response)

B, C,...<NR1>
A<NR1>  1 to 80(the number of data to be read)
(Envelope Mode ON  1 to 40)
B, C,...<NR1>  1 to 16383


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 specified number of data words/bytes.

When Envelope mode is set to ON (:CONFigure:ENVElope)
each data object consists of two data words: the maximum and the minimum values.
For example, in the response B1, B2, C1, C2, the B1 and B2 comprise the first data object,
in which B1 is the maximum value and B2 is the minimum value.
Similarly, C1 and C2 comprise the second data object, in which C1 is the maximum value
and C2 is the minimum values.

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


All functions
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 real-time data as ASCII code.


Syntax


(Query)


:MEMory:AREAl? CH$

(Response)

A, B, ...<NR1>
CH$  CH1 to CH4
A,B, ...<NR1>  0 to 16383


Details


After acquiring real-time data with the :MEMory:GETReall command,
the analog channel number specified by CH$ is returned.
Returns the value input on the channel designated by ch$.


Example


:MEMory:GETReal
:MEMory:AREAl? CH1
(Response)  :MEMORY:AREAL 8442  (when headers are enabled)


Note


When the :MEMory:GETReal command is not executed before this command, the returned value is not fixed.


Usage
Conditions


All functions




Read stored data as binary code.


Syntax


(Query)


:MEMory:BDATa? A

(Response)

#0...(binary data)
A<NR1>  1 to 200 (binary data)
(Envelope Mode ON  1 to 100)


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.

When Envelope mode is set to ON  (:CONFigure:ENVElope)
each data object consists of two data words: the maximum and the minimum values.



Upper byte

Lower byte

xxxx

xxxx

xxxx

xxxx

Analog data 1


Upper byte

Lower byte

xxxx

xxxx

xxxx

xxxx

Unused

Unused

Logic B

Logic A


(x means 0 or 1)

Refer to the :MEMory:RATIo? command description regarding conversion of binary data into physical values.


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)  (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


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




Capture real-time data.


Syntax


(Command)


:MEMory:GETReal


Details


Causes the instrument to acquire real-time measurement values on all channels.


Example


:MEMory:GETReal


Note


-


Usage
Conditions


All functions




Storage data read pointer offset.


Syntax


(Query)


:MEMory:HEADPoint?

(Response)

A<NR1>
A<NR1>  0 to


Details


Returns the storage data read pointer offset as an NR1 numerical value.


Example


:MEMory:HEADPoint?
(Response)  :MEMORY:HEADPOINT 0  (when headers are enabled)


Note


-


Usage
Conditions


All functions
measurement is not taking place.




Read logic data.


Syntax


(Query)


:MEMory:LDATa? A

(Response)

B, C, ...<NR1>
A<NR1>  1 to 100 (number of data values to be output)
(A<NR1>  1 to 50 (Envelope Mode ON))
B, C, ...<NR1>  1 to 255


Details


Writes the argument data into memory at the read pointer (logic channel and pointer offset)
specified by the :MEMory:POINt command.
The read pointer is incremented by the number of data bytes written.

When Envelope mode is set to ON   (:CONFigure:ENVElope),
each data object consists of two data words: the maximum and the minimum values.
For example, in the response B1, B2, C1, C2, the B1 and B2 comprise the first data object,
in which B1 is the maximum value and B2 is the minimum value.
Similarly, C1 and C2 comprise the second data object,
in which C1 is the maximum value and C2 is the minimum values.


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

Bit

7

6

5

4

3

2

1

0

Data

B4

B3

B2

B1

A4

A3

A2

A1


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

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


Example


:MEMory:POINt LOG,0
(Selects logic channel CHA 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


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




Read real-time logic data.


Syntax


(Query)


:MEMory:LREAl?

(Response)

A<NR1>  0 to 255


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? CHA
(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>
0  not data stored
0 to the number of stored data


Details


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


Example


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


Note


The maximum number of data that can be stored in the internal buffer memory is up to 1000001.
When both Real-time Function and continuous recording mode are set to ON,
the number of storage data acquired by the :MEMory:MAXPoint? command may be over 1000001
after buffer memory completes one cycle around.
In this case, the data offset is not at 0 anymore, set the data offset by the :MEMory:HEADPoint? command.





Usage
Conditions


All functions




Set or query the memory read pointer.


Syntax


(Command)
(Query)


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

(Response)

CH$,A<NR1>
CH$:CH1 to CH4,LOG
A<NR1>:0 to


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:POINt CH1,100
:MEMory:POINt?
(Response)  :MEMORY:POINT CH1,100  (when headers are enabled)


Note


If there is no stored data, the read/write pointer cannot be set.
Argument A can be set only to a value less than that returned by the :MEMory:MAXPoint? command.
The maximum number of data that can be stored in the internal buffer memory is up to 1000001.
When both Real-time Function and continuous recording mode are set to ON,
there might be the case when the internal buffer memory completes one cycle around.
Care is necessary for this case.
The value of (A) can be specified from the range of ":MEMory:HEADPoint?" to ":MEMory:MAXPoint?".

For example, when the number of storage data acquired by the :MEMory:MAXPoint? command is 1500001,
(A) can be specified from the range of 500000 to 1500000.
(The last 1000001data that are remained in the internal buffer memory can be acquired.)





Usage
Conditions


All functions




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 CH4
A<NR3>:Ratio
B<NR3>:Offset


Details


Returns coefficients for converting data read with the :MEMory:ADATa? command and the :MEMory:BDATa? 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,+1.5625E-05,-1.2800E-01  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Read stored data. (measured values)


Syntax


(Query)


:MEMory:VDATa? A

(Response)

B, C...
A<NR1>:1 to 40(measured values)
(Envelope Mode ON  1 to 20)
B, C...<NR3>


Details


Writes the argument data into memory at the read pointer (channel and pointer offset) specified and returned by the :MEMory:POINt command.
The read pointer is incremented by the number of data values written.

Scaled values are written and read when scaling is enabled.

When Envelope mode is set to ON   (:CONFigure:ENVElope),
each data object consists of two data words: the maximum and the minimum values.
For example, in the response B1, B2, C1, C2, the B1 and B2 comprise the first data object,
in which B1 is the maximum value and B2 is the minimum value.
Similarly, C1 and C2 comprise the second data object,
in which C1 is the maximum value and C2 is the minimum values.


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


All functions
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
and the stored data is present.




Read real-time data. (measured values)


Syntax


(Query)


:MEMory:VREAl? CH$

(Response)

A
CH$:CH1 to CH4
A<NR3>: Physical values


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.23456000E-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