[](../../actions/workflows/pylint.yml)
[](https://pypi.org/project/async-gpib/)
[](https://github.com/psf/black)
# async_gpib
Python3 asyncio [Linux GPIB Wrapper](https://linux-gpib.sourceforge.io/). The library requires Python
[asyncio](https://docs.python.org/3/library/asyncio.html) and is a thin wrapper for the threaded Linux GPIB Wrapper
library.
The library is fully type-hinted.
## Supported Devices
### Instruments
|Device|Supported|Tested|Comments|
|--|--|--|--|
|[Fluke 5440B](https://github.com/PatrickBaus/pyAsyncFluke5440B)|:heavy_check_mark:|:heavy_check_mark:| |
|[HP 3478A](https://github.com/PatrickBaus/pyAsyncHP3478A)|:heavy_check_mark:|:heavy_check_mark:| |
## Setup
There are currently no packages for Linux GPIB available on all platforms. To install the library it is required to
install Linux GPIB.
### Linux GPIB:
These instructions are for Ubuntu:
```bash
sudo apt install subversion build-essential autoconf libtool flex bison python3-dev
svn checkout svn://svn.code.sf.net/p/linux-gpib/code/trunk linux-gpib-code
cd ~/linux-gpib-code/linux-gpib-kernel
make
sudo make install # ignore the signing errors
sudo groupadd gpib # seems not to be installed
sudo modprobe ni_usb_gpib
cd ~/linux-gpib-code/linux-gpib-user
./bootstrap
./configure --sysconfdir=/etc
make
sudo make install
sudo ldconfig
```
### Linux GPIB Python module:
Once Linux GPIB is installed, you can either install the python package or use the `gpib-ctypes` package.
```bash
python3 -m venv env # virtual environment, optional
source env/bin/activate
pip install -e ~/linux-gpib-code/linux-gpib-user/language/python/
```
### async_gpib Python module
The package can be directly installed via Pypi:
```bash
python3 -m venv env # virtual environment, optional
source env/bin/activate
pip install async-gpib
```
## Usage
Initialize the GPIB adapter
```python
from async_gpib import AsyncGpib
# Create a controller and talk to device address 22
async with AsyncGpib(name=0, pad=22) as gpib_device:
# Add your code here
...
```
See [examples/](examples/) for more working examples.
## Support for Multiple Devices
> :warning: **Concurrency with multiple devices**: Note, that when using a single adapter to control multiple devices,
> there is no concurrency on the GPIB bus. This means, there is **no** speed increase, when making asynchronous reads
> from multiple devices on the bus regarding the transfer time.
## Versioning
I use [SemVer](http://semver.org/) for versioning. For the versions available, see the
[tags on this repository](../../tags).
## Documentation
I use the [Numpydoc](https://numpydoc.readthedocs.io/en/latest/format.html) style for documentation.
## Authors
* **Patrick Baus** - *Initial work* - [PatrickBaus](https://github.com/PatrickBaus)
## License
This project is licensed under the GPL v3 license - see the [LICENSE](LICENSE) file for details
Raw data
{
"_id": null,
"home_page": "",
"name": "async-gpib",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "linux-gpib,GPIB,API",
"author": "",
"author_email": "Patrick Baus <patrick.baus@physik.tu-darmstadt.de>",
"download_url": "https://files.pythonhosted.org/packages/04/da/6f6f5bfe4c8a62f661d7ce5dd98298ca41681567debe42eaca997c19d82f/async_gpib-2.1.2.tar.gz",
"platform": null,
"description": "[](../../actions/workflows/pylint.yml)\n[](https://pypi.org/project/async-gpib/)\n\n\n[](https://github.com/psf/black)\n# async_gpib\nPython3 asyncio [Linux GPIB Wrapper](https://linux-gpib.sourceforge.io/). The library requires Python\n[asyncio](https://docs.python.org/3/library/asyncio.html) and is a thin wrapper for the threaded Linux GPIB Wrapper\nlibrary.\n\nThe library is fully type-hinted.\n\n## Supported Devices\n\n### Instruments\n|Device|Supported|Tested|Comments|\n|--|--|--|--|\n|[Fluke 5440B](https://github.com/PatrickBaus/pyAsyncFluke5440B)|:heavy_check_mark:|:heavy_check_mark:| |\n|[HP 3478A](https://github.com/PatrickBaus/pyAsyncHP3478A)|:heavy_check_mark:|:heavy_check_mark:| |\n\n## Setup\nThere are currently no packages for Linux GPIB available on all platforms. To install the library it is required to\ninstall Linux GPIB.\n\n### Linux GPIB:\nThese instructions are for Ubuntu:\n```bash\nsudo apt install subversion build-essential autoconf libtool flex bison python3-dev\nsvn checkout svn://svn.code.sf.net/p/linux-gpib/code/trunk linux-gpib-code\ncd ~/linux-gpib-code/linux-gpib-kernel\nmake\nsudo make install # ignore the signing errors\nsudo groupadd gpib # seems not to be installed\nsudo modprobe ni_usb_gpib\ncd ~/linux-gpib-code/linux-gpib-user\n./bootstrap\n./configure --sysconfdir=/etc\nmake\nsudo make install\nsudo ldconfig\n```\n\n### Linux GPIB Python module:\nOnce Linux GPIB is installed, you can either install the python package or use the `gpib-ctypes` package.\n```bash\npython3 -m venv env # virtual environment, optional\nsource env/bin/activate\npip install -e ~/linux-gpib-code/linux-gpib-user/language/python/\n```\n\n### async_gpib Python module\nThe package can be directly installed via Pypi:\n```bash\npython3 -m venv env # virtual environment, optional\nsource env/bin/activate\npip install async-gpib\n```\n\n## Usage\nInitialize the GPIB adapter\n```python\nfrom async_gpib import AsyncGpib\n\n# Create a controller and talk to device address 22\nasync with AsyncGpib(name=0, pad=22) as gpib_device:\n # Add your code here\n ...\n```\nSee [examples/](examples/) for more working examples.\n\n## Support for Multiple Devices\n> :warning: **Concurrency with multiple devices**: Note, that when using a single adapter to control multiple devices,\n> there is no concurrency on the GPIB bus. This means, there is **no** speed increase, when making asynchronous reads\n> from multiple devices on the bus regarding the transfer time.\n\n## Versioning\nI use [SemVer](http://semver.org/) for versioning. For the versions available, see the\n[tags on this repository](../../tags). \n\n## Documentation\nI use the [Numpydoc](https://numpydoc.readthedocs.io/en/latest/format.html) style for documentation.\n\n## Authors\n* **Patrick Baus** - *Initial work* - [PatrickBaus](https://github.com/PatrickBaus)\n\n## License\nThis project is licensed under the GPL v3 license - see the [LICENSE](LICENSE) file for details\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 (GPLv3)",
"summary": "Python3 AsyncIO Linux GPIB wrapper",
"version": "2.1.2",
"project_urls": {
"Bug Tracker": "https://github.com/PatrickBaus/pyAsyncGpib/issues",
"Download": "https://github.com/PatrickBaus/pyAsyncGpib/releases",
"Homepage": "https://github.com/PatrickBaus/pyAsyncGpib"
},
"split_keywords": [
"linux-gpib",
"gpib",
"api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8ca37fb7aed9bb23696069b2ca91d89731497a582ef890b2b247af562dcd4dc0",
"md5": "f184cb5de6d30f5ac127701c16f65f23",
"sha256": "3cd033227caed163b2cc244fcd00101d715bcec0a54ea9ae9a9497ae4900f1e1"
},
"downloads": -1,
"filename": "async_gpib-2.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f184cb5de6d30f5ac127701c16f65f23",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 19110,
"upload_time": "2023-09-14T15:13:43",
"upload_time_iso_8601": "2023-09-14T15:13:43.604568Z",
"url": "https://files.pythonhosted.org/packages/8c/a3/7fb7aed9bb23696069b2ca91d89731497a582ef890b2b247af562dcd4dc0/async_gpib-2.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "04da6f6f5bfe4c8a62f661d7ce5dd98298ca41681567debe42eaca997c19d82f",
"md5": "7666bae6940d597f50c470ef5417b722",
"sha256": "0f0e3f9cdfeda25a89075f6b2d948cb4ba8a81ce9a78e2f289fcc0b734876501"
},
"downloads": -1,
"filename": "async_gpib-2.1.2.tar.gz",
"has_sig": false,
"md5_digest": "7666bae6940d597f50c470ef5417b722",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 19554,
"upload_time": "2023-09-14T15:13:45",
"upload_time_iso_8601": "2023-09-14T15:13:45.249698Z",
"url": "https://files.pythonhosted.org/packages/04/da/6f6f5bfe4c8a62f661d7ce5dd98298ca41681567debe42eaca997c19d82f/async_gpib-2.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-14 15:13:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PatrickBaus",
"github_project": "pyAsyncGpib",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "async-gpib"
}
JSON
