# Velleman K8090

Control the Velleman K8090 data acquisition system from Python with the `VellemanK8090` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Data acquisition](https://dev.nominal.io/instro/instruments/type/daq.md)  
**Manufacturer:** [Velleman](https://dev.nominal.io/instro/instruments/manufacturer/velleman.md)

For usage with the K8090 relay board, by Velleman.

## Publishing through instro

instro publishes the commands you send to a VellemanK8090 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.velleman import VellemanK8090, VellemanK8090Switches as Switches
from instro.pymeasure import PymeasureInstrument

with PymeasureInstrument(
    name="instrument",
    instrument=VellemanK8090("ASRL1::INSTR"),
    dataset_rid="<dataset rid>",
) as instrument:

    # Get status update from device
    last_on, curr_on, time_on = instrument.device.status

    # Toggle a selection of channels on
    instrument.device.switch_on = Switches.CH3 | Switches.CH4 | Switches.CH5
```

### 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.velleman import VellemanK8090, VellemanK8090Switches as Switches
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

instrument = VellemanK8090("ASRL1::INSTR")
recorder = attach(instrument, "instrument", [NominalCorePublisher(dataset_rid="<dataset rid>")])

# Get status update from device
last_on, curr_on, time_on = instrument.status

# Toggle a selection of channels on
instrument.switch_on = Switches.CH3 | Switches.CH4 | Switches.CH5

recorder.close()  # flush and close the publishers
```

The examples are adapted from the [pymeasure documentation for `VellemanK8090`](https://pymeasure.readthedocs.io/en/latest/api/instruments/velleman/velleman_k8090.html#pymeasure.instruments.velleman.velleman_k8090.VellemanK8090), which lists every property and method.
