# PyHam KISS
## Overview
This package provides a client implementation for the KISS TNC protocol,
providing send and receive capability via a TCP/IP connection. All commands
are supported in sending to the TNC; per the spec, only data frames are
supported when receiving from the TNC. Multi-port TNCs are supported.
This implementation has been tested with Direwolf as the server.
It is expected that developers working with this package will have some level
of knowledge of the KISS protocol. Those less familiar with the protocol may
wish to refer to the
[KISS protocol specification](http://www.ka9q.net/papers/kiss.html)
in conjunction with the documentation for this package.
**Author**: Martin F N Cooper, KD6YAM
**License**: MIT License
### Limitations
- This package supports only TCP/IP connection to a KISS server. It does not
support serial connection, nor are there plans to add such support.
## Installation
**Important**: This package requires Python 3.7 or later.
The PyHam KISS package is distributed on
[PyPI](https://pypi.org/project/pyham_kiss/),
and should be installed with pip as follows:
```console
$ pip install pyham_kiss
```
Then import the module in your code using:
```python
import kiss
```
The source code is available from the
[GitHub repository](https://github.com/mfncooper/pyham_kiss):
```console
$ git clone https://github.com/mfncooper/pyham_kiss
```
## Documentation
Full documentation is available
[online](https://pyham-kiss.readthedocs.io/en/latest/)
and includes the following:
<dl>
<dt><b>User Guide</b></dt>
<dd>The User Guide walks through some use cases for the package, starting
from the basics and adding capability as it progresses.</dd>
<br>
<dt><b>Examples</b></dt>
<dd>Complete example applications are included, in order that a developer
can observe the usage of the package in a real-world scenario.</dd>
<br>
<dt><b>API Reference</b></dt>
<dd>If you are looking for information on a specific function, class, or
method, this part of the documentation is for you.</dd>
</dl>
## References
<dl>
<dt>KISS protocol reference:</dt>
<dd><a href="http://www.ka9q.net/papers/kiss.html">http://www.ka9q.net/papers/kiss.html</a></dd>
<br>
<dt>Direwolf:</dt>
<dd><a href="https://github.com/wb2osz/direwolf">https://github.com/wb2osz/direwolf</a></dd>
</dl>
## About PyHam
PyHam is a collection of Python packages targeted at ham radio enthusiasts who
are also software developers. The name was born out of a need to find unique
names for these packages when the most obvious names were already taken.
PyHam packages aim to provide the kind of functionality that makes it much
simpler to build sophisticated ham radio applications without having to start
from scratch. In addition to the packages, PyHam aims to provide useful
real-world ham radio applications for all hams.
See the [PyHam home page](https://pyham.org) for more information, and a
list of currently available libraries and applications.
Raw data
{
"_id": null,
"home_page": null,
"name": "pyham_kiss",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "ham radio, amateur radio, packet radio, KISS, TNC, protocol",
"author": null,
"author_email": "Martin F N Cooper <mfncooper@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/22/98/83c50b62b5932b8a44838dfb36bc60a3e33285fdbf3d412ea588038204e7/pyham_kiss-1.0.0.tar.gz",
"platform": null,
"description": "# PyHam KISS\n\n## Overview\n\nThis package provides a client implementation for the KISS TNC protocol,\nproviding send and receive capability via a TCP/IP connection. All commands\nare supported in sending to the TNC; per the spec, only data frames are\nsupported when receiving from the TNC. Multi-port TNCs are supported.\n\nThis implementation has been tested with Direwolf as the server.\n\nIt is expected that developers working with this package will have some level\nof knowledge of the KISS protocol. Those less familiar with the protocol may\nwish to refer to the\n[KISS protocol specification](http://www.ka9q.net/papers/kiss.html)\nin conjunction with the documentation for this package.\n\n**Author**: Martin F N Cooper, KD6YAM \n**License**: MIT License\n\n### Limitations\n\n- This package supports only TCP/IP connection to a KISS server. It does not\n support serial connection, nor are there plans to add such support.\n\n## Installation\n\n**Important**: This package requires Python 3.7 or later.\n\nThe PyHam KISS package is distributed on\n[PyPI](https://pypi.org/project/pyham_kiss/),\nand should be installed with pip as follows:\n\n```console\n$ pip install pyham_kiss\n```\n\nThen import the module in your code using:\n\n```python\n import kiss\n```\n\nThe source code is available from the\n[GitHub repository](https://github.com/mfncooper/pyham_kiss):\n\n```console\n$ git clone https://github.com/mfncooper/pyham_kiss\n```\n\n## Documentation\n\nFull documentation is available\n[online](https://pyham-kiss.readthedocs.io/en/latest/)\nand includes the following:\n\n<dl>\n<dt><b>User Guide</b></dt>\n<dd>The User Guide walks through some use cases for the package, starting\nfrom the basics and adding capability as it progresses.</dd>\n<br>\n<dt><b>Examples</b></dt>\n<dd>Complete example applications are included, in order that a developer\ncan observe the usage of the package in a real-world scenario.</dd>\n<br>\n<dt><b>API Reference</b></dt>\n<dd>If you are looking for information on a specific function, class, or\nmethod, this part of the documentation is for you.</dd>\n</dl>\n\n## References\n\n<dl>\n<dt>KISS protocol reference:</dt>\n<dd><a href=\"http://www.ka9q.net/papers/kiss.html\">http://www.ka9q.net/papers/kiss.html</a></dd>\n<br>\n<dt>Direwolf:</dt>\n<dd><a href=\"https://github.com/wb2osz/direwolf\">https://github.com/wb2osz/direwolf</a></dd>\n</dl>\n\n## About PyHam\n\nPyHam is a collection of Python packages targeted at ham radio enthusiasts who\nare also software developers. The name was born out of a need to find unique\nnames for these packages when the most obvious names were already taken.\n\nPyHam packages aim to provide the kind of functionality that makes it much\nsimpler to build sophisticated ham radio applications without having to start\nfrom scratch. In addition to the packages, PyHam aims to provide useful\nreal-world ham radio applications for all hams.\n\nSee the [PyHam home page](https://pyham.org) for more information, and a\nlist of currently available libraries and applications.\n",
"bugtrack_url": null,
"license": null,
"summary": "KISS TNC Protocol Client for TCP/IP",
"version": "1.0.0",
"project_urls": {
"Documentation": "https://pyham_kiss.readthedocs.io",
"Source Code": "https://github.com/mfncooper/pyham_kiss"
},
"split_keywords": [
"ham radio",
" amateur radio",
" packet radio",
" kiss",
" tnc",
" protocol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "16d2909ddfda4c7ee6b935574238b816542134cc9dcd3b074e16afbeb5dbbac1",
"md5": "c0bfded6fde1bf81f3af17fe8cecb405",
"sha256": "39f4bd489866d5122214564be0878f6816f0bd535a364ea39528e353e776a01a"
},
"downloads": -1,
"filename": "pyham_kiss-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c0bfded6fde1bf81f3af17fe8cecb405",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5994,
"upload_time": "2024-04-03T20:53:55",
"upload_time_iso_8601": "2024-04-03T20:53:55.962999Z",
"url": "https://files.pythonhosted.org/packages/16/d2/909ddfda4c7ee6b935574238b816542134cc9dcd3b074e16afbeb5dbbac1/pyham_kiss-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "229883c50b62b5932b8a44838dfb36bc60a3e33285fdbf3d412ea588038204e7",
"md5": "b42b91be3831bfe7491498f55998862a",
"sha256": "5843f304cf720acc5b6683346af6a5cd29a2eee05994903141f45c8ef153a458"
},
"downloads": -1,
"filename": "pyham_kiss-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "b42b91be3831bfe7491498f55998862a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 16981,
"upload_time": "2024-04-03T20:53:57",
"upload_time_iso_8601": "2024-04-03T20:53:57.479617Z",
"url": "https://files.pythonhosted.org/packages/22/98/83c50b62b5932b8a44838dfb36bc60a3e33285fdbf3d412ea588038204e7/pyham_kiss-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-03 20:53:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mfncooper",
"github_project": "pyham_kiss",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "pyham_kiss"
}
JSON
