{"id":17972409,"url":"https://github.com/pklaus/ds1054z","last_synced_at":"2025-07-26T02:05:06.419Z","repository":{"id":56546528,"uuid":"40322702","full_name":"pklaus/ds1054z","owner":"pklaus","description":"Python package for the Rigol DS1054Z Oscilloscope","archived":false,"fork":false,"pushed_at":"2020-11-01T12:57:37.000Z","size":151,"stargazers_count":187,"open_issues_count":17,"forks_count":40,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-31T14:11:43.629Z","etag":null,"topics":["cli","ds1054z","oscilloscope","python3","rigol"],"latest_commit_sha":null,"homepage":"https://ds1054z.readthedocs.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pklaus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-06T19:17:57.000Z","updated_at":"2025-03-17T11:37:38.000Z","dependencies_parsed_at":"2022-08-15T20:40:43.542Z","dependency_job_id":null,"html_url":"https://github.com/pklaus/ds1054z","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fds1054z","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fds1054z/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fds1054z/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fds1054z/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pklaus","download_url":"https://codeload.github.com/pklaus/ds1054z/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675597,"owners_count":20977376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","ds1054z","oscilloscope","python3","rigol"],"created_at":"2024-10-29T16:14:47.372Z","updated_at":"2025-04-07T15:08:30.250Z","avatar_url":"https://github.com/pklaus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Github pklaus/ds1054z](https://img.shields.io/badge/Github-pklaus/ds1054z-brightgreen.svg)](https://github.com/pklaus/ds1054z) [![PyPI Package](https://img.shields.io/pypi/v/ds1054z.svg)](https://pypi.python.org/pypi/ds1054z)\n\n# ds1054z\n\nThis package allows you to connect to your Rigol DS1054Z\noscilloscope via Ethernet. It comes with a versatile command line tool.\n\nOff course, you can also use it to control the scope with your own script by using\n[the API](https://ds1054z.readthedocs.org/en/stable/api/index.html)\nthis package has to offer.\n\nWhile this software is named after the entry level oscilloscope DS1054Z,\nI believe there is no reason it wouldn't work with just any scope\nof the DS1000Z and MSO1000Z series by Rigol:\n\n* DS1054Z\n* DS1074Z\n* DS1104Z\n* DS1074Z-S\n* DS1104Z-S\n* MSO1074Z\n* MSO1104Z\n* MSO1074Z-S\n* MSO1104Z-S\n\n## Features\n\n* Discovering your scope via mDNS / DNS-SD\n* Saving Screenshots (incl. adjustable dimming of on-screen controls)\n* Running / stopping the scope\n* Acquiring waveforms\n* ... more to come!\n\n## Installation\n\nThe installation is dead simple:\n\n    pip install ds1054z[savescreen,discovery]\n\nds1054z depends on [python-vxi11](https://github.com/python-ivi/python-vxi11)\nwhich should automatically get installed along with itself.\n\n\nFor more information on the installation, please consult the\n[installation section][] of the [package documentation][].\n\n**Recommended Firmware**\n\nOlder versions of the oscilloscope's firmware have many issues.\nThe VXI-11 connection could be unstable or commands might return unexpected data.\nSpecifically, I'm recommending version 00.04.04.SP3 (alias 00.04.04.03.02) published on 2017-02-08.\n\n## Usage\n\n\n### Command Line Tool\n\nThis package installs a versatile command line (CLI) tool called `ds1054z`.\nYou can use it to save the screen of your scope, for example:\n\n```bash\nds1054z save-screen --overlay 0.6 192.168.0.23\n```\n\nAs a result, a file like this will be saved to your current working directory:\n\n![oscilloscope screenshot](docs/images/ds1054z-scope-display.png)\n\nYou can find out more ways to use the CLI tool with `ds1054z --help`\nor by reading [the manual](http://ds1054z.readthedocs.org/en/stable/using-the-cli.html).\n\n### Developers\n\nIf you're into Python programming, use [the DS1054Z class][]\nin your own code:\n\n```python\nfrom ds1054z import DS1054Z\n\nscope = DS1054Z('192.168.0.23')\nprint(\"Connected to: \", scope.idn)\n\nprint(\"Currently displayed channels: \", str(scope.displayed_channels))\n```\n\n## Author\n\n* Philipp Klaus  \n  \u003cphilipp.l.klaus@web.de\u003e\n\n## Resources\n\n* This Python package was inspired by [DS1054Z_screen_capture](https://github.com/RoGeorge/DS1054Z_screen_capture).\n* The device discovery built into this software is largely based on [this code](https://gist.github.com/MerseyViking/c67b7d6ebdda55929fbd) by [MerseyViking / GeoSpark](https://github.com/MerseyViking).\n* There is a Qt4 based GUI interface for the scope called [DSRemote](http://www.teuniz.net/DSRemote/).\n\n[installation section]: https://ds1054z.readthedocs.org/en/stable/installation.html\n[package documentation]: https://ds1054z.readthedocs.org/en/stable/index.html\n[the DS1054Z class]: https://ds1054z.readthedocs.org/en/stable/api/ds1054z.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpklaus%2Fds1054z","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpklaus%2Fds1054z","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpklaus%2Fds1054z/lists"}