(8) MEMory command (Sets and queries input and output, etc., from the memory.)

 

(1) Sets and queries the point in memory for input/output.

Common

 

Syntax

 

 

command

query

 

:MEMory:POINt ch$,A

:MEMory:POINt?

response

 

ch$,A<NR1>

ch$ = CH1 to CH4, CHA to CHD (8835)

       = CH1 to CH8, CHA to CHD (8835-01)

       = CH1 to CH32, CHA to CHH (8826)

       = CH1 to CH16, CHA to CHD (8841, 8842, 8720)

A = 0 to 2000000 (8835)

   = 0 to 4000000 (8835-01)

   = 0 to 16000000 (8826, 8841, 8842)

   = 0 to 1000000 (8720)

 

 

Explanation

 

 

Sets the input/output point in memory.

Returns the current input/output point in memory as an NR1 numerical value.

 

 

Example

 

 

:MEMory:POINt CH1,100

Sets the input/output point for channel 1 to the 100th location from the start of memory.

 

 

When allowed

 

 

In MEM and R&M (8720: in REC only).

 

 

(2) Queries the number of data samples stored.

Common

 

Syntax

 

 

query

 

:MEMory:MAXPoint?

response

 

A<NR1>

A = 0 : no data stored

      1 to 2000000 (divided by 100 gives the number of divisions) (8835)

      1 to 4000000 (divided by 100 gives the number of divisions) (8835-01)

      1 to 16000000 (divided by 100 gives the number of divisions) (8826, 8841, 8842)

      1 to 1000000 (divided by 100 gives the number of divisions) (8720)

 

 

Explanation

 

 

Returns the number of data samples stored in the memory as a numerical value in NR1 format.

 

 

Example

 

 

(query)         :MEMory:MAXPoint?

(response)   :MEMory:MAXPoint 1000 (when headers are on)

The number of data samples stored in the memory is 1000 (10 divisions).

 

 

When allowed

 

 

In MEM and R&M. (8720: in REC only)

 

 

(3) Prepares the memory.

Common

 

Syntax

 

 

command

 

 

MEMory:PREPare

 

 

Explanation

 

 

If there is no waveform data in the unit, ensures that the memory is in a state ready and able to receive transmitted data.

 

 

Example

 

 

(command) :MEMory:PREPare

Prepares the memory for receipt of waveform data.

 

 

Note

 

 

If data is currently stored in memory, a waveform is erased.

 

 

When allowed

 

 

In MEM and R&M (8720: in REC only).

 

 

(4) Inputs data to memory, and outputs stored data (in ASCII).

Except 8720

 

Syntax

 

 

command

query

 

:MEMory:ADATa B,C,...

:MEMory:ADATa? A

response

 

B,C,...all <NR1>

B, C,... = -2048 to 2047 (-737 to 3358 when measuring temperature with the 8937)

A = 1 to 80 (number of data values to be output)

 

 

Explanation

 

 

Puts the data of the data portion into the memory at the channel and point set by the :MEMory:POINt command.

If there are several data values, they are input in order from the point set by the :MEMory:POINt command.

The input/output point is incremented by the number of data values.

The number of data values specified by A are output from the memory channel and point set by the :MEMory:POINt command. The input/output point is incremented by the number of data values.

This cannot be executed during measurement operation.

 

 

 

Relationship between data values in memory and measured voltages

The following figure illustrates the relationship between the data values (-2048 to 2047)* input and output using the :MEMory:ADATa command and the measured voltage values. *: (-737 to 3358 (0 Cツー: 0) when measuring temperature with the 8937)

 

 

    Measured voltage value = data value ~ voltage range/160 (8835)

    Measured voltage value = data value ~ voltage range/80 (8826, 8841, 8842, 8720)

 

Example:

    When voltage range = 1 (V/DIV), data value = 768

    Measurement voltage = 768~1/160 = 4.8 (V)

 

 

Example

 

 

:MEMory:POINt CH1,0

:MEMory:ADATa? 10

Sets the input/output point to channel 1 and data value zero in memory, then outputs 10 stored data values.

 

 

When allowed

 

 

In MEM and R&M, provided that stored data is present, and provided that the input/output point is lower than the amount of data stored.

 

(5) Input voltage data to memory, and output voltage data from memory.

Except 8720

 

Syntax

 

 

command

query

 

:MEMory:VDATa B,C,...

:MEMory:VDATa? A

response

 

B,C,... all<NR3>

B,C,... = voltage values (units V, με, C°)

A = 1 to 40 (amount of data)

 

 

Explanation

 

 

Puts the data values (voltage values) in the data portion into the memory at the channel and point set by the :MEMory:POINt command.

If there are several data values, they are input in order from the point set by the :MEMory:POINt command.

The input/output point is incremented by the number of data values.

The number of stored data values specified by A are output as voltage values from the memory channel and point set by the :MEMory:POINt command.

The input/output point is incremented by the number of data values.

 

   When scaling, the scaled values are input and output.

   When calculating the waveform, calculated results are input and output.

   This cannot be executed during measurement operation.

 

 

 

Example

 

 

:MEMory:POINt CH1,0

:MEMory:VDATa? 10

Sets the input/output point to channel 1 and data value zero in memory, then outputs 10 stored data values as voltage values.

 

 

When allowed

 

 

In MEM and R&M, provided that stored data is present, and provided that the input/output point is lower than the amount of data stored. Stored data is obtained when there is no waveform data (see "Prepares the memory.").

 

 

(6) Captures real time data.

Common

 

Syntax

 

 

command

 

 

:MEMory:GETReal

 

 

Explanation

 

 

Captures the values which are currently input on the channel for all the channel.

 

 

When allowed

 

 

Providing that measurement operation is not taking place.

 

 

(7) Outputs real time data (in ASCII).

Common

 

Syntax

 

 

query

 

:MEMory:AREAl? ch$

response

 

A<NR1>

A = -2048 to 2047

 

 

Explanation

 

 

Returns the value input on the channel designated by ch$.

 

 

Example

 

 

Query       :MEMory:AREAl? CH1

response  :MEMory:AREAl 2000? (HEADER ON)

 

 

Note

 

 

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

 

 

When allowed

 

 

Providing that measurement operation is not taking place.

 

 

(8) Outputs real time data (voltage values).

Common

 

Syntax

 

 

query

 

:MEMory:VREAl? ch$

response

 

A<NR3>

A = a voltage value (units V, με, C°)

 

 

Explanation

 

 

Returns as a voltage value the value input on the channel designated by ch$.

 

 

Example

 

 

query        :MEMory:VREAl? CH1

response  :MEMory:VREAl 4.7E-2 (HEADER ON)

 

 

Note

 

 

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

 

 

When allowed

 

 

Providing that measurement operation is not taking place.

 

(9) Input logic data to memory, and output logic data from memory.

Except 8720

 

Syntax

 

 

command

query

 

:MEMory:LDATa B,C,...

:MEMory:LDATa? A

response

 

B,C,... all<NR1>

B C, ... = 0 to 15

A = 1 to 100 (number of data values to be output)

 

 

Explanation

 

 

Puts the data values (logic values) in the data portion into the memory at the channel and point set by the :MEMory:POINt command.

If there are several data values, they are input in order from the point set by the :MEMory:POINt command.

The input/output point is incremented by the number of data values.

The number of stored data values specified by A are output as logic values from the memory channel and point set by the :MEMory:POINt command.

The input/output point is incremented by the number of data values.

This cannot be executed during measurement operation.

 

 

The following is the correspondence between the channels set by the :MEMory:POINt command and the logic channel groups:

 

8835, 8835-01, 8841, 8842

8826

CHA

CHA1 to CHA4

CHA

CHA1 to CHA4

CHB

CHB1 to CHB4

CHB

CHB1 to CHB4

CHC

CHB1 to CHB4

...

CHD

CHB1 to CHB4

CHH

CHH1 to CHH4

 

 

The eight logic channels in each group are encoded as binary bits in the NR1 data value, as shown in the following example.

 

In the case of CHA?? (LOW: 0, HIGH 1)

Bit

7

6

5

4

3

2

1

0

Data

0

0

0

0

A4

A3

A2

A1

 

 

 

Example

 

 

command     :MEMory:POINt CHA,0

query           :MEMory:LDATa? 1

response     :MEMory:LDATa 10

 

Channels A1 to A4 are as follows;

(LOW: 0, HIGH: 1)

Bit

7

6

5

4

3

2

1

0

Data

0

0

0

0

1

A4

0

A3

1

A2

0

A1

 

 

 

When allowed

 

 

In MEM and R&M, provided that stored data is present, and provided that the input/output point is lower than the amount of data stored.

 

 

(10) Binary transfer of stored data.

Except 8720

 

Syntax

 

 

query

 

:MEMory:BDATa? A

response

 

#0...

A = 1 to 200 (number of data values to be output)

 

 

Explanation

 

 

Outputs the data stored by a :MEMory:POINt specification in binary format.

The input/output point is incremented by the number of data values.

The format of the output data is as follows:

  Initially: "#0" (Indicates binary format.)

  After the "#0", the number of data values specified by A (each value is two bytes (one byte: logic data)), is transmitted.

  The data is followed by LF (0AH) + EOI.

 

 

The data consists of the unaltered binary codes of the data stored in memory.

The bits are transmitted most significant bit first.

 

Upper byte

Lower byte

XXXX

0100

0010

1100

 

Analog channel data

 

 

XXXX

0101

Logic channel data

 

 

The data obtained is the same as that for ADATa? and LDATa?; for details refer to these commands.

It is not possible to input data in binary format.

 

 

Example

 

 

command    :MEMory:POINt CH1,0

query          :MEMory:BDATa? 10

This sets the input/output point to channel 1, and stored data value to address 0 in memory, then outputs 10 data values in binary format.

 

 

When allowed

 

 

In MEM and R&M, provided that stored data is present, and provided that the input/output point is lower than the amount of data stored.

 

 

(11) Outputs real time data (logic).

Common

 

Syntax

 

 

query

 

:MEMory:LREAl? ch$

response

 

A<NR1>

A = 0 to 15

 

 

Explanation

 

 

See "Input logic data to memory, and output logic data from memory."

 

 

Note

 

 

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

 

 

When allowed

 

 

Providing that measurement operation is not taking place.

 

 

(12) Outputs real time data (binary).

Except 8720

 

Syntax

 

 

query

 

:MEMory:BREAl? ch$

response

 

Binary data (2 bytes)

 

 

Explanation

 

 

See "Binary transfer of stored data."

 

 

Note

 

 

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

 

 

When allowed

 

 

Providing that measurement operation is not taking place.

 

 

(13) Sets and queries the output point for FFT data.

8835(A), 8835-01(A), 8826, 8841, 8842

 

Syntax

 

 

command

query

 

:MEMory:FFTPOint A$,B

:MEMory:FFTPOint?

response

 

A$,B<NR1>

A$ = G1,G2

B  = 0 to 9999 (in analysis mode STR, ACR, CCR, or IMP (maximum value: number of FFT points - 1))

     = 0 to 4000 (in analysis mode LIN, RMS, PSP, TRF, COH, or CSP (maximum value: number of FFT points * 0.4))

     = 0 to 400 (in analysis mode HIS, OCT)

 

 

Explanation

 

 

Sets the output point for FFT data on the graph number designated by A$.

Returns the current output point as an NR1 format.

 

 

Example

 

 

:MEMory:FFTPOint G1,100

Sets the output point for FFT data on the graph 1 to 100.

 

 

When allowed

 

 

In FFT.

 

 

(14) Queries the FFT data at the output point.

8835(A), 8835-01(A), 8826, 8841, 8842

 

Syntax

 

 

query

 

:MEMory:FFTData?

response

 

A<NR3>,B<NR3>

A = x-axis data (in <NR3> numerical format)

B = y-axis data (in <NR3> numerical format)

 

 

Explanation

 

 

Returns the x-axis and y-axis FFT data at the output point specified by the instruction :MEMORY:FFTPOint in <NR3> numerical format.

When this command is executed, only one output point is calculated, and then the specified output point is increased by one.

By executing this command repeatedly, a continuous set of data can be obtained.

 

 

Example

 

 

:MEMory:FFTPOint G1,100

:MEMory:FFTData?

Returns the x-axis and y-axis FFT data at points of 100 on graph 1.

 

 

When allowed

 

 

In FFT.

 

 

(15) Reads real-time store data.

8826, 8841, 8842

 

Syntax

 

 

command

 

 

:MEMory:RTLOad A(,B)

A = data start point

B = data end point

 

 

Explanation

 

 

Reads the memory waveform of data stored in real time.

Previously read real time store data is required.

When B (data end point) has not been set, then data is read from A (data start point) to 2000DIV.

 

 

Example

 

 

:MEMory:RTLOad 100,1100

When real time store data is read by the main unit, memory waveform data is read from the 100th point to point 1100.

 

 

When allowed

 

 

After real time data has been stored.

 

 

(16) Storage data output (ASCII).

8720

 

Syntax

 

 

command

query

 

:MEMory:RECAData B1,B2,C1,C2, ...

:MEMory:RECAData? A

response

 

B1,B2,C1,C2, ...all<NR1>

B1, B2, C1, C2,... = -2048 to 2047

A = 1 to 40 (number of the output sample)

 

 

Explanation

 

 

Inputs data into storage memory from the channel and point specified by MEMory:POINt.

When there are several pieces of data, then data are input sequentially from the point specified by MEMory:POINt, and the input/output points increment the data number.

Outputs the storage data from the channel and point specified by MEMory:POINt for the number of the sample specified at A.

In the recorder function, one sample consists of 2 pieces of data which hold maximum and the minimum values. For the response B1, B2, C1, C2, for example, B1, B2 comprise the first piece of data where B1 is the maximum value and B2 is the minimum value. C1, C2 is the second piece of data where C1 is the maximum value and C2 is the minimum value.

During startup this cannot be executed.

 

* For details about the relationship between storage data and the voltage value, refer to :MEMory:ADATa.

 

 

Example

 

 

:MEMory:POINt CH1,0

:MEMory:RECAData? 10

Sets the I/O point to channel 1 and storage data to 0, and outputs 10 samples (data number: 20) of storage data.

 

 

When allowed

 

 

When there is storage data.

 

 

(17) Storage data output (voltage value).

8720

 

Syntax

 

 

command

query

 

:MEMory:RECVData B1,B2,C1,C2...

:MEMory:RECVData? A

response

 

B1,B2,C1,C2,...all<NR3>

B1, B2, C1, C2,... = voltage value

A = 1 to 20 (number of the output sample)

 

 

Explanation

 

 

Inputs data (voltage value) into storage memory from the channel and point specified by MEMory:POINt.

When there are several pieces of data, then data are input sequentially from the point specified by MEMory:POINt, and the input/output points increment the data number.

Outputs the storage data from the channel and point specified by MEMory:POINt for the number of the sample specified at A.

In the recorder function, one sample consists of 2 pieces of data which hold maximum and the minimum values. For the response B1, B2, C1, C2, for example, B1, B2 comprise the first piece of data where B1 is the maximum value and B2 is the minimum value. C1, C2 is the second piece of data where C1 is the maximum value and C2 is the minimum value.

During startup this cannot be executed.

 

* When scaling, outputs the scaling value.

 

 

Example

 

 

:MEMory:POINt CH1,0

:MEMory:RECVData? 10

Sets the I/O point to channel 1 and storage data to 0, and outputs 10 samples (data number: 20) of storage data.

 

 

When allowed

 

 

When there is storage data.

 

 

(18) Transfers storage data in binary.

8720

 

Syntax

 

 

query

 

:MEMory:RECBData? A

response

 

#0...

A = 1 to 100 (number of the output sample)

 

 

Explanation

 

 

Outputs in binary format an output sample (specified at A) of the storage data from the channel and point specified by MEMory:POINt.

The input/output points increment the data number. For details about the output point, refer to MEMory:BDATa.

In the recorder function, one sample consists of 2 pieces of data which hold maximum and the minimum values.

The sequence of the data is identical to that of :RECAData, the first sample maximum value, first sample minimum value, second sample maximum value, second sample minimum value, and so on.

 

 

Example

 

 

:MEMory:POINt CH1,0

:MEMory:RECBData? 10

Sets the I/O point to channel 1 and storage data to 0, and outputs 10 samples (data number: 20) of storage data.

 

 

When allowed

 

 

When there is storage data.

 

 

(19) Storage data output (logic).

8720

 

Syntax

 

 

command

query

 

:MEMory:RECLData B1,B2,C1,C2

:MEMory:RECLData? A

response

 

B1,B2,C1,C2,...all<NR1>

B1, B2, C1, C2,... = 0 to 15

A = 1 to 50 (number of the output sample)

 

 

Explanation

 

 

Inputs data into storage memory from the channel and point specified by MEMory:POINt.

When there are several pieces of data, then data are input sequentially from the point specified by MEMory:POINt, and the input/output points increment the data number.

Outputs the storage data from the channel and point specified by MEMory:POINt for the number of the sample specified at A.

In the recorder function, one sample consists of 2 pieces of data which hold maximum and the minimum values. For the response B1, B2, C1, C2, for example, B1, B2 comprise the first piece of data where B1 is the maximum value and B2 is the minimum value. C1, C2 is the second piece of data where C1 is the maximum value and C2 is the minimum value.

During startup this cannot be executed.

 

* For details about logic data, refer to :MEMory:LDATa.

 

 

Example

 

 

:MEMory:POINt CH1,0

:MEMory:RECLData? 10

Sets the I/O point to channel 1 and storage data to 0, and outputs 10 samples (data number: 20) of storage data.

 

 

When allowed

 

 

When there is storage data.