# Temptronic ATS545

Control the Temptronic ATS545 temperature controller from Python with the `ATS545` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Temperature controllers and chambers](https://dev.nominal.io/instro/instruments/type/temperature.md)  
**Manufacturer:** [Temptronic](https://dev.nominal.io/instro/instruments/manufacturer/temptronic.md)

Represents the TemptronicATS545 instrument.

## Publishing through instro

instro publishes the commands you send to a ATS545 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.temptronic import ATS545
from instro.pymeasure import PymeasureInstrument

with PymeasureInstrument(
    name="ts",
    instrument=ATS545('ASRL3::INSTR'),
    dataset_rid="<dataset rid>",
) as ts:
    ts.device.configure()  # basic configuration (defaults to T-DUT)
    ts.device.start()  # starts flow (head position not changed)
    ts.device.set_temperature(25)  # sets temperature to 25 degC
    ts.device.wait_for_settling()  # blocks script execution and polls for settling
    ts.device.shutdown(head=False)  # disables thermostream, keeps head down
```

### 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.temptronic import ATS545
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

ts = ATS545('ASRL3::INSTR')  # replace adapter address
recorder = attach(ts, "ts", [NominalCorePublisher(dataset_rid="<dataset rid>")])
ts.configure()  # basic configuration (defaults to T-DUT)
ts.start()  # starts flow (head position not changed)
ts.set_temperature(25)  # sets temperature to 25 degC
ts.wait_for_settling()  # blocks script execution and polls for settling
ts.shutdown(head=False)  # disables thermostream, keeps head down

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

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