Active Technologies AWG401x_AFG#

Control the Active Technologies AWG401x_AFG function generator from Python with the AWG401x_AFG driver.

Driver: pymeasure
Type: Function and waveform generators
Manufacturer: Active Technologies

Represents the Active Technologies AWG-401x Arbitrary Waveform Generator in AFG mode.

Publishing through instro#

instro publishes the commands you send to a AWG401x_AFG and the values you read from it, through any publisher. It takes two forms, both described in the pymeasure guide. Install with uv add "instro[pymeasure]".

With a PymeasureInstrument#

PymeasureInstrument wraps the driver in an instro instrument, with tags and background polling. The instrument is created inside the with block, and .device is the pymeasure instrument.

from pymeasure.instruments.activetechnologies import AWG401x_AFG
from instro.pymeasure import PymeasureInstrument

with PymeasureInstrument(
    name="wfg",
    instrument=AWG401x_AFG("TCPIP::192.168.0.123::INSTR"),
    dataset_rid="<dataset rid>",
) as wfg:

    wfg.device.reset()                     # Reset the instrument at default state

    wfg.device.channels[1].shape = "SINUSOID"    # Sets a sine waveform on CH1
    wfg.device.channels[1].frequency = 4.7e3     # Sets the frequency to 4.7 kHz on CH1
    wfg.device.channels[1].amplitude = 1         # Set amplitude of 1 V on CH1
    wfg.device.channels[1].offset = 0            # Set the amplitude to 0 V on CH1
    wfg.device.channels[1].enabled = True        # Enables the CH1

    wfg.device.channels[2].shape = "SQUARE"      # Sets a square waveform on CH2
    wfg.device.channels[2].frequency = 100e6     # Sets the frequency to 100 MHz on CH2
    wfg.device.channels[2].amplitude = 0.5         # Set amplitude of 0.5 V on CH2
    wfg.device.channels[2].offset = 0            # Set the amplitude to 0 V on CH2
    wfg.device.channels[2].enabled = True        # Enables the CH2

    wfg.device.enabled = True              # Enable output of waveform generator
    wfg.device.beep()                      # "beep"

    print(wfg.device.check_errors())       # Get the error queue

With existing pymeasure code (attach())#

attach() adds publishing to pymeasure code you already have. The imports, the attach() call after the instrument is created, and recorder.close() are all that instro adds.

from pymeasure.instruments.activetechnologies import AWG401x_AFG
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

wfg = AWG401x_AFG("TCPIP::192.168.0.123::INSTR")
recorder = attach(wfg, "wfg", [NominalCorePublisher(dataset_rid="<dataset rid>")])

wfg.reset()                     # Reset the instrument at default state

wfg.channels[1].shape = "SINUSOID"    # Sets a sine waveform on CH1
wfg.channels[1].frequency = 4.7e3     # Sets the frequency to 4.7 kHz on CH1
wfg.channels[1].amplitude = 1         # Set amplitude of 1 V on CH1
wfg.channels[1].offset = 0            # Set the amplitude to 0 V on CH1
wfg.channels[1].enabled = True        # Enables the CH1

wfg.channels[2].shape = "SQUARE"      # Sets a square waveform on CH2
wfg.channels[2].frequency = 100e6     # Sets the frequency to 100 MHz on CH2
wfg.channels[2].amplitude = 0.5         # Set amplitude of 0.5 V on CH2
wfg.channels[2].offset = 0            # Set the amplitude to 0 V on CH2
wfg.channels[2].enabled = True        # Enables the CH2

wfg.enabled = True              # Enable output of waveform generator
wfg.beep()                      # "beep"

print(wfg.check_errors())       # Get the error queue

recorder.close()  # flush and close the publishers

The examples are adapted from the pymeasure documentation for AWG401x_AFG, which lists every property and method.