5.10. MEMory

The MEMory subsystem works with BB3 state files that are saved to (*SAV) and recalled from (*RCL) non-volatile storage locations numbered 0 through 9. The storage location 0 named “Power down state” is used to store the current BB3 parameters.

 

SCPI command

Description

MEMory

 

:NSTates?

Returns total number of state storage memory locations

:STATe

 

:CATalog?

Lists the names associated with all ten state storage locations

:DELete {<profile>}

Deletes the contents of a state storage location

:ALL

Deletes the contents of all state storage locations

:FREEze {<bool>}

Freezes saving changes into profile 0

:NAME {<profile>}, {<name>}

Assigns a custom name to a state storage locations

:RECall

 

:AUTO {<bool>}

Specifies whether the power-down state is recalled from location 0 on power-on

:SELect {<profile>}

Specifies which BB3 state will be used at power on

:VALid? {<profile>}

Determines whether a storage location contains a valid state

5.10.1. MEMory:NSTates

Syntax

MEMory:NSTates?

Description

Returns the total number of *SAV/*RCL states available in the BB3.

Return

Returns numeric value (NR1) which is one greater than the maximum that can be sent as a parameter to the *SAV and *RCL commands.

Usage example

MEM:NST?

10

5.10.2. MEMory:STATe:CATalog

Syntax

MEMory:STATe:CATalog?

Description

This query requests a list of defined names in the MEMory:STATe subsystem.

Return

The BB3 returns a list of defined <name>’s in a comma separated list. Each <name> is returned in a quoted string.

Usage example

MEM:STAT:CAT?

"",

"12V/1A",

"list V",

"4ch",

"tracking",

"parallel",

"long lists",

"list all channels",

"Saved at 2019-10-22 09:33:55",

"--Empty--"

Related Commands

MEMory:STATe:NAME

 

5.10.3. MEMory:STATe:DELete

Syntax

MEMory:STATe:DELete {<profile>}

MEMory:STATe:DELete:ALL

Description

When used with a profile number this command deletes the contents of the specified storage location. The MEMory:STATe:DELete:ALL deletes the contents of storage locations 1 through 9.

 

An error is generated on an attempt to recall a deleted state.

Parameters

Name

Type

Range

Default

<profile>

NR1

1 – 9

Return

None

Usage example

MEM:STAT:DEL 2

Related Commands

*RCL

*SAV

5.10.4. MEMory:STATe:FREEze

Syntax

MEMory:STATe:FREEze {<bool>}

MEMory:STATe:FREEze?

Description

This command prohibits saving any further changes to profile 0. It can be used, for example, to freeze program states before running the MicroPython script because the script will change some of the parameters. Once the script is complete, saving changes caused by further user activity can be re-enabled.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

Return

The command returns 0 if saving changes to profiles 0 is enabled, or returns 1 if saving changes to profiles 0 is disabled.

Usage example

MEM:STAT:FREE 1

Related Commands

*SAV

5.10.5. MEMory:STATe:NAME

Syntax

MEMory:STATe:NAME {<profile>}, {<name>}

MEMory:STATe:NAME? {<profile>}

Description

This command associates a <name> with a *SAV/*RCL register number. May assign same name to different locations and state names are unaffected by *RST. Deleting a storage location's contents MEMory:STATe:DELete resets associated name to “--Empty--”

Parameters

Name

Type

Range

Default

<profile>

NR1

1 – 9

<name>

Quoted string

0 to 32 characters

Return

Returns a *SAV/*RCL register number associates with profile number.

Usage example

MEM:STAT:DEF, 2, "All outputs on"

MEM:STAT:DEF? 2

"All outputs on"

Related Commands

MEMory:STATe:DELete

 

5.10.6. MEMory:STATe:RECall:AUTO

Syntax

MEMory:STATe:RECall:AUTO {<bool>}

MEMory:STATe:RECall:AUTO?

Description

This command disables or enables the automatic recall of a specific stored BB3 state selected using the MEMory:STATe:RECall:SELect command when power is turned on.

Select ON to automatically recall one of the ten stored states or the “power-down” state (location 0) when power is turned on. Select OFF to issue a reset (*RST) when power is turned on.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

Return

The query command returns 0 (OFF) or 1 (ON).

Usage example

MEM:STAT:REC:AUTO?

1

Related Commands

*SAV

MEMory:STATe:RECall:SELect

SYSTem:POWer

5.10.7. MEMory:STATe:RECall:SELect

Syntax

MEMory:STATe:RECall:SELect {<profile>}

MEMory:STATe:RECall:SELect?

Description

This command selects which BB3 state will be used at power on if the automatic recall mode is enabled (see MEMory:STATe:RECall:AUTO ON command). If the automatic recall mode is disabled (MEMory:STATe:RECall:AUTO OFF), then a “factory reset” (return to the default values) is issued when power is turned on.

Parameters

Name

Type

Range

Default

<profile>

NR1

0 – 9

Return

The query command returns numeric value (NR1) for 0 to 9 indicating which instrument state will be used at power on.

Usage example

MEM:STAT:REC:SEL?

2

Related Commands

*SAV

MEMory:STATe:RECall:AUTO

SYSTem:POWer

5.10.8. MEMory:STATe:VALid

Syntax

MEMory:STATe:VALid? {<profile>}

Description

This command queries the specified storage location to determine if a valid state is currently stored in this location.

 

Use this command before sending the *RCL command to determine if a valid state has been previously stored on queried location.

Parameters

Name

Type

Range

Default

<profile>

NR1

0 – 9

Return

Returns 0 if no state has been stored or if it has been deleted. It returns 1 if a valid state is stored in this location.

Usage example

MEM:STAT:VAL? 2

1

Related Commands

*RCL

*SAV