# Active Technologies AWG401x_AFG

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

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Function and waveform generators](https://dev.nominal.io/instro/instruments/type/awg.md)  
**Manufacturer:** [Active Technologies](https://dev.nominal.io/instro/instruments/manufacturer/active-technologies.md)

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](https://dev.nominal.io/instro/library/publishers.md). It takes two forms, both described in the [pymeasure guide](https://dev.nominal.io/instro/library/pymeasure.md). Install with `uv add "instro[pymeasure]"`.

### With a PymeasureInstrument

[`PymeasureInstrument`](https://dev.nominal.io/instro/library/pymeasure.md#write-new-instro-code) 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.

```python
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()`](https://dev.nominal.io/instro/library/pymeasure.md#publish-from-existing-code) 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.

```python
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`](https://pymeasure.readthedocs.io/en/latest/api/instruments/activetechnologies/AWG401x.html#pymeasure.instruments.activetechnologies.AWG401x.AWG401x_AFG), which lists every property and method.
