RECALL_33120A

Recalls the specified save state for a 33120A function generator. Note that the "0" state is the state saved when last powered down. Requires an OPEN SERIAL block at the start of the app to connect with the instrument. Params: connection : SerialConnection The VISA address (requires a OPEN SERIAL node). state : select The state to recall. Returns: out : DataContainer String: Summary of waveform generator settings.

Python Code

from flojoy import flojoy, DataContainer, String, SerialConnection
from typing import Optional, Literal


@flojoy(inject_connection=True)
def RECALL_33120A(
    connection: SerialConnection,
    state: Literal["0", "1", "2", "3"] = "1",
    default: Optional[DataContainer] = None,
) -> String:
    """Recalls the specified save state for a 33120A function generator.

    Note that the "0" state is the state saved when last powered down.

    Requires an OPEN SERIAL block at the start of the app to connect with
    the instrument.

    Parameters
    ----------
    connection: SerialConnection
        The VISA address (requires a OPEN SERIAL node).
    state: select
        The state to recall.

    Returns
    -------
    DataContainer
        String: Summary of waveform generator settings.
    """

    instru = connection.get_handle()

    instru.write(f"*RCL {state}\n".encode("utf-8"))

    return String(s=f"{state}")

Find this Flojoy Block on GitHub

Example

Having problems with this example app? Join our Discord community and we will help you out!

Press enter or space to select a node.You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Download this Flojoy App

In this example, a HP 33120A is used to generate a waveform and save the setting for later use.

First the necessary blocks were added and their parameters set:

• OPEN_SERIAL
• CLEAR BUFFER 33120A
• RESET 33120A
• IMPEDANCE 33120A
• TRIGGER 33120A
• VOLT UNIT 33120A - unit = VPP
• FUNCTION 33120A - waveform - square
• FREQUENCY 33120A - frequency - 20000 (Hz)
• DUTY 33120A - duty - 60 (%)
• AMPLITUDE 33120A - amplitude - 0.2 (Vpp)
• OFFSET 33120A - offset - 0.15 (V)
• SAVE 33120A
• RECALL 33120A
• ERRORS 33120A - number - 5
• TEXT VIEW

If no parameters are specified they were left at default settings. The instrument address was set for each instrument block to the corrent COM port.

The CLEAR BUFFER 33120A and RESET 33120A blocks can be important to prevent some errors such as a buffer overflow. The impedance, trigger, volt unit, frequency, duty, amplitude, and offset blocks all set parameters corresponding to the output function. The ERRORS 33120A will return any errors in the instrument’s buffer (first in first out).

The blocks were connected as shown and the app was run. The SAVE 33120A block can be used to save the current state of the instrument. When you wish the recall those setting you can use the RECALL 33120A block. RECALL 33120A can replace all blocks in the app except OPEN_SERIAL, CLEAR BUFFER 33120A, RESET 33120A, and ERRORS 33120A (as long as the settings are saved).