Skip to main content

Manage connections and interactions with Test & Measurement devices.

Project description

Testing Code testing status Docs testing status Coverage status
Code Quality CodeQL status CodeFactor grade pre-commit status
Package PyPI: Package status PyPI: Latest release version PyPI: Supported Python versions PyPI: Downloads License: Apache 2.0 Package build status PyPI upload status
Documentation ReadtheDocs Status
Code Style Test style: pytest Code style: ruff Docstring style: google
Linting pre-commit enabled Docstring formatter: docformatter Type Checker: pyright Linter: pylint Linter: Ruff

tm_devices: Test & Measurement Device Management

tm_devices is a device management package which allows for better control and usage of Test & Measurement devices in python scripts. This is accomplished by using the PyVISA package to manage connections and communication with devices. tm_devices gives users access to a much higher level abstraction of device control by providing access to device drivers with a complete Python API.

Dependencies

tm_devices can be used without any external (non-python) dependencies on any operating system thanks to the PyVISA-py VISA backend. However, in order to use any VISA functionality that PyVISA-py does not implement, a third-party VISA backend such as TekVISA (>=4.2.0) or NI-VISA can be installed. tm_devices will use an available VISA backend if one is found and will fall back to using PyVISA-py if no other VISA backends are installed.

Installation

pip install tm_devices

Basic Usage

Print Available VISA Devices

$ list-visa-resources
[
  "TCPIP0::192.168.0.1::inst0::INSTR",
  "ASRL4::INSTR"
]

Basic Script

from tm_devices import DeviceManager

with DeviceManager() as device_manager:
    scope = device_manager.add_scope("192.168.0.1")
    scope.query("*IDN?")
    print(scope)

Supported Devices & Software Solutions

[!TIP] Visit the Glossary to see definitions for all symbols and abbreviations.

Device Support Levels

Type Series/Model Command
Type
Basic
Control
Python API
Validation
Status
AFGs AFG3000 PI
AFG31xxx PI
AWGs AWG5000 PI
AWG5200 PI
AWG7000 PI
AWG70000 PI
Scopes 2 Series MSO PI
3 Series MDO PI
4 Series MSO PI
4 Series B MSO PI
5 Series MSO PI
5 Series B MSO PI
5 Series MSO (LP) PI
6 Series MSO PI
6 Series B MSO PI
6 Series LPD PI
MSO2000/B PI
DPO2000/B PI
MDO3000 PI
MDO4000/B/C PI
MSO4000/B PI
DPO4000/B PI
MSO5000/B PI
DPO5000/B PI
DPO7000/C PI
DPO70000/C/D/DX/SX PI
DSA70000/C/D PI
MSO70000/C/DX PI
TSOVu PI
TekScope PI
PSUs 2200 PI
2220 PI
2230 PI
2231 PI
2280S PI
2281S PI
SMUs 24xx Standard PI
24xx Interactive TSP
26xxB TSP 🚧
2636B TSP
Model 2601B-PULSE TSP
Model 2606B TSP 🚧
2651A TSP
2657A TSP
6430 (electrometer) PI
6514 (electrometer) PI
6517B (electrometer) PI
MTs TMT4 API
DMMs DMM6500 TSP
DMM7510 TSP
DMM7512 TSP
DAQs DAQ6510 TSP
SSs 3706A TSP

Software Solution Support Levels

Software
Solution
Command
Type
Basic
Control
Python API
Validation
Status
DPOJET PI
SourceXpress PI

Supported Connections

  • REST API
  • VISA (TekVISA, NI-VISA and PyVISA-py)
    • TCPIP
    • ASRL / Serial / RS-232 / RS-485
    • SOCKET
    • USBTMC (no PyVISA-py support)
    • GPIB (no PyVISA-py support)

Documentation

See the full documentation at https://tm-devices.readthedocs.io/stable/

Maintainers

Before reaching out to any maintainers directly, please first check if your issue or question is already covered by any open issues. If the issue or question you have is not already covered, please file a new issue or start a discussion and the maintainers will review and respond there.

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

tm_devices was created by Tektronix. It is licensed under the terms of the Apache License 2.0.

Security

The signatures of the files uploaded to PyPI and each GitHub Release can be verified using the GitHub CLI attestation verify command. The artifact attestations can also be directly downloaded from the GitHub repo attestations page if desired.

gh attestation verify --owner tektronix <file>

Credits

tm_devices was created with cookiecutter and the py-pkgs-cookiecutter template.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tm_devices-3.2.0.tar.gz (7.1 MB view details)

Uploaded Source

Built Distribution

tm_devices-3.2.0-py3-none-any.whl (7.9 MB view details)

Uploaded Python 3

File details

Details for the file tm_devices-3.2.0.tar.gz.

File metadata

  • Download URL: tm_devices-3.2.0.tar.gz
  • Upload date:
  • Size: 7.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.10

File hashes

Hashes for tm_devices-3.2.0.tar.gz
Algorithm Hash digest
SHA256 9da7472f89aef6a5d7c1f29a0ba43a54017789556876626167ec60c164a27052
MD5 a0e8dd48a01f8778a359cea3c9e73713
BLAKE2b-256 b410f4d37f9ff6f65329caf6f77aa6724c1dcd33026ab6b83061ca500bc776d5

See more details on using hashes here.

File details

Details for the file tm_devices-3.2.0-py3-none-any.whl.

File metadata

  • Download URL: tm_devices-3.2.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.10

File hashes

Hashes for tm_devices-3.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4e02e50d2337ae7d17d58c97d3281308bb0e8b397e69eda26efb12925ffb84e4
MD5 fd250d6e7ab10d03f26c7f22ad9abbb3
BLAKE2b-256 f4e65a3f79abfe77f40443101b3a0664392425466cf3fe1925053aa507b80104

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page